The FindLicenseByExpirationDate function is used to to find all licenses that have an expiration date that is earlier than the date specified in this function.
This function requires a LAC administrator token, which is obtained using the Login function, 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.
In addition, this function uses an offset. Licenses are packed into arrays of 100 elements. You can use an offset greater than 0 to get additional licenses. For example, if you have 321 licenses, you would run this method 4 times using the offsets 0, 100, 200, 300. The first 3 responses will have 100 licenses each, and the last response will have 21 licenses.
Return values
The response is of the type ArrayOfSoap_License which is an array of Soap_License objects.
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>