updateObject

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

updateObject

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

Parámetro	Tipo	Descripción
SID	Entero	Identifica la sesión recuperada del inicio de sesión.
objectHandle	Cadena	Determina el identificador del objeto de CA SDM para actualizar.
attrVals	Cadena[]	Identifica los pares nombre-valor para la actualización.
atributos	Cadena[]	Identifica la secuencia de nombres de atributo desde el 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.

Description

Actualiza uno o más atributos para el objeto especificado.

Para definir los valores para el objeto, el autor de la llamada introduce una matriz de una sola dimensión de pares nombre-valor del atributo. La primera mitad del par es un nombre de atributo y la segunda, el valor real. No se permiten nombres con puntos.

Para actualizar un atributo de tipo puntero (por ejemplo, el campo de cliente en una solicitud), se debe utilizar un identificador para el valor. Para los tipos Integer, Date y Duration, introduzca la representación de cadena de un número entero.

Por ejemplo, para actualizar una solicitud con un asignatario, una descripción y una prioridad nuevos, la matriz se mostraría de la siguiente forma:

[0] - “assignee”

[1] - “cnt:555A043EDDB36D4F97524F2496B35E75”  (a contact Handle)

[2] - “description”

[3] - “My new description”

[4] - “priority”

[5] - “pri:38903”  (a priority Handle)

Si la actualización ha fallado por cualquier motivo, se interrumpe toda la operación y no se produce ningún cambio.

Nota: Al actualizar una tarea, defina el valor de estado en último lugar en la matriz de atributos.

Resultado

Un elemento <UDSObject> que contiene el identificador del objeto actualizado, 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.

getArtifact

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

Parámetro

Tipo

Descripción

SID

Entero

Identifica la sesión recuperada del inicio de sesión.

contact

Cadena

Identifica el nombre del usuario asociado al ARTIFACT devuelto.

Nota: Éste es el nombre de inicio de sesión del sistema, no el nombre de contacto de CA Service Desk Manager.

contraseña

Cadena

Identifica la contraseña.

Descripción

Facilita la creación de las URL de la interfaz Web que se pueden utilizar para iniciar dicha interfaz Web en el contexto de un usuario determinado sin tener que iniciar una sesión. La URL debe ser similar a la siguiente:

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

Para iniciar la interfaz Web en el contexto de un usuario determinado (por ejemplo, un analista), una aplicación de llamada debe primero crear una URL de la interfaz Web que incluya un token de artefacto de CA EEM (un token de seguridad de la interfaz Web). Si no se proporciona un token de artefacto de CA EEM, es posible que aparezca un inicio de sesión interactivo al intentar iniciar la interfaz Web en el contexto elegido (como una vista detallada de un ticket determinado). El método getArtifact permite que el artefacto de CA EEM se genere en el contexto del usuario proporcionado por el parámetro de contacto.

Nota: Service Desk se debe integrar con CA EEM para realizar esta operación.

Resultado

Un artefacto de CA EEM basado en el nombre de usuario introducido. Se puede usar el artefacto para iniciar la interfaz Web solamente una vez.