Metodi dei servizi Web › Metodi business › attachChangeToRequest

Argomento precedente: createActivityLog

Argomento successivo: detachChangeFromRequest

attachChangeToRequest

I parametri seguenti sono validi per il metodo attachChangeToRequest:

Parametro

Tipo

Descrizione

SID

Numero intero

Identifica la sessione recuperata dall'accesso.

autore

Stringa

Identifica l'handle del contatto responsabile dell'attività.

requestHandle

Stringa

Identifica la richiesta a cui associare la modifica.

changeHandle

Stringa

Identifica l'handle della modifica da aggiungere. Se non è presente alcun valore, viene creato un nuovo ordine di cambiamento. Per ulteriori informazioni, vedere la descrizione seguente.

changeAttrVals

String[]

Identifica le coppie attributo-valore utilizzate per inizializzare un nuovo ordine di cambiamento se il parametro changeHandle non contiene alcun valore. Per ulteriori informazioni, vedere la descrizione seguente.

descrizione

Stringa

(Facoltativo) Identifica la descrizione dell'attività.

Descrizione

Associa un ordine di cambiamento nuovo o esistente a una richiesta. Corrisponde a "Attività—Nuova richiesta di cambiamento" o "Attività—Associa ad una richiesta esistente" in Dettagli richiesta nell'interfaccia di CA SDM.

Per creare un nuovo ordine di cambiamento, passare la stringa vuota nel parametro changeHandle. Il sistema crea un nuovo ordine di cambiamento con i valori inizializzati dalla richiesta, tra cui il richiedente del cambiamento, l'utente finale interessato, la descrizione e la priorità (è possibile vedere l'effetto di questa attività nell'interfaccia di CA SDM). È possibile sostituire tali valori o impostarne altri con il parametro changeAttrVals, che rappresenta un array di nome-valore simile a quello che viene passato per il metodo createObject().

Per associare un ordine di cambiamento esistente, specificare un handle nel parametro changeHandle. In questo caso, il parametro changeAttrVals viene ignorato.

Se viene creato un nuovo ordine di cambiamento, il parametro description viene utilizzato nel registro attività del nuovo ordine di cambiamento. Se viene associato un ordine di cambiamento esistente, il parametro description viene utilizzato nel registro attività della richiesta.

Se alla richiesta è già associato un ordine di cambiamento, viene restituito l'errore seguente:

UDS_CREATION_ERROR

Nota: questo metodo funziona esattamente come nella metodologia ITIL. Verificare semplicemente che al metodo venga passato l'handle appropriato di un problema o di un incidente ITIL.

Valore restituito

I valori restituiti sono i seguenti:

Elemento XML

Tipo

Descrizione

<changeHandle>

Stringa

Identifica l'handle di un ordine di cambiamento creato o associato.