Přeskočit obsah

Správa klíčových slov ve workflow

Klíčová slova workflow lze používat v nastavení workflow, kroků, akcí a oznámení.

Obecný formát klíčových slov workflow je následující:

  • Třída (např. PERSON, MANAGER, STARTER atd.)
  • Hlavní parametr (např. ATTRIBUTE, RIGHT atd.)
  • Sekundární parametr (např. kód atributu atd.)

Existují dvě hlavní kategorie klíčových slov:

  • Klíčová slova, která vracejí seznam objektů bez ohledu na data workflow. Tato klíčová slova se používají k filtrování nebo jako podmínky pro provádění úkolů nebo akcí. V tomto případě je oddělovačem „§“. K dispozici jsou následující klíčová slova:

    • §KAD§: klíčové slovo, které lze použít pouze ve workflow spouštěných událostí „Modification of an authorization rule“
      • §KAD§ATTRIBUTE§secondary_parameter§: umožňuje načíst informace o pravidle autorizace na základě jeho ID, názvu nebo popisu. secondary_parameter může nabývat následujících hodnot:
        • kad_id: identifikátor pravidla autorizace.
        • kad_name: název pravidla autorizace
        • kad_description: popis pravidla autorizace
      • §KAD§FILTRE§attribute_code§: umožňuje načíst hodnoty filtru, jehož kód je předán v „attribute_code“, v pravidle autorizace, které spouští instanci workflow.
      • §KAD§STRUCTURE§VALUE§: umožňuje načíst hodnoty struktur, na které se vztahuje pravidlo autorizace spouštějící instanci workflow.
      • §KAD§RIGHT§<AccountTypeCode.RightCode>§: umožňuje otestovat, zda se právo, jehož kód je uveden v parametru „Right_Code“ a které je propojeno s typem účtu, jehož kód je uveden v parametru „Account_Type_Code“, nachází v pravidle autorizace, které spouští instanci workflow.
    • §PERSON§: klíčové slovo pro načtení seznamu identit filtrovaného podle zadaných parametrů. Nebere v úvahu data workflow, ale používá se k filtrování potenciálních cílů workflow nebo k určení aktérů či cílů akcí nebo úkolů ve workflow.
      • §PERSON§ATTRIBUTE§attribute_code§: umožňuje načíst seznam osob podle hodnoty atributu.
      • §PERSON§RIGHT§<AccountTypeCode.RightCode>§: umožňuje načíst seznam osob, které skutečně mají právo, jehož kód je uveden v parametru „Right_Code“ a které je propojeno s typem účtu, jehož kód je uveden v parametru „Account_Type_Code“.
    • §OBJECT§ nebo §RESOURCE§: klíčové slovo pro načtení seznamu přidělení filtrovaného podle zadaných parametrů. Nebere v úvahu data workflow, ale používá se k filtrování objektů v akcích nebo úkolech ve workflow.
      • §OBJECT§ATTRIBUTE§attribute_code§ nebo §RESOURCE§ATTRIBUTE§attribute_code§: umožňuje načíst seznam přidělení na základě hodnot atributů.

  • Klíčová slova, která vracejí hodnoty z různých objektů obsažených v instancích workflow (cíle, aktéři, schvalovatelé, obsah požadavku atd.). V tomto případě je oddělovačem „#“. K dispozici jsou následující klíčová slova:

    • WORKFLOW#Code_workflow#parameter_step#: umožňuje načíst informace o instanci workflow, jejíž kód je roven „workflow_code“. Lze použít v poli pro vyhodnocení SQL (např. pravidla provádění, pravidla schvalování atd.) nebo v poli oznámení (např. předmět, text e-mailu). Parameter_step může nabývat následujících hodnot:

      • ID: identifikátor instance workflow
      • STATUS: stav instance workflow
        • -2 = neúspěch v důsledku eskalace
        • -1 = neúspěch
        • 0 = probíhá
        • 1 = úspěch
        • 2 = inicializováno uživatelem
        • 3 = událost čeká na doplňující informace
        • 4 = pozastaveno
        • 5 = potřeba informací
        • 6 = zablokováno
        • 7 = zastaveno
        • 8 = úspěch v důsledku eskalace
        • 9 = resetováno
      • STARTDATE: datum zahájení instance workflow
      • ENDDATE: datum ukončení instance workflow
      • LASTEVENTDATE: datum poslední události na úrovni instance workflow
      • DATA: vrátí seznam dotčených práv a uživatelů.

    • STEP#Step_code#parameter_step#: umožňuje načíst informace o instanci kroku workflow, jehož kód je roven „Step_code“. Lze použít v poli pro vyhodnocení SQL (např. pravidla provádění, pravidla schvalování atd.) nebo v poli oznámení (např. předmět, text e-mailu). Parameter_step může nabývat následujících hodnot:

      • ID: identifikátor instance kroku
      • STATUS: stav instance kroku s kódem „Step_code“ v instanci workflow
        • -1 = neúspěch
        • 0 = probíhá
        • 1 = úspěch
        • 4 = pozastaveno
        • 5 = potřeba informací
        • 6 = zablokováno
        • 7 = zastaveno
      • STARTDATE: datum zahájení instance kroku
      • ENDDATE: datum ukončení instance kroku
      • LASTEVENTDATE: datum poslední události na úrovni instance kroku

    • ACTION#Action_code#parameter_action#: umožňuje načíst informace o instanci akce, jejíž kód je roven „action_code“. Lze použít v poli pro vyhodnocení SQL (např. pravidla provádění, pravidla schvalování atd.) nebo v poli oznámení (např. předmět, text e-mailu). Parameter_action může nabývat následujících hodnot:

      • ID: identifikátor instance akce
      • STATUS: stav instance akce s kódem „Action_code“ v instanci workflow
        • -1 = neúspěch
        • 0 = probíhá
        • 1 = úspěch
        • 4 = pozastaveno
        • 5 = potřeba informací
        • 6 = zablokováno
        • 7 = zastaveno
      • STARTDATE: datum zahájení instance akce
      • ENDDATE: datum ukončení instance akce
      • LASTEVENTDATE: datum poslední události na úrovni instance akce
      • DEROGATED: ID osoby, na kterou byla akce delegována

    • TASK#Task_code#parameter_task#: umožňuje načíst informace o instanci úkolu, jehož kód je roven „task_code“. Lze použít v poli pro vyhodnocení SQL (např. pravidla provádění, pravidla schvalování atd.) nebo v poli oznámení (např. předmět, text e-mailu). Parameter_task může nabývat následujících hodnot:

      • ID: identifikátor instance úkolu
      • STATUS: stav instance úkolu s kódem „Task_code“ v instanci workflow
        • -1 = neúspěch
        • 0 = probíhá
        • 1 = úspěch
        • 4 = pozastaveno
        • 5 = potřeba informací
        • 6 = zablokováno
        • 7 = zastaveno
      • STARTDATE: datum zahájení instance úkolu
      • ENDDATE: datum ukončení instance úkolu
      • LASTEVENTDATE: datum poslední události na úrovni instance úkolu
      • DEROGATED: ID osoby, na kterou byl úkol delegován
    • V textu e-mailu lze vytvářet automatické odkazy pro schválení, pokud je oznámení nakonfigurováno v akci nebo úkolu schválení: http://[DNS address]/UserRequestWorkflow.aspx? MyActionId={#ACTION#Action_or_task_code#ID#}&accept=[result]
      • DNS address je třeba nahradit adresou serveru Identity
      • Action_or_task_code je třeba nahradit kódem akce nebo úkolu, které se mají prostřednictvím odkazu schválit
      • Result: zadejte 1 pro schválení akce nebo úkolu, nebo 0 pro jejich zamítnutí.

    Chcete-li nakonfigurovat odkaz v textu e-mailu, použijte tlačítko „type:inline“, pomocí kterého můžete zkontrolovat adresu a text, které se v e-mailu zobrazí.

    Poznámka: chcete-li schválit nebo zamítnout požadavek v e-mailu s oznámením, musí se uživatel přihlásit do rozhraní, aby se potvrdilo, že má práva k provedení této operace.

    • FORM#: klíčové slovo, které lze použít pouze ve workflow typu „User Request“ nebo v úkolech ručního zřizování/rušení zřízení, v pravidlech vyhodnocení SQL pro kroky akcí a úkolů nebo v oznámeních.

      • FORM#ADDRIGHTS#CODELIST#: umožňuje vypsat práva, která žadatel vybral ve formuláři požadavku na práva.

      • FORM#CHANGEATTRIBUTES#parameter_form#: vypíše atributy, které žadatel změnil ve formuláři úpravy osoby. parameter_form může nabývat následujících hodnot:

        • CODELIST: seznam kódů atributů, které žadatel změnil ve formuláři úpravy osoby.
        • CHANGEDATE: datum, od kterého se změny zohledňují, ve formátu dd/MM/yyyy

      • FORM#TYPERESOURCES#parameter_form#: načte seznam typů prostředků vybraných při vyplňování formuláře požadavku. parameter_form může nabývat následujících hodnot:

        • DATA: ID prostředků
        • DATA.CODE: kód prostředku
        • DATA.NAME: název prostředků

      • FORM#Validation_task_code#parameter_form#:

        • DATA: umožňuje načíst v textu e-mailu všechny účty a práva podle cílové aplikace.
        • DATA.PROVISIONINGRIGHTONLY: umožňuje podmínit provedení úkolu schválení formuláře a/nebo úkolu ručního zřizování tím, že cíle již mají účet v úložištích, kterých se požadavek týká.
        • DATA.UNPROVISIONINGRIGHTONLY: umožňuje podmínit provedení úkolu schválení formuláře a/nebo úkolu ručního rušení zřízení tím, že cíle již mají účet v úložištích, kterých se požadavek týká.
        • DATA.PROVISIONINGACCOUNTONLY: umožňuje podmínit provedení úkolu schválení formuláře a/nebo úkolu ručního zřizování tím, že cíle nemají účet v úložištích, kterých se požadavek týká.
        • DATA.UNPROVISIONINGACCOUNTONLY: umožňuje podmínit provedení úkolu schválení formuláře a/nebo úkolu ručního rušení zřízení tím, že cíle nemají účet v úložištích, kterých se požadavek týká.

    • TASKFORM#: klíčové slovo, které lze použít pouze v úkolech workflow následujících typů: přiřazení prostředků a ruční zřizování/rušení zřízení

      • TASKFORM#Task_code#fparameter_form#: umožňuje načíst data uvedená v „parameter_form“ buď z prostředku, nebo z práva. Toto klíčové slovo musí být použito v textu e-mailu, aby se výsledek zobrazil ve formě tabulky. parameter_form může nabývat následujících hodnot:

        • DATA: ID požadovaných prostředků, pokud je úkol typu „Resource assignment“, nebo ID práv, která se mají zřídit nebo jejichž zřízení se má zrušit, pokud je úkol typu „Manual provisioning/deprovisioning“.
        • DATA.CODE: kód požadovaných prostředků, pokud je úkol typu „Resource assignment“, nebo kód práv, která se mají zřídit nebo jejichž zřízení se má zrušit, pokud je úkol typu „Manual provisioning/deprovisioning“.
        • DATA.NAME: název požadovaných prostředků, pokud je úkol typu „Resource assignment“, nebo název práv, která se mají zřídit nebo jejichž zřízení se má zrušit, pokud je úkol typu „manual provisioning/deprovisioning“.
        • DATA.FIELDS: hodnoty doplňujících polí ve formuláři požadavku. Platí pouze v případě, že je úkol typu „manual provisioning/deprovisioning“.
        • DATACOMPLETEONLY: ID prostředků skutečně přiřazených v úkolu typu „Resource Assignment“. Platí pouze v případě, že je úkol typu „Resource Assignment“.
        • DATACOMPLETEONLY.CODE: kód prostředků skutečně přiřazených v úkolu typu „Resource Assignment“. Platí pouze v případě, že je úkol typu „Resource Assignment“.
        • DATACOMPLETEONLY.NAME: název prostředků skutečně přiřazených v úkolu typu „Resource Assignment“. Platí pouze v případě, že je úkol typu „Resource Assignment“.
        • DATAINCOMPLETE: ID typů prostředků, ke kterým nebyly přiřazeny žádné prostředky. Platí pouze v případě, že je úkol typu „Resource Assignment“.
        • DATAINCOMPLETE.CODE: kód typů prostředků, ke kterým nebyly přiřazeny žádné prostředky. Platí pouze v případě, že je úkol typu „Resource Assignment“.
        • DATAINCOMPLETE.NAME: název typů prostředků, ke kterým nebyly přiřazeny žádné prostředky. Platí pouze v případě, že je úkol typu „Resource Assignment“.

    • MANAGER#: správce workflow je osoba, která workflow spravuje.

      • MANAGER#ATTRIBUTE#attribute_code#: umožňuje vložit informace o instanci akce do pole pro vyhodnocení SQL (např. pravidla provádění, schvalování atd.) nebo do vyhodnocovaného pole (např. příjemci, předmět, text e-mailu).

      • MANAGER#RIGHT#<Account_Type_Code.Right_Code>#: umožňuje ověřit, že správce workflow má právo, jehož kód je uveden v parametru „Right_Code“ a které je propojeno s typem účtu, jehož kód je uveden v parametru „Account_Type_Code“.

      • MANAGER#RIGHTHEO#<Account_Type_Code.Right_Code>#: umožňuje ověřit, že správce workflow teoreticky má právo, jehož kód je uveden v parametru „Right_Code“ a které je propojeno s typem účtu, jehož kód je uveden v parametru „Account_Type_Code“.

    • POSSIBLEACTIONACTOR#: osoby, které mohou v rámci akce jednat

      • POSSIBLEACTIONACTOR#Action_code#attribute_code#: umožňuje načíst hodnotu atributu, jehož kód je předán v parametru attribute_code, u možných aktérů instance akce nebo úkolu, jejichž kód je roven „action_code“. Lze použít v poli pro vyhodnocení SQL (např. pravidla provádění, pravidla schvalování atd.) nebo v poli oznámení (např. příjemci, předmět, text e-mailu).

    • STARTER#: osoba, která workflow spouští

      • STARTER#ATTRIBUTE#attribute_code#: umožňuje načíst hodnotu atributu, jehož kód je předán v parametru attribute_code, u osoby, která workflow spustila. Lze použít v poli pro vyhodnocení SQL (např. pravidla provádění, pravidla schvalování atd.) nebo v poli oznámení (např. předmět, text e-mailu).

      • STARTER#RIGHT#<AccountTypeCode.RightCode>#: umožňuje ověřit, že žadatel workflow má právo, jehož kód je uveden v parametru „Right_Code“ a které je propojeno s typem účtu, jehož kód je uveden v parametru „Account_Type_Code“.

      • STARTER#RIGHTHEO#<Account_Type_Code.Right_Code>#: umožňuje ověřit, že žadatel workflow teoreticky má právo, jehož kód je uveden v parametru „Right_Code“ a které je propojeno s typem účtu, jehož kód je uveden v parametru „Account_Type_Code“.

    • TARGET#: objekt(y), které spouštějí instanci workflow

      • TARGET#ATTRIBUTE#attribute_code#: umožňuje načíst hodnotu atributu, jehož kód je předán v parametru attribute_code, u objektu, který workflow spustil. Lze použít v poli pro vyhodnocení SQL (např. pravidla provádění, pravidla schvalování atd.) nebo v poli oznámení (např. předmět, text e-mailu). Toto klíčové slovo funguje pouze tehdy, je-li cíl typu osoba nebo přidělení.

      • TARGET#RIGHT#<AccountTypeCode.RightCode>#: umožňuje ověřit, že cíl nebo cíle workflow mají právo, jehož kód je uveden v parametru „Right_Code“ a které je propojeno s typem účtu, jehož kód je uveden v parametru „Account_Type_Code“. Toto klíčové slovo funguje pouze tehdy, je-li cíl typu osoba.

      • TARGET#RIGHTTHEO#<AccountTypeCode.RightCode>#: umožňuje ověřit, že cíl nebo cíle workflow teoreticky mají právo, jehož kód je uveden v parametru „Right_Code“ a které je propojeno s typem účtu, jehož kód je uveden v parametru „Account_Type_Code“. Toto klíčové slovo funguje pouze tehdy, je-li cíl typu osoba.

      • TARGET#RESOURCE#DATA#: umožňuje načíst v textu e-mailu všechna data (hodnoty všech atributů) ze všech prostředků propojených s cíli instance workflow.

        • TARGET#RESOURCE#DATA@CodeAtt1,CodeAtt2,CodeAttN#: umožňuje načíst v textu e-mailu hodnoty atributů vybraných pomocí seznamu kódů atributů CodeAttN ze všech prostředků propojených s cíli instance workflow. Atributy „name“ a „code“ se v textu e-mailu zobrazují ve výchozím nastavení, aniž by bylo nutné je přidávat do seznamu.

        • TARGET#RESOURCE#DATA.CodeTypeResource1,CodeTypeResource2,CodeTypeResourceN#: umožňuje načíst v textu e-mailu hodnoty všech atributů typů prostředků vybraných pomocí seznamu kódů typů prostředků CodeTypeResourceN, které jsou propojeny s cíli instance workflow.

        • TARGET#RESOURCE#DATA.CodeTypeResource1,CodeTypeResourceN@CodeAtt1,CodeAtt2,CodeAttN#: umožňuje načíst v textu e-mailu následující hodnoty:

          • Buď všechny atributy typů prostředků vybraných pomocí seznamu kódů atributů CodeTypeResourceN, které jsou propojeny s cíli instance workflow atributů typu prostředek, pokud není zadán žádný kód atributu
          • Nebo hodnoty atributů vybraných pomocí seznamu kódů atributů pro typy prostředků vybrané pomocí seznamu kódů typů prostředků CodeTypeResourceN, které jsou propojeny s cíli instance workflow, pokud jsou zadány kódy atributů CodeAttN.

        • TARGET#RESOURCE#DATA.CodeTypeResource1,CodeTypeResource2,CodeTypeResourceN#: umožňuje načíst v textu e-mailu hodnoty všech atributů typů prostředků vybraných pomocí seznamu kódů typů prostředků CodeTypeResourceN, které jsou propojeny s cíli instance workflow.

      • TARGET#ACCOUNT#: klíčové slovo, které lze použít ve workflow událostí souvisejících s vytvořením skutečného účtu.

        • TARGET#ACCOUNT#LOGIN#: umožňuje načíst v textu e-mailu přihlašovací jméno účtu.

        • TARGET#ACCOUNT#PASSWORD#: umožňuje načíst v textu e-mailu heslo účtu (v prostém textu).

        • TARGET#ACCOUNT#STATUS#: umožňuje načíst v textu e-mailu stav zřizování účtu.

        • TARGET#ACCOUNT#DATA#: umožňuje načíst v textu e-mailu přihlašovací jméno, heslo a stav.

    • PRIMARYTARGET# a #SECONDARYTARGET#: klíčové slovo, které lze použít pouze ve workflow typu „On event“

      • PRIMARYTARGET#ATTRIBUTE#secondary_parameter# nebo #SECONDARYTARGET#ATTRIBUTE#secondary_parameter#: umožňuje načíst hodnotu objektu u primárního nebo sekundárního cíle instance workflow, jehož vlastnost je předána v parametru secondary_parameter. Toto klíčové slovo funguje pouze tehdy, je-li cíl následujícího typu:

        • Identity: v tomto případě bude sekundárním parametrem kód atributu.
        • Right: v tomto případě může sekundární parametr nabývat následujících hodnot:
          • Name: název práva
          • Description: popis práva
          • Code: kód práva
          • Applicationname: název aplikace související s právem
          • Applicationdescription: popis aplikace související s právem
          • Applicationcode: kód aplikace související s právem
          • ismanualprovisioning: logická hodnota označující, zda právo patří k úložišti s ručním zřizováním.

      • PRIMARYTARGET#TYPE#secondary_parameter# nebo #SECONDARYTARGET#TYPE#secondary_parameter#: umožňuje načíst informace o typu objektu, který odpovídá primárnímu nebo sekundárnímu cíli instance workflow. Toto klíčové slovo funguje pouze tehdy, je-li cíl typu osoba nebo přidělení. secondary_parameter může nabývat následujících hodnot:

        • NAME: název typu osoby nebo přidělení
        • CODE: kód typu osoby nebo přidělení
        • DESCRIPTION: popis typu osoby nebo přidělení

      • PRIMARYTARGET#ACCOUNT#secondary_parameter# nebo #SECONDARYTARGET#ACCOUNT#secondary_parameter#: umožňuje načíst informace o účtu, který odpovídá primárnímu nebo sekundárnímu cíli instance workflow. Toto klíčové slovo funguje pouze tehdy, je-li cíl typu účet. secondary_parameter může nabývat následujících hodnot:

        • STATUS: stav vytvořeného skutečného účtu
        • LOGIN: přihlašovací jméno vytvořeného skutečného účtu
        • PASSWORD: heslo vytvořeného skutečného účtu
        • DATA: tabulka s přihlašovacím jménem a heslem vytvořeného skutečného účtu

Tyto dvě skupiny klíčových slov lze používat společně v témže parametru „SQL Evaluation“, který ověřuje podmínku na základě vstupních parametrů a vrací typy „TRUE/FALSE“ nebo „List returned by an SQL evaluation“.

Zvláštnosti:

  • U všech klíčových slov, kterým lze v parametrech předat kód atributu za účelem načtení jeho hodnoty, lze u atributů typu výčet, osoba, struktura nebo prostředek použít rozšíření formátu „.object_attribute_code“, a načíst tak místo ID hodnotu atributu objektu. U atributů typu struktura, osoba nebo přidělení musíte zadat kód požadovaného atributu objektu a u výčtů může object_attribute_code nabývat následujících hodnot:
    • NAME: načte název výčtové hodnoty
    • CODE: načte kód výčtové hodnoty
  • Pokud klíčová slova pro vložení informací do textu e-mailu nestačí, lze k volání dotazu SQL SELECT použít následující syntaxi:
    • [@@@: <SQL Query>:@@@] : dotaz SQL musí být napsán bez klauzule „SELECT“. Vrací řetězec znaků.
  • Chcete-li zadat informace o cílech (osobách, kterých se workflow týká), je vhodnější použít klíčové slovo §PERSON§ než #TARGET#.