servicenow_create_incident

ServiceNow · macOS · Windows

Effet: écriture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

Crée un vrai incident dans l'instance ServiceNow connectée ; le ticket est visible du service desk dès sa création. Appelé sans confirm, il renvoie un aperçu de tous les champs et n'envoie rien ; passez confirm=true pour créer. urgency vaut 3 (Medium) par défaut. Renvoie le numéro de l'incident, son sys_id et un lien vers celui-ci. Pour compléter un incident existant, utilisez servicenow_add_comment ou servicenow_update_incident au lieu d'en créer un autre.

Entrées requises

short_description

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

Exemple de documentation pour servicenow_create_incident. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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

Windows

Objectif

Crée un incident dans l'instance ServiceNow connectée avec connect_servicenow, en utilisant les identifiants stockés. Sans confirm=true, rien n'est envoyé : la réponse donne un aperçu de tous les champs, car un appel confirmé enregistre un vrai ticket dans un système utilisé par d'autres personnes ; montrez le texte à l'utilisateur et obtenez son accord avant de confirmer. Seul un short_description vide est refusé ; urgency vaut 3 si omis. Rien ne vérifie l'existence d'un incident ouvert similaire, donc appeler deux fois en enregistre deux : cherchez d'abord avec servicenow_search_incidents ou servicenow_list_my_incidents. La réponse donne le numéro de l'incident et un lien. Ce serveur ne peut pas supprimer un incident ; pour en modifier ou en clôturer un, passez son sys_id (issu de servicenow_get_incident) à servicenow_update_incident.

Entrées requises

short_description

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

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