Към съдържанието

Управление на ключовите думи в работните потоци

Ключовите думи за работни потоци могат да се използват в настройките на работните потоци, стъпките, действията и известията.

Общият формат на ключовите думи за работни потоци е следният:

  • Клас (напр.: PERSON, MANAGER, STARTER и т.н.)
  • Основен параметър (напр.: ATTRIBUTE, RIGHT и т.н.)
  • Вторичен параметър (напр.: код на атрибут и т.н.)

Има две основни категории ключови думи:

  • Ключови думи, които връщат списък с обекти, без да вземат предвид данните на работния поток. Тези ключови думи се използват за филтриране или като условия за изпълнение на задачи или действия. В този случай разделителят е „§“. Налични са следните ключови думи:

    • §KAD§: ключова дума, която може да се използва само в работни потоци, задействани от събитието „Modification of an authorization rule“
      • §KAD§ATTRIBUTE§secondary_parameter§: позволява да извлечете информация за правило за упълномощаване по неговия идентификатор, име или описание. secondary_parameter може да приема следните стойности:
        • kad_id: идентификатор на правилото за упълномощаване.
        • kad_name: име на правилото за упълномощаване
        • kad_description: описание на правилото за упълномощаване
      • §KAD§FILTRE§attribute_code§: позволява да извлечете стойностите на филтъра, чийто код е подаден в „attribute_code“, в правилото за упълномощаване, което задейства екземпляра на работния поток.
      • §KAD§STRUCTURE§VALUE§: позволява да извлечете стойностите на структурите, обхванати от правилото за упълномощаване, което задейства екземпляра на работния поток.
      • §KAD§RIGHT§<AccountTypeCode.RightCode>§: позволява да проверите дали правото, чийто код е зададен в параметъра „Right_Code“ и което е свързано с типа акаунт, чийто код е зададен в параметъра „Account_Type_Code“, присъства в правилото за упълномощаване, което задейства екземпляра на работния поток.
    • §PERSON§: ключова дума за извличане на списък със самоличности, филтриран по въведените параметри. Не взема предвид данните на работния поток, но се използва за филтриране на потенциалните цели на работния поток или за определяне на участниците или целите на действия или задачи в работните потоци.
      • §PERSON§ATTRIBUTE§attribute_code§: позволява да извлечете списък с лица според стойност на атрибут.
      • §PERSON§RIGHT§<AccountTypeCode.RightCode>§: позволява да извлечете списък с лица, които действително имат правото, чийто код е посочен в параметъра „Right_Code“ и което е свързано с типа акаунт, чийто код е посочен в параметъра „Account_Type_Code“.
    • §OBJECT§ или §RESOURCE§: ключова дума за извличане на списък с предоставяния, филтриран по зададените параметри. Не взема предвид данните на работния поток, но се използва за филтриране на обекти в действия или задачи в работните потоци.
      • §OBJECT§ATTRIBUTE§attribute_code§ или §RESOURCE§ATTRIBUTE§attribute_code§: позволява да извлечете списък с предоставяния въз основа на стойности на атрибути.

  • Ключови думи, които връщат стойности от различни обекти, съдържащи се в екземплярите на работни потоци (цели, участници, одобряващи, съдържание на заявката и т.н.). В този случай разделителят е „#“. Налични са следните ключови думи:

    • WORKFLOW#Code_workflow#parameter_step#: позволява да извлечете информация за екземпляр на работен поток, чийто код е равен на „workflow_code“. Може да се използва в поле за оценка на SQL (напр. правила за изпълнение, правила за валидиране и т.н.) или в поле на известие (напр. тема, текст на имейла). Parameter_step може да приема следните стойности:

      • ID: идентификатор на екземпляра на работния поток
      • STATUS: статус на екземпляра на работния поток
        • -2 = неуспех чрез ескалация
        • -1 = неуспех
        • 0 = в ход
        • 1 = успех
        • 2 = иницииран от потребителя
        • 3 = събитие, очакващо допълнителна информация
        • 4 = на пауза
        • 5 = нужда от информация
        • 6 = блокиран
        • 7 = спрян
        • 8 = успех чрез ескалация
        • 9 = нулиран
      • STARTDATE: начална дата на екземпляра на работния поток
      • ENDDATE: крайна дата на екземпляра на работния поток
      • LASTEVENTDATE: дата на последното събитие на ниво екземпляр на работния поток
      • DATA: връща списъка със съответните права и потребители.

    • STEP#Step_code#parameter_step#: позволява да извлечете информация за екземпляр на стъпка от работен поток, чийто код е равен на „Step_code“. Може да се използва в поле за оценка на SQL (напр. правила за изпълнение, правила за валидиране и т.н.) или в поле на известие (напр. тема, текст на имейла). Parameter_step може да приема следните стойности:

      • ID: идентификатор на екземпляра на стъпката
      • STATUS: статус на екземпляра на стъпката с код „Step_code“ в екземпляра на работния поток
        • -1 = неуспех
        • 0 = в ход
        • 1 = успех
        • 4 = на пауза
        • 5 = нужда от информация
        • 6 = блокиран
        • 7 = спрян
      • STARTDATE: начална дата на екземпляра на стъпката
      • ENDDATE: крайна дата на екземпляра на стъпката
      • LASTEVENTDATE: дата на последното събитие на ниво екземпляр на стъпката

    • ACTION#Action_code#parameter_action#: позволява да извлечете информация за екземпляр на действие, чийто код е равен на „action_code“. Може да се използва в поле за оценка на SQL (напр. правила за изпълнение, правила за валидиране и т.н.) или в поле на известие (напр. тема, текст на имейла). Parameter_action може да приема следните стойности:

      • ID: идентификатор на екземпляра на действието
      • STATUS: статус на екземпляра на действието с код „Action_code“ в екземпляра на работния поток
        • -1 = неуспех
        • 0 = в ход
        • 1 = успех
        • 4 = на пауза
        • 5 = нужда от информация
        • 6 = блокиран
        • 7 = спрян
      • STARTDATE: начална дата на екземпляра на действието
      • ENDDATE: крайна дата на екземпляра на действието
      • LASTEVENTDATE: дата на последното събитие на ниво екземпляр на действието
      • DEROGATED: ID на лицето, на което е делегирано действието

    • TASK#Task_code#parameter_task#: позволява да извлечете информация за екземпляр на задача, чийто код е равен на „task_code“. Може да се използва в поле за оценка на SQL (напр. правила за изпълнение, правила за валидиране и т.н.) или в поле на известие (напр. тема, текст на имейла). Parameter_task може да приема следните стойности:

      • ID: идентификатор на екземпляра на задачата
      • STATUS: статус на екземпляра на задачата с код „Task_code“ в екземпляра на работния поток
        • -1 = неуспех
        • 0 = в ход
        • 1 = успех
        • 4 = на пауза
        • 5 = нужда от информация
        • 6 = блокиран
        • 7 = спрян
      • STARTDATE: начална дата на екземпляра на задачата
      • ENDDATE: крайна дата на екземпляра на задачата
      • LASTEVENTDATE: дата на последното събитие на ниво екземпляр на задачата
      • DEROGATED: ID на лицето, на което е делегирана задачата
    • Можете да създавате връзки за автоматично валидиране в текста на имейл, когато известието е конфигурирано в действие или задача за валидиране: http://[DNS address]/UserRequestWorkflow.aspx? MyActionId={#ACTION#Action_or_task_code#ID#}&accept=[result]
      • DNS address трябва да се замени с адреса на сървъра Identity
      • Action_or_task_code трябва да се замени с кода на действието или задачата, която трябва да бъде валидирана чрез връзката
      • Result: въведете 1, за да валидирате действието или задачата, или 0, за да ги отхвърлите.

    За да конфигурирате връзката в текста на имейла, използвайте бутона „type:inline“, с който можете да проверите адреса и текста, които ще се показват в имейла.

    Забележка: за да валидира или отхвърли заявка в имейл с известие, потребителят трябва да влезе в интерфейса, за да потвърди, че има правата за извършване на тази операция.

    • FORM#: ключова дума, която може да се използва само в работни потоци от тип „User Request“ или в задачи за ръчно осигуряване/премахване на осигуряването, в правилата за оценка на SQL на стъпките за действия и задачи или в известия.

      • FORM#ADDRIGHTS#CODELIST#: позволява да изброите правата, които заявителят е избрал във формуляра за заявка за права.

      • FORM#CHANGEATTRIBUTES#parameter_form#: изброява атрибутите, които заявителят е променил във формуляра за промяна на лице. parameter_form може да приема следните стойности:

        • CODELIST: списък с кодовете на атрибутите, които заявителят е променил във формуляра за промяна на лице.
        • CHANGEDATE: дата, на която промените се вземат предвид, във формат dd/MM/yyyy

      • FORM#TYPERESOURCES#parameter_form#: извлича списъка с типовете ресурси, избрани при попълването на формуляра за заявка. parameter_form може да приема следните стойности:

        • DATA: ID на ресурсите
        • DATA.CODE: код на ресурсите
        • DATA.NAME: име на ресурсите

      • FORM#Validation_task_code#parameter_form#:

        • DATA: позволява да извлечете в текста на имейла всички акаунти и права по целево приложение.
        • DATA.PROVISIONINGRIGHTONLY: позволява изпълнението на задача за валидиране на формуляр и/или задача за ръчно осигуряване да се обвърже с условието целите вече да имат акаунт в хранилищата, засегнати от заявката.
        • DATA.UNPROVISIONINGRIGHTONLY: позволява изпълнението на задача за валидиране на формуляр и/или задача за ръчно премахване на осигуряването да се обвърже с условието целите вече да имат акаунт в хранилищата, засегнати от заявката.
        • DATA.PROVISIONINGACCOUNTONLY: позволява изпълнението на задача за валидиране на формуляр и/или задача за ръчно осигуряване да се обвърже с условието целите да нямат акаунт в хранилищата, засегнати от заявката.
        • DATA.UNPROVISIONINGACCOUNTONLY: позволява изпълнението на задача за валидиране на формуляр и/или задача за ръчно премахване на осигуряването да се обвърже с условието целите да нямат акаунт в хранилищата, засегнати от заявката.

    • TASKFORM#: ключова дума, която може да се използва само в задачи на работни потоци от следните типове: присвояване на ресурси и ръчно осигуряване/премахване на осигуряването

      • TASKFORM#Task_code#fparameter_form#: позволява да извлечете данните, посочени в „parameter_form“, от ресурс или от право. Тази ключова дума трябва да се използва в текста на имейл, за да се покаже резултатът във вид на таблица. parameter_form може да приема следните стойности:

        • DATA: ID на заявените ресурси, ако задачата е от тип „Resource assignment“, или ID на правата, които трябва да бъдат осигурени или чието осигуряване трябва да бъде премахнато, ако задачата е от тип „Manual provisioning/deprovisioning“.
        • DATA.CODE: код на заявените ресурси, ако задачата е от тип „Resource assignment“, или код на правата, които трябва да бъдат осигурени или чието осигуряване трябва да бъде премахнато, ако задачата е от тип „Manual provisioning/deprovisioning“.
        • DATA.NAME: име на заявените ресурси, ако задачата е от тип „Resource assignment“, или име на правата, които трябва да бъдат осигурени или чието осигуряване трябва да бъде премахнато, ако задачата е от тип „manual provisioning/deprovisioning“.
        • DATA.FIELDS: стойности на допълнителните полета във формуляра за заявка. Валидно само ако задачата е от тип „manual provisioning/deprovisioning“.
        • DATACOMPLETEONLY: ID на ресурсите, действително присвоени в задачата от тип „Resource Assignment“. Валидно само ако задачата е от тип „Resource Assignment“.
        • DATACOMPLETEONLY.CODE: код на ресурсите, действително присвоени в задачата от тип „Resource Assignment“. Валидно само ако задачата е от тип „Resource Assignment“.
        • DATACOMPLETEONLY.NAME: име на ресурсите, действително присвоени в задачата от тип „Resource Assignment“. Валидно само ако задачата е от тип „Resource Assignment“.
        • DATAINCOMPLETE: ID на типовете ресурси, на които не са присвоени ресурси. Валидно само ако задачата е от тип „Resource Assignment“.
        • DATAINCOMPLETE.CODE: код на типовете ресурси, на които не са присвоени ресурси. Валидно само ако задачата е от тип „Resource Assignment“.
        • DATAINCOMPLETE.NAME: име на типовете ресурси, на които не са присвоени ресурси. Валидно само ако задачата е от тип „Resource Assignment“.

    • MANAGER#: мениджърът на работния поток е лицето, което администрира работния поток.

      • MANAGER#ATTRIBUTE#attribute_code#: позволява да вмъкнете информация за екземпляра на действието в поле за оценка на SQL (напр. правила за изпълнение, за валидиране и т.н.) или в оценявано поле (напр. получатели, тема, текст на имейла).

      • MANAGER#RIGHT#<Account_Type_Code.Right_Code>#: позволява да проверите дали мениджърът на работния поток има правото, чийто код е посочен в параметъра „Right_Code“ и което е свързано с типа акаунт, чийто код е посочен в параметъра „Account_Type_Code“.

      • MANAGER#RIGHTHEO#<Account_Type_Code.Right_Code>#: позволява да проверите дали мениджърът на работния поток теоретично има правото, чийто код е посочен в параметъра „Right_Code“ и което е свързано с типа акаунт, чийто код е посочен в параметъра „Account_Type_Code“.

    • POSSIBLEACTIONACTOR#: лица, които могат да изпълнят действие

      • POSSIBLEACTIONACTOR#Action_code#attribute_code#: позволява да извлечете стойността на атрибута, чийто код е подаден в параметъра attribute_code, за възможните участници в екземпляра на действие или задача, чийто код е равен на „action_code“. Може да се използва в поле за оценка на SQL (напр. правила за изпълнение, правила за валидиране и т.н.) или в поле на известие (напр. получатели, тема, текст на имейла).

    • STARTER#: лице, което стартира работен поток

      • STARTER#ATTRIBUTE#attribute_code#: позволява да извлечете стойността на атрибута, чийто код е подаден в параметъра attribute_code, за лицето, което е стартирало работния поток. Може да се използва в поле за оценка на SQL (напр. правила за изпълнение, правила за валидиране и т.н.) или в поле на известие (напр. тема, текст на имейла).

      • STARTER#RIGHT#<AccountTypeCode.RightCode>#: позволява да проверите дали заявителят на работния поток има правото, чийто код е посочен в параметъра „Right_Code“ и което е свързано с типа акаунт, чийто код е посочен в параметъра „Account_Type_Code“.

      • STARTER#RIGHTHEO#<Account_Type_Code.Right_Code>#: позволява да проверите дали заявителят на работния поток теоретично има правото, чийто код е посочен в параметъра „Right_Code“ и което е свързано с типа акаунт, чийто код е посочен в параметъра „Account_Type_Code“.

    • TARGET#: обект(и), които стартират екземпляр на работен поток

      • TARGET#ATTRIBUTE#attribute_code#: позволява да извлечете стойността на атрибута, чийто код е подаден в параметъра attribute_code, в обекта, който е стартирал работния поток. Може да се използва в поле за оценка на SQL (напр. правила за изпълнение, правила за валидиране и т.н.) или в поле на известие (напр. тема, текст на имейла). Тази ключова дума работи само когато целта е от тип лице или предоставяне.

      • TARGET#RIGHT#<AccountTypeCode.RightCode>#: позволява да проверите дали целта или целите на работния поток имат правото, чийто код е посочен в параметъра „Right_Code“ и което е свързано с типа акаунт, чийто код е посочен в параметъра „Account_Type_Code“. Тази ключова дума работи само когато целта е от тип лице.

      • TARGET#RIGHTTHEO#<AccountTypeCode.RightCode>#: позволява да проверите дали целта или целите на работния поток теоретично имат правото, чийто код е посочен в параметъра „Right_Code“ и което е свързано с типа акаунт, чийто код е посочен в параметъра „Account_Type_Code“. Тази ключова дума работи само когато целта е от тип лице.

      • TARGET#RESOURCE#DATA#: позволява да извлечете в текста на имейла всички данни (стойностите на всички атрибути) от всички ресурси, свързани с целите на екземпляр на работен поток.

        • TARGET#RESOURCE#DATA@CodeAtt1,CodeAtt2,CodeAttN#: позволява да извлечете в текста на имейла стойностите на атрибутите, избрани чрез списъка с кодове на атрибути CodeAttN, от всички ресурси, свързани с целите на екземпляр на работен поток. Атрибутите „name“ и „code“ се показват по подразбиране в текста на имейла, без да е необходимо да се добавят към списъка.

        • TARGET#RESOURCE#DATA.CodeTypeResource1,CodeTypeResource2,CodeTypeResourceN#: позволява да извлечете в текста на имейла стойностите на всички атрибути на типовете ресурси, избрани чрез списъка с кодове на типове ресурси CodeTypeResourceN, свързани с целите на екземпляр на работен поток.

        • TARGET#RESOURCE#DATA.CodeTypeResource1,CodeTypeResourceN@CodeAtt1,CodeAtt2,CodeAttN#: позволява да извлечете следните стойности в текста на имейла:

          • Или всички атрибути на типовете ресурси, избрани чрез списъка с кодове на атрибути CodeTypeResourceN, свързани с целите на екземпляр на работен поток на атрибути от тип ресурс, ако не е зададен код на атрибут
          • Или стойностите на атрибутите, избрани чрез списъка с кодове на атрибути за типовете ресурси, избрани чрез списъка с кодове на типове ресурси CodeTypeResourceN, свързани с целите на екземпляр на работен поток, ако са зададени кодове на атрибути CodeAttN.

        • TARGET#RESOURCE#DATA.CodeTypeResource1,CodeTypeResource2,CodeTypeResourceN#: позволява да извлечете в текста на имейла стойностите на всички атрибути на типовете ресурси, избрани чрез списъка с кодове на типове ресурси CodeTypeResourceN, свързани с целите на екземпляр на работен поток.

      • TARGET#ACCOUNT#: ключова дума, която може да се използва в работни потоци, задействани от събития, свързани със създаването на реален акаунт.

        • TARGET#ACCOUNT#LOGIN#: позволява да извлечете името за вход на акаунта в текста на имейла.

        • TARGET#ACCOUNT#PASSWORD#: позволява да извлечете паролата на акаунта (като обикновен текст) в текста на имейла.

        • TARGET#ACCOUNT#STATUS#: позволява да извлечете статуса на осигуряване на акаунта в текста на имейла.

        • TARGET#ACCOUNT#DATA#: позволява да извлечете името за вход, паролата и статуса в текста на имейла.

    • PRIMARYTARGET# и #SECONDARYTARGET#: ключова дума, която може да се използва само в работни потоци от тип „On event“

      • PRIMARYTARGET#ATTRIBUTE#secondary_parameter# или #SECONDARYTARGET#ATTRIBUTE#secondary_parameter#: позволява да извлечете стойността на обект в основната или вторичната цел на екземпляр на работен поток, чието свойство е подадено в параметъра secondary_parameter. Тази ключова дума работи само когато целта е от следния тип:

        • Identity: в този случай вторичният параметър ще бъде код на атрибут.
        • Right: в този случай вторичният параметър може да приема следните стойности:
          • Name: име на правото
          • Description: описание на правото
          • Code: код на правото
          • Applicationname: име на приложението, свързано с правото
          • Applicationdescription: описание на приложението, свързано с правото
          • Applicationcode: код на приложението, свързано с правото
          • ismanualprovisioning: булева стойност, която показва дали правото е част от хранилище с ръчно осигуряване.

      • PRIMARYTARGET#TYPE#secondary_parameter# или #SECONDARYTARGET#TYPE#secondary_parameter#: позволява да извлечете информация за типа обект, съответстващ на основната или вторичната цел на екземпляр на работен поток. Тази ключова дума работи само когато целта е от тип лице или предоставяне. secondary_parameter може да приема следните стойности:

        • NAME: име на типа лице или предоставяне
        • CODE: код на типа лице или предоставяне
        • DESCRIPTION: описание на типа лице или предоставяне

      • PRIMARYTARGET#ACCOUNT#secondary_parameter# или #SECONDARYTARGET#ACCOUNT#secondary_parameter#: позволява да извлечете информация за акаунта, съответстващ на основната или вторичната цел на екземпляр на работен поток. Тази ключова дума работи само когато целта е от тип акаунт. secondary_parameter може да приема следните стойности:

        • STATUS: статус на създадения реален акаунт
        • LOGIN: име за вход на създадения реален акаунт
        • PASSWORD: парола на създадения реален акаунт
        • DATA: таблица с името за вход и паролата на създадения реален акаунт

Тези две семейства ключови думи могат да се използват заедно в един и същ параметър „SQL Evaluation“, който проверява условието въз основа на входните параметри и връща типовете „TRUE/FALSE“ или „List returned by an SQL evaluation“.

Особености:

  • За всички ключови думи, на които в параметрите може да се подаде код на атрибут, за да се извлече стойността му, за атрибутите от тип изброена стойност, лице, структура или ресурс може да се използва разширение на формата „.object_attribute_code“, за да се извлече стойност на атрибут на обекта вместо ID. За атрибутите от тип структура, лице или предоставяне трябва да въведете кода на желания атрибут на обекта, а за изброените стойности object_attribute_code може да приема следните стойности:
    • NAME: извлича името на изброената стойност
    • CODE: извлича кода на изброената стойност
  • Когато ключовите думи не са достатъчни, за да се вмъкне информация в текста на имейл, може да се използва следният синтаксис за извикване на SQL заявка SELECT:
    • [@@@: <SQL Query>:@@@] : SQL заявката трябва да бъде написана без клаузата „SELECT“. Тя връща низ от знаци.
  • За да въведете информация за целите (лицата, участващи в работния поток), за предпочитане е да използвате ключовата дума §PERSON§ вместо #TARGET#.