Keri sisuni

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:

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

    Lingi konfigureerimiseks e-kirja sisus kasutage nuppu „type:inline“, 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.

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