servicenow_add_comment

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

Ajoutez un commentaire ou une note de travail à un incident ServiceNow. Les commentaires sont visibles par l'appelant ; les notes de travail sont uniquement internes. Appelé sans confirm, il renvoie un aperçu et n'envoie rien ; passez confirm=true pour l'ajouter.

Entrées requises

sys_id
text

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": {
    "confirm": {
      "description": "Must be true to send; without it nothing is sent and the call returns a preview of every field.",
      "type": "boolean"
    },
    "sys_id": {
      "description": "Incident sys_id from servicenow_get_incident",
      "type": "string"
    },
    "text": {
      "description": "Comment or work note text",
      "type": "string"
    },
    "type": {
      "description": "'comment' (visible to caller, default) or 'work_note' (internal only)",
      "type": "string"
    }
  },
  "required": [
    "sys_id",
    "text"
  ],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour servicenow_add_comment. 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,
  "sys_id": "0123456789abcdef0123456789abcdef",
  "text": "Can we review the launch checklist on Tuesday?"
}

Windows