Referencia a la API SOAP › Métodos de servicios Web › getStartRequestForms

getStartRequestForms

Utilice este método para buscar los formularios de solicitud de inicio en una biblioteca de CA Process Automation. Una búsqueda se basa en la ruta y la palabra clave proporcionadas.

Ejemplo

Con /root como ruta de búsqueda

<tns:getStartRequestForms xmlns:tns="http://www.ca.com/itpam">
<tns:auth>
<!--xsd:Choice Type-->
<tns:token>token__</tns:token>
<tns:user>Joe</tns:user>
<tns:password>thisismypassword</tns:password>
<tns:auth>
<tns:filter>
<tns:lookUpPath isRecursive="true">/</tns:lookUpPath>
<tns:keywords>
<tns:keyword>ABC</tns:keyword>
</tns:keywords>
</tns:filter>
</tns:getStartRequestForms>

Para obtener todos los formularios de solicitud de inicio en el entorno

Especifique / y elimine Keyword__ de las etiquetas de contraseñas:

<tns:getStartRequestFormsResponse xmlns:tns="http://www.ca.com/itpam">
<startRequests>
<tns:startRequest name="Iniciar formulario de solicitud de compra" refPath="/PAM Hardware Procurement/">
<tns:description/>
</tns:startRequest>
<tns:startRequest name="Asset_Install_SW_SRF" refPath="/sinra1/CA ITAM/SRF/">
<tns:description>Objeto Base de datos</tns:description>
</tns:startRequest>
<tns:startRequest name="Asset_MAC_HW_SRF" refPath="/sinra1/CA ITAM/SRF/">
<tns:description>Objeto Base de datos</tns:description>
</tns:startRequest>
<tns:startRequest name="Asset_Transfer_SRF" refPath="/sinra1/CA ITAM/SRF/">
<tns:description>Objeto Base de datos</tns:description>
</tns:startRequest>
<tns:startRequest name="Asset_Disposal_HW_SRF" refPath="/sinra1/CA ITAM/SRF/">
<tns:description>Objeto Base de datos</tns:description>
</tns:startRequest>
<tns:startRequest name="Asset_Install_HW_Transferred_SRF" refPath="/sinra1/CA ITAM/SRF/">
<tns:description>Objeto Base de datos</tns:description>
</tns:startRequest>
<tns:startRequest name="Asset_Install_HW_SRF" refPath="/sinra1/CA ITAM/SRF/">
<tns:description>Objeto Base de datos</tns:description>
</startRequest>
<tns:startRequest name="~Start Request Form" refPath="/Package Demo/">
<tns:description/>
</tns:startRequest>
<tns:startRequest name="~Start Request Form" refPath="/Jack/">
<tns:description/>
</tns:startRequest>
</tns:startRequests>
</tns:getStartRequestFormsResponse>

Búsqueda por palabra clave

Se pueden registrar formularios de solicitud de inicio con palabras clave asociadas a aquellos. Por ejemplo, se puede realizar una búsqueda para encontrar si SRF1 y SRF2 están asociados con la palabra clave "ABC" en la carpeta /myfolder.

<tns:getStartRequestForms xmlns:tns="http://www.ca.com/itpam">
<tns:auth>
<tns:user>Joe</tns:user>
<tns:password>thisismypassword</tns:password>
<tns:auth>
<tns:filter>
<tns:lookUpPath isRecursive="true">/myfolder</tns:lookUpPath>
<tns:keywords>
<tns:keyword>ABC</tns:keyword>
</tns:keywords>
</tns:filter>
</tns:getStartRequestForms>

Solicitud de SOAP

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<tns:getStartRequestForms xmlns:tns="http://www.ca.com/itpam">
<tns:auth>
<tns:user>Joe</tns:user>
<tns:password>thisismypassword</tns:password>
<tns:auth>
<tns:filter>
<tns:lookUpPath isRecursive="true">/</tns:lookUpPath>
<tns:keywords>
<tns:keyword>ABC</tns:keyword>
</tns:keywords>
</tns:filter>
</tns:getStartRequestForms>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Esta etiqueta está presente en la etiqueta <filter>:

• <lookUpPath> proporciona la ruta en la cual el usuario desea buscar los formularios de solicitud de inicio. Un atributo en esta etiqueta es recursivo. Si un usuario desea buscar recursivamente en la ruta proporcionada, debe establecer este atributo como verdadero. Si un usuario desea buscar solamente en la ruta proporcionada, establezca este atributo como verdadero. Proporcione la ruta total (como /Folder/Folder1) como el valor de esta etiqueta en las que el usuario desea buscar.

Respuesta de SOAP

<getStartRequestFormsResponse xmlns="http://www.ca.com/itpam">
<startRequests>
<startRequest name="SRF1" refPath="/TENSU03/">
<description/>
</startRequest>
<startRequest name="SRF2" refPath="/TENSU03/">
<description/>
</startRequest>
</startRequests>
</getStartRequestFormsResponse>

Para todos los formularios de solicitud de inicio que cumplen los criterios para la búsqueda, hay un <startRequest> bajo la etiqueta <startRequests>. Esta etiqueta contiene el nombre, ruta de referencia y descripción del formulario de solicitud de inicio en la respuesta de SOAP.