Bogatsze wartości kolumn items_page: podelementy, połączone tablice i twórcy

Zmiana niekompatybilna wstecz. W wersji API 2027-01 pole subitems w wartości kolumny podelementów w zapytaniu items_page (ItemsPageSubtasksValue) zwraca nowy typ ItemsPageSubitem. Wcześniej zwracało typ ItemsPageLinkedItem. Typ ItemsPageSubitem udostępnia pola id i name podelementu.

W tej samej wersji wzbogacono kilka wartości kolumn items_page. Dzięki temu możesz odczytać typowe powiązane dane w tym samym żądaniu, bez wysyłania kolejnych:

• Połączone tablice. Typ ItemsPageLinkedItem ma nowe pole board typu ItemsPageLinkedBoard, które zwraca pola id i name tablicy, do której należy połączony element.
• Twórcy i osoby aktualizujące. Pole creator (typu User) dodano do wartości kolumn plików dla zasobów, dokumentów i linków, do wartości kolumny dziennika utworzenia oraz do typu ItemResult. Typ ItemsPageLastUpdatedValue ma teraz pole updater, wskazujące użytkownika, który ostatnio zaktualizował element.
• Powiązane pliki. Typ ItemsPageFileAssetValue ma teraz pole asset (zasób powiązany z plikiem), a typ ItemsPageFileDocValue - pole doc (dokument powiązany z plikiem).
• Głosujący. Typ ItemsPageVoteValue ma teraz pole voters, zawierające użytkowników, którzy oddali głos.

Przykładowe żądanie:

query {
  items_page(input: { board_id: 1234567890, limit: 25 }) {
    cursor
    items {
      id
      column_values {
        ... on ItemsPageSubtasksValue {
          subitems {
            id
            name
          }
        }
        ... on ItemsPageCreationLogValue {
          creator {
            id
            name
          }
        }
      }
    }
  }
}

Uwagi dotyczące migracji

Żądania, które wybierają dla subitems tylko pola id i name, nadal działają bez zmian. Zaktualizuj kod, jeśli odwołujesz się do starego typu podelementów:

1. Zastąp wszystkie fragmenty inline lub odwołania do typu ItemsPageLinkedItem, których używasz dla subitems, typem ItemsPageSubitem.
2. Jeśli generujesz typy ze schematu, wygeneruj je ponownie. Lista subitems będzie wtedy typowana jako ItemsPageSubitem.
3. ItemsPageSubitem zawiera tylko pola id i name. Jeśli korzystasz z innych pól starego typu podelementów, takich jak nowe pole board w ItemsPageLinkedItem, nie będą one dostępne dla podelementów.