Widoki tablic w monday.com pozwalają wyświetlać dane z tablicy na różne sposoby, za pomocą kolorów, kształtów i wykresów.

Zapytania

Pobieranie widoków

• Zwraca tablicę zawierającą metadane kolekcji widoków tablicy.
• Zapytanie musi być zagnieżdżone w zapytaniu boards.

query {
  boards(
    ids: [1234567890]
    ) {
    views {
      type
      settings_str
      view_specific_data_str
      name
      id
    }
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `query ($board: [ID!]) { boards (ids: $board) { views { id name type } } }`
const variables = {
  board: 1234567
}
const response = await mondayApiClient.request(query, variables);

Argumenty

Argument	Typ	Opis
ids	[ID!]	Identyfikatory konkretnych tablic, których widoki mają zostać zwrócone.
type	String	Typ widoków, które mają zostać zwrócone.

Pola

Pole	Typ	Opis	Wartości wyliczeniowe
access_level	BoardViewAccessLevel!	Poziom dostępu użytkownika do widoku tablicy.	edit view
filter	JSON	Metadane filtrów widoku.
filter_team_id	Int	Identyfikator zespołu, według którego filtrowany jest widok.
filter_user_id	Int	Identyfikator użytkownika, według którego filtrowany jest widok.
id	ID!	Unikalny identyfikator widoku.
name	String!	Nazwa widoku.
settings	JSON	Ustawienia widoku. Ich struktura zależy od typu widoku.
settings_str	String!	Ustawienia widoku.
sort	JSON	Metadane sortowania widoku.
source_view_id	ID	Unikalny identyfikator oryginalnego widoku, na podstawie którego utworzono duplikat, jeśli dotyczy.
tags	[String!]	Tagi widoku.
type	String!	Typ widoku.
view_specific_data_str	String!	Dane specyficzne dla widoku tablicy (obsługiwane tylko w przypadku formularzy).

Mutacje

Wymagany zakres: boards:write

Tworzenie widoku

Tworzy nowy widok tablicy. Zwraca BoardView.

mutation {
  create_view(
    board_id: 1234567890
    type: APP
    name: "My app view"
    settings: {
      app_feature_id: 54321
    }
  ) {
    id
    name
  }
}

{
  "data": {
    "create_view": {
      "id": "9876543210",
      "name": "My app view"
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis	Wartości wyliczeniowe
board_id	ID!	Unikalny identyfikator tablicy.
filter	ItemsQueryGroup	Filtry widoku.
filter_user_id	ID	Identyfikator użytkownika, według którego ma być filtrowany widok.
filter_team_id	ID	Identyfikator zespołu, według którego ma być filtrowany widok.
name	String	Nazwa widoku.
settings	JSON	Ustawienia konfiguracji specyficzne dla typu widoku. Zapytaj o get_view_schema_by_type, aby sprawdzić dostępne właściwości.
sort	[ItemsQueryOrderBy!]	Kolejność sortowania widoku.
tags	[String!]	Tagi widoku.
type	ViewKind!	Typ widoku do utworzenia.	APP DASHBOARD FORM TABLE

Tworzenie widoku tabeli

Tworzy nowy widok tabeli dla tablicy. Zwraca BoardView.

mutation {
  create_view_table(
    board_id: 1234567890
    name: "My new table view"
  ) {
    id
    name
  }
} 

{
  "data": {
    "create_view_table": {
      "id": "9876543210",
      "name": "My new table view"
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis
board_id	ID!	Unikalny identyfikator tablicy.
filter	ItemsQueryGroup	Filtry widoku tabeli.
filter_user_id	ID	Identyfikator użytkownika, według którego ma być filtrowany widok.
filter_team_id	ID	Identyfikator zespołu, według którego ma być filtrowany widok.
name	String	Nazwa widoku tabeli.
settings	TableViewSettingsInput	Ustawienia konfiguracji widoku tabeli.
sort	[ItemsQueryOrderBy!]	Kolejność sortowania widoku tabeli.
tags	[String!]	Tagi widoku tabeli.

Aktualizowanie widoku

Aktualizuje widok tablicy. Zwraca BoardView.

mutation {
  update_view(
    board_id: 1234567890
    view_id: 54321
    sort: {
      column_id: "name"
      direction: asc
    }
    type:TABLE
  ) {
    id
    sort
  }
}

{
  "data": {
    "update_view": {
      "id": "54321",
      "sort": [
        {
          "column_id": "name",
          "direction": "ASC"
        }
      ]
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis	Wartości wyliczeniowe
board_id	ID!	Unikalny identyfikator tablicy.
filter	ItemsQueryGroup	Filtry widoku.
filter_user_id	ID	Identyfikator użytkownika, według którego ma być filtrowany widok.
filter_team_id	ID	Identyfikator zespołu, według którego ma być filtrowany widok.
name	String	Nazwa widoku.
settings	JSON	Ustawienia konfiguracji specyficzne dla typu widoku. Zapytaj o get_view_schema_by_type, aby sprawdzić dostępne właściwości.
sort	[ItemsQueryOrderBy!]	Kolejność sortowania widoku.
tags	[String!]	Tagi widoku.
type	ViewKind!	Typ widoku.	APP DASHBOARD FORM TABLE
view_id	ID!	Unikalny identyfikator widoku.

Aktualizowanie widoku tabeli

Aktualizuje widok tabeli dla tablicy. Zwraca BoardView.

mutation {
  update_view_table(
    board_id: 1234567890
    view_id: 54321
    settings: {
      columns:{
        column_properties:{
          column_id:"date",
          visible: false
        }
      }
    }
  ) {
    id
    sort
  }
}

Argumenty

Argument	Typ	Opis
board_id	ID!	Unikalny identyfikator tablicy.
filter	ItemsQueryGroup	Filtry widoku tabeli.
filter_user_id	ID	Identyfikator użytkownika, według którego ma być filtrowany widok.
filter_team_id	ID	Identyfikator zespołu, według którego ma być filtrowany widok.
name	String	Nazwa widoku tabeli.
settings	TableViewSettingsInput	Ustawienia konfiguracji widoku tabeli.
sort	[ItemsQueryOrderBy!]	Kolejność sortowania widoku tabeli.
tags	[String!]	Tagi widoku tabeli.
view_id	ID!	Unikalny identyfikator widoku.

Usuwanie widoku

Usuwa widok tablicy. Zwraca BoardView.

mutation {
  delete_view(
    board_id: 1234567890
    view_id: 54321
  ) {
    name
  }
}

{
  "data": {
    "delete_view": {
      "name": "Deleted Form"
    }
  },
  "extensions": {
    "request_id": "YOUR_REQUEST_ID"
  }
}

Argumenty

Argument	Typ	Opis
board_id	ID!	Unikalny identyfikator tablicy.
view_id	ID!	Unikalny identyfikator widoku.

Duplikowanie widoku

Tworzy duplikat istniejącego widoku tablicy. Zwraca BoardView.

mutation {
  duplicate_view(
    board_id: 1234567890
    view_id: 54321
  ) {
    id
    name
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });
const query = `mutation ($board: ID!, $view: ID!) { duplicate_view(board_id: $board, view_id: $view) { id name }}`
const variables = {
  board: 1234567890,
  view: 54321
}
const response = await mondayApiClient.request(query, variables);

Argumenty

Argument	Typ	Opis
board_id	ID!	Unikalny identyfikator tablicy.
view_id	ID!	Unikalny identyfikator widoku do zduplikowania.

Przywracanie widoku

Przywraca wcześniej usunięty widok tablicy. Zwraca BoardView.

mutation {
  restore_view(
    board_id: 1234567890
    view_id: 54321
  ) {
    id
    name
  }
}

import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });
const query = `mutation ($board: ID!, $view: ID!) { restore_view(board_id: $board, view_id: $view) { id name }}`
const variables = {
  board: 1234567890,
  view: 54321
}
const response = await mondayApiClient.request(query, variables);

Argumenty

Argument	Typ	Opis
board_id	ID!	Unikalny identyfikator tablicy.
view_id	ID!	Unikalny identyfikator usuniętego widoku do przywrócenia.