Page History

The information on this page refers to SOAP version 1. This function has been replaced in SOAP version 2 with the function FindLicenseByExpirationDateBetween.

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 login token, which is obtained using the Loginfunction, 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 20112015-05-26, 20112015-09-10, and 20122015-12-02, and you specify an expiration date of 20112015-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.

See ID fields for information about using the ID field.

Return values

The response is of the type Soap_Response_List_License, with result_array of type ArrayOfSoap_LicenseOn failure, the result string contains an error message. See Return Codes for further information on error messages.

Example request

No Format


<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?wsdl"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">
   <soapenv:Header/>
   <soapenv:Body>
      <ns:AddCustomerFindLicenseByExpirationDate soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <token xsi:type="xsd:string">e84b130bcd3fdf26644064098acdf9f3e5a3bfaa<>292c1bb77d6faf51049dc99e3c3e10d624791052</token>
         <customer<expirationDate xsi:type="nsxsd:Soap_Customer">string">2021-12-07</expirationDate>
         <offset xsi:type="xsd:int">0</offset>
  <!--You may enter the following 12 items in any order-->
    </ns:FindLicenseByExpirationDate>
   </soapenv:Body>
</soapenv:Envelope>

Example response

No Format

<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>
         <id<return xsi:type="xsd:int">0</id>
ns1:Soap_Response_List_License">
              <name<result_array SOAP-ENC:arrayType="ns1:Soap_License[1]" xsi:type="xsdns1:string">Customer Name</name>
ArrayOfSoap_License">
               <street<item xsi:type="xsdns1:string">Street Name</street>
Soap_License">
                  <zip_code<id xsi:type="xsd:stringint">55562<>8</zip_code>
id>
                  <city<activation_key xsi:type="xsd:string">City Name</city>
>58ARD-JETMQ-7Z4NQ-WMOEL</activation_key>
             <state     <license_text xsi:type="xsd:string">State Name</state>>
# 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>
            <country      <activation_time xsi:type="xsd:string">Country Name</country>
>2011-11-23 07:42:04</activation_time>
                 <phone <expiration_numberdate xsi:type="xsd:string">223236</phone_number>
>2011-12-08</expiration_date>
             <fax_number     <HostidValues SOAP-ENC:arrayType="ns1:Soap_HostidValue[1]" xsi:type="xsdns1:string">223236</fax_number>ArrayOfSoap_HostidValue">
            <vat_number         <item xsi:type="xsdns1:string">123</vat_number>
Soap_HostidValue">
             <description           <name xsi:type="xsd:string">Optional description for this customer</description>
>Not Locked</name>
                        <Contacts<value xsi:type="ns:ArrayOfSoap_Contact" soapenc:arrayType="ns:Soap_Contact[]xsd:string"/>
                     </customer>item>
                  </ns:AddCustomer>HostidValues>
   </soapenv:Body>
</soapenv:Envelope>

Example response

No Format


<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?wsdl"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
   <SOAP-ENV:Body>
            <ns1:AddCustomerResponse></item>
         <return xsi:type="ns1:Soap_Response">   </result_array>
            <result_code xsi:type="xsd:int">0</result_code>
            <result_string xsi:typenil="xsd:stringtrue"/>
         </return>
      </ns1:AddCustomerResponse>FindLicenseByExpirationDateResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Page tree

Versions Compared

Old Version 1

New Version Current

Key