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, de inmediato: esta herramienta no tiene vista previa ni paso de confirm, y el ticket es visible para el service desk en cuanto la llamada devuelve. Acuerde con el usuario el short_description y la urgency ANTES de llamar. 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 no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Esquema técnico canónico en inglés — macOS
{
  "properties": {
    "category": {
      "description": "Incident category, e.g. 'software', 'hardware', 'network'",
      "type": "string"
    },
    "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.

{
  "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. No hay vista previa ni paso de confirm: la primera llamada registra un ticket real en un sistema con el que trabajan otras personas, así que muestre al usuario el texto y obtenga su visto bueno antes de llamar. 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 no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Esquema técnico canónico en inglés — Windows
{
  "properties": {
    "category": {
      "description": "e.g. software, hardware, network",
      "type": "string"
    },
    "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.

{
  "short_description": "Calendar search returns an empty result."
}