ExportAsyncJob

Zwracany przez create_board_export. Odpytuj export_job_status, przekazując job_id zadania, aż jego status zmieni się na COMPLETED, FAILED lub CANCELLED.

Pole	Typ	Opis
job_id	ID	Nieprzezroczysty identyfikator zadania eksportu. Przekaż go do export_job_status, aby sprawdzić wynik.

---

ExportFile

Ukończony eksport tablicy, gotowy do pobrania. Zwracany jako jedna z gałęzi ExportResult, gdy eksport zakończył się w czasie obsługi synchronicznej.

Pole	Typ	Opis
download_url	String	Wstępnie podpisany URL do pobrania wyeksportowanego pliku. Traktuj go jak poufną informację - każda osoba, która go ma, może pobrać plik, dopóki URL nie wygaśnie.
expires_at	String	Data i godzina, po których download_url przestanie działać, w formacie znacznika czasu ISO 8601. Tego URL-a nie można odświeżyć. Aby uzyskać nowy, ponownie wywołaj mutację.

---

CreateBoardExportOptionsInput

Opcjonalna konfiguracja eksportu przekazywana do create_board_export. Wszystkie pola są opcjonalne. Jeśli pominiesz cały obiekt, tablica zostanie wyeksportowana z domyślnymi ustawieniami podanymi poniżej.

Pole	Typ	Domyślna wartość	Opis
include_subitems	Boolean	false	Uwzględnij podelementy w eksporcie.
include_item_identifiers	Boolean	false	Dodaj item_id - a gdy include_subitems ma wartość true, także parent_item_id - jako ostatnie kolumny. Pozwala dopasować wyeksportowane wiersze do elementów.
header_row	HeaderFormat	COLUMN_ID	Określa, czy w wierszu nagłówka mają być użyte tytuły kolumn, czy ich identyfikatory. Jeśli nie podasz tej wartości, domyślnie używane jest COLUMN_ID.
people_column_format	PeopleColumnFormat	-	Format wartości w kolumnie osób. Pomiń to pole, aby zachować surowy format identyfikatorów.
connected_item_column_format	ConnectedItemColumnFormat	NAME	Określa, czy połączone elementy (kolumna Połącz tablice (Connect boards)) mają być wyświetlane jako nazwy, czy identyfikatory.
columns_order	[String!]	-	Identyfikatory kolumn w kolejności, w jakiej mają pojawić się w pliku. Ta opcja również filtruje kolumny - zobacz uwagę poniżej. Pomiń ją, aby wyeksportować wszystkie kolumny w kolejności z tablicy.
include_project_board_link	Boolean	-	Dodaj na końcu kolumnę Project Board z identyfikatorem tablicy projektu połączonej z każdym wierszem przez kolumnę łącza projektu portfolio (portfolio_project_link). Zwracany jest identyfikator tablicy pierwszego połączonego projektu. Jeśli wiersz nie ma połączonego projektu, pole pozostaje puste. Ta opcja jest ignorowana w przypadku formatów innych niż CSV oraz gdy nie jest dostępna na koncie. Dostępne tylko w wersjach 2027-01 i nowszych.

---

ExportResult

Unia zwracana przez create_board_export. Zawiera ukończony eksport, który można od razu pobrać, albo odwołanie do nadal działającego zadania.

union ExportResult = ExportAsyncJob | ExportFile

Serwer wybiera zwracany typ na podstawie rozmiaru tablicy i bieżącego obciążenia. Zwracana gałąź nie jest gwarantowana i może się zmienić bez powiadomienia. Zapytanie musi więc obsługiwać oba typy. Wybierz oba typy za pomocą fragmentów inline:

mutation {
  create_board_export(board_id: 1234567890) {
    ... on ExportFile {
      download_url
      expires_at
    }
    ... on ExportAsyncJob {
      job_id
    }
  }
}

Typ	Znaczenie
ExportFile	Eksport jest już gotowy. Od razu użyj download_url.
ExportAsyncJob	Eksport nadal trwa. Odpytuj export_job_status, przekazując job_id, aż status będzie końcowy.

Unia nie zawiera typu błędu. Problemy są zgłaszane jako błąd GraphQL (jeśli żądanie zostanie odrzucone przed rozpoczęciem eksportu) albo jako status FAILED w export_job_status (jeśli eksport nie powiedzie się po rozpoczęciu).

---

HeaderFormat

Format wiersza nagłówka w wyeksportowanym pliku. Używany przez CreateBoardExportOptionsInput.header_row.

Wartość	Opis
TITLE	Użyj tytułów kolumn jako nagłówków. Są czytelne dla ludzi, ale nie są unikatowe i można je zmienić w dowolnym momencie.
COLUMN_ID	Użyj identyfikatorów kolumn jako nagłówków. Są stabilne - wybierz tę opcję, jeśli plik będzie ponownie importowany lub przetwarzany przez skrypt.

---

ConnectedItemColumnFormat

Format wartości w kolumnie połączonych elementów (kolumnie Połącz tablice (Connect boards)). Używany przez CreateBoardExportOptionsInput.connected_item_column_format.

Wartość	Opis
NAME	Użyj nazw wyświetlanych połączonych elementów (np. Task A, Task B). To ustawienie domyślne.
ID	Użyj identyfikatorów połączonych elementów (np. 111, 222). Wybierz tę opcję, jeśli eksportowane dane mają zostać ponownie powiązane z elementami.

---

PeopleColumnFormat

Format wartości w kolumnie osób. Używany przez CreateBoardExportOptionsInput.people_column_format.

Wartość	Opis
NAME	Użyj nazw wyświetlanych (np. Jordan Lee, Marketing Team) zamiast surowego formatu identyfikatorów (np. user:123).

Pomiń tę opcję, aby zachować surowy format identyfikatorów. Wybierz go, jeśli wartości mają zostać przypisane do konkretnych użytkowników lub zespołów.

---

ExportJobStatusInfo

Bieżący stan asynchronicznego zadania eksportu tablicy. Zwracany przez export_job_status.

Pole	Typ	Opis
status	ExportJobStatus	Bieżący status zadania. COMPLETED, FAILED i CANCELLED to statusy końcowe - zakończ odpytywanie po otrzymaniu jednego z nich.
download_url	String	Wstępnie podpisany URL do pobrania. Jest zwracany tylko wtedy, gdy status ma wartość COMPLETED i URL nie wygasł. Po wygaśnięciu jego wartość zmienia się na null. Ponownie uruchom eksport, aby uzyskać nowy URL.
failure_reason	ExportFailureReason	Ustrukturyzowana przyczyna niepowodzenia zadania. Jest zwracana tylko wtedy, gdy status ma wartość FAILED. Wybieraj obsługę na podstawie tego pola, a nie failure_message.
failure_message	String	Czytelny dla człowieka szczegół błędu, jeśli przyczyna niepowodzenia zawiera tekst, który można bezpiecznie wyświetlić. Jest zwracany tylko wtedy, gdy status ma wartość FAILED, i nawet wtedy może mieć wartość null.

Pamiętaj, że ukończone zadanie może zwrócić null w polu download_url, jeśli odpytasz o jego status po wygaśnięciu URL-a. Przed użyciem sprawdź, czy wartość nie jest null.

---

ExportJobStatus

Status cyklu życia asynchronicznego zadania eksportu tablicy. Używany przez ExportJobStatusInfo.status.

Wartość	Końcowy	Opis
RUNNING	Nie	Eksport nadal trwa. Kontynuuj odpytywanie.
COMPLETED	Tak	Eksport zakończył się pomyślnie. Odczytaj download_url.
FAILED	Tak	Eksport nie powiódł się. Odczytaj failure_reason oraz failure_message, jeśli jest dostępne.
CANCELLED	Tak	Eksport został anulowany.

Każdą nierozpoznaną wartość traktuj jako końcową, aby przyszłe rozszerzenie nie spowodowało niekończącego się odpytywania.

---

ExportFailureReason

Ustrukturyzowana przyczyna niepowodzenia asynchronicznego zadania eksportu tablicy. Używana przez ExportJobStatusInfo.failure_reason.

Wartość	Można ponowić	Opis
BOARD_UNAVAILABLE	Nie	Tablica została usunięta lub zarchiwizowana.
BOARD_INACCESSIBLE	Nie	Wywołujący utracił uprawnienia do odczytu tablicy.
ITEM_LIMIT_EXCEEDED	Nie	Liczba elementów na tablicy przekracza limit eksportu.
INVALID_REQUEST	Nie	Żądanie zostało odrzucone podczas weryfikacji - na przykład z powodu nieobsługiwanej kombinacji opcji eksportu. Popraw żądanie przed ponowną próbą.
NOT_FOUND	Nie	Nie udało się znaleźć tablicy lub czegoś, do czego się odwoływała.
INTERNAL_ERROR	Tak	Wystąpił nieoczekiwany błąd wewnętrzny. Ponowne wywołanie mutacji jest uzasadnione.

---

Zobacz też

• Omówienie eksportu tablicy - porównanie eksportu synchronicznego i asynchronicznego
• Dokumentacja API eksportu tablicy - create_board_export i export_job_status