Monday.com - Leer ítem

↩ Parte de la integración Monday.com.

Descripción

Este módulo lee un ítem por su id con la query GraphQL items:

query($id: ID!) {
  items(ids: [$id]) {
    id
    name
    column_values { id text value }
  }
}

Cada columna vuelve con tres campos: su id, un text legible para personas y el value crudo en JSON, que es lo que necesitás si después vas a reinyectarlo en una actualización.

Configuración

Campo	Tipo	Obligatorio	Descripción
`credentials_id`	credentials	Sí	Credencial de Monday
`item_id`	text	Sí	ID numérico del ítem

Credenciales

Este módulo requiere una credencial de tipo Monday.

Campo	Descripción
`token`	Token personal de la API (Avatar → Developers → My access tokens)
`timeout`	Opcional. Tiempo máximo de la petición en milisegundos (por defecto 20000)

Salida

{
  "nextModule": null,
  "data": {
    "id": "987654321",
    "name": "Acme S.A.",
    "column_values": [
      { "id": "status",  "text": "En curso",     "value": "{\"index\":0}" },
      { "id": "email",   "text": "ops@acme.com", "value": "{\"email\":\"ops@acme.com\",\"text\":\"ops@acme.com\"}" },
      { "id": "numbers", "text": "4200",         "value": "\"4200\"" }
    ]
  },
  "_meta": {
    "moduleVersion": "1.0.0",
    "success": true,
    "id": "987654321",
    "totalMs": 194
  }
}

Si el id no corresponde a ningún ítem, data vale null y el nodo igual informa éxito: comprobá el null en el nodo siguiente.

Ejemplo de uso

Leer un ítem con id fijo

{
  "credentials_id": 8,
  "item_id": "987654321"
}

Leer el ítem creado por un nodo anterior

{
  "credentials_id": 8,
  "item_id": "{{data.id}}"
}

Notas

Esta es la forma más simple de descubrir los ids de columna que necesitás para Crear ítem y Actualizar ítem: ejecutalo una vez contra un ítem real y mirá el id de cada entrada de column_values.
text es el valor de visualización y value es el JSON crudo como cadena. Parseá value cuando necesites la forma estructurada.
El nodo lee un único ítem. Para listar varios, filtrar un tablero o ejecutar una consulta paginada, usá Query GraphQL.
Un ítem borrado, o uno de un tablero que tu token no puede ver, vuelve como null y no como error.

Nodos relacionados

Monday.com - Actualizar ítem — escribí después de leer.
Monday.com - Query GraphQL — leé varios ítems, tableros o grupos de una vez.
Monday.com - Borrar ítem — eliminá el ítem.