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
  }
}
Positionering van Kopieën

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).
Vereiste Machtigingen

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 todoId
  • TODO_LIST_NOT_FOUND: Ongeldige of ontoegankelijke todoListId
  • FORBIDDEN: 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.

AI Assistent

Antwoorden worden gegenereerd met behulp van AI en kunnen fouten bevatten.

Hoe kan ik u helpen?

Vraag me alles over Blue of deze documentatie.

Voer in om te verzenden • Shift+Enter voor nieuwe regel • ⌘I om te openen