Preskočiť na obsah

Správa kľúčových slov vo workflow

Kľúčové slová workflow možno používať v nastaveniach workflow, krokov, akcií a oznámení.

Všeobecný formát kľúčových slov workflow je nasledujúci:

  • Trieda (napr.: PERSON, MANAGER, STARTER atď.)
  • Hlavný parameter (napr.: ATTRIBUTE, RIGHT atď.)
  • Sekundárny parameter (napr.: kód atribútu atď.)

Existujú dve hlavné kategórie kľúčových slov:

  • Kľúčové slová, ktoré vracajú zoznam objektov bez zohľadnenia údajov workflow. Tieto kľúčové slová sa používajú na filtrovanie alebo ako podmienky vykonania úloh alebo akcií. V tomto prípade je oddeľovačom „§“. K dispozícii sú tieto kľúčové slová:

    • §KAD§: kľúčové slovo, ktoré možno použiť iba vo workflow spúšťaných udalosťou „Modification of an authorization rule“
      • §KAD§ATTRIBUTE§secondary_parameter§: umožňuje načítať informácie o pravidle autorizácie na základe jeho ID, názvu alebo popisu. secondary_parameter môže nadobúdať tieto hodnoty:
        • kad_id: identifikátor pravidla autorizácie.
        • kad_name: názov pravidla autorizácie
        • kad_description: popis pravidla autorizácie
      • §KAD§FILTRE§attribute_code§: umožňuje načítať hodnoty filtra, ktorého kód sa odovzdá v „attribute_code“, v pravidle autorizácie, ktoré spúšťa inštanciu workflow.
      • §KAD§STRUCTURE§VALUE§: umožňuje načítať hodnoty štruktúr, na ktoré sa vzťahuje pravidlo autorizácie, ktoré spúšťa inštanciu workflow.
      • §KAD§RIGHT§<AccountTypeCode.RightCode>§: umožňuje otestovať, či sa právo, ktorého kód je uvedený v parametri „Right_Code“ a ktoré je prepojené s typom účtu, ktorého kód je uvedený v parametri „Account_Type_Code“, nachádza v pravidle autorizácie, ktoré spúšťa inštanciu workflow.
    • §PERSON§: kľúčové slovo na načítanie zoznamu identít filtrovaného podľa zadaných parametrov. Nezohľadňuje údaje workflow, ale používa sa na filtrovanie potenciálnych cieľov workflow alebo na určenie aktérov alebo cieľov akcií alebo úloh vo workflow.
      • §PERSON§ATTRIBUTE§attribute_code§: umožňuje načítať zoznam osôb podľa hodnoty atribútu.
      • §PERSON§RIGHT§<AccountTypeCode.RightCode>§: umožňuje načítať zoznam osôb, ktoré skutočne majú právo, ktorého kód je uvedený v parametri „Right_Code“ a ktoré je prepojené s typom účtu, ktorého kód je uvedený v parametri „Account_Type_Code“.
    • §OBJECT§ alebo §RESOURCE§: kľúčové slovo na načítanie zoznamu pridelení filtrovaného podľa zadaných parametrov. Nezohľadňuje údaje workflow, ale používa sa na filtrovanie objektov v akciách alebo úlohách vo workflow.
      • §OBJECT§ATTRIBUTE§attribute_code§ alebo §RESOURCE§ATTRIBUTE§attribute_code§: umožňuje načítať zoznam pridelení na základe hodnôt atribútov.

  • Kľúčové slová, ktoré vracajú hodnoty z rôznych objektov obsiahnutých v inštanciách workflow (ciele, aktéri, validátori, obsah požiadavky atď.). V tomto prípade je oddeľovačom „#“. K dispozícii sú tieto kľúčové slová:

    • WORKFLOW#Code_workflow#parameter_step#: umožňuje načítať informácie o inštancii workflow, ktorej kód sa rovná „workflow_code“. Možno ho použiť v poli vyhodnotenia SQL (napr. pravidlá vykonania, pravidlá validácie atď.) alebo v poli oznámenia (napr. predmet, telo e-mailu). Parameter_step môže nadobúdať tieto hodnoty:

      • ID: identifikátor inštancie workflow
      • STATUS: stav inštancie workflow
        • -2 = zlyhanie v dôsledku eskalácie
        • -1 = zlyhanie
        • 0 = prebieha
        • 1 = úspech
        • 2 = inicializované používateľom
        • 3 = udalosť čakajúca na doplňujúce informácie
        • 4 = pozastavené
        • 5 = potrebné informácie
        • 6 = zablokované
        • 7 = zastavené
        • 8 = úspech v dôsledku eskalácie
        • 9 = resetované
      • STARTDATE: dátum začiatku inštancie workflow
      • ENDDATE: dátum ukončenia inštancie workflow
      • LASTEVENTDATE: dátum poslednej udalosti na úrovni inštancie workflow
      • DATA: vráti zoznam príslušných práv a používateľov.

    • STEP#Step_code#parameter_step#: umožňuje načítať informácie o inštancii kroku workflow, ktorého kód sa rovná „Step_code“. Možno ho použiť v poli vyhodnotenia SQL (napr. pravidlá vykonania, pravidlá validácie atď.) alebo v poli oznámenia (napr. predmet, telo e-mailu). Parameter_step môže nadobúdať tieto hodnoty:

      • ID: identifikátor inštancie kroku
      • STATUS: stav inštancie kroku s kódom „Step_code“ v inštancii workflow
        • -1 = zlyhanie
        • 0 = prebieha
        • 1 = úspech
        • 4 = pozastavené
        • 5 = potrebné informácie
        • 6 = zablokované
        • 7 = zastavené
      • STARTDATE: dátum začiatku inštancie kroku
      • ENDDATE: dátum ukončenia inštancie kroku
      • LASTEVENTDATE: dátum poslednej udalosti na úrovni inštancie kroku

    • ACTION#Action_code#parameter_action#: umožňuje načítať informácie o inštancii akcie, ktorej kód sa rovná „action_code“. Možno ho použiť v poli vyhodnotenia SQL (napr. pravidlá vykonania, pravidlá validácie atď.) alebo v poli oznámenia (napr. predmet, telo e-mailu). Parameter_action môže nadobúdať tieto hodnoty:

      • ID: identifikátor inštancie akcie
      • STATUS: stav inštancie akcie s kódom „Action_code“ v inštancii workflow
        • -1 = zlyhanie
        • 0 = prebieha
        • 1 = úspech
        • 4 = pozastavené
        • 5 = potrebné informácie
        • 6 = zablokované
        • 7 = zastavené
      • STARTDATE: dátum začiatku inštancie akcie
      • ENDDATE: dátum ukončenia inštancie akcie
      • LASTEVENTDATE: dátum poslednej udalosti na úrovni inštancie akcie
      • DEROGATED: ID osoby, na ktorú bola akcia delegovaná

    • TASK#Task_code#parameter_task#: umožňuje načítať informácie o inštancii úlohy, ktorej kód sa rovná „task_code“. Možno ho použiť v poli vyhodnotenia SQL (napr. pravidlá vykonania, pravidlá validácie atď.) alebo v poli oznámenia (napr. predmet, telo e-mailu). Parameter_task môže nadobúdať tieto hodnoty:

      • ID: identifikátor inštancie úlohy
      • STATUS: stav inštancie úlohy s kódom „Task_code“ v inštancii workflow
        • -1 = zlyhanie
        • 0 = prebieha
        • 1 = úspech
        • 4 = pozastavené
        • 5 = potrebné informácie
        • 6 = zablokované
        • 7 = zastavené
      • STARTDATE: dátum začiatku inštancie úlohy
      • ENDDATE: dátum ukončenia inštancie úlohy
      • LASTEVENTDATE: dátum poslednej udalosti na úrovni inštancie úlohy
      • DEROGATED: ID osoby, na ktorú bola úloha delegovaná
    • V tele e-mailu možno vytvoriť automatické odkazy na validáciu, keď je oznámenie nakonfigurované v akcii alebo úlohe validácie: http://[DNS address]/UserRequestWorkflow.aspx? MyActionId={#ACTION#Action_or_task_code#ID#}&accept=[result]
      • DNS address nahraďte adresou servera Identity
      • Action_or_task_code nahraďte kódom akcie alebo úlohy, ktorá sa má prostredníctvom odkazu validovať
      • Result: zadajte 1, ak chcete akciu alebo úlohu validovať, alebo 0, ak ju chcete zamietnuť.

    Ak chcete nakonfigurovať odkaz v tele e-mailu, použite tlačidlo „type:inline“, v ktorom môžete skontrolovať adresu a text, ktoré sa zobrazia v e-maile.

    Poznámka: Ak chce používateľ validovať alebo zamietnuť požiadavku v e-maile s oznámením, musí sa prihlásiť do rozhrania, aby sa potvrdilo, že má práva na vykonanie tejto operácie.

    • FORM#: kľúčové slovo, ktoré možno použiť iba vo workflow typu „User Request“ alebo v úlohách manuálneho zriaďovania/zrušenia zriadenia, v pravidlách vyhodnotenia SQL pre kroky akcií a úloh alebo v oznámeniach.

      • FORM#ADDRIGHTS#CODELIST#: umožňuje vypísať práva, ktoré žiadateľ vybral vo formulári požiadavky na práva.

      • FORM#CHANGEATTRIBUTES#parameter_form#: vypíše atribúty, ktoré žiadateľ upravil vo formulári úpravy osoby. parameter_form môže nadobúdať tieto hodnoty:

        • CODELIST: zoznam kódov atribútov, ktoré žiadateľ upravil vo formulári úpravy osoby.
        • CHANGEDATE: dátum, od ktorého sa zmeny zohľadnia, vo formáte dd/MM/yyyy

      • FORM#TYPERESOURCES#parameter_form#: načíta zoznam typov prostriedkov vybraných pri vypĺňaní formulára požiadavky. parameter_form môže nadobúdať tieto hodnoty:

        • DATA: ID prostriedkov
        • DATA.CODE: kód prostriedku
        • DATA.NAME: názov prostriedkov

      • FORM#Validation_task_code#parameter_form#:

        • DATA: umožňuje načítať všetky účty a práva podľa cieľovej aplikácie v tele e-mailu.
        • DATA.PROVISIONINGRIGHTONLY: umožňuje podmieniť vykonanie úlohy validácie formulára a/alebo úlohy manuálneho zriaďovania tým, že ciele už majú účet v úložiskách, ktorých sa požiadavka týka.
        • DATA.UNPROVISIONINGRIGHTONLY: umožňuje podmieniť vykonanie úlohy validácie formulára a/alebo úlohy manuálneho zrušenia zriadenia tým, že ciele už majú účet v úložiskách, ktorých sa požiadavka týka.
        • DATA.PROVISIONINGACCOUNTONLY: umožňuje podmieniť vykonanie úlohy validácie formulára a/alebo úlohy manuálneho zriaďovania tým, že ciele nemajú účet v úložiskách, ktorých sa požiadavka týka.
        • DATA.UNPROVISIONINGACCOUNTONLY: umožňuje podmieniť vykonanie úlohy validácie formulára a/alebo úlohy manuálneho zrušenia zriadenia tým, že ciele nemajú účet v úložiskách, ktorých sa požiadavka týka.

    • TASKFORM#: kľúčové slovo, ktoré možno použiť iba v úlohách workflow týchto typov: priradenie prostriedkov a manuálne zriaďovanie/zrušenie zriadenia

      • TASKFORM#Task_code#fparameter_form#: umožňuje načítať údaje uvedené v „parameter_form“ buď z prostriedku, alebo z práva. Toto kľúčové slovo sa musí použiť v tele e-mailu, aby sa výsledok zobrazil vo forme tabuľky. parameter_form môže nadobúdať tieto hodnoty:

        • DATA: ID požadovaných prostriedkov, ak je úloha typu „Resource assignment“, alebo ID práv, ktoré sa majú zriadiť alebo ktorých zriadenie sa má zrušiť, ak je úloha typu „Manual provisioning/deprovisioning“.
        • DATA.CODE: kód požadovaných prostriedkov, ak je úloha typu „Resource assignment“, alebo kód práv, ktoré sa majú zriadiť alebo ktorých zriadenie sa má zrušiť, ak je úloha typu „Manual provisioning/deprovisioning“.
        • DATA.NAME: názov požadovaných prostriedkov, ak je úloha typu „Resource assignment“, alebo názov práv, ktoré sa majú zriadiť alebo ktorých zriadenie sa má zrušiť, ak je úloha typu „manual provisioning/deprovisioning“.
        • DATA.FIELDS: hodnoty doplňujúcich polí formulára požiadavky. Platí iba vtedy, ak je úloha typu „manual provisioning/deprovisioning“.
        • DATACOMPLETEONLY: ID prostriedkov skutočne priradených v úlohe typu „Resource Assignment“. Platí iba vtedy, ak je úloha typu „Resource Assignment“.
        • DATACOMPLETEONLY.CODE: kód prostriedkov skutočne priradených v úlohe typu „Resource Assignment“. Platí iba vtedy, ak je úloha typu „Resource Assignment“.
        • DATACOMPLETEONLY.NAME: názov prostriedkov skutočne priradených v úlohe typu „Resource Assignment“. Platí iba vtedy, ak je úloha typu „Resource Assignment“.
        • DATAINCOMPLETE: ID typov prostriedkov, ku ktorým nebol priradený žiadny prostriedok. Platí iba vtedy, ak je úloha typu „Resource Assignment“.
        • DATAINCOMPLETE.CODE: kód typov prostriedkov, ku ktorým nebol priradený žiadny prostriedok. Platí iba vtedy, ak je úloha typu „Resource Assignment“.
        • DATAINCOMPLETE.NAME: názov typov prostriedkov, ku ktorým nebol priradený žiadny prostriedok. Platí iba vtedy, ak je úloha typu „Resource Assignment“.

    • MANAGER#: správca workflow je osoba, ktorá tento workflow spravuje.

      • MANAGER#ATTRIBUTE#attribute_code#: umožňuje vložiť informácie o inštancii akcie do poľa vyhodnotenia SQL (napr. pravidlá vykonania, validácie atď.) alebo do vyhodnocovaného poľa (napr. príjemcovia, predmet, telo e-mailu).

      • MANAGER#RIGHT#<Account_Type_Code.Right_Code>#: umožňuje overiť, či správca workflow má právo, ktorého kód je uvedený v parametri „Right_Code“ a ktoré je prepojené s typom účtu, ktorého kód je uvedený v parametri „Account_Type_Code“.

      • MANAGER#RIGHTHEO#<Account_Type_Code.Right_Code>#: umožňuje overiť, či správca workflow teoreticky má právo, ktorého kód je uvedený v parametri „Right_Code“ a ktoré je prepojené s typom účtu, ktorého kód je uvedený v parametri „Account_Type_Code“.

    • POSSIBLEACTIONACTOR#: osoby, ktoré môžu vykonať akciu

      • POSSIBLEACTIONACTOR#Action_code#attribute_code#: umožňuje načítať hodnotu atribútu, ktorého kód sa odovzdá v parametri attribute_code, pri možných aktéroch inštancie akcie alebo úlohy, ktorej kód sa rovná „action_code“. Možno ho použiť v poli vyhodnotenia SQL (napr. pravidlá vykonania, pravidlá validácie atď.) alebo v poli oznámenia (napr. príjemcovia, predmet, telo e-mailu).

    • STARTER#: osoba, ktorá spúšťa workflow

      • STARTER#ATTRIBUTE#attribute_code#: umožňuje načítať hodnotu atribútu, ktorého kód sa odovzdá v parametri attribute_code, pri osobe, ktorá workflow spustila. Možno ho použiť v poli vyhodnotenia SQL (napr. pravidlá vykonania, pravidlá validácie atď.) alebo v poli oznámenia (napr. predmet, telo e-mailu).

      • STARTER#RIGHT#<AccountTypeCode.RightCode>#: umožňuje overiť, či žiadateľ workflow má právo, ktorého kód je uvedený v parametri „Right_Code“ a ktoré je prepojené s typom účtu, ktorého kód je uvedený v parametri „Account_Type_Code“.

      • STARTER#RIGHTHEO#<Account_Type_Code.Right_Code>#: umožňuje overiť, či žiadateľ workflow teoreticky má právo, ktorého kód je uvedený v parametri „Right_Code“ a ktoré je prepojené s typom účtu, ktorého kód je uvedený v parametri „Account_Type_Code“.

    • TARGET#: objekt(y), ktoré spúšťajú inštanciu workflow

      • TARGET#ATTRIBUTE#attribute_code#: umožňuje načítať hodnotu atribútu, ktorého kód sa odovzdá v parametri attribute_code, v objekte, ktorý workflow spustil. Možno ho použiť v poli vyhodnotenia SQL (napr. pravidlá vykonania, pravidlá validácie atď.) alebo v poli oznámenia (napr. predmet, telo e-mailu). Toto kľúčové slovo funguje iba vtedy, keď je cieľ typu osoba alebo pridelenie.

      • TARGET#RIGHT#<AccountTypeCode.RightCode>#: umožňuje overiť, či cieľ alebo ciele workflow majú právo, ktorého kód je uvedený v parametri „Right_Code“ a ktoré je prepojené s typom účtu, ktorého kód je uvedený v parametri „Account_Type_Code“. Toto kľúčové slovo funguje iba vtedy, keď je cieľ typu osoba.

      • TARGET#RIGHTTHEO#<AccountTypeCode.RightCode>#: umožňuje overiť, či cieľ alebo ciele workflow teoreticky majú právo, ktorého kód je uvedený v parametri „Right_Code“ a ktoré je prepojené s typom účtu, ktorého kód je uvedený v parametri „Account_Type_Code“. Toto kľúčové slovo funguje iba vtedy, keď je cieľ typu osoba.

      • TARGET#RESOURCE#DATA#: umožňuje v tele e-mailu načítať všetky údaje (hodnoty všetkých atribútov) zo všetkých prostriedkov prepojených s cieľmi inštancie workflow.

        • TARGET#RESOURCE#DATA@CodeAtt1,CodeAtt2,CodeAttN#: umožňuje v tele e-mailu načítať hodnoty atribútov vybraných pomocou zoznamu kódov atribútov CodeAttN zo všetkých prostriedkov prepojených s cieľmi inštancie workflow. Atribúty „name“ a „code“ sa v tele e-mailu zobrazujú predvolene a netreba ich pridávať do zoznamu.

        • TARGET#RESOURCE#DATA.CodeTypeResource1,CodeTypeResource2,CodeTypeResourceN#: umožňuje v tele e-mailu načítať hodnoty všetkých atribútov typov prostriedkov vybraných pomocou zoznamu kódov typov prostriedkov CodeTypeResourceN, ktoré sú prepojené s cieľmi inštancie workflow.

        • TARGET#RESOURCE#DATA.CodeTypeResource1,CodeTypeResourceN@CodeAtt1,CodeAtt2,CodeAttN#: umožňuje v tele e-mailu načítať tieto hodnoty:

          • Buď všetky atribúty typov prostriedkov vybraných pomocou zoznamu kódov atribútov CodeTypeResourceN, prepojených s cieľmi inštancie workflow atribútov typu prostriedok, ak nie je zadaný žiadny kód atribútu
          • Alebo hodnoty atribútov vybraných pomocou zoznamu kódov atribútov pre typy prostriedkov vybrané pomocou zoznamu kódov typov prostriedkov CodeTypeResourceN, prepojené s cieľmi inštancie workflow, ak sú zadané kódy atribútov CodeAttN.

        • TARGET#RESOURCE#DATA.CodeTypeResource1,CodeTypeResource2,CodeTypeResourceN#: umožňuje v tele e-mailu načítať hodnoty všetkých atribútov typov prostriedkov vybraných pomocou zoznamu kódov typov prostriedkov CodeTypeResourceN, ktoré sú prepojené s cieľmi inštancie workflow.

      • TARGET#ACCOUNT#: kľúčové slovo, ktoré možno použiť vo workflow spúšťaných udalosťami, ktoré súvisia s vytvorením skutočného účtu.

        • TARGET#ACCOUNT#LOGIN#: umožňuje načítať prihlasovacie meno účtu v tele e-mailu.

        • TARGET#ACCOUNT#PASSWORD#: umožňuje načítať heslo účtu (ako čistý text) v tele e-mailu.

        • TARGET#ACCOUNT#STATUS#: umožňuje načítať stav zriaďovania účtu v tele e-mailu.

        • TARGET#ACCOUNT#DATA#: umožňuje načítať prihlasovacie meno, heslo a stav v tele e-mailu.

    • PRIMARYTARGET# a #SECONDARYTARGET#: kľúčové slovo, ktoré možno použiť iba vo workflow typu „On event“

      • PRIMARYTARGET#ATTRIBUTE#secondary_parameter# alebo #SECONDARYTARGET#ATTRIBUTE#secondary_parameter#: umožňuje načítať hodnotu objektu pri primárnom alebo sekundárnom cieli inštancie workflow, ktorého vlastnosť sa odovzdá v parametri secondary_parameter. Toto kľúčové slovo funguje iba vtedy, keď je cieľ niektorého z týchto typov:

        • Identity: v tomto prípade bude sekundárnym parametrom kód atribútu.
        • Right: v tomto prípade môže sekundárny parameter nadobúdať tieto hodnoty:
          • Name: názov práva
          • Description: popis práva
          • Code: kód práva
          • Applicationname: názov aplikácie súvisiacej s právom
          • Applicationdescription: popis aplikácie súvisiacej s právom
          • Applicationcode: kód aplikácie súvisiacej s právom
          • ismanualprovisioning: logická hodnota, ktorá určuje, či právo patrí do úložiska s manuálnym zriaďovaním.

      • PRIMARYTARGET#TYPE#secondary_parameter# alebo #SECONDARYTARGET#TYPE#secondary_parameter#: umožňuje načítať informácie o type objektu, ktorý zodpovedá primárnemu alebo sekundárnemu cieľu inštancie workflow. Toto kľúčové slovo funguje iba vtedy, keď je cieľ typu osoba alebo pridelenie. secondary_parameter môže nadobúdať tieto hodnoty:

        • NAME: názov typu osoby alebo pridelenia
        • CODE: kód typu osoby alebo pridelenia
        • DESCRIPTION: popis typu osoby alebo pridelenia

      • PRIMARYTARGET#ACCOUNT#secondary_parameter# alebo #SECONDARYTARGET#ACCOUNT#secondary_parameter#: umožňuje načítať informácie o účte, ktorý zodpovedá primárnemu alebo sekundárnemu cieľu inštancie workflow. Toto kľúčové slovo funguje iba vtedy, keď je cieľ typu účet. secondary_parameter môže nadobúdať tieto hodnoty:

        • STATUS: stav vytvoreného skutočného účtu
        • LOGIN: prihlasovacie meno vytvoreného skutočného účtu
        • PASSWORD: heslo vytvoreného skutočného účtu
        • DATA: tabuľka s prihlasovacím menom a heslom vytvoreného skutočného účtu

Tieto dve skupiny kľúčových slov možno použiť spolu v tom istom parametri „SQL Evaluation“, ktorý overuje podmienku na základe vstupných parametrov a vracia typy „TRUE/FALSE“ alebo „List returned by an SQL evaluation“.

Osobitosti:

  • Pri všetkých kľúčových slovách, ktorým možno v parametroch odovzdať kód atribútu na načítanie jeho hodnoty, možno pri atribútoch typu výčet, osoba, štruktúra alebo prostriedok použiť rozšírenie formátu „.object_attribute_code“ na načítanie hodnoty atribútu objektu namiesto ID. Pri atribútoch typu štruktúra, osoba alebo pridelenie musíte zadať kód požadovaného atribútu objektu a pri výčtoch môže object_attribute_code nadobúdať tieto hodnoty:
    • NAME: načíta názov výčtovej hodnoty
    • CODE: načíta kód výčtovej hodnoty
  • Ak kľúčové slová nestačia na vloženie informácií do tela e-mailu, možno na volanie dotazu SQL SELECT použiť túto syntax:
    • [@@@: <SQL Query>:@@@] : dotaz SQL sa musí napísať bez klauzuly „SELECT“. Vracia reťazec znakov.
  • Na zadanie informácií o cieľoch (osobách zapojených do workflow) je vhodnejšie použiť kľúčové slovo §PERSON§ namiesto #TARGET#.