createTicket

Méthodes de services Web › Méthodes d’activité › createTicket

createTicket

Les paramètres suivants s'appliquent à la méthode createTicket :

Paramètre	Type	Description
SID	Nombre entier	Identifie la session extraite depuis la connexion.
Description	Chaîne	(Facultatif) Identifie la description du ticket.
problem_type	Chaîne	Spécifie le code (et non l'ID persistant) d'un type de problème existant pour la politique sous laquelle une application de services Web s'exécute. Si elle est vide ou comporte une valeur incorrecte, le type de problème utilisé est celui défini par défaut.
ID d'utilisateur	Chaîne	(Facultatif) Spécifie l'ID d'utilisateur de l'utilisateur final du nouveau ticket. Si elle est vide ou si l'ID d'utilisateur fourni est introuvable, le contact Proxy défini dans la politique d'accès est utilisé, mais le ticket est tout de même créé.
Activé	Chaîne	(Facultatif) Identifie le descripteur d'un actif à joindre au ticket.
DuplicationID	Chaîne	(Facultatif) Permet aux appelants d'aider les routines de gestion des doublons servant à classer les tickets uniques et différents. Si la gestion des doublons est activée, cette chaîne est inspectée après la mise en correspondance avec les critères de gestion des doublons pour déterminer s'il s'agit d'un appel unique à cette méthode ou bien d'un doublon. Pour plus d'informations sur la gestion des tickets en double, reportez-vous à la section "Gestion des tickets en double".
newTicketHandle	String Holder	Identifie l'objet String Holder pour la capture des données renvoyées. Voir la liste Retour d'éléments XML ci-dessous pour plus de détails.
newTicketNumber	String Holder	Identifie l'objet String Holder pour la capture des données renvoyées. Voir la liste Retour d'éléments XML ci-dessous pour plus de détails.
returnUserData	String Holder	Identifie l'objet String Holder pour la capture des données renvoyées. Voir la liste Retour d'éléments XML ci-dessous pour plus de détails.
returnApplicationData	String Holder	Identifie l'objet String Holder pour la capture des données renvoyées. Voir la liste Retour d'éléments XML ci-dessous pour plus de détails.

Description

Crée un ticket à partir des règles définies dans la politique Service Aware et dans le type de problème spécifié. Le type de problème spécifie le type de ticket créé par un modèle Demande/Demande de changement/Demande client. La description fournie est copiée, et l'utilisateur est défini à partir du contact proxy de la politique d'accès.

Si l'attribut problem_type entré n'existe pas, le type de problème utilisé est celui défini par défaut dans la politique. Le type de problème définit également la manière de gérer la création de tickets en double ainsi que d'autres données renvoyées. Pour en savoir plus sur la configuration des politiques d'accès et des types de problème, reportez-vous au Manuel d'implémentation.

Eléments renvoyés

Renvoie le descripteur du nouveau ticket, le numéro de ticket et les données renvoyées, spécifiées par l'utilisateur et définies dans le type de problème servant à créer le ticket.

Elément XML	Type	Description
<UDSObject>	N/D	Renvoie l'élément XML à des fins de cohérence avec les retours de ces autres méthodes : createRequest() createChange() createIssue() Le corps de la balise est vide.
<newTicketHandle>	Chaîne	Identifie le nouveau descripteur du ticket.
<newTicketNumber>	Chaîne	Identifie le numéro du nouveau ticket (son attribut ref_num ou chg_ref_num).
<returnUserData>	Chaîne	Identifie les données spécifiées par l'utilisateur pour le type de problème et destinées à l'utilisateur final ou aux entrées du journal. Vous pouvez définir cette valeur dans le champ Renvoi des données de l'utilisateur de l'onglet Données renvoyées de la fenêtre Détail du type de problème.
<returnApplicationData>	Chaîne	Identifie les données spécifiées par l'utilisateur pour le type de problème et devant être utilisées dans le code de l'application, surtout pour les actions. Vous pouvez définir cette valeur dans le champ Renvoi des données d'application de l'onglet Données renvoyées de la fenêtre Détail du type de problème.