Page History

...

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.

See ID fields for information about using the ID field.

Return valuesOn failure, the result string contains an error message. See Return Codes for further information on error messages

The response is of the type ArrayOfSoap_License which is an array of Soap_License objects.

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>
      </ns:FindLicenseByExpirationDate>
  <!--You may enter the following 12 items in any order-->
    </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_number    <expiration_date 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 2

Key