Filtruj wyszukiwanie elementów według przypisanej osoby, zespołu, statusu, tagu i osoby tworzącej

Pole items w API wyszukiwania obsługuje teraz pięć opcjonalnych argumentów filtrowania. Dzięki nim możesz zawęzić wyniki wyszukiwania elementów według osób powiązanych z elementem i sposobu jego oznaczenia, a nie tylko według tablicy, obszaru roboczego i zakresu dat:

• person_ids: elementy, do których przypisano co najmniej jeden z podanych identyfikatorów użytkowników w dowolnej kolumnie osób.
• team_ids: elementy, do których przypisano co najmniej jeden z podanych identyfikatorów zespołów w dowolnej kolumnie osób.
• status_labels: elementy, w których dowolna kolumna statusu ma jedną z podanych etykiet. Etykiety muszą być zgodne z całą nazwą, bez uwzględniania wielkości liter.
• tag_names: elementy oznaczone co najmniej jednym z podanych tagów, na przykład bug. Nazwy muszą być zgodne z całą nazwą, bez uwzględniania wielkości liter. Początkowy znak # jest ignorowany.
• creator_ids: elementy utworzone przez co najmniej jednego z podanych użytkowników.

W obrębie jednej listy wartości są alternatywne - wystarczy, że pasuje jedna z nich. Jeśli podasz kilka filtrów, element musi spełniać je wszystkie. Filtry osób, statusu i tagów sprawdzają wszystkie kolumny danego typu w elemencie, a nie jedną konkretną kolumnę. Obowiązują limity: łącznie maksymalnie 50 unikalnych identyfikatorów w person_ids i team_ids, a także maksymalnie 10 etykiet w status_labels i 10 nazw w tag_names; każda z nich może mieć maksymalnie 64 znaki.

Te argumenty są opcjonalne, więc dotychczasowe zapytania nadal będą działać bez zmian.

query {
  search {
    items(
      query: "launch plan"
      person_ids: [12345678]
      status_labels: ["Working on it", "Stuck"]
      tag_names: ["q1"]
    ) {
      results {
        id
        live_data {
          id
          name
        }
      }
    }
  }
}

Przeczytaj przewodnik Wyszukiwanie w całym koncie, aby poznać sposoby filtrowania.