Maak een kopie van een bestaand record terwijl specifieke data-elementen behouden blijven.
Een Record Kopiëren
Om een kopie van een bestaand record te maken terwijl specifieke elementen behouden blijven, gebruik de copyTodo
mutatie:
mutation CopyTodo {
copyTodo(
input: {
title: "new todo"
todoId: "todo-id"
todoListId: "todo-list-id"
options: [
DESCRIPTION
DUE_DATE
CHECKLISTS
ASSIGNEES
TAGS
CUSTOM_FIELDS
COMMENTS
]
}
)
}
Vereiste Headers
x-bloo-token-id: "your-token-id"
x-bloo-token-secret: "your-token-secret"
x-bloo-project-id: "project-id-or-slug"
x-bloo-company-id: "company-id-or-slug"
Invoervariabelen
Veld | Type | Vereist | Beschrijving |
---|---|---|---|
title | String | Nee | Nieuwe titel voor het gekopieerde record (optioneel) |
todoId | String | Ja | ID van het te kopiëren record |
todoListId | String | Ja | ID van de lijst waarin de kopie moet worden gemaakt |
options | Array | Ja | Data-elementen om te kopiëren van het originele record |
Kopieeropties
De options
array accepteert deze waarden:
Optie | Beschrijving |
---|---|
DESCRIPTION | Kopieert de beschrijving van het record |
DUE_DATE | Kopieert de vervaldatum en tijdzone |
CHECKLISTS | Kopieert alle checklists en hun items |
ASSIGNEES | Kopieert alle toegewezen gebruikers (gefilterd op lidmaatschap van het doelproject) |
TAGS | Kopieert alle bijbehorende tags |
CUSTOM_FIELDS | Kopieert alle waarden van aangepaste velden (inclusief bestandsbijlagen) |
COMMENTS | Kopieert alle opmerkingen en antwoorden |
Voorbeeld Antwoord
{
"data": {
"copyTodo": true
}
}
Het gekopieerde record wordt standaard onderaan de doel lijst geplaatst. Om de positionering te regelen, gebruik de [mutatie record verplaatsen](/api/records/move-record-list).
Je hebt Bewerken machtigingen (eigenaar, beheerder of lid rol) nodig op zowel de bron- als doelprojecten. Opmerking: Gebruikers met de rol lid kunnen alleen records binnen hetzelfde project kopiëren. Kopiëren tussen projecten vereist beheerders- of eigenaar machtigingen. Mislukte kopieën geven een `FORBIDDEN` foutcode terug.
Foutafhandeling
Veelvoorkomende foutcodes voor deze operatie:
TODO_NOT_FOUND
: Ongeldige of ontoegankelijke todoIdTODO_LIST_NOT_FOUND
: Ongeldige of ontoegankelijke todoListIdFORBIDDEN
: Onvoldoende machtigingen of beperking bij het kopiëren tussen projecten
Zie Foutcodes voor een complete referentie.
Geavanceerde Kenmerken
Kopiëren Tussen Projecten
De mutatie ondersteunt het kopiëren van records tussen verschillende projecten met deze overwegingen:
- EIGENAAR/BEHEERDER: Kan records tussen alle projecten kopiëren waartoe ze toegang hebben
- LID: Beperkt tot kopiëren binnen hetzelfde project
- Toewijzing Filtering: Bij het kopiëren tussen projecten worden toewijzingen automatisch gefilterd om alleen gebruikers op te nemen die toegang hebben tot het doelproject
Verwerking van Aangepaste Velden
Bij het gebruik van de CUSTOM_FIELDS
optie:
- Alle waarden van aangepaste velden worden gekopieerd naar het nieuwe record
- Bestandsbijlagen in aangepaste velden worden correct gedupliceerd met nieuwe opslagreferenties
- Typen aangepaste velden worden behouden en gevalideerd tegen de configuratie van het doelproject
Automatiseringsintegratie
Kopieën tussen projecten kunnen aanvullende automatiseringsregels in zowel de bron- als doelprojecten activeren, waardoor geavanceerd workflowbeheer over projectgrenzen heen mogelijk is.