Web service SOAP - Créer un ticket

Sommaire

Remarques
Liste des paramètres
- Paramètres obligatoires
- Paramètres optionnels
Description des actions effectuées
Codes retour du web service

UseRestInsteadOfSoap

Note : Les web services SOAP Service Manager ne sont plus maintenus depuis la version Oxygène. Vous pouvez toujours les utiliser mais nous vous conseillons d'utiliser l'API REST Service Manager pour profiter des dernières améliorations et fonctionnalités.

Open url.png voir Méthode Créer un ticket de l'API REST Service Manager

EZV_CreateRequest

Ce web service permet de :
- créer un nouveau ticket (incident, demande - service / changement / investissement - problème, événement) ;
- démarrer le workflow lié.

Remarques

En cas de succès, un code retour 1 est retourné ; le numéro du ticket généré dans Service Manager est fourni.

Liste des paramètres

Paramètres obligatoires

Vous devez renseigner les paramètres ci-dessous.

Notes :

Le sujet peut être renseigné via catalog_guid (utilisé en priorité) ou catalog_code.
Si catalog_guid est erroné, le traitement est stoppé sans lire catalog_code.

Objet	Type	Description / Exemple
account	string	Compte Service Manager utilisé exemple 50004 : Base de production ; 50005 : Base sandbox
login, pass	string	Login / Mot de passe de connexion à Service Manager
catalog_guid	string	Identifiant du sujet du ticket

Paramètres optionnels

Objet	Type	Description / Exemple
catalog_code	string	Code du sujet du ticket
assetid, assettag, asset_name	string	Identifiant / Code / Nom du matériel Les objets sont traités dans cet ordre de priorité par l'algorithme de recherche.
ci_id, ci_asset_tag, ci_name	string	Identifiant du CI / Code matériel du CI / Nom du CI Les objets sont traités dans cet ordre de priorité par l'algorithme de recherche.
department_id, department_code	string	Identifiant / Code de l'entité du demandeur Les objets sont traités dans cet ordre de priorité par l'algorithme de recherche.
description	string	Description du ticket
external_reference	string	Identifiant du ticket attribué par une application externe.
location_id, location_code	string	Identifiant / Code de la localisation du demandeur Les objets sont traités dans cet ordre de priorité par l'algorithme de recherche.
origin	string	Identifiant de l'origine du ticket (ex. : Téléphone, E-mail)
parentrequest	string	Identifiant de la demande liée (demande parent) rattachée au ticket
phone	string	Numéro de téléphone du demandeur
recipient_identification, recipient_mail, recipient_name	string	Numéro de matricule / Adresse e-mail / Nom du bénéficiaire Les objets sont traités dans cet ordre de priorité par l'algorithme de recherche.
requestor_identification, requestor_mail, requestor_name	string	Numéro de matricule / Adresse e-mail / Nom du demandeur Les objets sont traités dans cet ordre de priorité par l'algorithme de recherche.
severity_id	integer	Identifiant du niveau de gravité du ticket
submit_date	string	Date de création du ticket Par défaut, date courante (now).
urgency_id	integer	Identifiant du niveau d'urgence du ticket

Description des actions effectuées

1. Un nouveau ticket est créé dans la table SD_REQUEST.

submit_date = now
Si recipient_id est passé en paramètre :
- location_id = location_id du recipient_id
- department_id = department_id du recipient_id
- requestor_phone = phone du recipient_id
- rfc_number ==> Get NewIncidentNumber
- max_resolution_date_ut ==> calculateMaxResolution(SLA_id à récupérer)
- first_call_resolution ==> 0
- status_id = Clé status_id dont le GUID est {6e554fc1-1a5d-47e4-b303-cd98a8767aec} [12 - en général En cours]
Si parentRequest est renseigné :
- parentRequest_id renseigné (demande liée)

2. Une action de type CALL est créée dans la table AM_ACTION, rattachée au ticket.

request_id = request_id du ticket qui vient d’être créé
doneBy_id = requestor_id du ticket qui vient d’être créé
creation_date_ut = start_date_ut = end_date_ut = SD_REQUEST.submit_date
action_type_id = 7
AM_ACTION.contact_id = SD_REQUEST.requestor_id

3. Le workflow workflow_id associé au ticket est démarré.

Codes retour du web service

Code	Erreur	Action corrective
1	Traitement effectué avec succès
-1	Base non trouvée	Vérifiez que le paramètre account correspond bien à un compte Service Manager.
-2	Connexion à Service Manager impossible	Vérifiez et corrigez les paramètres login et pass.
-3	Un paramètre en entrée est incorrect	Vérifiez et corrigez les paramètres passés en entrée. Vérifiez que tous les paramètres obligatoires sont renseignés.
-4	Workflow du ticket non trouvé
-22	Nombre maximal de connexions atteint	Vérifiez que votre profil défini sur le compte Service Manager autorise l'exécution de l'action demandée au web service.

Tags:

Modifié par Utilisateur inconnu le 2021/12/22 15:37

Créé par Administrator XWiki le 2013/03/25 18:17