The information on this page refers to SOAP version 2. This function replaced FindLicenseByExpirationDate in SOAP version 1. 

The FindLicenseByExpirationDateBetween function is used to find all licenses that have an expiration date between the start and end dates specified in this function.

This function requires a login token, which is obtained using the Login function. This function also uses an offset and a start date and end date in the format YYYY-MM-DD. For example, if you have three licenses that expire on 2013-05-26, 2013-09-10, and 2013-12-02, and you specify a start date of 2013-05-26 and an end date of 2013-09-10 in this function, the first two licenses will be returned.

Return values

The response is of the type Soap_Response_List_License, with result_array of type ArrayOfSoap_License.

Example request

<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns="https://license.x-formation.com/soap/type/vendor/version/2">
   <soapenv:Header/>
   <soapenv:Body>
      <ns:FindLicenseByExpirationDateBetween soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <token xsi:type="xsd:string">648acb1cb0c129f0c143f25a76521c429a06ef2b</token>
         <startDate xsi:type="xsd:string">2016-01-01</startDate>
         <endDate xsi:type="xsd:string">2020-01-01</endDate>
         <offset xsi:type="xsd:int">0</offset>
      </ns:FindLicenseByExpirationDateBetween>
   </soapenv:Body>
</soapenv:Envelope>

Example response

<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="https://license.x-formation.com/soap/type/vendor/version/2"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <SOAP-ENV:Body>
      <ns1:FindLicenseByExpirationDateBetweenResponse>
         <return xsi:type="ns1:Soap_Response_List_License">
            <result_array SOAP-ENC:arrayType="ns1:Soap_License[1]" xsi:type="ns1:ArrayOfSoap_License">
               <item xsi:type="ns1:Soap_License">
                  <id xsi:type="xsd:int">13</id>
                  <activation_key xsi:type="xsd:string">XSFGS-270T9-4PWEI-4TE4Q</activation_key>
                  <license_text xsi:type="xsd:string"># This license is generated using X-Formation License Activation Center
# Generation Time: 2012-07-16 12:22:26 GMT
# Activation Key: XSFGS-270T9-4PWEI-4TE4Q

FEATURE f2
{
VENDOR=XFORMATION VERSION=1.0 END=2017-06-27 LICENSEE="11"
KEY=H1r8mwNJ1bpUD7kOFUm6NQrF69eXWvPHCTTJpO2mZK96GI2FqG5TmumxXxXdXWD]NWwr9tE[vwie0SLJSfJ6vR1aERFicYuWBl8b \
	RE1Umv4GlfN6ENZnkS[Wnuj6B57hBB3AuoAQLEXLtnMFZSDwSXyR1DX6OcwvBgHhRHA3LitmpBi69cRBEa3KjX59I[bNb]e3cXlw \
	PFMpSV8sc4SaLLdeMfhu]7Wrh12brVQTMxNMIbN6KBuxTeq26SwO1wYxr6caoPa6eJtM5JdzWesfmlAR3kfl7MT6eTz[mTPrA9BK \
	FgY63pMWhAEVFvpEBtPG]jiOIQM5sxX64UnR7XPWdSPt4hL0TegFz7UDzVxmynNDNKqdbgRJNkmPIqY9vUV1k0mcmuv]6odZjkan \
	ae590YbeIpL1AJ2fCB9YmWxdkSqg[frdWULTXustSgfViWZ6KUhd1o[sKzmnrSfTmFQMlEqFAXsg
}</license_text>
                  <activation_time xsi:type="xsd:string">2012-07-16 12:22:26</activation_time>
                  <expiration_date xsi:type="xsd:string">2017-06-27</expiration_date>
                  <HostidValues SOAP-ENC:arrayType="ns1:Soap_HostidValue[1]" xsi:type="ns1:ArrayOfSoap_HostidValue">
                     <item xsi:type="ns1:Soap_HostidValue">
                        <name xsi:type="xsd:string">Not Locked</name>
                        <value xsi:type="xsd:string"/>
                     </item>
                  </HostidValues>
               </item>
            </result_array>
            <result_code xsi:type="xsd:int">0</result_code>
            <result_string xsi:nil="true"/>
         </return>
      </ns1:FindLicenseByExpirationDateBetweenResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
  • No labels