Skoči na vsebino

Upravljanje ključnih besed v workflow

Ključne besede workflow je mogoče uporabiti v nastavitvah workflow, korakov, dejanj in obvestil.

Splošna oblika ključnih besed workflow je naslednja:

  • Razred (npr.: PERSON, MANAGER, STARTER itd.)
  • Glavni parameter (npr.: ATTRIBUTE, RIGHT itd.)
  • Sekundarni parameter (npr.: koda atributa itd.)

Obstajata dve glavni kategoriji ključnih besed:

  • Ključne besede, ki vrnejo seznam objektov, ne da bi upoštevale podatke workflow. Te ključne besede se uporabljajo za filtriranje ali kot pogoji za izvajanje nalog ali dejanj. V tem primeru je ločilo „§“. Na voljo so naslednje ključne besede:

    • §KAD§: ključna beseda, ki jo je mogoče uporabiti samo v workflow, ki jih sproži dogodek „Modification of an authorization rule“
      • §KAD§ATTRIBUTE§secondary_parameter§: omogoča pridobitev podatkov o pravilu avtorizacije na podlagi njegovega identifikatorja, imena ali opisa. secondary_parameter lahko zavzame naslednje vrednosti:
        • kad_id: identifikator pravila avtorizacije.
        • kad_name: ime pravila avtorizacije
        • kad_description: opis pravila avtorizacije
      • §KAD§FILTRE§attribute_code§: omogoča pridobitev vrednosti filtra, katerega koda je podana v „attribute_code“, v pravilu avtorizacije, ki sproži instanco workflow.
      • §KAD§STRUCTURE§VALUE§: omogoča pridobitev vrednosti struktur, ki jih zajema pravilo avtorizacije, ki sproži instanco workflow.
      • §KAD§RIGHT§<AccountTypeCode.RightCode>§: omogoča preverjanje, ali je pravica, katere koda je navedena v parametru „Right_Code“ in ki je povezana z vrsto računa, katere koda je navedena v parametru „Account_Type_Code“, prisotna v pravilu avtorizacije, ki sproži instanco workflow.
    • §PERSON§: ključna beseda za pridobitev seznama identitet, filtriranega glede na vnesene parametre. Ne upošteva podatkov workflow, temveč se uporablja za filtriranje morebitnih ciljev workflow ali za določanje akterjev ali ciljev dejanj ali nalog v workflow.
      • §PERSON§ATTRIBUTE§attribute_code§: omogoča pridobitev seznama oseb glede na vrednost atributa.
      • §PERSON§RIGHT§<AccountTypeCode.RightCode>§: omogoča pridobitev seznama oseb, ki dejansko imajo pravico, katere koda je navedena v parametru „Right_Code“ in ki je povezana z vrsto računa, katere koda je navedena v parametru „Account_Type_Code“.
    • §OBJECT§ ali §RESOURCE§: ključna beseda za pridobitev seznama dodelitev, filtriranega glede na podane parametre. Ne upošteva podatkov workflow, temveč se uporablja za filtriranje objektov v dejanjih ali nalogah v workflow.
      • §OBJECT§ATTRIBUTE§attribute_code§ ali §RESOURCE§ATTRIBUTE§attribute_code§: omogoča pridobitev seznama dodelitev na podlagi vrednosti atributov.

  • Ključne besede, ki vrnejo vrednosti različnih objektov, vsebovanih v primerkih workflow (cilji, akterji, potrjevalci, vsebina zahteve itd.). V tem primeru je ločilo „#“. Na voljo so naslednje ključne besede:

    • WORKFLOW#Code_workflow#parameter_step#: omogoča pridobitev podatkov o primerku workflow, katerega koda je enaka „workflow_code“. Uporabiti jo je mogoče v polju za vrednotenje SQL (npr. pravila izvajanja, pravila potrjevanja itd.) ali v polju obvestila (npr. zadeva, telo e-poštnega sporočila). Parameter_step lahko zavzame naslednje vrednosti:

      • ID: identifikator primerka workflow
      • STATUS: stanje primerka workflow
        • -2 = Neuspeh zaradi eskalacije
        • -1 = Neuspeh
        • 0 = V teku
        • 1 = Uspeh
        • 2 = Inicializiral uporabnik
        • 3 = Dogodek čaka na dodatne informacije
        • 4 = Začasno zaustavljeno
        • 5 = Potrebne so informacije
        • 6 = Blokirano
        • 7 = Zaustavljeno
        • 8 = Uspeh zaradi eskalacije
        • 9 = Ponastavljeno
      • STARTDATE: datum začetka primerka workflow
      • ENDDATE: datum konca primerka workflow
      • LASTEVENTDATE: datum zadnjega dogodka na ravni primerka workflow
      • DATA: vrne seznam zadevnih pravic in uporabnikov.

    • STEP#Step_code#parameter_step#: omogoča pridobitev podatkov o primerku koraka workflow, katerega koda je enaka „Step_code“. Uporabiti jo je mogoče v polju za vrednotenje SQL (npr. pravila izvajanja, pravila potrjevanja itd.) ali v polju obvestila (npr. zadeva, telo e-poštnega sporočila). Parameter_step lahko zavzame naslednje vrednosti:

      • ID: identifikator primerka koraka
      • STATUS: stanje primerka koraka s kodo „Step_code“ v primerku workflow
        • -1 = Neuspeh
        • 0 = V teku
        • 1 = Uspeh
        • 4 = Začasno zaustavljeno
        • 5 = Potrebne so informacije
        • 6 = Blokirano
        • 7 = Zaustavljeno
      • STARTDATE: datum začetka primerka koraka
      • ENDDATE: datum konca primerka koraka
      • LASTEVENTDATE: datum zadnjega dogodka na ravni primerka koraka

    • ACTION#Action_code#parameter_action#: omogoča pridobitev podatkov o primerku dejanja, katerega koda je enaka „action_code“. Uporabiti jo je mogoče v polju za vrednotenje SQL (npr. pravila izvajanja, pravila potrjevanja itd.) ali v polju obvestila (npr. zadeva, telo e-poštnega sporočila). Parameter_action lahko zavzame naslednje vrednosti:

      • ID: identifikator primerka dejanja
      • STATUS: stanje primerka dejanja s kodo „Action_code“ v primerku workflow
        • -1 = Neuspeh
        • 0 = V teku
        • 1 = Uspeh
        • 4 = Začasno zaustavljeno
        • 5 = Potrebne so informacije
        • 6 = Blokirano
        • 7 = Zaustavljeno
      • STARTDATE: datum začetka primerka dejanja
      • ENDDATE: datum konca primerka dejanja
      • LASTEVENTDATE: datum zadnjega dogodka na ravni primerka dejanja
      • DEROGATED: ID osebe, na katero je bilo dejanje delegirano

    • TASK#Task_code#parameter_task#: omogoča pridobitev podatkov o primerku naloge, katere koda je enaka „task_code“. Uporabiti jo je mogoče v polju za vrednotenje SQL (npr. pravila izvajanja, pravila potrjevanja itd.) ali v polju obvestila (npr. zadeva, telo e-poštnega sporočila). Parameter_task lahko zavzame naslednje vrednosti:

      • ID: identifikator primerka naloge
      • STATUS: stanje primerka naloge s kodo „Task_code“ v primerku workflow
        • -1 = Neuspeh
        • 0 = V teku
        • 1 = Uspeh
        • 4 = Začasno zaustavljeno
        • 5 = Potrebne so informacije
        • 6 = Blokirano
        • 7 = Zaustavljeno
      • STARTDATE: datum začetka primerka naloge
      • ENDDATE: datum konca primerka naloge
      • LASTEVENTDATE: datum zadnjega dogodka na ravni primerka naloge
      • DEROGATED: ID osebe, na katero je bila naloga delegirana
    • V telesu e-poštnega sporočila je mogoče ustvariti samodejne povezave za potrjevanje, kadar je obvestilo konfigurirano v dejanju ali nalogi potrjevanja: http://[DNS address]/UserRequestWorkflow.aspx? MyActionId={#ACTION#Action_or_task_code#ID#}&accept=[result]
      • DNS address je treba zamenjati z naslovom strežnika Identity
      • Action_or_task_code je treba zamenjati s kodo dejanja ali naloge, ki naj se potrdi prek povezave
      • Result: vnesite 1 za potrditev dejanja ali naloge ali 0 za zavrnitev.

    Če želite konfigurirati povezavo v telesu e-poštnega sporočila, uporabite gumb „type:inline“, s katerim lahko preverite naslov in besedilo, ki bosta prikazana v e-poštnem sporočilu.

    Opomba: če želi uporabnik potrditi ali zavrniti zahtevo v e-poštnem sporočilu z obvestilom, se mora prijaviti v vmesnik, s čimer potrdi, da ima pravice za izvedbo te operacije.

    • FORM#: ključna beseda, ki jo je mogoče uporabiti samo v workflow vrste „User Request“ ali v nalogah ročnega zagotavljanja/preklica zagotavljanja, v pravilih vrednotenja SQL za korake dejanj in nalog ali v obvestilih.

      • FORM#ADDRIGHTS#CODELIST#: omogoča navedbo pravic, ki jih je prosilec izbral v obrazcu za zahtevo za pravice.

      • FORM#CHANGEATTRIBUTES#parameter_form#: navede atribute, ki jih je prosilec spremenil v obrazcu za spreminjanje osebe. parameter_form lahko zavzame naslednje vrednosti:

        • CODELIST: seznam kod atributov, ki jih je prosilec spremenil v obrazcu za spreminjanje osebe.
        • CHANGEDATE: datum, ko se spremembe upoštevajo, v obliki dd/MM/yyyy

      • FORM#TYPERESOURCES#parameter_form#: pridobi seznam vrst virov, izbranih pri izpolnjevanju obrazca za zahtevo. parameter_form lahko zavzame naslednje vrednosti:

        • DATA: ID virov
        • DATA.CODE: koda vira
        • DATA.NAME: ime virov

      • FORM#Validation_task_code#parameter_form#:

        • DATA: omogoča pridobitev vseh računov in pravic po ciljni aplikaciji v telesu e-poštnega sporočila.
        • DATA.PROVISIONINGRIGHTONLY: omogoča, da je izvedba naloge potrjevanja obrazca in/ali naloge ročnega zagotavljanja pogojena s tem, da cilji že imajo račun v skladiščih, na katera se nanaša zahteva.
        • DATA.UNPROVISIONINGRIGHTONLY: omogoča, da je izvedba naloge potrjevanja obrazca in/ali naloge ročnega preklica zagotavljanja pogojena s tem, da cilji že imajo račun v skladiščih, na katera se nanaša zahteva.
        • DATA.PROVISIONINGACCOUNTONLY: omogoča, da je izvedba naloge potrjevanja obrazca in/ali naloge ročnega zagotavljanja pogojena s tem, da cilji nimajo računa v skladiščih, na katera se nanaša zahteva.
        • DATA.UNPROVISIONINGACCOUNTONLY: omogoča, da je izvedba naloge potrjevanja obrazca in/ali naloge ročnega preklica zagotavljanja pogojena s tem, da cilji nimajo računa v skladiščih, na katera se nanaša zahteva.

    • TASKFORM#: ključna beseda, ki jo je mogoče uporabiti samo v nalogah workflow naslednjih vrst: dodelitev virov in ročno zagotavljanje/preklic zagotavljanja

      • TASKFORM#Task_code#fparameter_form#: omogoča pridobitev podatkov, navedenih v „parameter_form“, za vir ali za pravico. To ključno besedo je treba uporabiti v telesu e-poštnega sporočila, da se rezultat prikaže v obliki tabele. parameter_form lahko zavzame naslednje vrednosti:

        • DATA: ID zahtevanih virov, če je naloga vrste „Resource assignment“, ali ID pravic, za katere je treba izvesti zagotavljanje ali preklic zagotavljanja, če je naloga vrste „Manual provisioning/deprovisioning“.
        • DATA.CODE: koda zahtevanih virov, če je naloga vrste „Resource assignment“, ali koda pravic, za katere je treba izvesti zagotavljanje ali preklic zagotavljanja, če je naloga vrste „Manual provisioning/deprovisioning“.
        • DATA.NAME: ime zahtevanih virov, če je naloga vrste „Resource assignment“, ali ime pravic, za katere je treba izvesti zagotavljanje ali preklic zagotavljanja, če je naloga vrste „manual provisioning/deprovisioning“.
        • DATA.FIELDS: vrednosti dodatnih polj v obrazcu za zahtevo. Velja samo, če je naloga vrste „manual provisioning/deprovisioning“.
        • DATACOMPLETEONLY: identifikatorji virov, ki so bili dejansko dodeljeni v nalogi vrste „Resource Assignment“. Velja samo, če je naloga vrste „Resource Assignment“.
        • DATACOMPLETEONLY.CODE: koda virov, ki so bili dejansko dodeljeni v nalogi vrste „Resource Assignment“. Velja samo, če je naloga vrste „Resource Assignment“.
        • DATACOMPLETEONLY.NAME: ime virov, ki so bili dejansko dodeljeni v nalogi vrste „Resource Assignment“. Velja samo, če je naloga vrste „Resource Assignment“.
        • DATAINCOMPLETE: identifikatorji vrst virov, ki jim ni bil dodeljen noben vir. Velja samo, če je naloga vrste „Resource Assignment“.
        • DATAINCOMPLETE.CODE: koda vrst virov, ki jim ni bil dodeljen noben vir. Velja samo, če je naloga vrste „Resource Assignment“.
        • DATAINCOMPLETE.NAME: ime vrst virov, ki jim ni bil dodeljen noben vir. Velja samo, če je naloga vrste „Resource Assignment“.

    • MANAGER#: upravitelj workflow je oseba, ki upravlja workflow.

      • MANAGER#ATTRIBUTE#attribute_code#: omogoča vstavljanje podatkov o primerku dejanja v polje za vrednotenje SQL (npr. pravila izvajanja, potrjevanja itd.) ali v vrednoteno polje (npr. prejemniki, zadeva, telo e-poštnega sporočila).

      • MANAGER#RIGHT#<Account_Type_Code.Right_Code>#: omogoča preverjanje, ali ima upravitelj workflow pravico, katere koda je navedena v parametru „Right_Code“ in ki je povezana z vrsto računa, katere koda je navedena v parametru „Account_Type_Code“.

      • MANAGER#RIGHTHEO#<Account_Type_Code.Right_Code>#: omogoča preverjanje, ali ima upravitelj workflow teoretično pravico, katere koda je navedena v parametru „Right_Code“ in ki je povezana z vrsto računa, katere koda je navedena v parametru „Account_Type_Code“.

    • POSSIBLEACTIONACTOR#: osebe, ki lahko ukrepajo pri dejanju

      • POSSIBLEACTIONACTOR#Action_code#attribute_code#: omogoča pridobitev vrednosti atributa, katerega koda je podana v parametru attribute_code, pri možnih akterjih primerka dejanja ali naloge, katerega koda je enaka „action_code“. Uporabiti jo je mogoče v polju za vrednotenje SQL (npr. pravila izvajanja, pravila potrjevanja itd.) ali v polju obvestila (npr. prejemniki, zadeva, telo e-poštnega sporočila).

    • STARTER#: oseba, ki zažene workflow

      • STARTER#ATTRIBUTE#attribute_code#: omogoča pridobitev vrednosti atributa, katerega koda je podana v parametru attribute_code, za osebo, ki je zagnala workflow. Uporabiti jo je mogoče v polju za vrednotenje SQL (npr. pravila izvajanja, pravila potrjevanja itd.) ali v polju obvestila (npr. zadeva, telo e-poštnega sporočila).

      • STARTER#RIGHT#<AccountTypeCode.RightCode>#: omogoča preverjanje, ali ima prosilec workflow pravico, katere koda je navedena v parametru „Right_Code“ in ki je povezana z vrsto računa, katere koda je navedena v parametru „Account_Type_Code“.

      • STARTER#RIGHTHEO#<Account_Type_Code.Right_Code>#: omogoča preverjanje, ali ima prosilec workflow teoretično pravico, katere koda je navedena v parametru „Right_Code“ in ki je povezana z vrsto računa, katere koda je navedena v parametru „Account_Type_Code“.

    • TARGET#: objekt ali objekti, ki zaženejo primerek workflow

      • TARGET#ATTRIBUTE#attribute_code#: omogoča pridobitev vrednosti atributa, katerega koda je podana v parametru attribute_code, za objekt, ki je zagnal workflow. Uporabiti jo je mogoče v polju za vrednotenje SQL (npr. pravila izvajanja, pravila potrjevanja itd.) ali v polju obvestila (npr. zadeva, telo e-poštnega sporočila). Ta ključna beseda deluje samo, če je cilj vrste oseba ali dodelitev.

      • TARGET#RIGHT#<AccountTypeCode.RightCode>#: omogoča preverjanje, ali imajo cilji workflow pravico, katere koda je navedena v parametru „Right_Code“ in ki je povezana z vrsto računa, katere koda je navedena v parametru „Account_Type_Code“. Ta ključna beseda deluje samo, če je cilj vrste oseba.

      • TARGET#RIGHTTHEO#<AccountTypeCode.RightCode>#: omogoča preverjanje, ali imajo cilji workflow teoretično pravico, katere koda je navedena v parametru „Right_Code“ in ki je povezana z vrsto računa, katere koda je navedena v parametru „Account_Type_Code“. Ta ključna beseda deluje samo, če je cilj vrste oseba.

      • TARGET#RESOURCE#DATA#: omogoča pridobitev vseh podatkov (vrednosti vseh atributov) vseh virov, povezanih s cilji primerka workflow, v telesu e-poštnega sporočila.

        • TARGET#RESOURCE#DATA@CodeAtt1,CodeAtt2,CodeAttN#: omogoča pridobitev vrednosti atributov, izbranih s seznamom kod atributov CodeAttN, iz vseh virov, povezanih s cilji primerka workflow, v telesu e-poštnega sporočila. Atributa „name“ in „code“ sta v telesu e-poštnega sporočila privzeto prikazana, ne da bi ju bilo treba dodati na seznam.

        • TARGET#RESOURCE#DATA.CodeTypeResource1,CodeTypeResource2,CodeTypeResourceN#: omogoča pridobitev vrednosti vseh atributov vrst virov, izbranih s seznamom kod vrst virov CodeTypeResourceN in povezanih s cilji primerka workflow, v telesu e-poštnega sporočila.

        • TARGET#RESOURCE#DATA.CodeTypeResource1,CodeTypeResourceN@CodeAtt1,CodeAtt2,CodeAttN#: omogoča pridobitev naslednjih vrednosti v telesu e-poštnega sporočila:

          • Bodisi vseh atributov vrst virov, izbranih s seznamom kod atributov CodeTypeResourceN in povezanih s cilji primerka workflow atributov vrste vir, če ni navedena nobena koda atributa
          • Bodisi vrednosti atributov, izbranih s seznamom kod atributov, za vrste virov, izbrane s seznamom kod vrst virov CodeTypeResourceN in povezane s cilji primerka workflow, če so navedene kode atributov CodeAttN.

        • TARGET#RESOURCE#DATA.CodeTypeResource1,CodeTypeResource2,CodeTypeResourceN#: omogoča pridobitev vrednosti vseh atributov vrst virov, izbranih s seznamom kod vrst virov CodeTypeResourceN in povezanih s cilji primerka workflow, v telesu e-poštnega sporočila.

      • TARGET#ACCOUNT#: ključna beseda, ki jo je mogoče uporabiti v dogodkovnih workflow, povezanih z ustvarjanjem dejanskega računa.

        • TARGET#ACCOUNT#LOGIN#: omogoča pridobitev prijavnega imena računa v telesu e-poštnega sporočila.

        • TARGET#ACCOUNT#PASSWORD#: omogoča pridobitev gesla računa (v navadnem besedilu) v telesu e-poštnega sporočila.

        • TARGET#ACCOUNT#STATUS#: omogoča pridobitev stanja zagotavljanja računa v telesu e-poštnega sporočila.

        • TARGET#ACCOUNT#DATA#: omogoča pridobitev prijavnega imena, gesla in stanja v telesu e-poštnega sporočila.

    • PRIMARYTARGET# in #SECONDARYTARGET#: ključna beseda, ki jo je mogoče uporabiti samo v workflow vrste „On event“

      • PRIMARYTARGET#ATTRIBUTE#secondary_parameter# ali #SECONDARYTARGET#ATTRIBUTE#secondary_parameter#: omogoča pridobitev vrednosti objekta na primarnem ali sekundarnem cilju primerka workflow, katerega lastnost je podana v parametru secondary_parameter. Ta ključna beseda deluje samo, če je cilj ene od naslednjih vrst:

        • Identity: v tem primeru bo sekundarni parameter koda atributa.
        • Right: v tem primeru lahko sekundarni parameter zavzame naslednje vrednosti:
          • Name: ime pravice
          • Description: opis pravice
          • Code: koda pravice
          • Applicationname: ime aplikacije, povezane s pravico
          • Applicationdescription: opis aplikacije, povezane s pravico
          • Applicationcode: koda aplikacije, povezane s pravico
          • ismanualprovisioning: logična vrednost, ki označuje, ali pravica pripada skladišču z ročnim zagotavljanjem.

      • PRIMARYTARGET#TYPE#secondary_parameter# ali #SECONDARYTARGET#TYPE#secondary_parameter#: omogoča pridobitev podatkov o vrsti objekta, ki ustreza primarnemu ali sekundarnemu cilju primerka workflow. Ta ključna beseda deluje samo, če je cilj vrste oseba ali dodelitev. secondary_parameter lahko zavzame naslednje vrednosti:

        • NAME: ime vrste osebe ali dodelitve
        • CODE: koda vrste osebe ali dodelitve
        • DESCRIPTION: opis vrste osebe ali dodelitve

      • PRIMARYTARGET#ACCOUNT#secondary_parameter# ali #SECONDARYTARGET#ACCOUNT#secondary_parameter#: omogoča pridobitev podatkov o računu, ki ustreza primarnemu ali sekundarnemu cilju primerka workflow. Ta ključna beseda deluje samo, če je cilj vrste račun. secondary_parameter lahko zavzame naslednje vrednosti:

        • STATUS: stanje ustvarjenega dejanskega računa
        • LOGIN: prijavno ime ustvarjenega dejanskega računa
        • PASSWORD: geslo ustvarjenega dejanskega računa
        • DATA: tabela s prijavnim imenom in geslom ustvarjenega dejanskega računa

Ti dve družini ključnih besed je mogoče uporabiti skupaj v istem parametru „SQL Evaluation“, ki preveri pogoj na podlagi vhodnih parametrov in vrne vrsti „TRUE/FALSE“ ali „List returned by an SQL evaluation“.

Posebnosti:

  • Za vse ključne besede, pri katerih je mogoče v parametrih podati kodo atributa za pridobitev njegove vrednosti, je mogoče pri atributih vrste naštevanje, oseba, struktura ali vir uporabiti razširitev oblike „.object_attribute_code“, da se namesto identifikatorja pridobi vrednost atributa objekta. Za atribute vrste struktura, oseba ali dodelitev morate vnesti kodo želenega atributa objekta, za naštevanja pa lahko object_attribute_code zavzame naslednje vrednosti:
    • NAME: pridobi ime naštevanja
    • CODE: pridobi kodo naštevanja
  • Kadar ključne besede ne zadoščajo za vstavljanje podatkov v telo e-poštnega sporočila, lahko za klic poizvedbe SQL SELECT uporabite naslednjo sintakso:
    • [@@@: <SQL Query>:@@@] : poizvedbo SQL je treba napisati brez stavka „SELECT“. Vrne niz znakov.
  • Za vnos podatkov o ciljih (osebah, vključenih v workflow) je bolje uporabiti ključno besedo §PERSON§ namesto #TARGET#.