Zmienianie wartości kolumn

Każda tablica w monday.com ma jedną lub więcej kolumn. Każda z nich przechowuje określoną informację. Kolumny mają różne typy, a każdy typ wymaga innych parametrów do zaktualizowania wartości.

Wartości kolumn elementu najczęściej trzeba zmienić w dwóch sytuacjach: gdy aktualizujesz wartość elementu za pomocą mutacji change_column_value() lub ustawiasz początkowe wartości elementu za pomocą mutacji create_item().

Formatowanie: JSON a ciągi znaków

Aby zaktualizować wartość kolumny, w mutacji prześlij ciąg znaków w formacie JSON albo zwykły ciąg znaków.

Wszystkie typy kolumn obsługiwane przez nasze API akceptują formatowanie JSON, ale nie wszystkie akceptują również formatowanie String.

Przesyłając dane do konkretnej kolumny, użyj ciągu znaków w formacie JSON. Jeśli korzystasz z JavaScriptu, możesz użyć JSON.stringify(), aby zamienić obiekt JSON na ciąg znaków.

Zmienianie wartości jednej kolumny

Aby zmienić wartość jednej kolumny, użyj metody change_simple_column_value() albo change_column_value().

Wybór metody zależy od typu kolumny, której wartość chcesz zmienić. Niektóre kolumny akceptują tylko wartości JSON, a inne zarówno ciągi znaków (String), jak i wartości JSON.

Zmienianie wartości wielu kolumn

Oprócz zmieniania wartości pojedynczej kolumny możesz zmienić wartości wielu kolumn za pomocą mutacji change_multiple_column_values(). Pozwala ona zaktualizować wartości wielu kolumn konkretnego elementu (wiersza).

Kolumny mają różne typy, a każdy typ wymaga innych parametrów do zaktualizowania wartości.

Argument column_values wymaga ciągu znaków JSON (par klucz–wartość). Kluczami w tym ciągu powinny być identyfikatory kolumn, a wartościami - dane, które chcesz ustawić. Jako wartości możesz podać ciągi znaków (String) albo połączyć wartości String i JSON.

Oto przykład argumentu column_values z kolumną tekstową (Text) i kolumną statusu (Status), w którym użyto wartości String:\
{\"text0\": \"New text\", \"status2\": \"Done\"}.

Oto ten sam przykład argumentu column_values z kolumną tekstową i kolumną statusu, w którym połączono wartości String i JSON:\
{\"text5\": \"New text\", \"status3\": {\"label\": \"Done\"}}.

W drugim przykładzie do kolumny statusu przesyłana jest wartość JSON {\"label\": \"Done\"}, zamiast wartości String „Done”, która została użyta w pierwszym przykładzie.

📘 UWAGA

Kolumny statusu akceptują również wartość JSON z polem "index" (numerycznym identyfikatorem etykiety) zamiast "label". Na przykład: {\"status3\": {\"index\": 1}}. Użycie indeksu jest bardziej niezawodne, ponieważ administratorzy tablic mogą zmienić tekst etykiety. Szczegóły znajdziesz w dokumentacji kolumny statusu.

Ustawianie wartości kolumn podczas tworzenia elementu

Podobnie jak w przypadku ustawiania wartości kolumn za pomocą metod change_column_value(), change_simple_column_value() i change_multiple_column_values(), podczas tworzenia elementu wartości kolumn należy przesłać w formacie JSON.

Usuwanie wartości kolumn

Aby usunąć wartość kolumny (czyli skasować jej bieżącą wartość), prześlij pusty ciąg znaków w przypadku kolumn tekstowych (Text) i liczbowych (Number) albo pusty obiekt w przypadku kolumn akceptujących wartości JSON.

Surowy JSON (użyj go w zmiennych z wartościami kolumn): JSON.stringify({});

Ciąg JSON (użyj go w edytorze GraphiQL): "{}"

mutation {
  change_simple_column_value(item_id: 123456789, board_id: 11223344, column_id: "text", value: "") {
    id
  }
}

mutation {
  change_column_value(item_id: 123456789, board_id: 11223344, column_id: "email", value: "{}") {
    id
  }
}

📘 UWAGA

Aby usunąć wartość z kolumny plików (File), musisz jawnie ustawić flagę clear_all, ponieważ tej czynności nie można cofnąć.

Surowy JSON (użyj go w zmiennych z wartościami kolumn):\ JSON.stringify({ "clear_all": true });

Ciąg JSON (użyj go w edytorze GraphiQL): "{\"clear_all\":true}"

Masz pytania?

Dołącz do naszej społeczności deweloperów! Możesz zadawać pytania i uczyć się od innych użytkowników oraz ekspertów produktowych monday.com.

Zanim utworzysz nowy temat, sprawdź, czy ktoś już o to nie pytał!