> Source: https://docs.cyberelements.io/identity/7.1/et/UserDocumentation/GeneralConfigurations/ManagingKeywordsInWorkflows/

# Märksõnade haldamine workflow'des

Workflow-märksõnu saab kasutada workflow'de, etappide, toimingute ja teatiste sätetes.

Workflow-märksõnade üldvorming on järgmine:

- Klass (nt PERSON, MANAGER, STARTER jne)
- Põhiparameeter (nt ATTRIBUTE, RIGHT jne)
- Teisene parameeter (nt atribuudi kood jne)

Märksõnu on kaks põhikategooriat:

- Märksõnad, mida kasutatakse objektide loendi tagastamiseks workflow-andmeid arvestamata. Neid märksõnu kasutatakse filtreerimiseks või ülesannete või toimingute täitmise tingimustena. Sel juhul on eraldaja „§“. Saadaval on järgmised märksõnad:
    - §KAD§: märksõna, mida saab kasutada ainult workflow'des, mille käivitab sündmus „Modification of an authorization rule“
        - §KAD§ATTRIBUTE§secondary_parameter§: võimaldab hankida teavet autoriseerimisreegli kohta selle ID, nime või kirjelduse põhjal. secondary_parameter võib võtta järgmisi väärtusi:
            - kad_id: autoriseerimisreegli identifikaator.
            - kad_name: autoriseerimisreegli nimi
            - kad_description: autoriseerimisreegli kirjeldus
        - §KAD§FILTRE§attribute_code§: võimaldab hankida workflow-eksemplari käivitavast autoriseerimisreeglist selle filtri väärtused, mille kood antakse parameetris „attribute_code“.
        - §KAD§STRUCTURE§VALUE§: võimaldab hankida nende struktuuride väärtused, mida workflow-eksemplari käivitav autoriseerimisreegel hõlmab.
        - §KAD§RIGHT§<AccountTypeCode.RightCode>§: võimaldab kontrollida, kas õigus, mille kood on määratud parameetris „Right_Code“ ja mis on seotud kontotüübiga, mille kood on määratud parameetris „Account_Type_Code“, sisaldub workflow-eksemplari käivitavas autoriseerimisreeglis.
    - §PERSON§: märksõna filtreeritud identiteediloendi hankimiseks sisestatud parameetrite põhjal. Ei arvesta workflow-andmeid, kuid seda kasutatakse potentsiaalsete workflow-sihtmärkide filtreerimiseks või workflow'de toimingute või ülesannete osaliste või sihtmärkide määramiseks.
        - §PERSON§ATTRIBUTE§attribute_code§: võimaldab hankida isikute loendi atribuudi väärtuse põhjal.
        - §PERSON§RIGHT§<AccountTypeCode.RightCode>§: võimaldab hankida nende isikute loendi, kellel on tegelikult õigus, mille kood on näidatud parameetris „Right_Code“ ja mis on seotud kontotüübiga, mille kood on näidatud parameetris „Account_Type_Code“.
    - §OBJECT§ või §RESOURCE§: märksõna filtreeritud eraldiste loendi hankimiseks antud parameetrite põhjal. Ei arvesta workflow-andmeid, kuid seda kasutatakse objektide filtreerimiseks workflow'de toimingutes või ülesannetes.
        - §OBJECT§ATTRIBUTE§attribute_code§ või §RESOURCE§ATTRIBUTE§attribute_code§: võimaldab hankida eraldiste loendi atribuudiväärtuste põhjal.
- Märksõnad, mida kasutatakse workflow-eksemplarides sisalduvate eri objektide (sihtmärgid, osalised, kinnitajad, taotluse sisu jne) väärtuste tagastamiseks. Sel juhul on eraldaja „#“. Saadaval on järgmised märksõnad:

  Lingi konfigureerimiseks e-kirja sisus kasutage nuppu „![type:inline](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_PictoJoindreChaine.png)“, kus saate kontrollida e-kirjas kuvatavat aadressi ja teksti.

  **Märkus:** taotluse kinnitamiseks või tagasilükkamiseks teatise e-kirjast peab kasutaja liidesesse sisse logima, et kinnitada, et tal on selle tegevuse sooritamiseks õigused.
    - # WORKFLOW#Code_workflow#parameter_step#: võimaldab hankida teavet workflow-eksemplari kohta, mille kood on võrdne väärtusega „workflow_code“. Saab kasutada SQL-hindamisväljal (nt täitmisreeglid, kinnitusreeglid jne) või teatiseväljal (nt teema, e-kirja sisu). Parameter_step võib võtta järgmisi väärtusi:
        - ID: workflow-eksemplari identifikaator
        - STATUS: workflow-eksemplari olek
            - -2 = nurjus eskaleerimise tõttu
            - -1 = nurjus
            - 0 = käimas
            - 1 = õnnestus
            - 2 = kasutaja algatatud
            - 3 = sündmus ootab lisateavet
            - 4 = peatatud
            - 5 = vaja on teavet
            - 6 = blokeeritud
            - 7 = seisatud
            - 8 = õnnestus eskaleerimise kaudu
            - 9 = lähtestatud
        - STARTDATE: workflow-eksemplari alguskuupäev
        - ENDDATE: workflow-eksemplari lõppkuupäev
        - LASTEVENTDATE: viimase sündmuse kuupäev workflow-eksemplari tasemel
        - DATA: tagastab asjaomaste õiguste ja kasutajate loendi.
    - # STEP#Step_code#parameter_step#: võimaldab hankida teavet workflow-etapi eksemplari kohta, mille kood on võrdne väärtusega „Step_code“. Saab kasutada SQL-hindamisväljal (nt täitmisreeglid, kinnitusreeglid jne) või teatiseväljal (nt teema, e-kirja sisu). Parameter_step võib võtta järgmisi väärtusi:
        - ID: etapieksemplari identifikaator
        - STATUS: koodiga „Step_code“ etapi eksemplari olek workflow-eksemplaris
            - -1 = nurjus
            - 0 = käimas
            - 1 = õnnestus
            - 4 = peatatud
            - 5 = vaja on teavet
            - 6 = blokeeritud
            - 7 = seisatud
        - STARTDATE: etapieksemplari alguskuupäev
        - ENDDATE: etapieksemplari lõppkuupäev
        - LASTEVENTDATE: viimase sündmuse kuupäev etapieksemplari tasemel
    - # ACTION#Action_code#parameter_action#: võimaldab hankida teavet toimingu eksemplari kohta, mille kood on võrdne väärtusega „action_code“. Saab kasutada SQL-hindamisväljal (nt täitmisreeglid, kinnitusreeglid jne) või teatiseväljal (nt teema, e-kirja sisu). Parameter_action võib võtta järgmisi väärtusi:
        - ID: toimingueksemplari identifikaator
        - STATUS: koodiga „Action_code“ toimingu eksemplari olek workflow-eksemplaris
            - -1 = nurjus
            - 0 = käimas
            - 1 = õnnestus
            - 4 = peatatud
            - 5 = vaja on teavet
            - 6 = blokeeritud
            - 7 = seisatud
        - STARTDATE: toimingueksemplari alguskuupäev
        - ENDDATE: toimingueksemplari lõppkuupäev
        - LASTEVENTDATE: viimase sündmuse kuupäev toimingueksemplari tasemel
        - DEROGATED: selle isiku ID, kellele toiming delegeeriti
    - # TASK#Task_code#parameter_task#: võimaldab hankida teavet ülesande eksemplari kohta, mille kood on võrdne väärtusega „task_code“. Saab kasutada SQL-hindamisväljal (nt täitmisreeglid, kinnitusreeglid jne) või teatiseväljal (nt teema, e-kirja sisu). Parameter_task võib võtta järgmisi väärtusi:
        - ID: ülesandeeksemplari identifikaator
        - STATUS: koodiga „Task_code“ ülesande eksemplari olek workflow-eksemplaris
            - -1 = nurjus
            - 0 = käimas
            - 1 = õnnestus
            - 4 = peatatud
            - 5 = vaja on teavet
            - 6 = blokeeritud
            - 7 = seisatud
        - STARTDATE: ülesandeeksemplari alguskuupäev
        - ENDDATE: ülesandeeksemplari lõppkuupäev
        - LASTEVENTDATE: viimase sündmuse kuupäev ülesandeeksemplari tasemel
        - DEROGATED: selle isiku ID, kellele ülesanne delegeeriti
    - E-kirja sisusse saab luua automaatseid kinnituslinke, kui teatis on konfigureeritud kinnitustoimingus või -ülesandes: http://[DNS address]/UserRequestWorkflow.aspx? MyActionId={#ACTION#Action_or_task_code#ID#}&accept=[result]
        - DNS address tuleb asendada Identity serveri aadressiga
        - Action_or_task_code tuleb asendada lingi kaudu kinnitatava toimingu või ülesande koodiga
        - Result: sisestage 1 toimingu või ülesande kinnitamiseks või 0 selle tagasilükkamiseks.
    - # FORM#: märksõna, mida saab kasutada ainult tüübi „User Request“ workflow'des või käsitsi ettevalmistuse / ettevalmistuse tühistamise ülesannetes, toimingu- ja ülesandeetappide SQL-hindamisreeglites või teatistes.
        - # FORM#ADDRIGHTS#CODELIST#: võimaldab loetleda õigused, mille taotleja on õiguste taotlusvormis valinud.
        - # FORM#CHANGEATTRIBUTES#parameter_form#: loetleb atribuudid, mida taotleja on isiku muutmisvormis muutnud. parameter_form võib võtta järgmisi väärtusi:
            - CODELIST: nende atribuutide koodide loend, mida taotleja on isiku muutmisvormis muutnud.
            - CHANGEDATE: kuupäev, millest alates muudatusi arvesse võetakse, vormingus dd/MM/yyyy
        - # FORM#TYPERESOURCES#parameter_form#: hangib taotlusvormi täitmisel valitud ressursitüüpide loendi. parameter_form võib võtta järgmisi väärtusi:
            - DATA: ressursside ID
            - DATA.CODE: ressursi kood
            - DATA.NAME: ressursside nimi
        - # FORM#Validation_task_code#parameter_form#:
            - DATA: võimaldab hankida e-kirja sisusse kõik kontod ja õigused sihtrakenduste kaupa.
            - DATA.PROVISIONINGRIGHTONLY: võimaldab seada vormi kinnitusülesande ja/või käsitsi ettevalmistuse ülesande täitmise tingimuseks, et sihtmärkidel on taotlusega seotud hoidlates juba konto olemas.
            - DATA.UNPROVISIONINGRIGHTONLY: võimaldab seada vormi kinnitusülesande ja/või käsitsi ettevalmistuse tühistamise ülesande täitmise tingimuseks, et sihtmärkidel on taotlusega seotud hoidlates juba konto olemas.
            - DATA.PROVISIONINGACCOUNTONLY: võimaldab seada vormi kinnitusülesande ja/või käsitsi ettevalmistuse ülesande täitmise tingimuseks, et sihtmärkidel pole taotlusega seotud hoidlates kontot.
            - DATA.UNPROVISIONINGACCOUNTONLY: võimaldab seada vormi kinnitusülesande ja/või käsitsi ettevalmistuse tühistamise ülesande täitmise tingimuseks, et sihtmärkidel pole taotlusega seotud hoidlates kontot.
    - # TASKFORM#: märksõna, mida saab kasutada ainult järgmist tüüpi workflow-ülesannetes: ressursi määramine ja käsitsi ettevalmistus / ettevalmistuse tühistamine
        - # TASKFORM#Task_code#fparameter_form#: võimaldab hankida „parameter_form“ abil määratud andmed kas ressursist või õigusest. Seda märksõna tuleb kasutada e-kirja sisus, et tulemus kuvataks tabeli kujul. parameter_form võib võtta järgmisi väärtusi:
            - DATA: taotletud ressursside ID, kui ülesanne on tüüpi „Resource assignment“, või ettevalmistatavate või ettevalmistuse tühistamisele kuuluvate õiguste ID, kui ülesanne on tüüpi „Manual provisioning/deprovisioning“.
            - DATA.CODE: taotletud ressursside kood, kui ülesanne on tüüpi „Resource assignment“, või ettevalmistatavate või ettevalmistuse tühistamisele kuuluvate õiguste kood, kui ülesanne on tüüpi „Manual provisioning/deprovisioning“.
            - DATA.NAME: taotletud ressursside nimi, kui ülesanne on tüüpi „Resource assignment“, või ettevalmistatavate või ettevalmistuse tühistamisele kuuluvate õiguste nimi, kui ülesanne on tüüpi „manual provisioning/deprovisioning“.
            - DATA.FIELDS: taotlusvormi lisaväljade väärtused. Kehtib ainult siis, kui ülesanne on tüüpi „manual provisioning/deprovisioning“.
            - DATACOMPLETEONLY: ülesandetüübis „Resource Assignment“ tegelikult määratud ressursside ID-d. Kehtib ainult siis, kui ülesanne on tüüpi „Resource Assignment“.
            - DATACOMPLETEONLY.CODE: ülesandetüübis „Resource Assignment“ tegelikult määratud ressursside kood. Kehtib ainult siis, kui ülesanne on tüüpi „Resource Assignment“.
            - DATACOMPLETEONLY.NAME: ülesandetüübis „Resource Assignment“ tegelikult määratud ressursside nimi. Kehtib ainult siis, kui ülesanne on tüüpi „Resource Assignment“.
            - DATAINCOMPLETE: nende ressursitüüpide ID-d, millele pole ühtegi ressurssi määratud. Kehtib ainult siis, kui ülesanne on tüüpi „Resource Assignment“.
            - DATAINCOMPLETE.CODE: nende ressursitüüpide kood, millele pole ühtegi ressurssi määratud. Kehtib ainult siis, kui ülesanne on tüüpi „Resource Assignment“.
            - DATAINCOMPLETE.NAME: nende ressursitüüpide nimi, millele pole ühtegi ressurssi määratud. Kehtib ainult siis, kui ülesanne on tüüpi „Resource Assignment“.
    - # MANAGER#: workflow-haldur on isik, kes administreerib workflow'd.
        - # MANAGER#ATTRIBUTE#attribute_code#: võimaldab lisada toimingueksemplari teavet SQL-hindamisväljale (nt täitmis- ja kinnitusreeglid jne) või hinnatavale väljale (nt adressaadid, teema, e-kirja sisu).
        - # MANAGER#RIGHT#<Account_Type_Code.Right_Code>#: võimaldab kontrollida, et workflow-halduril on õigus, mille kood on näidatud parameetris „Right_Code“ ja mis on seotud kontotüübiga, mille kood on näidatud parameetris „Account_Type_Code“.
        - # MANAGER#RIGHTHEO#<Account_Type_Code.Right_Code>#: võimaldab kontrollida, et workflow-halduril on teoreetiliselt õigus, mille kood on näidatud parameetris „Right_Code“ ja mis on seotud kontotüübiga, mille kood on näidatud parameetris „Account_Type_Code“.
    - # POSSIBLEACTIONACTOR#: isikud, kes saavad toimingut käsitleda
        - # POSSIBLEACTIONACTOR#Action_code#attribute_code#: võimaldab hankida selle atribuudi väärtuse, mille kood antakse parameetris attribute_code, selle toimingu või ülesande eksemplari võimalikelt osalistelt, mille kood on võrdne väärtusega „action_code“. Saab kasutada SQL-hindamisväljal (nt täitmisreeglid, kinnitusreeglid jne) või teatiseväljal (nt adressaadid, teema, e-kirja sisu).
    - # STARTER#: isik, kes käivitab workflow'
        - # STARTER#ATTRIBUTE#attribute_code#: võimaldab hankida selle atribuudi väärtuse, mille kood antakse parameetris attribute_code, workflow' käivitanud isiku puhul. Saab kasutada SQL-hindamisväljal (nt täitmisreeglid, kinnitusreeglid jne) või teatiseväljal (nt teema, e-kirja sisu).
        - # STARTER#RIGHT#<AccountTypeCode.RightCode>#: võimaldab kontrollida, et workflow-taotlejal on õigus, mille kood on näidatud parameetris „Right_Code“ ja mis on seotud kontotüübiga, mille kood on näidatud parameetris „Account_Type_Code“.
        - # STARTER#RIGHTHEO#<Account_Type_Code.Right_Code>#: võimaldab kontrollida, et workflow-taotlejal on teoreetiliselt õigus, mille kood on näidatud parameetris „Right_Code“ ja mis on seotud kontotüübiga, mille kood on näidatud parameetris „Account_Type_Code“.
    - # TARGET#: objekt(id), mis käivitavad workflow-eksemplari
        - # TARGET#ATTRIBUTE#attribute_code#: võimaldab hankida selle atribuudi väärtuse, mille kood antakse parameetris attribute_code, objektilt, mis workflow' käivitas. Saab kasutada SQL-hindamisväljal (nt täitmisreeglid, kinnitusreeglid jne) või teatiseväljal (nt teema, e-kirja sisu). See märksõna toimib ainult siis, kui sihtmärk on tüüpi isik või eraldis.
        - # TARGET#RIGHT#<AccountTypeCode.RightCode>#: võimaldab kontrollida, et workflow' sihtmärgil (sihtmärkidel) on õigus, mille kood on näidatud parameetris „Right_Code“ ja mis on seotud kontotüübiga, mille kood on näidatud parameetris „Account_Type_Code“. See märksõna toimib ainult siis, kui sihtmärk on tüüpi isik.
        - # TARGET#RIGHTTHEO#<AccountTypeCode.RightCode>#: võimaldab kontrollida, et workflow' sihtmärgil (sihtmärkidel) on teoreetiliselt õigus, mille kood on näidatud parameetris „Right_Code“ ja mis on seotud kontotüübiga, mille kood on näidatud parameetris „Account_Type_Code“. See märksõna toimib ainult siis, kui sihtmärk on tüüpi isik.
        - # TARGET#RESOURCE#DATA#: võimaldab hankida e-kirja sisusse kõik andmed (kõigi atribuutide väärtused) kõigist ressurssidest, mis on seotud workflow-eksemplari sihtmärkidega.
            - # TARGET#RESOURCE#DATA@CodeAtt1,CodeAtt2,CodeAttN#: võimaldab hankida e-kirja sisusse atribuudikoodide loendi CodeAttN kaudu valitud atribuutide väärtused kõigist ressurssidest, mis on seotud workflow-eksemplari sihtmärkidega. Atribuudid „name“ ja „code“ kuvatakse e-kirja sisus vaikimisi, ilma et neid peaks loendisse lisama.
            - # TARGET#RESOURCE#DATA.CodeTypeResource1,CodeTypeResource2,CodeTypeResourceN#: võimaldab hankida e-kirja sisusse nende ressursitüüpide kõigi atribuutide väärtused, mis on valitud ressursitüübikoodide loendi CodeTypeResourceN kaudu ja seotud workflow-eksemplari sihtmärkidega.
            - # TARGET#RESOURCE#DATA.CodeTypeResource1,CodeTypeResourceN@CodeAtt1,CodeAtt2,CodeAttN#: võimaldab hankida e-kirja sisusse järgmised väärtused:
                - kas nende ressursitüüpide kõik atribuudid, mis on valitud koodiloendi CodeTypeResourceN kaudu ja seotud workflow-eksemplari sihtmärkidega, kui ühtegi atribuudikoodi pole määratud
                - või atribuudikoodide loendi kaudu valitud atribuutide väärtused nende ressursitüüpide puhul, mis on valitud ressursitüübikoodide loendi CodeTypeResourceN kaudu ja seotud workflow-eksemplari sihtmärkidega, kui atribuudikoodid CodeAttN on määratud.
            - # TARGET#RESOURCE#DATA.CodeTypeResource1,CodeTypeResource2,CodeTypeResourceN#: võimaldab hankida e-kirja sisusse nende ressursitüüpide kõigi atribuutide väärtused, mis on valitud ressursitüübikoodide loendi CodeTypeResourceN kaudu ja seotud workflow-eksemplari sihtmärkidega.
        - # TARGET#ACCOUNT#: märksõna, mida saab kasutada sündmuspõhistes workflow'des, mis on seotud tegeliku konto loomisega.
            - # TARGET#ACCOUNT#LOGIN#: võimaldab hankida e-kirja sisusse konto kasutajanime.
            - # TARGET#ACCOUNT#PASSWORD#: võimaldab hankida e-kirja sisusse konto parooli (lihttekstina).
            - # TARGET#ACCOUNT#STATUS#: võimaldab hankida e-kirja sisusse konto ettevalmistuse oleku.
            - # TARGET#ACCOUNT#DATA#: võimaldab hankida e-kirja sisusse kasutajanime, parooli ja oleku.
    - # PRIMARYTARGET# ja #SECONDARYTARGET#: märksõna, mida saab kasutada ainult tüübi „On event“ workflow'des
        - # PRIMARYTARGET#ATTRIBUTE#secondary_parameter# või #SECONDARYTARGET#ATTRIBUTE#secondary_parameter#: võimaldab hankida workflow-eksemplari esmaselt või teiseselt sihtmärgilt objekti väärtuse, mille omadus antakse parameetris secondary_parameter. See märksõna toimib ainult siis, kui sihtmärk on järgmist tüüpi:
            - Identity: sel juhul on teisene parameeter atribuudikood.
            - Right: sel juhul võib teisene parameeter võtta järgmisi väärtusi:
                - Name: õiguse nimi
                - Description: õiguse kirjeldus
                - Code: õiguse kood
                - Applicationname: õigusega seotud rakenduse nimi
                - Applicationdescription: õigusega seotud rakenduse kirjeldus
                - Applicationcode: õigusega seotud rakenduse kood
                - ismanualprovisioning: tõeväärtus, mis näitab, kas õigus kuulub käsitsi ettevalmistuse hoidlasse.
        - # PRIMARYTARGET#TYPE#secondary_parameter# või #SECONDARYTARGET#TYPE#secondary_parameter#: võimaldab hankida teavet workflow-eksemplari esmasele või teisesele sihtmärgile vastava objektitüübi kohta. See märksõna toimib ainult siis, kui sihtmärk on tüüpi isik või eraldis. secondary_parameter võib võtta järgmisi väärtusi:
            - NAME: isiku- või eraldisetüübi nimi
            - CODE: isiku- või eraldisetüübi kood
            - DESCRIPTION: isiku- või eraldisetüübi kirjeldus
        - # PRIMARYTARGET#ACCOUNT#secondary_parameter# või #SECONDARYTARGET#ACCOUNT#secondary_parameter#: võimaldab hankida teavet workflow-eksemplari esmasele või teisesele sihtmärgile vastava konto kohta. See märksõna toimib ainult siis, kui sihtmärk on tüüpi konto. secondary_parameter võib võtta järgmisi väärtusi:
            - STATUS: loodud tegeliku konto olek
            - LOGIN: loodud tegeliku konto kasutajanimi
            - PASSWORD: loodud tegeliku konto parool
            - DATA: tabel, milles on loetletud loodud tegeliku konto kasutajanimi ja parool

Neid kahte märksõnaperet saab kasutada koos samas parameetris „SQL Evaluation“, mis kontrollib tingimust sisendparameetrite põhjal ja tagastab tüübid „TRUE/FALSE“ või „List returned by an SQL evaluation“.

Eripärad:

- Kõigi märksõnade puhul, mille parameetrites saab atribuudi väärtuse hankimiseks edastada selle koodi, saab loetelu-, isiku-, struktuuri- või ressursitüüpi atribuutide puhul kasutada vormingulaiendit „.object_attribute_code“, et hankida ID asemel objekti atribuudiväärtus. Struktuuri-, isiku- või eraldisetüüpi atribuutide puhul tuleb sisestada soovitud objektiatribuudi kood ning loeteluväärtuste puhul võib object_attribute_code võtta järgmisi väärtusi:
    - NAME: hangib loeteluväärtuse nime
    - CODE: hangib loeteluväärtuse koodi
- Kui märksõnadest ei piisa teabe lisamiseks e-kirja sisusse, saab SQL-päringu SELECT väljakutsumiseks kasutada järgmist süntaksit:
    - [@@@: <SQL Query>:@@@] : SQL-päring tuleb kirjutada ilma „SELECT“-klauslita. See tagastab märgistringi.
- Sihtmärgi teabe (workflow'ga seotud isikud) sisestamiseks on parem kasutada märksõna §PERSON§ kui #TARGET#.
