Preskoči na sadržaj

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:

    • 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.

    Da biste konfigurirali poveznicu u tijelu poruke e-pošte, upotrijebite gumb „type:inline“ 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.

    • 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#.