Set Field Value¶
Akce Set Field Value nastaví hodnotu pole (sloupce) na položce SharePoint seznamu. Může pracovat s kontextovou položkou workflow nebo s jinou položkou určenou pomocí ID, URL nebo CAML dotazu.
Vlastnosti¶
| Vlastnost | Popis | Hodnota / Komentář |
|---|---|---|
| TargetField | Interní název cílového pole. [Povinné] | Status |
| Value | Nová hodnota pole. Podporuje tokeny. | {wf:initiator} |
| ItemId | ID cílové položky. Podporuje tokeny. Pokud není zadáno, použije se kontextová položka. | {var:TargetItemId} |
| List | Název nebo GUID seznamu cílové položky. Podporuje tokeny. | Documents |
| ItemUrl | URL cílové položky. Podporuje tokeny. | — |
| CAML | CAML dotaz pro vyhledání cílové položky. Podporuje tokeny. | — |
| Recursive | Rekurzivní nastavení hodnoty na všechny podpoložky (při práci se složkou). | Vypnuto / Zapnuto |
| Scope | Rozsah CAML dotazu. | Default / Recursive / RecursiveAll / FilesOnly |
| ItemBehavior | Chování při nenalezení položky. | Default / ThrowError / Ignore |
| Label | Popisný štítek zobrazený v editoru akcí. | — |
| Disabled | Pokud je akce deaktivována, její vykonání se přeskočí. | Vypnuto / Zapnuto |
Chování¶
Pokud pole TargetField na položce neexistuje, akce skončí chybou. Hodnota se před zápisem zpracuje tokenovou substitucí.
Při práci s kontextovou položkou se změna neuloží ihned — uloží se společně s ostatními změnami na konci zpracování akcí. Při práci s jinou položkou se změna uloží okamžitě.
Příklady¶
Příklad: Nastavení stavu na kontextové položce¶
<SetFieldValue TargetField="Status" Value="Schváleno" />
Příklad: Nastavení pole na jiné položce¶
<SetFieldValue
TargetField="ApprovedBy"
Value="{wf:initiator}"
ItemId="{var:RelatedItemId}"
List="Protokoly" />
Příklad: Rekurzivní nastavení na podpoložky složky¶
<SetFieldValue
TargetField="Department"
Value="{item:Department}"
Recursive="true" />