Vai al contenuto
Tutti gli strumenti

servicenow_create_incident

ServiceNow · macOS · Windows

Effetto: scrittura. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Crea un incidente reale nell'istanza ServiceNow collegata; il ticket è visibile al service desk non appena viene creato. Se chiamato senza confirm restituisce un'anteprima di ogni campo e non invia nulla; passa confirm=true per creare. urgency è 3 (Media) per impostazione predefinita. Restituisce il numero dell'incidente, il suo sys_id e un link. Per aggiungere a un incidente esistente usa servicenow_add_comment o servicenow_update_incident invece di crearne un altro.

Input obbligatori

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per servicenow_create_incident. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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

Windows

Scopo

Crea un incidente nell'istanza ServiceNow collegata con connect_servicenow, usando le credenziali memorizzate. Senza confirm=true non viene inviato nulla: la risposta mostra in anteprima ogni campo, perché una chiamata confermata registra un ticket reale in un sistema su cui lavorano altre persone; mostra il testo all'utente e ottieni il suo via libera prima di confermare. Viene rifiutata solo una short_description vuota; urgency è 3 se omessa. Nulla controlla se esiste un incidente aperto simile, quindi chiamare due volte ne registra due: controlla prima con servicenow_search_incidents o servicenow_list_my_incidents. La risposta fornisce il numero dell'incidente e un link. Questo server non può eliminare un incidente; per modificarne o chiuderne uno, passa il suo sys_id (da servicenow_get_incident) a servicenow_update_incident.

Input obbligatori

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per servicenow_create_incident. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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