servicenow_create_incident

ServiceNow · macOS · Windows

Wirkung: Schreiben. Status: bedingt verfügbar.

„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.

macOS

Zweck

Erstellt einen echten Vorfall in der verbundenen ServiceNow-Instanz; das Ticket ist für den Service Desk sichtbar, sobald es erstellt ist. Ohne confirm aufgerufen, gibt es eine Vorschau aller Felder zurück und sendet nichts; übergeben Sie confirm=true zum Erstellen. urgency ist standardmäßig 3 (Mittel). Gibt die Vorfallnummer, seine sys_id und einen Link dazu zurück. Um einen bestehenden Vorfall zu ergänzen, verwenden Sie servicenow_add_comment oder servicenow_update_incident, statt einen weiteren zu erstellen.

Erforderliche Eingaben

short_description

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für servicenow_create_incident. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

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

Windows

Zweck

Erstellt mit den gespeicherten Anmeldeinformationen einen Vorfall in der ServiceNow-Instanz, die mit connect_servicenow verbunden wurde. Ohne confirm=true wird nichts gesendet: Die Antwort zeigt eine Vorschau aller Felder, weil ein bestätigter Aufruf ein echtes Ticket in einem System anlegt, in dem andere Personen arbeiten; zeigen Sie dem Benutzer den Text und holen Sie sein Einverständnis ein, bevor Sie bestätigen. Nur eine leere short_description wird abgelehnt; urgency ist 3, wenn sie weggelassen wird. Nichts prüft, ob ein ähnlicher offener Vorfall existiert, sodass zweimaliges Aufrufen zwei anlegt: Schauen Sie zuerst mit servicenow_search_incidents oder servicenow_list_my_incidents nach. Die Antwort enthält die Vorfallnummer und einen Link. Dieser Server kann keinen Vorfall löschen; um einen zu ändern oder zu schließen, übergeben Sie seine sys_id (aus servicenow_get_incident) an servicenow_update_incident.

Erforderliche Eingaben

short_description

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

Kanonisches technisches Schema auf Englisch — 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"
}

Dokumentationsbeispiel

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