attachChangeToRequest

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

attachChangeToRequest

Les paramètres suivants s’appliquent à la méthode attachChangeToRequest :

Paramètre	Type	Description
SID	Nombre entier	Identifie la session extraite depuis la connexion.
creator	Chaîne	Identifie le descripteur du contact responsable de l’activité.
requestHandle	Chaîne	Identifie l’appel auquel vous attachez le changement.
changeHandle	Chaîne	Identifie le descripteur du changement à ajouter. Si ce paramètre n’est pas renseigné, une demande de changement est créée. Pour plus d’informations, consultez la description suivante.
changeAttrVals	Chaîne[]	Identifie les paires attribut-valeur utilisées pour initialiser une nouvelle demande de changement si changeHandle n’est pas renseigné. Pour plus d’informations, consultez la description suivante.
description	Chaîne	(Facultatif) Identifie la description de l’activité.

Description

Joint une demande de changement nouvelle ou existante à l’appel. Il correspond à Activités - Nouvelle demande de changement ou Activités - Joindre à l'appel existant dans le détail des appels de l'interface CA SDM.

Pour créer une demande de changement, transmettez la chaîne vide dans changeHandle. Le système crée une demande de changement avec les valeurs initialisées à partir de l'appel, y compris le demandeur, l'utilisateur final affecté, la description et la priorité de la demande de changement (vous pouvez consulter ces éléments dans l'interface CA SDM). Vous pouvez remplacer ces valeurs ou en définir d'autres à l'aide de changeAttrVals. Il s'agit d'un tableau nom-valeur similaire aux éléments transmis pour createObject().

Pour joindre une demande de changement existante, indiquez un descripteur dans le paramètre changeHandle. Dans ce cas, changeAttrVals est ignoré.

Si une demande de changement est créée, la description est utilisée dans le journal d’activité de la nouvelle demande de changement. Si une demande de changement existante est jointe, la description est utilisée dans le journal d’activité de l’appel.

Si une demande de changement est déjà jointe à l’appel, l’erreur suivante est renvoyée :

UDS_CREATION_ERROR

Remarque : Cette méthode fonctionne de la même manière pour la méthodologie ITIL. Veillez simplement à transmettre le descripteur d'un incident ou problème ITIL approprié à la méthode.

Eléments renvoyés

Les éléments suivants sont renvoyés :

Elément XML	Type	Description
<changeHandle>	Chaîne	Identifie le descripteur de la demande de changement créée ou jointe.