servicenow_update_incident

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

Actualice los campos de un incidente de ServiceNow existente: estado (`state`), prioridad (`priority`), asignación. Utilice sys_id de servicenow_get_incident. Si se llama sin confirm, devuelve una vista previa de los campos que cambiarían y no envía nada; pase confirm=true para actualizar.

Entradas obligatorias

sys_id

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.

Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

Esquema técnico canónico en inglés — macOS

{
  "properties": {
    "assigned_to": {
      "description": "Username or email to assign to",
      "type": "string"
    },
    "close_notes": {
      "description": "Resolution notes (required when state=6 or 7)",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to send; without it nothing is sent and the call returns a preview of every field.",
      "type": "boolean"
    },
    "priority": {
      "description": "1=Critical, 2=High, 3=Moderate, 4=Low, 5=Planning",
      "type": "string"
    },
    "short_description": {
      "description": "Updated summary",
      "type": "string"
    },
    "state": {
      "description": "1=New, 2=In Progress, 3=On Hold, 6=Resolved, 7=Closed",
      "type": "string"
    },
    "sys_id": {
      "description": "Incident sys_id from servicenow_get_incident",
      "type": "string"
    },
    "urgency": {
      "description": "1=Critical, 2=High, 3=Medium, 4=Low",
      "type": "string"
    }
  },
  "required": [
    "sys_id"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para servicenow_update_incident. 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,
  "short_description": "Calendar search returns no events.",
  "sys_id": "0123456789abcdef0123456789abcdef"
}

Windows