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>