Import zbiorczy

API platformy udostępnia dwie mutacje do zbiorczego importowania elementów: ingest_items i backfill_items. Obie działają według tego samego asynchronicznego schematu: uruchom zadanie, prześlij plik CSV i sprawdzaj jego status. Są jednak przeznaczone do różnych zastosowań.

Używaj ingest_items do cyklicznych importów oraz takich, które mają przebiegać jak zwykła aktywność na tablicy. Mutacja wywołuje wszystkie standardowe skutki uboczne platformy: uruchamiają się automatyzacje, a każda zmiana jest zapisywana w Dzienniku aktywności (Activity Log). W przypadku standardowego importowania elementów obsługuje też logikę aktualizowania istniejących lub pomijania ich za pomocą on_match.

Używaj backfill_items tylko do zaplanowanego, jednorazowego wstępnego załadowania danych, gdy chcesz zasilić tablicę po cichu, zanim użytkownicy lub automatyzacje zaczną z niej korzystać. Ta mutacja wymaga uprawnień administratora konta, pomija automatyzacje i nie zapisuje zmian w Dzienniku aktywności.

Import zbiorczy obsługuje też importy hierarchii w trybie tworzenia, na tablicach z podelementami. W przypadku tablic z klasycznymi podelementami plik CSV używa sufiksu .subitem do oznaczania nagłówków i wierszy podelementów. W przypadku tablic z wielopoziomowymi podelementami hierarchię elementów nadrzędnych i podrzędnych określają kolumny poziomów od name.l1 do name.l5. Oba formaty plików opisano w przewodniku Importowanie elementów zbiorczo.

Import zbiorczy obsługuje również kolumny relacji między tablicami (Board Relation), z dodatkowymi limitami dotyczącymi poszczególnych komórek i relacji między tablicami. Format wartości w pliku CSV opisano w przewodniku.

Porównanie

Szczegółową instrukcję, która obejmuje format pliku CSV, formaty plików dla klasycznych i wielopoziomowych podelementów, walidację typów kolumn oraz rozwiązywanie problemów, znajdziesz w przewodniku Importowanie elementów zbiorczo.