Dziennik tworzenia
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 |
|
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.