Metodi dei servizi Web › Metodi vari › updateObject

Argomento precedente: serverStatus

Argomento successivo: Metodi dei flussi di lavoro

updateObject

I parametri seguenti sono validi per il metodo updateObject:

Parametro

Tipo

Descrizione

SID

Numero intero

Identifica la sessione recuperata dall'accesso.

objectHandle

Stringa

Identifica l'handle di un oggetto di CA SDM da aggiornare.

attrVals

String[]

Identifica le coppie nome-valore per l'aggiornamento.

attributi

String[]

Identifica la sequenza dei nomi di attributo dall'oggetto per cui restituire i valori. È possibile utilizzare la notazione a punti. Se questo campo è vuoto, vengono restituiti tutti i valori degli attributi.

Descrizione

Aggiorna uno o più attributi per l'oggetto specifico.

Per impostare i valori per l'oggetto, il chiamante passa un array monodimensionale delle coppie nome-valore dell'attributo. La prima metà della coppia è un nome di attributo; la seconda metà è il valore effettivo. I nomi puntati non sono ammessi.

Per aggiornare un attributo di tipo Puntatore (ad esempio, il campo Cliente in una richiesta), è necessario utilizzare un handle per il valore. Per i tipi di attributo Intero, Data e Durata, passare la rappresentazione della stringa di un valore intero.

Ad esempio, per aggiornare una richiesta con un nuovo assegnatario, una nuova descrizione e una nuova priorità, l'array è il seguente:

[0] - "assegnatario"

[1] - "cnt:555A043EDDB36D4F97524F2496B35E75"  (un handle contatto)

[2] - "descrizione"

[3] - "Nuova descrizione"

[4] - "priorità"

[5] - "pri:38903"  (un handle di priorità)

Se per qualche motivo l'aggiornamento non ha esito positivo, l'intera operazione viene annullata e non viene apportato alcun cambiamento.

Nota: quando si aggiorna un'attività, impostare il valore dello stato per ultimo nell'array dell'attributo.

Valore restituito

Un elemento <UDSObject> contenente l'handle dell'oggetto, insieme ai valori di attributo specificati nel parametro attributes. Se il parametro attributes è vuoto, vengono restituiti tutti i valori di attributo. Vengono restituiti anche i tipi di attributo list e LREL, ma non gli elementi vuoti.

getArtifact

I parametri seguenti sono validi per il metodo getArtifact:

Parametro

Tipo

Descrizione

SID

Numero intero

Identifica la sessione recuperata dall'accesso.

contatto

Stringa

Identifica il nome dell'utente associato al ARTIFACT restituito.

Nota: questo è il nome di accesso al sistema, non il nome di contatto per CA Service Desk Manager.

password

Stringa

Identifica la password.

Descrizione

Facilita la creazione degli URL dell'interfaccia Web che possono essere utilizzati per avviare l'interfaccia Web nel contesto di un utente con accesso senza verifica. L'URL può essere simile al seguente:

http://host/CAisd/pdmweb.exe?USERNAME=xxxxx+ARTIFACT=nnnnn+OP=xxxx....

Per avviare l'interfaccia Web di un utente (ad esempio un analista), un'applicazione di chiamata deve innanzitutto creare un URL dell'interfaccia Web, che includa un token CA EEM ARTIFACT (un token di protezione dell'interfaccia Web). La mancata fornitura di un token CA EEM ARTIFACT potrebbe causare un accesso interattivo senza verifica quando si tenta di avviare l'interfaccia Web nel contesto specifico (ad esempio una vista dettagliata di un ticket). Il metodo getArtifact consente al CA EEM ARTIFACT di essere generato nel contesto dell'utente specificato dal parametro del contatto.

Nota: Service Desk deve essere integrato con CA EEM per eseguire questa operazione.

Valore restituito

Un CA EEM ARTIFACT basato sul nome dell'utente immesso. È possibile utilizzare solo una volta ARTIFACT per avviare l'interfaccia Web.