Dokumentacja dla programistów

Dziennik tworzenia

Aktualizacja 2026-09-06

Kolumna dziennika tworzenia wyświetla osobę, która utworzyła element, oraz datę jego utworzenia. Kolumna wypełnia się automatycznie po utworzeniu elementu i nie można jej modyfikować.

Za pośrednictwem API kolumna dziennika tworzenia obsługuje odczyt i filtrowanie. Nie można jej programowo aktualizować ani czyścić, ponieważ jej wartości są generowane przez system.

Typ kolumny Typ implementacji Obsługiwane operacje
creation_log CreationLogValue
  • Odczyt: tak
  • Filtrowanie: tak
  • Tworzenie: tak (tylko kolumny)
  • Aktualizacja: nie
  • Czyszczenie: nie

Zapytania

Kolumny dziennika tworzenia można odpytywać za pomocą pola column_values w zapytaniach items, używając wbudowanego fragmentu typu CreationLogValue.

query {
  items(ids: [1234567890, 9876543210]) {
    column_values {
      ... on CreationLogValue {
        id
        text
        value
        created_at
        creator_id
        creator {
          id
          name
          email
        }
      }
    }
  }
}
const query = `
  query ($itemIds: [ID!]) {
    items(ids: $itemIds) {
      column_values {
        ... on CreationLogValue {
          id
          text
          value
          created_at
          creator_id
          creator {
            id
            name
            email
          }
        }
      }
    }
  }
`;

const variables = { itemIds: [1234567890, 9876543210] };

const response = await mondayApiClient.request(query, variables);

Pola

Możesz użyć poniższych pól, aby określić, jakie informacje zwróci implementacja CreationLogValue.

Pole Opis
column Column! Kolumna, do której należy wartość.
created_at Date! Data i godzina utworzenia elementu w formacie ISO 8601.
creator User! Użytkownik, który utworzył element. Obsługuje zagnieżdżone pola, takie jak id, name i email.
creator_id ID! Unikatowy identyfikator użytkownika, który utworzył element.
id ID! Unikatowy identyfikator kolumny.
is_leaf Boolean! Informuje, czy element nie ma podelementów.
text String Wartość kolumny w postaci czytelnego tekstu (np. "2026-02-27 12:11:30 UTC").
type ColumnType! Typ kolumny (creation_log).
value JSON Surowa wartość kolumny w formacie JSON.

Przykładowa odpowiedź

{
  "data": {
    "items": [
      {
        "column_values": [
          {
            "id": "creation_log",
            "text": "2026-02-27 12:11:30 UTC",
            "value": "{\"created_at\":\"2026-02-27T12:11:30Z\",\"creator_id\":\"48202303\"}",
            "created_at": "2026-02-27T12:11:30Z",
            "creator_id": "48202303",
            "creator": {
              "id": "48202303",
              "name": "John Doe",
              "email": "john@example.com"
            }
          }
        ]
      }
    ]
  }
}

Pole value zwraca ciąg JSON zawierający created_at (datę i godzinę w formacie ISO 8601) oraz creator_id (identyfikator użytkownika jako ciąg znaków). Pole text zwraca czytelną postać: "YYYY-MM-DD HH:MM:SS UTC".


Filtrowanie

Możesz filtrować elementy według wartości dziennika tworzenia za pomocą obiektu items_page. Kolumna dziennika tworzenia umożliwia filtrowanie według osoby, która utworzyła element, oraz zakresu dat utworzenia.

Operator Porównywana wartość Porównywany atrybut
any_of Tablica identyfikatorów użytkowników (np. [123456]) "CREATED_BY"
not_any_of Tablica identyfikatorów użytkowników do wykluczenia (np. [123456]) "CREATED_BY"
between Tablica z dwiema datami: ["YYYY-MM-DD", "YYYY-MM-DD"] "CREATED_AT"

Przykłady

Filtrowanie według osoby, która utworzyła element

Poniższe zapytanie zwraca wszystkie elementy utworzone przez użytkownika 123456.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "creation_log"
            compare_value: [123456]
            compare_attribute: "CREATED_BY"
            operator: any_of
          }
        ]
      }
    ) {
      items {
        id
        name
      }
    }
  }
}
const query = `
  query ($boardId: [ID!], $columnId: ID!, $operator: ItemsQueryRuleOperator!, $compareValue: CompareValue!, $compareAttribute: String!) {
    boards(ids: $boardId) {
      items_page(
        query_params: {
          rules: [
            {
              column_id: $columnId,
              compare_value: $compareValue,
              compare_attribute: $compareAttribute,
              operator: $operator
            }
          ]
        }
      ) {
        items {
          id
          name
        }
      }
    }
  }
`;

const variables = {
  boardId: 1234567890,
  columnId: "creation_log",
  compareValue: [123456],
  compareAttribute: "CREATED_BY",
  operator: "any_of",
};

const response = await mondayApiClient.request(query, variables);

Wykluczanie określonych osób, które utworzyły elementy

Poniższe zapytanie zwraca elementy, których nie utworzył użytkownik 123456.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "creation_log"
            compare_value: [123456]
            compare_attribute: "CREATED_BY"
            operator: not_any_of
          }
        ]
      }
    ) {
      items {
        id
        name
      }
    }
  }
}

Filtrowanie według zakresu dat utworzenia

Poniższe zapytanie zwraca wszystkie elementy utworzone między 1 stycznia a 31 marca 2026 roku.

query {
  boards(ids: 1234567890) {
    items_page(
      query_params: {
        rules: [
          {
            column_id: "creation_log"
            compare_value: ["2026-01-01", "2026-03-31"]
            compare_attribute: "CREATED_AT"
            operator: between
          }
        ]
      }
    ) {
      items {
        id
        name
      }
    }
  }
}

Mutacje

Tworzenie kolumny

Wymagany zakres uprawnień: boards:write

Możesz utworzyć kolumnę dziennika tworzenia za pomocą mutacji create_column. Kolumny dziennika tworzenia są tylko do odczytu - system automatycznie uzupełnia ich wartości podczas tworzenia elementów.

mutation {
  create_column(
    board_id: 1234567890
    title: "Created"
    column_type: creation_log
  ) {
    id
    title
    type
    settings
  }
}

Opcjonalnie możesz przekazać ciąg JSON defaults, aby ustawić tryb wyświetlania kolumny (np. "{\"mode\":\"dateOnly\"}"). Dostępne tryby opisano w sekcji Odczytywanie konfiguracji kolumny.

Aktualizowanie i czyszczenie

Kolumna dziennika tworzenia jest generowana przez system i dostępna tylko do odczytu. Nie można aktualizować ani czyścić jej wartości za pomocą change_simple_column_value lub change_multiple_column_values.

Próba aktualizacji zwraca błąd:

  • change_simple_column_value: "column type PulseLogColumn is not supporting changing the column value with simple column value"
  • change_multiple_column_values: "This column type can not be updated or created (client side auto calculated column)"

Odczytywanie konfiguracji kolumny

Możesz odpytać ustawienia kolumny dziennika tworzenia za pomocą pola settings kolumny.

Pole settings_str jest przestarzałe od wersji API 2025-10. Zamiast niego użyj typowanego obiektu settings, który zwraca uporządkowane dane JSON, a nie ciąg zakodowany w formacie JSON.

query {
  boards(ids: 1234567890) {
    columns(ids: ["creation_log"]) {
      id
      title
      settings
    }
  }
}

Struktura odpowiedzi settings

Pole settings zwraca typowany obiekt JSON z następującymi kluczami:

Klucz Typ Opis
mode string Tryb wyświetlania kolumny. Jedna z wartości: "personOnly", "dateOnly" lub "personAndDate".

Tryb wyświetlania określa, co kolumna pokazuje w interfejsie tablicy. "personAndDate" wyświetla awatar osoby, która utworzyła element, oraz datę jego utworzenia, "personOnly" wyświetla tylko tę osobę, a "dateOnly" - tylko datę. Niezależnie od trybu wyświetlania API zawsze zwraca wszystkie pola (created_at, creator, creator_id).

Przykładowa odpowiedź settings

{
  "mode": "personAndDate"
}

Jeśli nie ustawiono niestandardowego trybu, settings zwraca {}. Domyślny tryb wyświetlania to personAndDate.


Pobieranie schematu typu kolumny

Możesz programowo pobrać schemat JSON ustawień kolumny dziennika tworzenia za pomocą zapytania get_column_type_schema. Zwraca ono strukturę, reguły walidacji i dostępne właściwości konfiguracji kolumny.

query {
  get_column_type_schema(
    type: creation_log
  )
}
{
  "data": {
    "get_column_type_schema": {
      "schema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
          "settings": {
            "type": "object",
            "description": "Column specific settings",
            "properties": {
              "mode": {
                "type": "string",
                "description": "Display mode for the pulse log",
                "enum": [
                  "personOnly",
                  "dateOnly",
                  "personAndDate"
                ]
              }
            },
            "additionalProperties": false
          }
        }
      }
    }
  }
}

Odpowiedź zawiera nazwy właściwości, ich typy, ograniczenia (takie jak maksymalna długość i dozwolone wartości) oraz opisy poszczególnych ustawień. Możesz jej użyć do sprawdzania poprawności ustawień kolumny, dynamicznego generowania interfejsów użytkownika lub przekazywania kontekstu agentom AI. Dowiedz się więcej o formacie odpowiedzi schematu.