Saltar al contenido
Todas las herramientas

servicenow_create_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

Crea un incidente real en la instancia de ServiceNow conectada; el ticket es visible para el service desk en cuanto se crea. Si se llama sin confirm, devuelve una vista previa de todos los campos y no envía nada; pase confirm=true para crearlo. urgency es 3 (Medium) por defecto. Devuelve el número del incidente, su sys_id y un enlace a él. Para añadir información a un incidente existente, use servicenow_add_comment o servicenow_update_incident en lugar de crear otro.

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": {
    "category": {
      "description": "Incident category, e.g. 'software', 'hardware', 'network'",
      "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"
    },
    "description": {
      "description": "Full description of the issue",
      "type": "string"
    },
    "short_description": {
      "description": "Brief summary of the issue (required)",
      "type": "string"
    },
    "urgency": {
      "description": "1=Critical, 2=High, 3=Medium (default), 4=Low",
      "type": "string"
    }
  },
  "required": [
    "short_description"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para servicenow_create_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 an empty result."
}

Windows

Propósito

Crea un incidente en la instancia de ServiceNow conectada con connect_servicenow, usando las credenciales almacenadas. Sin confirm=true no se envía nada: la respuesta muestra una vista previa de todos los campos, porque una llamada confirmada registra un ticket real en un sistema con el que trabajan otras personas; muestre al usuario el texto y obtenga su visto bueno antes de confirmar. Solo se rechaza un short_description en blanco; urgency es 3 si se omite. Nada comprueba si existe un incidente abierto similar, así que llamar dos veces registra dos: busque antes con servicenow_search_incidents o servicenow_list_my_incidents. La respuesta da el número del incidente y un enlace. Este servidor no puede eliminar un incidente; para cambiar o cerrar uno, pase su sys_id (de servicenow_get_incident) a servicenow_update_incident.

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": {
    "category": {
      "description": "e.g. software, hardware, network",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to send. Without it nothing is sent and the answer previews every field.",
      "type": "boolean"
    },
    "description": {
      "description": "Full description",
      "type": "string"
    },
    "short_description": {
      "description": "Brief summary (required)",
      "type": "string"
    },
    "urgency": {
      "description": "1=Critical, 2=High, 3=Medium (default), 4=Low",
      "type": "string"
    }
  },
  "required": [
    "short_description"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para servicenow_create_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 an empty result."
}