Copy Item¶
Akce Copy Item zkopíruje položku (soubor nebo složku) na jiné místo v rámci SharePoint. Na rozdíl od akce Move Item ponechá původní položku na místě.
Vlastnosti¶
| Vlastnost | Popis | Hodnota / Komentář |
|---|---|---|
| ItemId | ID položky ke kopírování. Podporuje tokeny. Pokud není zadáno, použije se kontextová položka. | {var:FileId} |
| List | Název nebo GUID zdrojového seznamu. Podporuje tokeny. | Documents |
| ItemUrl | URL položky ke kopírování. Podporuje tokeny. | — |
| CAML | CAML dotaz pro vyhledání položky. Podporuje tokeny. | — |
| Destination | Cílová cesta pro kopii. Význam závisí na DestinationType. Podporuje tokeny. |
Backup/2024 |
| DestinationType | Typ cílové cesty. | ListRelativeUrl / WebRelativeUrl / ServerRelativeUrl |
| Expression | JavaScript výraz, jehož výsledek se použije jako hodnota Destination. |
— |
| FileName | Nový název souboru. Podporuje tokeny. Pokud není zadán, zachová se původní název. | — |
| Overwrite | Přepsat existující soubor v cílovém umístění. Pokud je Vypnuto a soubor existuje, přidá se číselná přípona. |
Vypnuto / Zapnuto |
| CopySystemFields | Systémová pole, která se mají zkopírovat. Hodnoty se oddělují čárkou, středníkem nebo mezerou. Možné hodnoty: Author (a), Created (c), Editor (e), Modified (m). |
Author,Created |
| CopyOnlyFileData | Kopírovat pouze binární data souboru (bez metadat). Cílový soubor musí existovat. | Vypnuto / Zapnuto |
| TargetVariable | Název workflow proměnné, do které se uloží výsledná cílová cesta. | CopiedFilePath |
| ItemBehavior | Chování při nenalezení položky. | Default / ThrowError / Ignore |
| Scope | Rozsah CAML dotazu. | Default / Recursive / RecursiveAll / FilesOnly |
| Label | Popisný štítek zobrazený v editoru akcí. | — |
| Disabled | Pokud je akce deaktivována, její vykonání se přeskočí. | Vypnuto / Zapnuto |
Chování¶
Po zkopírování se na cílovou položku přenesou metadata (hodnoty polí) ze zdrojové položky. Pole, která v cílovém seznamu neexistují, se přeskočí. Systémová pole (Author, Created, Editor, Modified) se kopírují pouze pokud je to explicitně nastaveno ve vlastnosti CopySystemFields.
Při CopyOnlyFileData = Zapnuto se přepíší pouze binární data souboru — metadata cílového souboru zůstanou beze změny.
Příklady¶
Příklad: Kopírování dokumentu do zálohy¶
<CopyItem
Destination="Backup"
DestinationType="ListRelativeUrl"
Overwrite="true"
CopySystemFields="Author,Created" />
Příklad: Kopírování do jiné knihovny s přejmenováním¶
<CopyItem
Destination="/sites/archive/SharedDocuments"
DestinationType="ServerRelativeUrl"
FileName="COPY_{item:FileLeafRef}"
TargetVariable="BackupPath" />