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

# Upravljanje ključnim riječima u workflowima

Ključne riječi workflowa mogu se koristiti u postavkama workflowa, koraka, radnji i obavijesti.

Opći format ključnih riječi workflowa je sljedeći:

- klasa (npr.: PERSON, MANAGER, STARTER itd.)
- glavni parametar (npr.: ATTRIBUTE, RIGHT itd.)
- sekundarni parametar (npr.: kod atributa itd.)

Postoje dvije glavne kategorije ključnih riječi:

- Ključne riječi koje se koriste za vraćanje popisa objekata bez uzimanja u obzir podataka workflowa. Te se ključne riječi koriste za filtriranje ili kao uvjeti za izvršavanje zadataka ili radnji. U tom je slučaju razdjelnik „§“. Dostupne su sljedeće ključne riječi:
    - §KAD§: ključna riječ koja se može koristiti samo u workflowima koje pokreće događaj „Modification of an authorization rule“
        - §KAD§ATTRIBUTE§secondary_parameter§: omogućuje dohvaćanje informacija o pravilu autorizacije na temelju njegova ID-a, naziva ili opisa. secondary_parameter može poprimiti sljedeće vrijednosti:
            - kad_id: identifikator pravila autorizacije.
            - kad_name: naziv pravila autorizacije
            - kad_description: opis pravila autorizacije
        - §KAD§FILTRE§attribute_code§: omogućuje dohvaćanje vrijednosti filtra čiji je kod proslijeđen u „attribute_code“ u pravilu autorizacije koje pokreće instancu workflowa.
        - §KAD§STRUCTURE§VALUE§: omogućuje dohvaćanje vrijednosti struktura obuhvaćenih pravilom autorizacije koje pokreće instancu workflowa.
        - §KAD§RIGHT§<AccountTypeCode.RightCode>§: omogućuje provjeru nalazi li se pravo čiji je kod naveden u parametru „Right_Code“, povezano s vrstom računa čiji je kod naveden u parametru „Account_Type_Code“, u pravilu autorizacije koje pokreće instancu workflowa.
    - §PERSON§: ključna riječ za dohvaćanje popisa identiteta filtriranog prema unesenim parametrima. Ne uzima u obzir podatke workflowa, ali se koristi za filtriranje mogućih ciljeva workflowa ili za određivanje aktera ili ciljeva radnji ili zadataka u workflowima.
        - §PERSON§ATTRIBUTE§attribute_code§: omogućuje dohvaćanje popisa osoba prema vrijednosti atributa.
        - §PERSON§RIGHT§<AccountTypeCode.RightCode>§: omogućuje dohvaćanje popisa osoba koje stvarno imaju pravo čiji je kod naveden u parametru „Right_Code“ i koje je povezano s vrstom računa čiji je kod naveden u parametru „Account_Type_Code“.
    - §OBJECT§ ili §RESOURCE§: ključna riječ za dohvaćanje popisa zaduženja filtriranog prema navedenim parametrima. Ne uzima u obzir podatke workflowa, ali se koristi za filtriranje objekata u radnjama ili zadacima u workflowima.
        - §OBJECT§ATTRIBUTE§attribute_code§ ili §RESOURCE§ATTRIBUTE§attribute_code§: omogućuje dohvaćanje popisa zaduženja na temelju vrijednosti atributa.
- Ključne riječi koje se koriste za vraćanje vrijednosti različitih objekata sadržanih u instancama workflowa (ciljevi, akteri, validatori, sadržaj zahtjeva itd.). U tom je slučaju razdjelnik „#“. Dostupne su sljedeće ključne riječi:

  Da biste konfigurirali poveznicu u tijelu poruke e-pošte, upotrijebite gumb „![type:inline](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_PictoJoindreChaine.png)“ pomoću kojeg možete provjeriti adresu i tekst koji će se prikazati u poruci e-pošte.

  **Napomena:** da bi odobrio ili odbio zahtjev iz poruke e-pošte s obaviješću, korisnik se mora prijaviti u sučelje kako bi se potvrdilo da ima prava za izvođenje te operacije.
    - # WORKFLOW#Code_workflow#parameter_step#: omogućuje dohvaćanje informacija o instanci workflowa čiji je kod jednak „workflow_code“. Može se koristiti u polju za evaluaciju SQL-a (npr. pravila izvršavanja, pravila provjere valjanosti itd.) ili u polju obavijesti (npr. predmet, tijelo poruke e-pošte). Parameter_step može poprimiti sljedeće vrijednosti:
        - ID: identifikator instance workflowa
        - STATUS: status instance workflowa
            - -2 = neuspjeh zbog eskalacije
            - -1 = neuspjeh
            - 0 = u tijeku
            - 1 = uspjeh
            - 2 = pokrenuo korisnik
            - 3 = događaj čeka dodatne informacije
            - 4 = pauzirano
            - 5 = potrebne su informacije
            - 6 = blokirano
            - 7 = zaustavljeno
            - 8 = uspjeh zbog eskalacije
            - 9 = ponovno postavljeno
        - STARTDATE: datum početka instance workflowa
        - ENDDATE: datum završetka instance workflowa
        - LASTEVENTDATE: datum posljednjeg događaja na razini instance workflowa
        - DATA: vraća popis prava i korisnika na koje se odnosi.
    - # STEP#Step_code#parameter_step#: omogućuje dohvaćanje informacija o instanci koraka workflowa čiji je kod jednak „Step_code“. Može se koristiti u polju za evaluaciju SQL-a (npr. pravila izvršavanja, pravila provjere valjanosti itd.) ili u polju obavijesti (npr. predmet, tijelo poruke e-pošte). Parameter_step može poprimiti sljedeće vrijednosti:
        - ID: identifikator instance koraka
        - STATUS: status instance koraka s kodom „Step_code“ u instanci workflowa
            - -1 = neuspjeh
            - 0 = u tijeku
            - 1 = uspjeh
            - 4 = pauzirano
            - 5 = potrebne su informacije
            - 6 = blokirano
            - 7 = zaustavljeno
        - STARTDATE: datum početka instance koraka
        - ENDDATE: datum završetka instance koraka
        - LASTEVENTDATE: datum posljednjeg događaja na razini instance koraka
    - # ACTION#Action_code#parameter_action#: omogućuje dohvaćanje informacija o instanci radnje čiji je kod jednak „action_code“. Može se koristiti u polju za evaluaciju SQL-a (npr. pravila izvršavanja, pravila provjere valjanosti itd.) ili u polju obavijesti (npr. predmet, tijelo poruke e-pošte). Parameter_action može poprimiti sljedeće vrijednosti:
        - ID: identifikator instance radnje
        - STATUS: status instance radnje s kodom „Action_code“ u instanci workflowa
            - -1 = neuspjeh
            - 0 = u tijeku
            - 1 = uspjeh
            - 4 = pauzirano
            - 5 = potrebne su informacije
            - 6 = blokirano
            - 7 = zaustavljeno
        - STARTDATE: datum početka instance radnje
        - ENDDATE: datum završetka instance radnje
        - LASTEVENTDATE: datum posljednjeg događaja na razini instance radnje
        - DEROGATED: ID osobe kojoj je radnja delegirana
    - # TASK#Task_code#parameter_task#: omogućuje dohvaćanje informacija o instanci zadatka čiji je kod jednak „task_code“. Može se koristiti u polju za evaluaciju SQL-a (npr. pravila izvršavanja, pravila provjere valjanosti itd.) ili u polju obavijesti (npr. predmet, tijelo poruke e-pošte). Parameter_task može poprimiti sljedeće vrijednosti:
        - ID: identifikator instance zadatka
        - STATUS: status instance zadatka s kodom „Task_code“ u instanci workflowa
            - -1 = neuspjeh
            - 0 = u tijeku
            - 1 = uspjeh
            - 4 = pauzirano
            - 5 = potrebne su informacije
            - 6 = blokirano
            - 7 = zaustavljeno
        - STARTDATE: datum početka instance zadatka
        - ENDDATE: datum završetka instance zadatka
        - LASTEVENTDATE: datum posljednjeg događaja na razini instance zadatka
        - DEROGATED: ID osobe kojoj je zadatak delegiran
    - U tijelu poruke e-pošte moguće je stvoriti poveznice za automatsku provjeru valjanosti kada je obavijest konfigurirana u radnji ili zadatku provjere valjanosti: http://[DNS address]/UserRequestWorkflow.aspx? MyActionId={#ACTION#Action_or_task_code#ID#}&accept=[result]
        - DNS address zamijenite adresom poslužitelja Identity
        - Action_or_task_code zamijenite kodom radnje ili zadatka koji treba odobriti putem poveznice
        - Result: unesite 1 da biste odobrili radnju ili zadatak, a 0 da biste ih odbili.
    - # FORM#: ključna riječ koja se može koristiti samo u workflowima vrste „User Request“ ili u zadacima ručnog dodjeljivanja/ukidanja dodjeljivanja, u pravilima evaluacije SQL-a za korake radnji i zadataka ili u obavijestima.
        - # FORM#ADDRIGHTS#CODELIST#: omogućuje navođenje prava koja je podnositelj zahtjeva odabrao u obrascu zahtjeva za prava.
        - # FORM#CHANGEATTRIBUTES#parameter_form#: navodi atribute koje je podnositelj zahtjeva izmijenio u obrascu za izmjenu osobe. parameter_form može poprimiti sljedeće vrijednosti:
            - CODELIST: popis kodova atributa koje je podnositelj zahtjeva izmijenio u obrascu za izmjenu osobe.
            - CHANGEDATE: datum od kojeg se promjene uzimaju u obzir, u formatu dd/MM/yyyy
        - # FORM#TYPERESOURCES#parameter_form#: dohvaća popis vrsta resursa odabranih pri ispunjavanju obrasca zahtjeva. parameter_form može poprimiti sljedeće vrijednosti:
            - DATA: ID resursa
            - DATA.CODE: kod resursa
            - DATA.NAME: naziv resursa
        - # FORM#Validation_task_code#parameter_form#:
            - DATA: omogućuje dohvaćanje svih računa i prava po ciljnoj aplikaciji u tijelu poruke e-pošte.
            - DATA.PROVISIONINGRIGHTONLY: omogućuje uvjetovanje izvršavanja zadatka provjere valjanosti obrasca i/ili zadatka ručnog dodjeljivanja time da ciljevi već imaju račun u repozitorijima na koje se zahtjev odnosi.
            - DATA.UNPROVISIONINGRIGHTONLY: omogućuje uvjetovanje izvršavanja zadatka provjere valjanosti obrasca i/ili zadatka ručnog ukidanja dodjeljivanja time da ciljevi već imaju račun u repozitorijima na koje se zahtjev odnosi.
            - DATA.PROVISIONINGACCOUNTONLY: omogućuje uvjetovanje izvršavanja zadatka provjere valjanosti obrasca i/ili zadatka ručnog dodjeljivanja time da ciljevi nemaju račun u repozitorijima na koje se zahtjev odnosi.
            - DATA.UNPROVISIONINGACCOUNTONLY: omogućuje uvjetovanje izvršavanja zadatka provjere valjanosti obrasca i/ili zadatka ručnog ukidanja dodjeljivanja time da ciljevi nemaju račun u repozitorijima na koje se zahtjev odnosi.
    - # TASKFORM#: ključna riječ koja se može koristiti samo u zadacima workflowa sljedećih vrsta: dodjela resursa i ručno dodjeljivanje/ukidanje dodjeljivanja
        - # TASKFORM#Task_code#fparameter_form#: omogućuje dohvaćanje podataka navedenih u „parameter_form“ iz resursa ili iz prava. Ova se ključna riječ mora koristiti u tijelu poruke e-pošte kako bi se rezultat prikazao u obliku tablice. parameter_form može poprimiti sljedeće vrijednosti:
            - DATA: ID zatraženih resursa ako je zadatak vrste „Resource assignment“ ili ID prava koja treba dodijeliti ili ukinuti ako je zadatak vrste „Manual provisioning/deprovisioning“.
            - DATA.CODE: kod zatraženih resursa ako je zadatak vrste „Resource assignment“ ili kod prava koja treba dodijeliti ili ukinuti ako je zadatak vrste „Manual provisioning/deprovisioning“.
            - DATA.NAME: naziv zatraženih resursa ako je zadatak vrste „Resource assignment“ ili naziv prava koja treba dodijeliti ili ukinuti ako je zadatak vrste „manual provisioning/deprovisioning“.
            - DATA.FIELDS: vrijednosti dodatnih polja obrasca zahtjeva. Vrijedi samo ako je zadatak vrste „manual provisioning/deprovisioning“.
            - DATACOMPLETEONLY: ID-ovi resursa stvarno dodijeljenih u zadatku vrste „Resource Assignment“. Vrijedi samo ako je zadatak vrste „Resource Assignment“.
            - DATACOMPLETEONLY.CODE: kod resursa stvarno dodijeljenih u zadatku vrste „Resource Assignment“. Vrijedi samo ako je zadatak vrste „Resource Assignment“.
            - DATACOMPLETEONLY.NAME: naziv resursa stvarno dodijeljenih u zadatku vrste „Resource Assignment“. Vrijedi samo ako je zadatak vrste „Resource Assignment“.
            - DATAINCOMPLETE: ID-ovi vrsta resursa kojima nije dodijeljen nijedan resurs. Vrijedi samo ako je zadatak vrste „Resource Assignment“.
            - DATAINCOMPLETE.CODE: kod vrsta resursa kojima nije dodijeljen nijedan resurs. Vrijedi samo ako je zadatak vrste „Resource Assignment“.
            - DATAINCOMPLETE.NAME: naziv vrsta resursa kojima nije dodijeljen nijedan resurs. Vrijedi samo ako je zadatak vrste „Resource Assignment“.
    - # MANAGER#: upravitelj workflowa je osoba koja administrira workflow.
        - # MANAGER#ATTRIBUTE#attribute_code#: omogućuje umetanje informacija o instanci radnje u polje za evaluaciju SQL-a (npr. pravila izvršavanja, provjere valjanosti itd.) ili u evaluirano polje (npr. primatelji, predmet, tijelo poruke e-pošte).
        - # MANAGER#RIGHT#<Account_Type_Code.Right_Code>#: omogućuje provjeru ima li upravitelj workflowa pravo čiji je kod naveden u parametru „Right_Code“, povezano s vrstom računa čiji je kod naveden u parametru „Account_Type_Code“.
        - # MANAGER#RIGHTHEO#<Account_Type_Code.Right_Code>#: omogućuje provjeru ima li upravitelj workflowa teorijski pravo čiji je kod naveden u parametru „Right_Code“, povezano s vrstom računa čiji je kod naveden u parametru „Account_Type_Code“.
    - # POSSIBLEACTIONACTOR#: osobe koje mogu djelovati na radnju
        - # POSSIBLEACTIONACTOR#Action_code#attribute_code#: omogućuje dohvaćanje vrijednosti atributa čiji je kod proslijeđen u parametru attribute_code za moguće aktere instance radnje ili zadatka čiji je kod jednak „action_code“. Može se koristiti u polju za evaluaciju SQL-a (npr. pravila izvršavanja, pravila provjere valjanosti itd.) ili u polju obavijesti (npr. primatelji, predmet, tijelo poruke e-pošte).
    - # STARTER#: osoba koja pokreće workflow
        - # STARTER#ATTRIBUTE#attribute_code#: omogućuje dohvaćanje vrijednosti atributa čiji je kod proslijeđen u parametru attribute_code za osobu koja je pokrenula workflow. Može se koristiti u polju za evaluaciju SQL-a (npr. pravila izvršavanja, pravila provjere valjanosti itd.) ili u polju obavijesti (npr. predmet, tijelo poruke e-pošte).
        - # STARTER#RIGHT#<AccountTypeCode.RightCode>#: omogućuje provjeru ima li podnositelj zahtjeva workflowa pravo čiji je kod naveden u parametru „Right_Code“, povezano s vrstom računa čiji je kod naveden u parametru „Account_Type_Code“.
        - # STARTER#RIGHTHEO#<Account_Type_Code.Right_Code>#: omogućuje provjeru ima li podnositelj zahtjeva workflowa teorijski pravo čiji je kod naveden u parametru „Right_Code“, povezano s vrstom računa čiji je kod naveden u parametru „Account_Type_Code“.
    - # TARGET#: objekt ili objekti koji pokreću instancu workflowa
        - # TARGET#ATTRIBUTE#attribute_code#: omogućuje dohvaćanje vrijednosti atributa čiji je kod proslijeđen u parametru attribute_code na objektu koji je pokrenuo workflow. Može se koristiti u polju za evaluaciju SQL-a (npr. pravila izvršavanja, pravila provjere valjanosti itd.) ili u polju obavijesti (npr. predmet, tijelo poruke e-pošte). Ova ključna riječ funkcionira samo kada je cilj vrste osoba ili zaduženje.
        - # TARGET#RIGHT#<AccountTypeCode.RightCode>#: omogućuje provjeru imaju li cilj ili ciljevi workflowa pravo čiji je kod naveden u parametru „Right_Code“, povezano s vrstom računa čiji je kod naveden u parametru „Account_Type_Code“. Ova ključna riječ funkcionira samo kada je cilj vrste osoba.
        - # TARGET#RIGHTTHEO#<AccountTypeCode.RightCode>#: omogućuje provjeru imaju li cilj ili ciljevi workflowa teorijski pravo čiji je kod naveden u parametru „Right_Code“, povezano s vrstom računa čiji je kod naveden u parametru „Account_Type_Code“. Ova ključna riječ funkcionira samo kada je cilj vrste osoba.
        - # TARGET#RESOURCE#DATA#: omogućuje dohvaćanje svih podataka (vrijednosti svih atributa) svih resursa povezanih s ciljevima instance workflowa u tijelu poruke e-pošte.
            - # TARGET#RESOURCE#DATA@CodeAtt1,CodeAtt2,CodeAttN#: omogućuje dohvaćanje vrijednosti atributa odabranih putem popisa kodova atributa CodeAttN iz svih resursa povezanih s ciljevima instance workflowa u tijelu poruke e-pošte. Atributi „name“ i „code“ prema zadanim se postavkama prikazuju u tijelu poruke e-pošte, bez potrebe da ih se doda na popis.
            - # TARGET#RESOURCE#DATA.CodeTypeResource1,CodeTypeResource2,CodeTypeResourceN#: omogućuje dohvaćanje vrijednosti svih atributa vrsta resursa odabranih putem popisa kodova vrsta resursa CodeTypeResourceN, povezanih s ciljevima instance workflowa, u tijelu poruke e-pošte.
            - # TARGET#RESOURCE#DATA.CodeTypeResource1,CodeTypeResourceN@CodeAtt1,CodeAtt2,CodeAttN#: omogućuje dohvaćanje sljedećih vrijednosti u tijelu poruke e-pošte:
                - ili svih atributa vrsta resursa odabranih putem popisa kodova atributa CodeTypeResourceN, povezanih s ciljevima instance workflowa atributa vrste resurs, ako nije naveden nijedan kod atributa
                - ili vrijednosti atributa odabranih putem popisa kodova atributa za vrste resursa odabrane putem popisa kodova vrsta resursa CodeTypeResourceN, povezanih s ciljevima instance workflowa, ako su navedeni kodovi atributa CodeAttN.
            - # TARGET#RESOURCE#DATA.CodeTypeResource1,CodeTypeResource2,CodeTypeResourceN#: omogućuje dohvaćanje vrijednosti svih atributa vrsta resursa odabranih putem popisa kodova vrsta resursa CodeTypeResourceN, povezanih s ciljevima instance workflowa, u tijelu poruke e-pošte.
        - # TARGET#ACCOUNT#: ključna riječ koja se može koristiti u workflowima događaja povezanima sa stvaranjem stvarnog računa.
            - # TARGET#ACCOUNT#LOGIN#: omogućuje dohvaćanje imena za prijavu računa u tijelu poruke e-pošte.
            - # TARGET#ACCOUNT#PASSWORD#: omogućuje dohvaćanje lozinke računa (kao običnog teksta) u tijelu poruke e-pošte.
            - # TARGET#ACCOUNT#STATUS#: omogućuje dohvaćanje statusa dodjeljivanja računa u tijelu poruke e-pošte.
            - # TARGET#ACCOUNT#DATA#: omogućuje dohvaćanje imena za prijavu, lozinke i statusa u tijelu poruke e-pošte.
    - # PRIMARYTARGET# i #SECONDARYTARGET#: ključna riječ koja se može koristiti samo u workflowima vrste „On event“
        - # PRIMARYTARGET#ATTRIBUTE#secondary_parameter# ili #SECONDARYTARGET#ATTRIBUTE#secondary_parameter#: omogućuje dohvaćanje vrijednosti objekta na primarnom ili sekundarnom cilju instance workflowa čije je svojstvo proslijeđeno u parametru secondary_parameter. Ova ključna riječ funkcionira samo kada je cilj sljedeće vrste:
            - Identity: u tom će slučaju sekundarni parametar biti kod atributa.
            - Right: u tom slučaju sekundarni parametar može poprimiti sljedeće vrijednosti:
                - Name: naziv prava
                - Description: opis prava
                - Code: kod prava
                - Applicationname: naziv aplikacije povezane s pravom
                - Applicationdescription: opis aplikacije povezane s pravom
                - Applicationcode: kod aplikacije povezane s pravom
                - ismanualprovisioning: Booleova vrijednost koja označava je li pravo dio repozitorija s ručnim dodjeljivanjem.
        - # PRIMARYTARGET#TYPE#secondary_parameter# ili #SECONDARYTARGET#TYPE#secondary_parameter#: omogućuje dohvaćanje informacija o vrsti objekta koja odgovara primarnom ili sekundarnom cilju instance workflowa. Ova ključna riječ funkcionira samo kada je cilj vrste osoba ili zaduženje. secondary_parameter može poprimiti sljedeće vrijednosti:
            - NAME: naziv vrste osobe ili zaduženja
            - CODE: kod vrste osobe ili zaduženja
            - DESCRIPTION: opis vrste osobe ili zaduženja
        - # PRIMARYTARGET#ACCOUNT#secondary_parameter# ili #SECONDARYTARGET#ACCOUNT#secondary_parameter#: omogućuje dohvaćanje informacija o računu koji odgovara primarnom ili sekundarnom cilju instance workflowa. Ova ključna riječ funkcionira samo kada je cilj vrste račun. secondary_parameter može poprimiti sljedeće vrijednosti:
            - STATUS: status stvorenog stvarnog računa
            - LOGIN: ime za prijavu stvorenog stvarnog računa
            - PASSWORD: lozinka stvorenog stvarnog računa
            - DATA: tablica s imenom za prijavu i lozinkom stvorenog stvarnog računa

Te se dvije skupine ključnih riječi mogu zajedno koristiti u istom parametru „SQL Evaluation“, koji provjerava uvjet na temelju ulaznih parametara i vraća vrste „TRUE/FALSE“ ili „List returned by an SQL evaluation“.

Posebnosti:

- Za sve ključne riječi kojima je u parametrima moguće proslijediti kod atributa radi dohvaćanja njegove vrijednosti, za atribute vrste nabrajanje, osoba, struktura ili resurs moguće je koristiti proširenje formata „.object_attribute_code“ kako bi se umjesto ID-a dohvatila vrijednost atributa objekta. Za atribute vrste struktura, osoba ili zaduženje morate unijeti kod željenog atributa objekta, a za nabrajanja object_attribute_code može poprimiti sljedeće vrijednosti:
    - NAME: dohvaća naziv vrijednosti nabrajanja
    - CODE: dohvaća kod vrijednosti nabrajanja
- Kada ključne riječi nisu dovoljne za umetanje informacija u tijelo poruke e-pošte, za pozivanje upita SQL SELECT može se koristiti sljedeća sintaksa:
    - [@@@: <SQL Query>:@@@] : upit SQL mora se napisati bez klauzule „SELECT“. Vraća niz znakova.
- Za unos informacija o ciljevima (osobama uključenima u workflow) preporučuje se upotreba ključne riječi §PERSON§ umjesto #TARGET#.
