Utwórz kopię istniejącego rekordu, zachowując określone elementy danych.
Kopiowanie Rekordu
Aby utworzyć kopię istniejącego rekordu, zachowując określone elementy, użyj mutacji copyTodo:
mutation CopyTodo {
copyTodo(
input: {
title: "new todo"
todoId: "todo-id"
todoListId: "todo-list-id"
options: [
DESCRIPTION
DUE_DATE
CHECKLISTS
ASSIGNEES
TAGS
CUSTOM_FIELDS
COMMENTS
]
}
)
}
Wymagane Nagłówki
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"
Parametry Wejściowe
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
| title | String | Nie | Nowy tytuł dla skopiowanego rekordu (opcjonalnie) |
| todoId | String | Tak | ID rekordu do skopiowania |
| todoListId | String | Tak | ID listy, w której ma być utworzona kopia |
| options | Array | Tak | Elementy danych do skopiowania z oryginalnego rekordu |
Opcje Kopiowania
Tablica options akceptuje te wartości:
| Opcja | Opis |
|---|---|
| DESCRIPTION | Kopiuje opis rekordu |
| DUE_DATE | Kopiuje termin i strefę czasową |
| CHECKLISTS | Kopiuje wszystkie listy kontrolne i ich elementy |
| ASSIGNEES | Kopiuje wszystkich przypisanych użytkowników (filtrowanych według członkostwa w docelowym projekcie) |
| TAGS | Kopiuje wszystkie powiązane tagi |
| CUSTOM_FIELDS | Kopiuje wszystkie wartości pól niestandardowych (w tym załączniki plików) |
| COMMENTS | Kopiuje wszystkie komentarze i odpowiedzi |
Przykład Odpowiedzi
{
"data": {
"copyTodo": true
}
}
Pozycjonowanie Kopii
Skopiowany rekord zostanie domyślnie umieszczony na dole docelowej listy. Aby kontrolować pozycjonowanie, użyj [mutacji przenoszenia rekordu](/api/records/move-record-list).
Skopiowany rekord zostanie domyślnie umieszczony na dole docelowej listy. Aby kontrolować pozycjonowanie, użyj [mutacji przenoszenia rekordu](/api/records/move-record-list).
Wymagane Uprawnienia
Potrzebujesz uprawnień Edytuj (WŁAŚCICIEL, ADMIN, lub CZŁONEK) w obu projektach źródłowym i docelowym. Uwaga: Użytkownicy z rolą CZŁONKA mogą kopiować rekordy tylko w obrębie tego samego projektu. Kopiowanie między projektami wymaga uprawnień ADMIN lub WŁAŚCICIELA. Nieudane kopie zwrócą kod błędu `FORBIDDEN`.
Potrzebujesz uprawnień Edytuj (WŁAŚCICIEL, ADMIN, lub CZŁONEK) w obu projektach źródłowym i docelowym. Uwaga: Użytkownicy z rolą CZŁONKA mogą kopiować rekordy tylko w obrębie tego samego projektu. Kopiowanie między projektami wymaga uprawnień ADMIN lub WŁAŚCICIELA. Nieudane kopie zwrócą kod błędu `FORBIDDEN`.
Obsługa Błędów
Typowe kody błędów dla tej operacji:
TODO_NOT_FOUND: Nieprawidłowe lub niedostępne todoIdTODO_LIST_NOT_FOUND: Nieprawidłowe lub niedostępne todoListIdFORBIDDEN: Niewystarczające uprawnienia lub ograniczenia między projektami
Zobacz Kody Błędów w celu uzyskania pełnej referencji.
Zaawansowane Funkcje
Kopiowanie Między Projektami
Mutacja wspiera kopiowanie rekordów między różnymi projektami z następującymi uwagami:
- WŁAŚCICIEL/ADMIN: Może kopiować rekordy między dowolnymi projektami, do których mają dostęp
- CZŁONEK: Ograniczone do kopiowania tylko w obrębie tego samego projektu
- Filtrowanie Przypisanych: Podczas kopiowania między projektami, przypisani użytkownicy są automatycznie filtrowani, aby uwzględnić tylko tych, którzy mają dostęp do docelowego projektu
Obsługa Pól Niestandardowych
Podczas korzystania z opcji CUSTOM_FIELDS:
- Wszystkie wartości pól niestandardowych są kopiowane do nowego rekordu
- Załączniki plików w polach niestandardowych są odpowiednio duplikowane z nowymi odniesieniami do przechowywania
- Typy pól niestandardowych są zachowywane i weryfikowane w odniesieniu do konfiguracji docelowego projektu
Integracja Automatyzacji
Kopie między projektami mogą wywoływać dodatkowe zasady automatyzacji w obu projektach źródłowym i docelowym, co pozwala na zaawansowane zarządzanie przepływem pracy w ramach granic projektów.