Web service SOAP - Mettre à jour 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 Modifier un ticket de l'API REST Service Manager

EZV_UpdateRequest 

Remarques

Liste des paramètres

Paramètres obligatoires

Vous devez renseigner les paramètres ci-dessous.

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
rfc_number, request_id, external_reference string Numéro / Identifiant du ticket dans Service Manager / Identifiant du ticket attribué par une application externe
  • Au moins l'un des paramètres doit être renseigné pour rechercher le ticket.
  • Les objets sont traités dans cet ordre de priorité par l'algorithme de recherche.

Paramètres optionnels

Objet Type Description / Exemple
fields_to_update string Liste des champs et valeurs à mettre à jour - Open url.png voir :
exemple {comment=updated by mail} {ci=SRV_15-F} {asset=ZS_003}


Liste des champs de la table SD_REQUEST ne pouvant pas être modifiés

rfc_number - request_id - location_id - request_project_id - recipient_id - urgency_id - severity_id - status_id - department_id - parent_request_id - last_group_id - last_done_by_id - submitted_by - kbase_id - sla_id - sd_catalog_id - initial_sd_catalog_id - order_id - news_id - project_id


Liste des champs d’autres tables, modifiables, associés à un alias spécifique

Alias Champ mis à jour dans la table SD_REQUEST Table de recherche Champ utilisé dans la table de recherche pour retrouver la valeur passée en paramètre
ci_id ci_id AM_ASSET asset_tag
asset asset_id AM_ASSET asset_tag
asset_tag asset_id AM_ASSET asset_tag
net_price_cur_id net_price_cur_id AM_CURRENCY currency
rental_net_price_cur_id rental_net_price_cur_id AM_CURRENCY currency
analytical_charge_id analytical_charge_id EP_ANALYTICAL_CHARGE analytical_charge_code
system_id system_id AM_REFERENCE reference_lng
release_id release_id CMDB_RELEASE release_code
continuity_plan_id continuity_plan_id CMDB_CONTINUITY_PLAN code
ci ci_id AM_ASSET network_identifier
ci_serial ci_id AM_ASSET serial_number
asset_serial asset_id AM_ASSET serial_number
owner_id owner_id AM_EMPLOYEE last_name
owning_group_id owning_group_id AM_GROUP group_lng
known_problems_id known_problems_id SD_KNOWN_PROBLEMS known_problems_id
root_cause_id root_cause_id AM_REFERENCE reference_lng
request_origin_id request_origin_id SD_REQUEST_ORIGIN name_lng

Description des actions effectuées

1. Le ticket est modifié dans la table SD_REQUEST.

2. Les champs mis à jour sont ceux passés via le paramètre fields_to_update.

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 Échec de la requête SQL utilisée pour la mise à jour de la base de données Vérifiez et corrigez le paramètre fields_to_update.
-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:24

Raccourcis

L'actualité mensuelle
•  Newsletter

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

Powered by XWiki ©, EasyVista 2021