====== XML dla Workflow ====== Jako repozytorium i silnik bpmn używamy Activiti. Poniższa dokumentacja jest rozszerzeniem http://www.activiti.org/userguide/index.html#bpmn20 i należy się z nią wcześniej zapoznać. ===== Ogólny opis zawartości pliku ===== W pliku występują następujące znaczniki: - - oznacza rozpoczęcie workflow i może zawierać formatkę - - oznacza pojedyncze zadania i może zawierać formatkę - - oznacza opis do zadania - - zawiera opisy formatki - - zawiera opis pojedynczego pola z formatki ===== Przykład znacznika ===== Wartości parametru **name** mogą być dowolne i nie mają wpływu na pracę workflow. ===== Opis znacznika ===== Jest to najważniejszy znacznik w workflow i definiuje on co będzie widział użytkownik na formatce. Istotne znaczenie mają atrybuty id i type. Atrybuty dodatkowe: * writable - określa możliwość zapisu * readable - określa możliwość widoczności * default - określa wartość początkową pola * required - określa wymagalność pola Znaczenie poszczególnych wartości w atrybutach zostanie pokazana na przykładach: == Pole firmaticowe == * ID - jest nazwą dowolną używaną tylko w workflow * TYPE - FIRMATIC_FIELD * ARGS - FIR_NAME:Tytul - **Tytul** jest to nazwa pola znajdująca się w xmlu z firmatica W tym polu można używać atrybutu writable w celu ograniczenia edytowalności pola (tzn. z pola edytowalnego w firmaticu można zrobić nieedytowalne w workflow). == Pole firmaticowe odświeżane w zakładce "Informacje o procesie" == Domyślnie pola firmaticowe w zakładce "Informacje o procesie" nie są odświeżane. Można wymusić odświeżanie poprzez zastosowanie opcji MUTABLE == Pole firmaticowe wyświetlane jako TextArea == Dodatkowy parametr w ARGS to FIELD_OPT. == Pole firmaticowe typu przycisk == Pole to tworzy na formatce przycisk o dowolnej nazwie. Jego kliknięcie powoduje wysłanie komunikatu do Firmatica. * TYPE - FIRMATIC_SIGNAL * KEY - kod klawisza który ma być wysłany * CODEPROC - codeproc który ma być dołączony do klawisza == Pole workflow typu string == == Pole workflow typu string - wyświetlane jako TextArea == == Pole wyboru użytkownika == W powyższym przykładzie wykorzystano atrybut variable, który zawsze musi mieć wartość taką jak "ID". Jest on używany do przypisywania zadań do użytkowników za pomocą zmiennych. == Pole wyboru użytkownika z opcją DW == Jest to specjalne pole, które umożliwia dodanie nowej linii firmaticowej dla użytkownika, nawet jeżeli nie jest on przypisany do żadnego zadania. * DW:TRUE - oznacza, że pole jest do wiadomości * ARGS:{DW:TRUE, INNER_LIST:szef} - można również zdefiniować listę z której wybiera się pracowników == Pole wyboru użytkownika ze wskazaniem grupy oraz z wartością domyślną == Jest to pole wyboru użytkownika ze specjalnymi opcjami. Pierwszą z nich wskazanie listy z której można wybierać użytkowników. Drugim elementem jest wartość domyślna. Może ona zarówno określać pojedynczego użytkownika jak i całą listę. * INNER_LIST:PTP-330 - wybór będzie tylko z listy PTP-330 == Pole wyświetlające linie 2 spraw == * TYPE - musi być FIRMATIC_LINEAFF2 * NUM:9 - jeżeli na danej formatce ma być więcej pól tego typu to każde musi mieć swój numer * FIELD_HEIGHT:100 - określenie wysokości pola w px == Pole typu radio button == * DEFAULT: - oznacza, że nie ma wartości domyślnej, mogło by też być np. DEFAULT:isEnd i wówczas isEnd byłoby znaznaczone == Pole z historią zmian == * TYPE - FIRMATIC_LINEAFF2_LOG * NUM:0 - lepiej stosować konwencję i dać 0 * ARGS2:{firDescription} - oznacza jakie pola mają być brane do historii zmian == Pole z warunkową walidacją == * REQUIRED_IF_EXPR - pole to będzie wymagane jeżeli zostanie spełnione wyrażenie == Wartości domyślne w polach z użytkownikami == * default="list:szef" - domyślnie lista szef (= wszyscy pracownicy z tej listy) * default="user:b" - domyślnie tylko jeden pracownik ===== Przepływy i warunki ===== Ogólnie o przepływach i warunkach należy przeczytać w dokumentacji do Activiti. W **startEvent** lub **userTask** można zdefiniować pole logiczne lub enum które będzie użyte w sterowaniu przepływem. ==== Przepływ po zmiennej logicznej ==== Najpierw w **userTask** definiujemy zmienną logiczną: * variable="is_claim_valid" - pozwala na odnoszenie się do tej zmiennej w innych punktach xml-a Następnie możemy zdefiniować warunek: ${is_claim_valid == 'false'} ${is_claim_valid == 'true'} ==== Przepływ po zmiennej enum ==== Najpierw w **userTask** definiujemy zmienną enum: * variable="is_to_board_approval" Następnie możemy zdefiniować warunek: ${is_to_board_approval == 'toBoard'} * z uwagi na default="after_describe_decision_flow3", nie trzeba definiować warunku przepływu w