The FindLicenseByExpirationDate function is used to find all licenses that have an expiration date that is earlier than the date specified in this function.
This function requires a login token, which is obtained using the Login function. This function also uses an offset and an expiration date in the format YYYY-MM-DD. For example, if you have three licenses that expire on 2011-05-26, 2011-09-10, and 2012-12-02, and you specify an expiration date of 2011-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/1"> <soapenv:Header/> <soapenv:Body> <ns:FindLicenseByExpirationDate soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"> <token xsi:type="xsd:string">292c1bb77d6faf51049dc99e3c3e10d624791052</token> <expirationDate xsi:type="xsd:string">2021-12-07</expirationDate> <offset xsi:type="xsd:int">0</offset> </ns:FindLicenseByExpirationDate> </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/1" 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:FindLicenseByExpirationDateResponse> <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">8</id> <activation_key xsi:type="xsd:string">58ARD-JETMQ-7Z4NQ-WMOEL</activation_key> <license_text xsi:type="xsd:string"> # This license is generated using X-Formation License Activation Center # Generation Time: 2011-11-23 05:42:04 GMT # Activation Key: 58ARD-JETMQ-7Z4NQ-WMOEL FEATURE f1 { VENDOR = XFORMATION VERSION = 2.51 END = 2011-12-08 KEY = lixSdQyvYqNHqXrV2EeJC[zfUKD1RCI6jvMmqSKDuFWnnpqV34Aonef0TbnuxzdbD5jc5h \ n72aJG2MOOCeApu1UFX1tNlTJZRa8bkoHCwKUQ3z[QbwBKuMHavXQD0n6BEssNRBRyJXRR \ RJct752lmOx[JbRq5S7FD1Qoba2XyE1cNsjkJ9HtLZn[CYy]NfASgKRkdrm2JVnnrM8IUM \ t8PWH9P]0PeYZatGsjdfhkjsdhfkljsdhfjksdhfjsds9r6rcQEYbK1IshBrBrdehp7OZ[maRgAh2 \ 8RgvWxc069mfXaDeoxbeJ2up0VYeRHsbop5il1X8bm3wce[LE[P892T5Qr[GWhdWsgoA[9 \ C5zSLUDRF9L6JItz0o7pix8hHN[zoHxnLoJQlLr[96]MEXkgWOh0qBwEDG3I6aIKbvstXR \ NlGzeQb0s]deqME]kdqE2e8NY6FMpkITjcZzFQ80Z316tyQEqe7ejMcJ }</license_text> <activation_time xsi:type="xsd:string">2011-11-23 07:42:04</activation_time> <expiration_date xsi:type="xsd:string">2011-12-08</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:FindLicenseByExpirationDateResponse> </SOAP-ENV:Body> </SOAP-ENV:Envelope>