Mettre à jour un incident ServiceNow

Met à jour un incident existant dans ServiceNow à l'aide de l'API Table.

Pour la configuration de l’authentification, voir les actions d’incident ServiceNow.

Champ de saisie	optionnalité	Type	Description	Exemple
domain	Requis	Chaîne	Domaine de l'instance ServiceNow. Utilisé pour construire l'URL de base `your-domain.service-now.com` .	`"your-domain"`
apiKey	Requis	Chaîne	Clé API REST ServiceNow pour l'authentification. Transmis en tant qu'en-tête de requête `x-sn-apikey` . Doit être fourni en tant que secret.	`"${{ :secrets:serviceNowApiKey }}"`
sysId	Requis	Chaîne	ID système unique de l'incident à mettre à jour. Doit être une chaîne alphanumérique de 32 caractères (pas au format UUID).	`"fa7616894723b210f89ff3ac416d43c2"`
champs	Requis	Carte	Champs d'incident à mettre à jour dans l'incident ServiceNow. Consultez le tableau de référence des champs ci-dessous.	`"{\"short_description\": \"Updated incident description\", \"state\": \"2\", \"work_notes\": \"Investigating the issue\", \"assigned_to\": \"john.doe\", \"priority\": \"2\"}"` Consultez le format d’objet JSON pour obtenir un exemple d’objet.
paramètres	Facultatif	Carte	Paramètres de requête d'URL facultatifs pour la requête d'API ServiceNow. Contrôle le format et le contenu de la réponse de l'API. Consultez le tableau de référence des paramètres ci-dessous.	`"{\"sysparm_fields\": \"name,short_description\", \"sysparm_exclude_reference_link\": \"true\", \"sysparm_input_display_value\": \"false\", \"sysparm_display_value\": \"true\"}"` Consultez now_table_api_latest_spec.json ou Exporter vers la spécification OpenAPI pour obtenir une liste des paramètres acceptés.
sélecteurs	Facultatif	List		`[{\"name\": \"incidentNumber\", \"expression\": \".responseBody.result.number\"}]`

Référence des paramètres d'URL courants

paramètres	Type	Description	Défaut
sysparm_fields	Chaîne	Liste de champs séparés par des virgules à renvoyer dans la réponse.
sysparm_exclude_reference_link	Chaîne	`true` ou `false` pour exclure les liens de référence de la réponse.	`false`
sysparm_display_value	Chaîne	`true` , `false` ou `all` pour renvoyer des valeurs d'affichage au lieu des valeurs réelles.	`false`
sysparm_input_display_value	Chaîne	`true` ou `false` . Lorsque `true` , définit les valeurs des champs en utilisant leur valeur d'affichage au lieu de la valeur réelle.	`false`
sysparm_suppress_auto_sys_field	Chaîne	`true` ou `false` . Lorsque `true` , supprime la génération automatique des champs système.	`false`
sysparm_view	Chaîne	Restitue la réponse selon une vue spécifique de l'interface utilisateur. Remplacé par `sysparm_fields` .	`default`
sysparm_query_no_domain	Chaîne	`true` ou `false` . Lorsque `true` , permet l'accès aux données entre les domaines si autorisé.	`false`

Référence des champs incidentData

Champ	Type
description_courte	Chaîne
description	Chaîne
caller_id	Chaîne
catégorie	Chaîne
sous-catégorie	Chaîne
urgence	Chaîne
impact	Chaîne
priorité	Chaîne
assignment_group	Chaîne
assigné_à	Chaîne
état	Chaîne
contact_type	Chaîne
business_service	Chaîne
cmdb_ci	Chaîne
commentaires	Chaîne
work_notes	Chaîne
ouvert_par	Chaîne
opened_at	Chaîne
correlation_id	Chaîne
affichage_de_corrélation	Chaîne
close_code	Chaîne
notes_de_clôture	Chaîne
résolu_par	Chaîne
resolved_at	Chaîne

Champ de sortie	Type	Exemple
response	Objet	`{ "result": { "number": "INC0019382", "sys_id": "ed59ab193b67ba10e811026aa5e45a2d", "short_description": "The server is on fire.", "description": "The server is on fire." "priority": "3" } }`
succès	Booléen	`success: true \| false`
message d'erreur	Chaîne	`[ { "success": false, "errorMessage": "{\"error\":{\"message\":\"User Not Authenticated\",\"detail\":\"Required to provide Auth information\"},\"status\":\"failure\"}" } ]`

Champ de sortie

Type

Exemple

response

Objet

{
"result": {
    "number": "INC0019382",
    "sys_id": "ed59ab193b67ba10e811026aa5e45a2d",
    "short_description": "The server is on fire.",
    "description": "The server is on fire."
    "priority": "3"
}
}

succès

Booléen

success: true | false

message d'erreur

Chaîne

[
  {
    "success": false,
    "errorMessage": "{\"error\":{\"message\":\"User Not Authenticated\",\"detail\":\"Required to provide Auth information\"},\"status\":\"failure\"}"
  }
]

Exemple de workflow
name: create-servicenow-update description: to update a incident in ServiceNow steps: - type: action name: updateIncident action: serviceNow.incident.update version: 1 inputs: domain: "your-domain" apiKey: "${{ :secrets:serviceNowApiKey }}" sysId: "ed59ab193b67ba10e811026aa5e45a2d" fields: short_description: "Test incident from New Relic WFA" assigned_to: "npitchuka" contact_type: "slack" parameters: sysparm_display_value: "true" sysparm_fields: "number,short_description,description,priority,sys_id" selectors: - name: sysId expression: .responseBody.result.sys_id next: end

Exemple de workflow

name: create-servicenow-update
description: to update a incident in ServiceNow

steps:
  - type: action
    name: updateIncident
    action: serviceNow.incident.update
    version: 1
    inputs:
      domain: "your-domain"
      apiKey: "${{ :secrets:serviceNowApiKey }}"
      sysId: "ed59ab193b67ba10e811026aa5e45a2d"
      fields: 
        short_description: "Test incident from New Relic WFA"
        assigned_to: "npitchuka"
        contact_type: "slack"
      parameters:
        sysparm_display_value: "true"
        sysparm_fields: "number,short_description,description,priority,sys_id"
      selectors:
        - name: sysId
          expression: .responseBody.result.sys_id
    next: end

Cette traduction automatique est fournie pour votre commodité.

Référence des paramètres d'URL courants

Référence des champs incidentData