Eksport tablicy

API platformy udostępnia operację create_board_export, która eksportuje elementy tablicy do pliku CSV. Eksport małych tablic zwykle kończy się przed zwróceniem wyniku operacji. W przypadku większych tablic operacja zwraca zadanie, którego status trzeba sprawdzać. Oba wyniki są zwracane przez to samo wywołanie, więc każdy klient musi obsługiwać oba.

Przebieg eksportu:

1. Wywołaj create_board_export. Operacja zwraca ExportResult, czyli typ sumy: * ExportFile - eksport został już zakończony. Pobierz plik z download_url przed upływem terminu expires_at. * ExportAsyncJob - eksport nadal trwa. Przejdź do kroku 2.
2. Sprawdzaj export_job_status, przekazując job_id zadania, aż status osiągnie wartość końcową - COMPLETED, FAILED lub CANCELLED.
3. Jeśli status to COMPLETED, pobierz plik z download_url przed jego wygaśnięciem. Jeśli status to FAILED, odczytaj failure_reason (a jeśli jest dostępne, także failure_message) z ExportFailureReason.

To, którą ścieżkę otrzymasz, nie jest gwarantowane. Serwer wybiera ExportFile lub ExportAsyncJob w zależności od rozmiaru tablicy i bieżącego obciążenia. Progi mogą się zmienić bez powiadomienia, więc ta sama tablica może dziś zwrócić ExportFile, a jutro ExportAsyncJob. Zawsze obsługuj oba warianty.

Porównanie

Pełne informacje o żądaniach i odpowiedziach dla obu operacji znajdziesz w dokumentacji API eksportu tablicy. Informacje o obiektach wejściowych, typach wyników i wyliczeniach znajdziesz w sekcji Inne typy związane z eksportem tablicy.