Katalog zasobów monday.com zapewnia scentralizowany przegląd zasobów na koncie. Możesz w nim definiować atrybuty, takie jak stanowiska, umiejętności, lokalizacje i kierownicy zasobów, przypisywać je do zasobów oraz filtrować je według tych atrybutów, aby szybko znaleźć odpowiednią osobę do projektu.

🚧 Katalog zasobów jest dostępny tylko w planach Enterprise.

Zapytania

Pobieranie zasobów z katalogu

• 🚧 Dostępne tylko w planach Enterprise
• Zwraca tablicę zawierającą metadane zasobów na koncie
• Można wykonać tylko bezpośrednio w katalogu głównym; nie można zagnieżdżać tego zapytania w innym zapytaniu

query {
  get_directory_resources(limit: 25) {
    resources {
      id
      name
      email
    }
    cursor
    id
  }
}

Przykład: filtrowanie za pomocą query_params

Przekaż ItemsQuery jako query_params. Dla każdej reguły ustaw column_id na atrybut katalogu zasobów, według którego chcesz filtrować, na przykład JOB_ROLE, LOCATION, SKILLS, TEAMS, NAME lub EMAIL. Użyj wartości ItemsQueryRuleOperator, takich jak contains_text lub any_of, razem z compare_value, zgodnie z tymi samymi wzorcami co w filtrach items_page.

Poniższe zapytanie zwraca zasoby, których stanowisko zawiera tekst "Engineer" i których lokalizacja zawiera tekst "London". Górny poziom operator w query_params określa, jak łączyć wiele reguł (and lub or).

query {
  get_directory_resources(
    limit: 25
    query_params: {
      operator: and
      rules: [
        {
          column_id: "JOB_ROLE"
          operator: contains_text
          compare_value: "Engineer"
        }
        {
          column_id: "LOCATION"
          operator: contains_text
          compare_value: "London"
        }
      ]
    }
  ) {
    resources {
      id
      name
      job_role
      location
      skills
    }
    cursor
    id
  }
}

Argumenty

Argument	Typ	Opis
cursor	String	Nieprzezroczysty token reprezentujący pozycję w zbiorze wyników, od której należy pobrać zasoby. Użyj go do stronicowania dużych zbiorów wyników.
limit	Int	Liczba zasobów do pobrania. Domyślna wartość to 25.
query_params	ItemsQuery	Filtruje zasoby katalogu według atrybutów opartych na kolumnach, takich jak stanowisko, umiejętności, lokalizacja i inne atrybuty zasobów.

Pola

Pole	Typ	Opis
cursor	String	Nieprzezroczysty kursor reprezentujący pozycję na liście po ostatnim zwróconym zasobie. Użyj go do stronicowania i pobrania kolejnego zestawu zasobów. Jeśli kursor ma wartość null, nie ma więcej zasobów do pobrania.
id	ID!	Unikatowy identyfikator zasobu w katalogu.
resources	[DirectoryResource!]!	Zasoby z katalogu.

Mutacje

• 🚧 Dostępne tylko w planach Enterprise

Aktualizowanie atrybutów zasobów w katalogu

Aktualizuje atrybuty zasobów na koncie. Zwraca UpdateDirectoryResourceAttributesResponse.

mutation {
  update_directory_resources_attributes(
    attribute: SKILLS
    values: ["React", "JavaScript"]
    resource_ids: [12345, 54321]
  ) {
    success
  }
}

Argumenty

Argument	Typ	Opis	Wartości wyliczeniowe
attribute	DirectoryResourceAttribute!	Typ atrybutu lub atrybutów do zaktualizowania.	JOB_ROLE LOCATION SKILLS
resource_ids	[ID!]!	Unikatowe identyfikatory zasobów do zaktualizowania. Wykonaj zapytanie get_directory_resources, aby pobrać identyfikatory.
values	[String!]!	Nowe wartości atrybutu lub atrybutów zasobu. Atrybut musi już istnieć, w przeciwnym razie żądanie zakończy się niepowodzeniem.