Web service SOAP - Créer un ticket


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

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

Raccourcis

L'actualité mensuelle
•  Newsletter

Tous les changements
•  Service Manager
•  Service Apps
•  Self Help
•  Service Bots

Powered by XWiki ©, EasyVista 2021