Vlastnosti prvků diagramu workflow
Panel Prvky diagramu umístěný v levé části návrháře obsahuje nabídku všech prvků, které můžete při vytváření agendy použít.
Panel Vlastnosti prvků v pravé části stránky mění svůj obsah podle toho, která část agendy (prvek diagramu) je právě aktivní.
Slouží k definování atributů pro jednotlivé prvky diagramu. Některé vlastnosti, jako identifikátory a popis prvku, jsou zobrazeny přímo, u dalších položek je možné si tlačítkem Upravit zobrazit dialog Vlastnosti prvku xxx, který umožňuje prohlížení, přidávání i editaci dalších, složitějších údajů.
Kde najdete popisy vlastností prvků
Jednotlivé prvky diagramu mají řadu vlastností, které lze nastavit i upravit. Základní nastavení několika klíčových vlastností je možné v panelu Vlastnosti prvku v pravé části okna FlowApps Designeru. Z panelu je možné otvírat okno Vlastnosti prvku, ve kterém lze danému prvku nastavit všechny vlastnosti, které u něj přicházejí v úvahu.
-
Klepnutím myší do diagramu vyberete prvek, jehož vlastnosti chcete upravit.
-
V pravé části okna se v panelu Vlastnosti prvku zobrazí základní vlastnosti vybraného prvku.
-
Klepnutím na tlačítka se třemi tečkami (mimo tlačítko Upravit) přejdete do okna Vlastnosti prvku pro komplexní nastavení vlastností prvku.
-
Tlačítkem Upravit je možné přejít do okna FormApps Designeru k úpravám formuláře s daným prvkem. Tlačítkem se třemi tečkami vedle tlačítka Upravit je nejprve otevřeno okno Vlastnosti prvku s nastaveným prvkem Formulář.
Okno Vlastnosti prvku je dvoudílné.
-
V levé části (sekce Vlastnosti) je zobrazena struktura vlastností zvoleného prvku (a pod ní i struktura vlastností celé agendy).
-
V pravé části se zobrazí popis vybrané vlastnosti prvku a ovladače k jejich úpravám nebo nastavení.
Prvky mají některé vlastnosti stejné a jiné odlišné. V dalších podkapitolách bude uveden jejich souhrnný přehled.
V sekci Vlastnosti nebývají pro přehlednost uvedeny všechny vlastnosti prvku. Pokud vás zajímá některá z vlastností, kterou daný prvek sice má, ale její položku zde nevidíte, klepněte na tlačítko se symbolem „plus“ v pravé části záhlaví sekce Vlastnosti.
Otevře se nabídka s dalšími prvky. Klepnutím na položku v nabídce se tato položka zařadí do seznamu v sekci Vlastnosti.
Výchozí GraphQL dotaz
Výchozí GraphQL dotaz, který je vykonán vždy na vstupu do prvku ve své fázi zpracování.
Zpracovává se pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Hlavní JavaScriptová funkce
Hlavní PAJS funkce, která je vykonána vždy na vstupu do prvku ve své fázi zpracování.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
GraphQL dotaz
GraphQL dotaz, který je možné následně volat z PAJS kódu.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
JavaScriptová funkce
JavaScriptová funkce, kterou je možné v daném prvku volat z jakéhokoliv dalšího PAJS kódu (hlavní PAJS funkce, PAJS výrazy, atd).
Prostor pro zpracování zahrnuje všechny vlastnosti stejného typu v prvku. Dědičnost v prvcích se omezuje pouze na tento prvek.
Zahrnuje definici příjemců, předmětu a těla emailu. Do těla a předmětu je možné vkládat hodnoty z proměnných, PAJS výrazy, HTML fragmenty a další. Předmět je po vygenerování vždy převeden na prostý text.
V některých prvcích může být podpořeno opakování (např. opakované avízo u uživatelského úkolu) a naopak nemusí být některé položky dostupné (např. příjemce u uživatelského úkolu, protože je příjemcem aktér).
Příjemce je možno zadat jako emaily oddělené středníkem, z proměnné (emaily oddělené středníkem), jakéhokoliv prvku s aktérem (příjemcem je ten, kdo naposledy splnil nebo má úkol právě ke splnění) a pomocí PAJS výrazu.
Dále je možno zadat přílohy pomocí PAJS výrazu (do výsledku nastavit pole IScriptFileReference).
Je tu i možnost nastavit opakování od aktuálního nebo zadaného data v zadané dny nebo v zadaném intervalu. Pro vypočtené opakování je k dispozici PAJS výraz a rozšíření PAJS o EmailSupport.
Odeslání je možno podmínit PAJS výrazem nebo globální proměnnou. Pokud se email vyhodnocuje pro každého příjemce, vyhodnotí se i podmínka pro každého příjemce. Návštěvníkům a na přímo zadané emailové adresy je email zasílán vždy.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Výsledek podmínky
Týká se prvků typu hrana. Vyhodnotí podmínky, kde výsledkem je odpovídá/neodpovídá. Zadává se JavaScriptový výraz, proměnné typu boolean nebo cesta do výchozího GraphQL dotazu.
Vyhodnocení vždy probíhá s aktuálním tokenem a v prvku, ze kterého hrana vychází. Je tudíž v tomto prvku možné volat PAJS funkce a GQL dotazy.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Verze
Verze diagramu a předpisu.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Proměnné agendy
Definuje proměnné agendy, jejich datové typy a výchozí hodnoty.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Spojovací JavaScriptová funkce
Popisuje JavaScriptovou funkci sloužící k vyřešení konfliktů při spojování proměnných od více vstupních tokenů.
Používá se v paralelní bráně do které vede více hran. Argumentem je objekt obsahující metodu GetEdgeVariables(edgename), kde edgename je uživatelský identifikátor vstupní hrany a návratová hodnota je IScriptVariables tokenu, který touto hranou do prvku přišel.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Aktér
Definuje aktéra ze seznamu uživatelů, rolí a skupin, pomocí PAJS výrazu, z proměnné (identifikátor jednoho uživatele/skupiny) nebo z uživatelského úkolu (berou se aktéři, kteří úkol splnili naposledy, nesplněný úkol nemá aktéra).
Speciální hodnotou je žádný, kdy je aktérem uživatel zasílající zprávu. V tomto případě je vygenerován rovnou odkaz na otevření formuláře a při návratu do prvku je aktérem ten, kdo formulář naposledy vyplnil.
Je podporováno vyhodnocení nadřízeného zadaných aktérů (množina aktérů může mít více nadřízených), znovuvyhodnocení aktéra při každém vstupu do prvku (jinak se v dalším kole stává aktérem ten, kde úkol naposledy splnil) a možnost expanze skupin na jednotlivé uživatele (např. pro paralelní úkol, který mají splnit všichni ze zadané skupiny za sebe).
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
XSLT
Specifikuje se XSLT transformace, kterou je možné použít pro úpravu XML v PAJS. Podpora pro XSTL v PAJS je v rozšíření XSLT typu IScriptXSLT.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
JavaScriptová funkce – podmínka dokončení úkolu
Zadává se JavaScriptová funkce pro vyhodnocení, zda byl úkol již vyřízen.
Je volána po každém zpracování paralelního nebo sekvenčního úkolu. Argumentem je objekt typu IScriptTaskCompletedData, který může být podle typu prvku obohacen o další informace.
Funkce vrací hodnotu typu boolean, kde true znamená, že úkol byl splněn. Pokud je úkol splněn, ale nebyly vyřízeny všechny jeho části, jsou nevyřízené části zrušeny.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Upřesnění úkolu
Upřesňuje typ úkolu (normální, paralelní, sekvenční) a ovlivňuje interakci mezi aktéry v případě paralelního nebo sekvenčního úkolu (automatické předávání proměnných, dostupnost zpracovaných částí v dalších krocích).
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Popis uživatelského úkolu
Definuje popis uživatelského úkolu, který se zobrazí uživateli. Pokud není popis definován, zobrazí se uživateli popis agendy.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Název uživatelského úkolu
Zadává se název uživatelského úkolu, který se uživateli zobrazí v gridu.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Popis agend
Slouží ke změně popisu agendy při průchodu prvkem.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Spuštění instance agendy
Nastavuje se způsob zahájení agendy. Je možno určit, zda se má běh tokenu naplánovat (PLANNED) nebo rovnou spustit (IMMEDIATELY) a čekat na výsledek.
Při složité agendě je při čekání na výsledek riziko vypršení časového limitu u klienta a pádu běhu instance. |
Dále je možno nastavit způsob automatické sběru dat v tokenu, který z tohoto prvku vychází.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Odeslání zprávy
Definuje jakou zprávu a jakému příjemci prvek zasílá.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Příprava odesílaných dat
JavaScriptová funkce pro přípravu dat zasílaných zprávou. Funkce vrací data jako string.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Zpracování výsledku odeslání zprávy
JavaScriptová funkce sloužící ke zpracování výsledku zaslání zprávy. Funkce má dva argumenty, prvním je boolean hodnota, jestli se zaslání zdařilo, a druhým je string identifikátor příjemce zprávy (při zaslání vzoru je to identifikátor nově nastartované instance).
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Přijetí zprávy
Definuje, jakou zprávu prvek přijímá. Každá zpráva může být v agendě přijímána nejvýš jednou.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Zpracování přijatých dat
JavaScriptová funkce sloužící k e zpracování dat, která byla zaslána zprávou. Data jako string jsou jediným argumentem funkce.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Pravidla pro přijetí zprávy
Tato vlastnost bude dostupná od verze: 4.9. |
Definuje pravidla, za kterých je možné přijmout zprávu.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Definice časovače
Definuje výpočet data a času pro použití v daném prvku. Jako počáteční datum a čas je možno vzít aktuální nebo z proměnné. K tomuto je možno přičíst nebo odečíst roky, měsíce, dny, hodiny a minuty.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Práva ke zprávě
Definuje oprávnění, kdo smí zaslat instanci zadanou zprávu. Oprávnění může být dáno seznamem uživatelů a skupin, uživatelských úkolů nebo zákazem zasílání pro uživatele.
Dále je možno nastavit, jestli danou zprávu může zasílat externí informační systém, ale bez možnosti vybrat konkrétní systém.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Filtr prvků pro poslední splněný uživatelský úkol
Umožňuje filtrovat, které uživatelské úkoly se mají ignorovat v případě požadavku na zobrazení posledního odeslaného uživatelského úkolu v instanci. Zpravidla se jedná o servisní úkoly a boční větve procesu.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
HTML fragment
Fragment HTML, který může obsahovat vložené proměnné. Je možno jej načíst pomocí PAJS, doplnit další informace a vložit do těla emailu. Vždy se musí jednat o XML, aby bylo možno jej zpracovat.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích zahrnuje všechny nadřazené prvky.
Globální proměnné agendy
Definice globálních proměnných agendy, jejich typů, výchozích hodnot a dalších vlastností (omezení zasílání zprávou, možnost nastavení v konfiguraci agendy). Definované globální proměnné mají vždy nastaven InstanceIdent na identifikátor aktuální instance a nemají nastaven CommonIdent. Globální proměnné, které nejsou definovány je možné použít pouze v PAJS kódu.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích zahrnuje všechny nadřazené prvky.
Přehledová tabulka
Definuje název a sloupce přehledové tabulky a případně mapování globálních proměnných do této tabulky. V případě mapování musí odpovídat datový typ proměnné typu sloupce (např. proměnnou typu GUID je možné mapovat na sloupce typu GUID, GROUP a INSTANCE_IDENT). Je také možno zakázat sběr dat v publikovaném vzoru (další řízení sběru dat je možné ovlivnit nastavením běhového tokenu pomocí PAJS, ale pokud je sběr zakázán, tak nastavení tokenu nemá vliv).
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Akce při stornování agendy
Nastavuje se PAJS funkce, která je vykonána vždy, když je voláno storno instance agendy.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Formulář
Otevře formulář uživatelského úkolu FAS.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
JavaScriptová funkce pro přípravu dat formuláře
Specifikuje se JavaScriptová funkce, která je volána při otevření formuláře. Má k dispozici proměnné tokenu, které budou přeneseny do formuláře a jako argument dostává IScriptXDocument obsahující FormData z výchozí datové věty. Pokud vrátí IScriptXDocument, jsou jím FormData nahrazena.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
JavaScriptová funkce pro zpracování dat formuláře
Specifikuje se JavaScriptová funkce, která je volána po odeslání dat formuláře. Má k dispozici proměnné tokenu a globální proměnné, které přišly v datové větě formuláře a jako argument dostává IScriptXDocument obsahující FormData z dat formuláře.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.
Sdílená data formulářů
Definují se sdílená data formulářů pro FAS v dané agendě.
Prostor pro zpracování zahrnuje pouze konkrétní vlastnost. Dědičnost v prvcích se omezuje pouze na tento prvek.