attachChangeToRequest

Métodos de servicios Web › Métodos de negocios › attachChangeToRequest

attachChangeToRequest

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

Parámetro	Tipo	Descripción
SID	Entero	Identifica la sesión recuperada del inicio de sesión.
creador	Cadena	Determina el identificador del contacto responsable de la actividad.
requestHandle	Cadena	Identifica la solicitud a la que se adjunta el cambio.
changeHandle	Cadena	Determina el identificador del cambio que se va a agregar. Si está en blanco, se crea una nueva orden de cambios. Para obtener más información, consulte la descripción que se muestra a continuación.
changeAttrVals	Cadena[]	Identifica los pares atributo-valor utilizados para iniciar una nueva orden de cambios si el parámetro changeHandle está en blanco. Si desea obtener más información, consulte la descripción que se muestra a continuación.
descripción	Cadena	(Opcional) Identifica la descripción de la actividad.

Descripción

Adjunta una orden de cambios nueva o existente a una solicitud. Se corresponde con los comandos "Actividades—Nueva solicitud de cambio" o "Actividades—Adjuntar a solicitud existente" en una ventana Detalles de la solicitud de la interfaz de CA SDM.

Para crear una nueva orden de cambio, introduzca la cadena vacía en changeHandle. El sistema creará una nueva orden de cambio con los valores de la solicitud, incluidos el solicitante del cambio, el usuario final afectado, la descripción y la prioridad (puede visualizar esto en la interfaz de CA SDM). Puede sustituir éstos o definir valores adicionales con changeAttrVals, que es una matriz nombre-valor parecida al valor introducido para createObject().

Para adjuntar una orden de cambio existente, especifique un identificador en el parámetro changeHandle. En este caso, se omitirá changeAttrVals.

Si se crea una nueva orden de cambio, se utiliza el parámetro description en el registro de actividades de la nueva orden de cambio. Si se adjunta un cambio existente, se utiliza el parámetro description en el registro de actividades de la solicitud.

Si la solicitud ya tiene una orden de cambios adjunta, se devuelve el siguiente error:

UDS_CREATION_ERROR

Nota: Este método funciona exactamente igual para la metodología ITIL; simplemente verifique que introduce el identificador adecuado de un incidente o problema de ITIL en el método.

Resultado

Se devuelve lo siguiente:

Elemento XML	Tipo	Descripción
<changeHandle>	Cadena	Determina el identificador de una orden de cambios, ya sea creada o adjunta.