Saltar al contenido
Todas las herramientas

servicenow_add_comment

ServiceNow · macOS · Windows

Efecto: escritura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Agregue un comentario o nota de trabajo a un incidente de ServiceNow. Los comentarios son visibles para la persona que llama; Las notas de trabajo son solo internas. Si se llama sin confirm, devuelve una vista previa y no envía nada; pase confirm=true para agregarlo.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — macOS
{
  "properties": {
    "confirm": {
      "description": "Must be true to send; without it nothing is sent and the call returns a preview of every field.",
      "type": "boolean"
    },
    "sys_id": {
      "description": "Incident sys_id from servicenow_get_incident",
      "type": "string"
    },
    "text": {
      "description": "Comment or work note text",
      "type": "string"
    },
    "type": {
      "description": "'comment' (visible to caller, default) or 'work_note' (internal only)",
      "type": "string"
    }
  },
  "required": [
    "sys_id",
    "text"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para servicenow_add_comment. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "confirm": false,
  "sys_id": "0123456789abcdef0123456789abcdef",
  "text": "Can we review the launch checklist on Tuesday?"
}

Windows

Propósito

Agregue un comentario o nota de trabajo a un incidente de ServiceNow. Los comentarios son visibles para la persona que llama; Las notas de trabajo son solo internas. Sin confirm=true no se envía nada: la respuesta muestra una vista previa del incidente, el tipo y el texto.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — Windows
{
  "properties": {
    "confirm": {
      "description": "Must be true to send. Without it nothing is sent and the answer previews every field.",
      "type": "boolean"
    },
    "sys_id": {
      "description": "Incident sys_id from servicenow_get_incident",
      "type": "string"
    },
    "text": {
      "description": "Comment or work note text",
      "type": "string"
    },
    "type": {
      "description": "'comment' (visible to caller, default) or 'work_note' (internal only)",
      "type": "string"
    }
  },
  "required": [
    "sys_id",
    "text"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para servicenow_add_comment. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "confirm": false,
  "sys_id": "0123456789abcdef0123456789abcdef",
  "text": "Can we review the launch checklist on Tuesday?"
}