...
...
...
...
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-68 |
|---|
|
...
| Expand |
|---|
|
Walidator, na podstawie podanego loginu, wyszukuje użytkownika i zapisuje zdefiniowaną informację o jego istnieniu/nieistnieniu do podanej zmiennej.  Image Removed
|
...
| Expand |
|---|
|
Login : STRING Login sprawdzanego użytkownika. Tylko aktywny : BOOLEAN Flaga informująca o tym, czy wyszukiwany użytkownik musi znajdować się na liście aktywnych użytkowników. Informacja o niewystępowaniu : STRING Informacja zapisywana do zmiennej w przypadku nieistnienia w systemie użytkownika o podanym loginie. Potwierdzenie : BOOLEAN Informuje o tym, czy wyświetlić okienko potwierdzenia. Komunikat : STRING Treść komunikatu w oknie z błędem/oknie potwierdzenia. |
...
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-5 |
|---|
|
...
| Expand |
|---|
|
Na podstawie loginu i id roli z procesu walidator ustala czy użytkownik posiada podaną rolę.  Image Removed
|
...
| Expand |
|---|
|
Login użytkownika : STRING Login użytkownika, dla którego sprawdzane jest posiadanie roli. Id roli : STRING Id roli z mapy określonego procesu. Szukać w pakiecie? : BOOLEAN Określa, czy rola ma być wyszukiwana w obrębie pakietu, a nie tylko obecnego procesu. Potwierdzenie : BOOLEAN Informuje o tym, czy wyświetlić okienko potwierdzenia. Komunikat : STRING Treść komunikatu w oknie z błędem/oknie potwierdzenia. |
...
Walidator podłączenia dokumentu
...
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| columns | key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-21 |
|---|
|
...
| Expand |
|---|
|
Sprawdza, czy podłączono dokument/y na zasadach określonych przez parametry.  Image Removed
|
...
| Expand |
|---|
|
Klasy dokumentów : STRING_ARRAY Opc. nazwy klas dokumentów. Komponent dostarcza rozwijalną listę nazw klas. Podłączono tutaj? : BOOLEAN Decyduje o tym, czy szukane dokumenty miałyby być podłączone w obecnym zadaniu. Komunikat : STRING Treść alertu Potwierdzenie : BOOLEAN Decyduje o tym, czy okienko informujące o błędzie zastąpić okienkiem potwierdzenia (dla wartości true). |
...
Ogólne
...
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-8 |
|---|
|
...
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-98 |
|---|
|
...
1.0.0
1.0.10
...
Category | Avalable from version | Description | Tags | Checking the existence of a user | User | 1.0.6 | The validator, based on the given login, searches the user and saves the defined information about its existence / non-existence to the given variable.> Detailed description < | | Validation of the role held by the user | User | 1.0.1 | On the basis of login and role id from the process, the validator determines whether the user has the given role. > Detailed description < | | Validation of connecting documents | Documents | 1.0.3 | Checks whether the document / s has been connected according to the rules defined by the parameters. > Detailed description < | | Validation based on the logical result of the function | General | 1.0.0 1.0.10 | Accepts the result of the function given in the parameter that evaluates the data in terms of regularity. If the logic function returns the truth, the validator continues. If it returns false, it will show a note. > Detailed description < | | Validation of process uniqueness | General | 1.0.5 | Based on the set of variables, it checks if there are already other processes in the system containing the same values stored by these variables. > Detailed description < | | Validation of process documents | Document | 1.0.7 | Verifies the given conditions and displays the appropriate note if the verification was unsuccessful. > Detailed description < | | Validation of the comment to the task | Comments | 1.0.13 | Displays a window with the option of adding a comment in the lack of a comment from the user > Detailed description < | | Validation of data from the form in the database | Database | 1.0.14 | The validator checks the existence of an entry in the database (eg it can check if there is a user with a given id). Next, it checks whether the entry has the same values that are on the form (you can decide for yourself which values to compare). > Detailed description < | |
Validators under construction |
| Polish |
|---|
Walidatory ukończone| Identyfikator komponentu | Nazwa | Kategoria | Dostępne od wersji | Opis | Tagi |
|---|
| CVA0001 | Walidacja na podstawie logicznego wyniku funkcji | Ogólne | 1.0.0 | Przyjmuje wynik funkcji podanej w parametrze, która ewaluuje dane pod względem prawidłowości. Jeżeli funkcja logiczna zwróci prawdę, to walidator przechodzi dalej. Jeżeli zwróci fałsz, to pokaże komunikat. |
|
Update:
W walidatorze istnieje możliwość walidowania tabel dynamicznych. Aby zwalidować tabelę należy określić, czy sprawdzanie warunku ma się odnosić do każdego wiersza w tabeli, czy też dowolnego wiersza w tabeli.
Przykład 1. Chcę, aby tabela posiadała PRZYNAJMNIEJ JEDEN wpis, gdzie w kolumnie "uzytkownik" wpisana jest nazwa aktualnego użytkownika.
Przykład 2. Chcę, aby formularz przepuszczał użytkownika dalej jedynie w przypadku, gdy WSZYSTKIE wiersze w kolumnie "zadluzenie" są równe 0.
Pierwszym krokiem jest wybranie odpowiedniej wartości z parametru: "Użycie tabeli w funkcji". Dla przykładu pierwszego będzie to "Funkcja z użyciem kolumn(jakikolwiek wiersz)", dla przykładu drugiego "Funkcja z użyciem kolumn(każdy wiersz)".
UWAGA: Zmienne "Każdy wiersz" i "Jakikolwiek wiersz" nie mogą zostać użyte razem w funkcji walidującej. Pomimo pojawiania się obu z nich w menu wyboru zmiennej to tylko zmienna wybrana w parametrze "Użycie tabeli w funkcji" będzie działać poprawnie.
Po wybraniu odpowiedniego parametru możemy użyć następującego zestawu funkcji:
Dla przykładu 1: eq(item($Jakikolwiek wiersz, $uzytkownik), $aktualny_uzytkownik)
Gdzie: $Jakikolwiek wiersz to zmienna kontekstowa(powinna się pojawić po wpisaniu dolara), $użytkownik to zmienna kolumnowa, którą chcemy sprawdzić, a $aktualny_użytkownik to zmienna przetrzymująca login aktualnego użytkownika.
Dla przykładu 2: eq(item($Każdy wiersz, $zadluzenie), 0)
Gdzie: $Każdy wiersz to zmienna kontekstowa(powinna się pojawić po wpisaniu dolara), a $zadluzenie to zmienna kolumnowa, którą chcemy sprawdzić
Image Removed
...
| Expand |
|---|
|
Funkcja : FUNCTION Funkcja zwracająca wynik typu logicznego. Potwierdzenie : BOOLEAN Decyduje o tym, czy okienko informujące o błędzie zastąpić okienkiem potwierdzenia (dla wartości true). Komunikat : STRING Treść alertu Użycie tabeli w funkcji : STRING
Określa czy, i w jaki sposób użyć wartości kolumn z tabeli dynamicznej Długość tabeli : INTEGER Liczba wierszy w tabeli(można uzyskać przekazując długość dowolnej z kolumn tabeli) |
...
Walidator unikatowości dokumentu procesowego
...
Ogólne
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-31 |
|---|
|
...
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-94 |
|---|
|
...
> Szczegółowy opis < | walidator ogólny, sprawdzanie warunku | | CVA0002 | Sprawdzenie roli wskazanego użytkownika | Użytkownik | 1.0.1 | Na podstawie loginu i id roli z procesu walidator ustala czy użytkownik posiada podaną rolę. > Szczegółowy opis < | rola, użytkownik | | CVA0003 | Weryfikacja podłączenia dokumentów | Dokumenty | 1.0.3 | Sprawdza, czy podłączono dokument/y na zasadach określonych przez parametry. > Szczegółowy opis < | dokumenty w procesie, podłącz, podłączenie | | CVA0004 | Walidacja unikatowości procesu | Ogólne | 1.0.5 | Na podstawie zestawu zmiennych sprawdza, czy w systemie istnieją już inne procesy zawierające te same wartości przechowywane przez te zmienne. |
|
Image Removed
...
| Expand |
|---|
|
Zmienne : VARIABLE_ARRAY Wybrane zmienne procesu Potwierdzenie : BOOLEAN Decyduje o tym, czy okienko informujące o błędzie zastąpić okienkiem potwierdzenia (dla wartości true). Komunikat : STRING Treść alertu Zmienne wykluczająca potencjalne duplikaty : VARIABLE_ARRAY Zmienne, które wartości z poniższego parametru wyklucza dany proces z ewaluacji. Wartości dla zmiennych wykluczającej : STRING_ARRAY Tablica wartości, z których każda decyduje o wykluczeniu potencjalnego duplikatu z ewaluacji. |
...
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-80 |
|---|
|
...
| > Szczegółowy opis < | unikatowość, proces, duplikaty | | CVA0005 | Sprawdzenie istnienia użytkownika | Użytkownik | 1.0.6 | Walidator, na podstawie podanego loginu, wyszukuje użytkownika i zapisuje zdefiniowaną informację o jego istnieniu/nieistnieniu do podanej zmiennej. > Szczegółowy opis < | użytkownik, istnienie | | CVA0006 | Walidacja dokumentów procesu | Dokumenty | 1.0.7 | Weryfikuje podane warunki i wyświetla odpowiedni komunikat jeżeli weryfikacja została zakończona niepowodzeniem. |
|
Szczegółowe dane odnośnie konfiguracji: http://192.168.1.52:8081/confluence/display/CUF/DocumentService
(Weryfikacja dokumentów procesu(od 3.1.3-0))
Image Removed
...
| Expand |
|---|
|
Tryb weryfikacji : STRING (lista wartości) Określa w jaki sposób weryfikować dokumenty podłączone do procesu. Dostępne są trzy tryby - activity, stage i process. Wyświetlanie komunikatu : BOOLEAN Decyduje o tym, czy wyświetlać komunikat. Domyślnie TRUE. Warunki : STRING_ARRAY Lista warunków do spełnienia przez weryfikowane dokumenty. Warunki zostały opisane w artykule przedstawiającym szczegóły konfiguracji. Należy jednak pamiętać, że implementacja rozwiązania w walidatorze zakłada, że warunki deklarowane są bez użycia apostrofów! Przykładowy warunek: conditionType:<= Potwierdzenie : BOOLEAN Decyduje o tym, czy okienko informujące o błędzie zastąpić okienkiem potwierdzenia (dla wartości true). |
...
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-27 |
|---|
|
...
| > Szczegółowy opis < | dokumenty w procesie, weryfikacja | | CVA0007 | Walidacja komentarza do zadania | Komentarze | 1.0.13 | Wyświetla okno z możliwością podania komentarza w przypadku braku komentarza od użytkownika |
|
...
| > Szczegółowy opis < | sprawdzenie komentarza, użytkownik, komentarz | | CVA0008 | Walidacja danych z formularza w bazie danych | Baza danych |
|
...
| JIRA |
|---|
| server | 192.168.1.52 JIRA |
|---|
| serverId | 2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1 |
|---|
| key | CUFCMP-64 |
|---|
|
...
| 1.0.14 | Walidator sprawdza istnienie wpisu w bazie danych (np. może sprawdzić, czy istnieje użytkownik o danym id). Następnie sprawdza, czy wpis ten posiada te same wartości, które znajdują się na formularzu (możemy sami zdecydować, które wartości ma porównać). |
|
Mogą wystąpić trzy możliwości:
- wpis nie istnieje, a użytkownik może dodać nowy wpis w bazie, wtedy pojawia się okno dodania nowego wpisu
- wpis istnieje, ale z innymi danymi - wtedy użytkownik może edytować dane - pojawia się okno akceptacji zmian
- wpis istnieje, z identycznymi danymi - wtedy walidator przechodzi dalej
W oknie dodania/edycji istnieje możliwość pominięcia walidacji i przejścia dalej.
Aby walidator działał poprawnie, musimy przygotować odpowiednie zapytania w bazie danych, które będą wywoływane podczas sprawdzania istnienia/identyczności/dodawania/edycji danych. W tym celu należy dodać cztery zapytania do tabeli pm_dbqueries, pamiętając o dodaniu odpowiedniego identyfikatora.
Przykład: Załóżmy, że chcemy sprawdzić, czy istnieje użytkownik, którego dane są zapisane na formularzu. Przykładowe wpisy w pm_dbqueries mogłyby wyglądać tak:
| name | query |
|---|
| USER_EXIST | SELECT * FROM pm_cust_users WHERE userid = ? |
| USER_EQUALS | SELECT * FROM pm_cust_users WHERE userid = ? AND name = ? AND username = ? |
| USER_INSERT | INSERT INTO pm_cust_users (userid, name, username) VALUES (?, ?, ?) |
| USER_UPDATE | UPDATE pm_cust_users SET name = ? , username = ? WHERE userid = ? |
W tym przykładzie nasz klucz zapytania to USER. Do klucza zapytania musimy dodać frazy: _EXIST, _EQUALS, _INSERT bądź _UPDATE, by określić ich przeznaczenie. Parametry oznaczone znakiem zapytania możemy dodać w konfiguracji walidatora(należy pamiętać o kolejności! w ostatnim zapytaniu identyfikator wiersza pojawia się na końcu!)
...
| Expand |
|---|
|
Nazwa bazy danych : STRING
Nazwa bazy danych skonfigurowana w dbExplorer w systemie PlusWorkflow Klucz zapytania : STRING
Klucz (przedrostek z kolumny name z tabeli pm_dbqueries) na postawie którego pobrane zostaną zapytania Parametry zapytania : STRING_ARRAY
Wartości parametrów zapytania o istnienie Typy parametrów : STRING_ARRAY
Typy parametrów zapytania o istnienie, jakie są zapisane w bazie(dla tekstowych - string, dla liczb - number) Parametry zapytania : STRING_ARRAY
Wartości parametrów zapytania o identyczność Typy parametrów : STRING_ARRAY
Typy parametrów zapytania o identyczność, jakie są zapisane w bazie(dla tekstowych - string, dla liczb - number) Parametry zapytania : STRING_ARRAY
Wartości parametrów zapytania o dodanie Typy parametrów : STRING_ARRAY
Typy parametrów zapytania o dodanie, jakie są zapisane w bazie(dla tekstowych - string, dla liczb - number) Parametry zapytania : STRING_ARRAY
Wartości parametrów zapytania o aktualizację Typy parametrów : STRING_ARRAY
Typy parametrów zapytania o aktualizację, jakie są zapisane w bazie(dla tekstowych - string, dla liczb - number) Nazwa okna : STRING
Tytuł okna, które pojawi się, gdy identyczny wiersz nie zostanie znaleziony Pytanie o dodanie : STRING
Komunikat do użytkownika, który pojawi się w oknie, gdy nie zostanie znaleziony wiersz o danym kluczu(możliwość dodania wiersza) Pytanie o aktualizację : STRING
Komunikat do użytkownika, który pojawi się w oknie, gdy zostanie znaleziony wiersz o danym kluczu ale o innych wartościach(możliwość aktualizacji wiersza) Nazwa przycisku dodania : STRING Nazwa pod jaką ma występować przycisk służący do dodania nowego wiersza, a następnie akceptacji zadania Nazwa przycisku aktualizacji : STRING
Nazwa pod jaką ma występować przycisk służący do aktualizacji wiersza, a następnie akceptacji zadania Nazwa przycisku przejścia dalej : STRING
Nazwa pod jaką ma występować przycisk służący do przejścia dalej, bez modyfikacji wpisów w bazie danych Nazwa przycisku cofnięcia : STRING
Nazwa pod jaką ma występować przycisk służący do powrotu do formularzu zadania |
> Szczegółowy opis < | baza danych, okno z danymi, aktualizacja danych, dodanie danych, zapytania do bazy | | CVA0009 | Walidator zapytań do bazy danych | Baza danych | 1.0.41 | Walidator tworzy zapytanie na podstawie podanych parametrów i sprawdza, czy zwróci ono wynik. > Szczegółowy opis < | walidacja zapytania, baza danych, query |
Walidatory w trakcie budowy |
