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

createRequest

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

Description

Crea un objeto de solicitud de CA SDM (cr). Debe utilizar esta función para crear una solicitud; no utilice createObject().

propertyValues es una lista de valores de cada objeto de propiedad que se adjuntará a la nueva solicitud. Las propiedades adjuntas se determinan mediante el valor de atributo "category" (categoría) de la nueva solicitud. Todas las propiedades creadas desde la interfaz de servicios Web de CA SDM tendrán un valor predeterminado (para obtener más información, consulte la sección Categorías y propiedades), que es importante ya que no se guardará una solicitud hasta que todas sus propiedades marcadas como "obligatorias" tengan un valor.

Puede sustituir el valor predeterminado proporcionando valores para todas las propiedades que se adjuntarán al crear la solicitud. Debe proporcionar esta información antes de crear la solicitud, ya que createRequest() intentará almacenar el último objeto creado. Utilice getPropertyInfoForCategory() para obtener una lista de propiedades para una categoría específica. Esta función devuelve las propiedades en el orden de su atributo "sequence" (secuencia), que es el orden esperado de la matriz propertyValues. Por ejemplo, si las secuencias y los símbolos de las propiedades son los siguientes:

100 - Tamaño del disco duro

200 - CPU 

300 - Memoria

La matriz propertyValues puede aparecer de la siguiente forma en función del lenguaje de programación:

[“40 GB”, “Pentium 4 1,7 Ghz”, “256”]

getPropertyInfoForCategory() indica las propiedades marcadas como obligatorias.

Si no define la categoría de solicitud o no desea definir ningún valor de propiedad, introduzca una cadena vacía para propertyValues.

Si no desea basarse en los valores de propiedad predeterminados, se sugiere el orden siguiente para crear una nueva solicitud (o incidencia u orden de cambio):

1. Recupere una lista de categorías/áreas. El nombre de objeto del área de solicitud es "pcat".
2. Llame a getPropertyInfoForCategory() y examine la lista de propiedades de la categoría de la nueva solicitud/incidencia/cambio.
3. Cree una matriz de valores para cada propiedad devuelta. Esto se identifica mediante el parámetro propertyValues para la operación de creación.
4. Monte la matriz attrVals y llame al método de creación.

Como alternativa al método anterior, puede recuperar la lista de propiedades utilizando getRelatedListValues() cuando se devuelva createRequest(). Las propiedades se almacenan en la lista de propiedades de una solicitud.

En función de la aplicación, puede que sea más rápido almacenar en caché, al menos, la lista de categorías, ya que estos datos no cambian a menudo en muchos sitios cliente.

Nota: De manera predeterminada, este método crea una solicitud. Si utiliza la metodología ITIL, tiene que definir el atributo "type" en la matriz attrVals para determinar si está creando un parte de incidente o de problema. Para obtener más información sobre procedimientos ITIL, consulte la sección Notas sobre el uso de la instalación de la metodología ITIL.

Resultado

Devuelve el identificador de los nuevos objetos con todos sus valores de atributo. También se devuelven los valores LREL y de lista, pero como elementos vacíos.