Créer un incident ServiceNow

Crée un nouvel incident dans ServiceNow en utilisant 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"`
shortDescription	Requis	Chaîne	Brève description de l'incident.	`"Test Incident"`
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 }}"`
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 Exportation vers la spécification OpenAPI pour obtenir une liste des paramètres acceptés.
champs	Facultatif	Carte	Champs d'incident supplémentaires à inclure dans le corps de la requête. Tous les champs sont fusionnés avec `shortDescription`. Consultez le tableau de référence des champs ci-dessous.	`"{\"description\": \"Detailed description\", \"urgency\": \"2\", \"impact\": \"2\", \"priority\": \"3\", \"assignment_group\": \"IT Support\", \"assigned_to\": \"john.doe\", \"category\": \"Software\", \"subcategory\": \"Application\", \"caller_id\": \"jane.smith\", \"contact_type\": \"email\", \"state\": \"1\", \"cmdb_ci\": \"web-server-01\"}"` Consultez le format d’objet JSON pour obtenir un exemple d’objet.
sélecteurs	Facultatif	List		`[{\"name\": \"incidentNumber\", \"expression\": \".responseBody.result.number\"}]`

Référence des paramètres

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`

Référence des champs

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
ouvert_par	Chaîne
opened_at	Chaîne
correlation_id	Chaîne
affichage_de_corrélation	Chaîne

Champ de sortie	Type	Exemple
response	Objet	`{ "result": { "number": "INC0019382", "sys_id": "ed59ab193b67ba10e811026aa5e45a2d", "short_description": "The server is on fire.", .... .... } }`
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.",
    ....
    ....
}
}

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-incident description: to create a incident in ServiceNow steps: - type: action name: createIncident action: serviceNow.incident.create version: 1 inputs: domain: "your-domain" apiKey: "${{ :secrets:serviceNowApiKey }}" shortDescription: "Test incident from New Relic WFA" fields: description: "This is a test incident created from New Relic WFA using access token authentication." priority: "2" impact: "2" urgency: "2" assignment_group: "IT Support" assigned_to: "admin" contact_type: "email" 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-incident
description: to create a incident in ServiceNow
steps:
  - type: action
    name: createIncident
    action: serviceNow.incident.create
    version: 1
    inputs:
      domain: "your-domain"
      apiKey: "${{ :secrets:serviceNowApiKey }}"
      shortDescription: "Test incident from New Relic WFA"
      fields:
        description: "This is a test incident created from New Relic WFA using access token authentication."
        priority: "2"
        impact: "2"
        urgency: "2"
        assignment_group: "IT Support"
        assigned_to: "admin"
        contact_type: "email"
      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

Référence des champs