createObject

Métodos de servicios Web › Métodos variados › createObject

createObject

Los siguientes parámetros se aplican al método createObject:

Parámetro	Tipo	Descripción
SID	Entero	Identifica la sesión recuperada del inicio de sesión.
ObjectType	Cadena	Identifica el tipo de objeto que se desea crear (el nombre de fábrica de Majic).
attrVals	Cadena[]	Identifica una secuencia de pares nombre-valor utilizada para definir los valores de atributo iniciales de la nueva incidencia. Nota: No se permiten nombres con puntos.
atributos	Cadena[]	Identifica una secuencia de nombres de atributo desde el nuevo objeto al que se van a devolver valores. Se permite la notación con puntos. Si este campo está vacío, se devuelven todos los valores del atributo.
createObjectResult	String Holder	Identifica el objeto String Holder para capturar los datos devueltos. Consulte la lista Resultados de elementos XML a continuación para obtener información detallada.
newHandle	String Holder	Identifica el objeto String Holder para capturar los datos devueltos. Consulte la lista Resultados de elementos XML a continuación para obtener información detallada.

Description

Crea un objeto de CA SDM. El autor de la llamada es responsable de definir los campos necesarios en el parámetro attrVals. No se permiten nombres con puntos.

ObjectType

Identifica el nombre de un tipo de objeto (fábrica).

attrVals

Describe la matriz de pares nombre-valor utilizada para iniciar el nuevo objeto. Por ejemplo, el siguiente código falso muestra cómo crear un contacto y devolver un elemento <UDSObject> con valores para todos sus atributos:

String [4] attrVals;

attrVals[0] = “first_name”;	// nombre de atributo

attrVals[1] = “Edgar”;

attrVals[2] = “last_name”;

attrVals[3] = “Martin”;

string [0] emptyArray;

CreateObject(sid, “cnt”, attrVals, emptyArray, createObjectReturn, newHandle);

Nota: No utilice este método para nuevos activos, incidencias, solicitudes u órdenes de cambio. Utilice los métodos especializados createXXX() para dichos tipos de objeto. Esto también es aplicable si utiliza la metodología ITIL: utilice los métodos adecuados para crear elementos de configuración, incidentes y problemas.

Resultado

Elemento <UDSObject> que contiene el nuevo identificador de objeto, junto con los valores del atributo especificados en el parámetro attributes. Si el parámetro attributes está vacío, se devuelven todos los valores del atributo. También se devuelven los valores LREL y de lista, pero como elementos vacíos.

Elemento XML	Tipo	Descripción
<createObjectResult>	N/D	Identifica el elemento UDSObject estándar que contiene el identificador y los valores de atributo solicitados.
<newHandle>	Cadena	Determina el identificador del nuevo objeto.