createObject

Metodi dei servizi Web › Metodi vari › createObject

createObject

I parametri seguenti sono validi per il metodo createObject:

Parametro	Tipo	Descrizione
SID	Numero intero	Identifica la sessione recuperata dall'accesso.
ObjectType	Stringa	Identifica il tipo di oggetto da creare (il nome factory majic).
attrVals	String[]	Identifica una sequenza di coppie nome-valore utilizzata per impostare i valori di attributo iniziali per la nuova problematica. Nota: i nomi puntati non sono ammessi.
attributi	String[]	Identifica una sequenza di nomi di attributo dal nuovo oggetto per cui restituire i valori. È possibile utilizzare la notazione a punti. Se questo campo è vuoto, vengono restituiti tutti i valori degli attributi.
createObjectResult	String Holder	Identifica l'oggetto String Holder per la cattura dei dati restituiti. Per informazioni dettagliate, vedere l'elenco Restituzione degli oggetti in formato XML.
newHandle	String Holder	Identifica l'oggetto String Holder per la cattura dei dati restituiti. Per informazioni dettagliate, vedere l'elenco Restituzione degli oggetti in formato XML.

Descrizione

Crea un oggetto CA SDM. Il chiamante è responsabile dell'impostazione dei campi obbligatori nel parametro attrVals. I nomi puntati non sono ammessi.

ObjectType

Identifica il nome di un tipo di oggetto (factory).

attrVals

Descrive l'array delle coppie nome-valore utilizzato per inizializzare il nuovo oggetto. Ad esempio, lo pseudo-codice seguente mostra come creare un contatto e restituire un elemento <UDSObject> con i valori per tutti i relativi attributi:

String [4] attrVals;

attrVals[0] = "first_name";_// attribute name

attrVals[1] = "Mario";

attrVals[2] = "last_name";

attrVals[3] = "Rossi";

string [0] emptyArray;

CreateObject(sid, "cnt", attrVals, emptyArray, createObjectReturn, newHandle);

Nota: non utilizzare questo metodo per i nuovi asset, questioni, richieste o ordini di cambiamento. Per questi tipi di oggetti utilizzare i metodi createXXX() specifici. Questo commento è valido anche se si utilizza la metodologia ITIL. Utilizzare i metodi appropriati per creare gli elementi della configurazione, gli incidenti e i problemi.

Valore restituito

Un elemento <UDSObject> contenente l'handle del nuovo 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.

Elemento XML	Tipo	Descrizione
<createObjectResult>	N/D	Identifica l'elemento UDSObject standard che contiene l'handle e i valori di attributo richiesti.
<newHandle>	Stringa	Identifica l'handle dei nuovi oggetti.

Contatta CA Technologies