Disponibilidad

Listar las indisponibilidades de un recurso

Devuelve las ventanas en las que una persona, un vehículo o un espacio NO está disponible.

Herramienta
filmo_unavailabilities_list
Acceso: Lectura

Resultado

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_unavailabilities_list",
    "arguments": {
      "resourceType": "staff",
      "limit": 20
    }
  }
}

generado desde el esquema

absenceType se emite para vehículos y espacios, donde es operativo, y NO para personas, donde sería un dato de salud. El motivo de la indisponibilidad no se emite nunca. Solo se devuelven las declaraciones con state: unavailable que aún no han terminado (actuales o futuras): una indisponibilidad desaparece de la lista cuando pasa su fecha de fin, y las ventanas available o unknown nunca se listan.

Argumentos

resourceTypestringObligatorio

Qué recursos consultar.

Opciones disponibles: staff, vehicle, space

resourceIdstring

Limita a un recurso concreto.

Límites: longitud mín. 1

startDatestring<date-time>

Inicio de la ventana, en ISO 8601 con desplazamiento.

endDatestring<date-time>

Fin de la ventana, en ISO 8601 con desplazamiento.

limitintegerpredeterminado:50

Tamaño de página (1-500). Por defecto es 50.

Límites: mín. 1, máx. 500

cursorstring

Cursor opaco de la página que se devuelve. Pasa el valor de pagination.nextCursor de la respuesta anterior; trátalo como opaco.

Límites: longitud máx. 200

Resultado

En un éxito el resultado lleva structuredContent con data y meta. Estos son los atributos de data.

Ver los atributos de data
idstring

Identificador único de la indisponibilidad.

resourceTypestring

Qué recurso: staff, vehicle o space.

resourceIdstring

Identificador de ese recurso.

resourceNamestring | null

Nombre del recurso; null si no consta.

startDatestring<date-time>

Inicio de la indisponibilidad en ISO 8601 UTC.

endDatestring<date-time>

Fin de la indisponibilidad en ISO 8601 UTC.

statestring

Estado declarado. Este listado solo devuelve ventanas unavailable que aún no han terminado, así que aquí siempre es unavailable; available y unknown existen como declaraciones pero no se listan.

absenceTypestring | null

Tipo de ausencia. Solo se emite para vehículos y espacios, donde es operativo; para el personal es un dato de salud y se devuelve como null.

updatedAtstring<date-time> | null

Última modificación en ISO 8601 UTC; null si no está registrada.

Un error es un resultado con isError: true y el problema en content[0].text; no hay structuredContent. Consulta Errores.

La misma operación por REST

Esta herramienta ejecuta GET /api/v1/availability/unavailabilities.

  • Disponibilidad

    Listar las indisponibilidades de un recurso

    Devuelve las ventanas en las que una persona, un vehículo o un espacio NO está disponible.

  • Guías

    Escrituras seguras

    Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.

  • Guías

    Errores

    Un error de herramienta es un resultado con isError: true y el problema en el primer bloque de texto. Ramifica por su code.