Sei sulla pagina 1di 5

uso dei web services AHD

Ciao

Per eseguire una create request � necessario seguire gli step documentati di
seguito

1) Effettuare la login a AHD con una chiamata al metodo login()

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ser="http://www.ca.com/UnicenterServicePlus/ServiceDesk">

<soapenv:Header/>

<soapenv:Body>

<ser:login>

<username>xxx</username>

<password>yyy</password>

</ser:login>

</soapenv:Body>

</soapenv:Envelope>

Il sistema risponde con un token (sid) a tempo nell'elemento loginReturn. Questo


token dovr� essere utilizzato in tutte le successive chiamate ai servizi

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<soapenv:Body>

<loginResponse xmlns="http://www.ca.com/UnicenterServicePlus/ServiceDesk">

<loginReturn xmlns="">656653049</loginReturn>

</loginResponse>

</soapenv:Body>

</soapenv:Envelope>
2) Si ottiene l'handle dell'utente che deve creare la richiesta chiamando il metodo
getHandleForUserid passando il sid ottenuto al punto 1) e l'utente da utilizzare

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ser="http://www.ca.com/UnicenterServicePlus/ServiceDesk">

<soapenv:Header/>

<soapenv:Body>

<ser:getHandleForUserid>

<sid>656653049</sid>

<userID>UGA03657</userID>

</ser:getHandleForUserid>

</soapenv:Body>

</soapenv:Envelope>

Il sistema risponde con l'handle nell'elemento getHandleForUseridReturn. Questo


valore deve essere usato per eseguire la chiamata alla createRequest

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<soapenv:Body>

<getHandleForUseridResponse
xmlns="http://www.ca.com/UnicenterServicePlus/ServiceDesk">

<getHandleForUseridReturn
xmlns="">cnt:6133919799194043B66B963A7D3CEBAC</getHandleForUseridReturn>

</getHandleForUseridResponse>

</soapenv:Body>

</soapenv:Envelope>

3) Si esegue la chiamata al metodo createRequest passando il sid ottenuto al punto


1) e l'user id restituito dalla chiamata (2) e una serie di coppie (nome, valore)
che rappresentano i valori da impostare

per la richiesta. Gli elementi <attributes> impostano una serie di valori di


ritorno che il sistema valorizzer� in caso di richiesta andata a buon fine

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ser="http://www.ca.com/UnicenterServicePlus/ServiceDesk">

<soapenv:Header/>

<soapenv:Body>

<ser:createRequest>

<sid>656653049</sid>

<creatorHandle>cnt:6133919799194043B66B963A7D3CEBAC</creatorHandle>

<attrVals>

<string>description</string>

<string>Descrizione problema</string>

<string>category.sym</string>

<string>Age.01.01.01.04</string>

<string>priority</string>

<string>0</string>

</attrVals>

<propertyValues>

<!--1 or more repetitions:-->

<string></string>

</propertyValues>

<template></template>

<attributes>

<string>ref_num</string>

<string>persistent_id</string>
<string>status</string>

<string>open_date</string>

</attributes>

<newRequestHandle>""</newRequestHandle>

<newRequestNumber>""</newRequestNumber>

</ser:createRequest>

</soapenv:Body>

</soapenv:Envelope>

Il sistema risponde con il nodo <UDSObject> che contiene tutti gli attributi
richiesti con i loro valori. Inoltre il nodo newRequestNumber contiene il numero
della richiesta creata

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

<soapenv:Body>

<createRequestResponse
xmlns="http://www.ca.com/UnicenterServicePlus/ServiceDesk">

<createRequestReturn xmlns=""><![CDATA[<?xml version="1.0" encoding="UTF-


8"?><UDSObject>

<Handle>cr:102101131</Handle>

<Attributes>

<Attribute DataType="2002">

<AttrName>ref_num</AttrName>

<AttrValue>19914895</AttrValue>

</Attribute>

<Attribute DataType="2002">

<AttrName>persistent_id</AttrName>

<AttrValue>cr:102101131</AttrValue>
</Attribute>

<Attribute DataType="2005">

<AttrName>status</AttrName>

<AttrValue>SOSP</AttrValue>

</Attribute>

<Attribute DataType="2004">

<AttrName>open_date</AttrName>

<AttrValue>1548940509</AttrValue>

</Attribute>

</Attributes>

</UDSObject>]]></createRequestReturn>

<newRequestHandle xmlns="">cr:102101131</newRequestHandle>

<newRequestNumber xmlns="">19914895</newRequestNumber>

</createRequestResponse>

</soapenv:Body>

</soapenv:Envelope>

4) Dopo la richiesta eseguire il logout con il metodo logout() passando il sid


ottenuto al punto 1) in modo da invalidare il token

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ser="http://www.ca.com/UnicenterServicePlus/ServiceDesk">

<soapenv:Header/>

<soapenv:Body>

<ser:logout>

<sid>656653049</sid>

</ser:logout>

</soapenv:Body>

</soapenv:Envelope>