Logon

This method is required to create an authenticated Web services session. It must be called before any other webservice methods can be used. This method returns a token which is supplied to all of the other methods.

The parameters for the Logon method are:

Parameter Datatype Description
username string The user name of the user who is logging in.
password string The password associated with the username.
dbtitle string The connection name of the database to connect to.

XML request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
                  xmlns:agil="http://serena.com/Agile">
   <soapenv:Header/>
   <soapenv:Body>
      <agil:Logon>
          <agil:username>user@example.com</agil:username>
         <agil:password>p@$$w0rD</agil:password>
         <agil:dbtitle>AGILE_database_name</agil:dbtitle>
      </agil:Logon>
   </soapenv:Body>
</soapenv:Envelope>

XML response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <LogonResponse xmlns="http://serena.com/Agile">
         <LogonResult>5092995f-f90b-4743-a0f4-1c74de64d2caAGILE_database_name</LogonResult>
      </LogonResponse>
   </soap:Body>
</soap:Envelope>