Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

English

...

Validators completed

...

Name

...

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-68

...

Expand
titleOpis

Walidator, na podstawie podanego loginu, wyszukuje użytkownika i zapisuje zdefiniowaną informację o jego istnieniu/nieistnieniu do podanej zmiennej.

Image Removed

...

Expand
titleParametry

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
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-5

...

Expand
titleOpis

Na podstawie loginu i id roli z procesu walidator ustala czy użytkownik posiada podaną rolę.

Image Removed

...

Expand
titleParametry

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.

...

Walidacja podłączenia dokumentów

...

JIRA
server192.168.1.52 JIRA
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-21

...

Expand
titleOpis

Sprawdza, czy podłączono dokument/y na zasadach określonych przez parametry.

Image Removed

...

 

Expand
titleParametry

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).

 

...

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 komponentuNazwaKategoriaDostępne od wersjiOpisTagi
CVA0001Walidacja na podstawie logicznego wyniku funkcji

Ogólne

...

1.

...

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-98

...

0.0

1.0.10

...

titleOpis

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
titleParametry

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)

 

...

Walidacja unikatowości procesu

...

Ogólne

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-31

...

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-94

...

JIRA
server192.168.1.52 JIRA
serverId2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
keyCUFCMP-139

...

titleOpis

> Szczegółowy opis <

walidator ogólny, sprawdzanie warunku
CVA0002Sprawdzenie roli wskazanego użytkownikaUżytkownik1.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

Update 139:

Komunikat posiada wbudowany interpreter, dzięki któremu możemy się odwołać do kontekstu zduplikowanego procesu. Możemy zatem pobrać zmienne ze zduplikowanego procesu, podając w umieszczając w komunikacie id zmiennej między dwoma znakami "@". Przykład:

Treść alertu: "Zduplikowany proces posiadał wniosek o id: @id_wniosku@." - w miejsce @ id_wniosku@ zostanie wpisana wartość zmiennej o id: "id_wniosku" ze zduplikowanego procesu.

   

 

Expand
titleParametry

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.

Rodzaje procesów : STRING

Wybieramy, w jakich procesach szukać duplikatu: otwarte, zamknięte lub wszystkie.

...

> Szczegółowy opis <unikatowość, proces, duplikaty
CVA0005Sprawdzenie istnienia użytkownikaUżytkownik1.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
CVA0006Walidacja dokumentów procesuDokumenty

...

1.

...

0.7

...

titleOpis

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
titleParametry

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).

...

> Szczegółowy opis <dokumenty w procesie, weryfikacja
CVA0007Walidacja komentarza do zadaniaKomentarze

...

1.

...

0.13

...

titleOpis

Wyświetla okno z możliwością podania komentarza w przypadku braku komentarza od użytkownika

 

 

...

> Szczegółowy opis <sprawdzenie komentarza, użytkownik, komentarz
CVA0008Walidacja danych z formularza w bazie danychBaza danych

...

1.

...

0.14

...

titleOpis

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:

namequery
USER_EXISTSELECT * FROM pm_cust_users WHERE userid = ?
USER_EQUALSELECT * FROM pm_cust_users WHERE userid = ? AND name = ? AND username = ?
USER_INSERTINSERT INTO pm_cust_users (userid, name, username) VALUES (?, ?, ?)
USER_UPDATEUPDATE 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
titleParametry

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

CVA0009Walidator zapytań do bazy danychBaza danych1.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