Assign Task¶
Akce Assign Task vytváří úkoly v seznamu úkolů workflow a přiřazuje je zadaným uživatelům. Slouží jako hlavní mechanismus pro zapojení uživatelů do schvalovacích a rozhodovacích procesů.
Vlastnosti¶
| Vlastnost | Popis | Hodnota / Komentář |
|---|---|---|
| UserData | Uživatelé, kterým bude úkol přiřazen. Podporuje tokeny. Více uživatelů se odděluje středníkem. | {item:Approver} |
| UserSourceType | Zdroj uživatelů pro přiřazení. | Static / RuleMatrix |
| AssignType | Způsob přiřazení úkolů více uživatelům. | Parallel / Serial |
| MatrixList | Název seznamu s rozhodovací maticí. Použije se při UserSourceType = RuleMatrix. Pokud není zadán, hledá se hierarchicky (workflow, globální konfigurace, výchozí název). |
ApprovalMatrix |
| MultiTaskMode | Způsob vyhodnocení výsledků při více úkolech. | AllEqualTo / FirstApplies / Any / NeverEnding |
| RefState | Stav workflow, do kterého se přejde při splnění podmínky MultiTaskMode. Podporuje tokeny. |
Approved |
| FallState | Stav workflow, do kterého se přejde při nesplnění podmínky MultiTaskMode. Podporuje tokeny. |
Rejected |
| NoUserState | Stav workflow, do kterého se přejde, pokud nebyl nalezen žádný uživatel. Pokud není zadán a uživatel chybí, akce vyhodí chybu. | NoApprover |
| Title | Titulek úkolu. Podporuje tokeny. | Schválení dokumentu {item:Title} |
| Body | Tělo (popis) úkolu. Podporuje tokeny. | Prosím schvalte dokument. |
| TaskTemplate | Název textové šablony pro titulek a tělo úkolu. Pokud je zadán, přepíše hodnoty Title a Body. Podporuje tokeny. |
ApprovalTaskTemplate |
| DefaultSelectedState | Předvolený výsledek (outcome) na formuláři úkolu. Pokud je prázdný, uživatel musí výsledek zvolit před odesláním. | Approved |
| ReadOnlyItemForm | Formulář souvisejícího položky na formuláři úkolu bude pouze pro čtení. | Vypnuto / Zapnuto |
| DueDays | Počet dní do termínu splnění úkolu (od vytvoření). Hodnota -1 znamená bez termínu. Podporuje tokeny. |
7 |
| RemindDays | Počet dní do připomenutí. Pokud není zadán, použije se hodnota DueDays. Hodnota -1 znamená bez připomenutí. Podporuje tokeny. |
5 |
| EnableWorkDays | Termín splnění a připomenutí se počítá v pracovních dnech. | Vypnuto / Zapnuto |
| SendNotificationEmail | Odeslat e-mailové oznámení o přiřazení úkolu. Hierarchická vlastnost. | Vypnuto / Zapnuto |
| SendCancelNotificationEmail | Odeslat e-mailové oznámení o zrušení úkolu. Funguje pouze pokud je SendNotificationEmail zapnuto. Hierarchická vlastnost. |
Vypnuto / Zapnuto |
| MailTemplate | Název e-mailové šablony pro oznámení. Podporuje tokeny. | TaskNotification |
| EmailSubject | Předmět e-mailu oznámení. Tokeny se v této vlastnosti nenahrazují automaticky — nahrazují se až při odeslání. | Nový úkol: {item:Title} |
| EmailBody | Tělo e-mailu oznámení. Tokeny se v této vlastnosti nenahrazují automaticky — nahrazují se až při odeslání. | — |
| OutcomeMode | Způsob zobrazení výsledků (outcomes) na formuláři úkolu. Hierarchická vlastnost. | RadioButtons / DropDown / Buttons |
| Sync | Povolení synchronního dokončení úkolu. | Vypnuto / Zapnuto |
| IsQuestionAllowed | Povolení funkce doplňujícího dotazu z formuláře úkolu. | Vypnuto / Zapnuto |
| QuestionWorkflow | Interní název workflow pro doplňující dotaz. Hierarchická vlastnost. | QuestionWF |
| IsAdditionalApprovalAllowed | Povolení dodatečného schválení z formuláře úkolu. | Vypnuto / Zapnuto |
| AdditionalApprovalWorkflow | Interní název workflow pro dodatečné schválení. Hierarchická vlastnost. | AdditionalApprovalWF |
| IsDelegationAllowed | Povolení delegace úkolu na jiného uživatele. Hierarchická vlastnost. | Vypnuto / Zapnuto |
| DelegationAllowedUsers | Omezení seznamu uživatelů, na které lze úkol delegovat. Podporuje tokeny. | user1@contoso.com;user2@contoso.com |
| IsOutOfOfficeAllowed | Povolení automatické delegace na zastupujícího uživatele (out of office). Hierarchická vlastnost. Funguje pouze při paralelním přiřazení (AssignType = Parallel). |
Vypnuto / Zapnuto |
| IsSavingItemAllowed | Povolení uložení položky bez dokončení úkolu. Hierarchická vlastnost. | Vypnuto / Zapnuto |
| MultipleApprovalTransition | Interní název přechodu (transition) pro hromadné schválení. Podporuje tokeny. | Approve |
| BulkApprovalFormTemplate | Šablona formuláře pro hromadné schválení. Použije se pouze pokud MultipleApprovalTransition není zadán. Podporuje tokeny. |
BulkApprovalForm |
| AssignTaskItemPermissionLevel | Úroveň oprávnění, která se nastaví na položce workflow pro uživatele, kterému je úkol přiřazen. Hierarchická vlastnost. Podporuje tokeny. | Contribute |
| Label | Popisný štítek zobrazený v editoru akcí. | — |
| Disabled | Pokud je akce deaktivována, její vykonání se přeskočí. | Vypnuto / Zapnuto |
Události¶
Akce Assign Task podporuje vnořené akce, které se spouští při konkrétních událostech:
| Událost | Popis |
|---|---|
| OnAssignTask | Akce provedené při přiřazení úkolu uživateli. |
| OnCompleteTask | Akce provedené při dokončení úkolu uživatelem. |
| OnOverDue | Akce provedené při překročení termínu konkrétního úkolu. |
| OnOverDueGlobal | Akce provedené při překročení termínu na úrovni celého multitasku. |
| OnRemind | Akce provedené při připomenutí úkolu. |
| OnDelegate | Akce provedené při delegaci úkolu na jiného uživatele. |
Zdroj uživatelů¶
Static¶
Uživatelé jsou zadáni přímo ve vlastnosti UserData. Podporuje tokeny a skupiny SharePoint (skupiny se automaticky rozbalí na jednotlivé uživatele).
RuleMatrix¶
Uživatelé se určí z rozhodovací matice uložené v SharePoint seznamu. Název seznamu se určuje hierarchicky:
- Vlastnost
MatrixListakce - Vlastnost
MatrixListworkflow definice - Výchozí název seznamu
Režimy vyhodnocení (MultiTaskMode)¶
| Režim | Popis |
|---|---|
AllEqualTo |
Všechny výsledky musí odpovídat — pokud ano, přejde se do RefState, jinak do FallState. |
FirstApplies |
Výsledek prvního dokončeného úkolu se použije, ostatní úkoly se nezohledňují. |
Any |
Jakýkoli výsledek je považován za úspěšný. |
NeverEnding |
Úkoly se nikdy automaticky neuzavřou. |
Hierarchické vlastnosti¶
Některé vlastnosti (označené jako "Hierarchická vlastnost") se vyhodnocují hierarchicky — hodnota se hledá nejprve na akci, pak na workflow definici a nakonec v globální konfiguraci. To umožňuje nastavit výchozí chování centrálně a přepisovat ho na úrovni konkrétní akce.
Příklady¶
Příklad: Paralelní schválení dvěma uživateli¶
Úkol je přiřazen dvěma uživatelům současně. Workflow pokračuje do stavu Approved pouze pokud oba schválí, jinak přejde do Rejected.
<AssignTask
UserData="{item:Approver1};{item:Approver2}"
AssignType="Parallel"
MultiTaskMode="AllEqualTo"
RefState="Approved"
FallState="Rejected"
Title="Schválení dokumentu {item:Title}"
DueDays="7"
SendNotificationEmail="true" />
Příklad: Sériové schválení s rozhodovací maticí¶
Úkoly se přiřazují postupně uživatelům z rozhodovací matice. Jakmile první uživatel odpoví, jeho výsledek se aplikuje.
<AssignTask
UserSourceType="RuleMatrix"
MatrixList="ApprovalMatrix"
AssignType="Serial"
MultiTaskMode="FirstApplies"
RefState="Approved"
FallState="Rejected"
Title="Schválení faktury {item:InvoiceNumber}"
DueDays="3"
EnableWorkDays="true" />