How to obtain unique ID's

[ptancre]

Hi,

How can you get the following : 

<product>
<uniqueId>???</uniqueId>
</product>

and 

<licenseModel>

<uniqueId>???</uniqueId>

</licenseModel>

From the producer portal or else?

Thanks,

[jberthold]

Hi @ptancre ,

May I ask why you need these IDs?  If you are using web services can you use the product / license model names?

Thanks,

[ptancre]

thank you for your reply, I am happy to add name but this part :
<entitledProduct>
<!-- Optional -->
<product>
<uniqueId>[string?]</uniqueId>
</product>
<quantity>[integer]</quantity>
</entitledProduct>
</entitledProducts>
requires the id and I trying to add the name string does not work...

[jberthold]

Hi @ptancre ,

Which web service are you using?

Thanks,

[ptancre]

/services/v4/EntitlementOrderService

[jberthold · Accepted solution]

Hi @ptancre ,

Can  you be more specific (which web service(s) in the EntitlementOrderService wsdl)?

For example, if you are using createSimpleEntitlement, you can specify either the Product ID or the Product Name/Version:

<urn:product>
   <!--Optional:-->
          <urn:uniqueId>?</urn:uniqueId>
<!--Optional:-->
<urn:primaryKeys>
        <urn:name>?</urn:name>
        <urn:version>?</urn:version>
</urn:primaryKeys>

Same with the License Model, you can reference it by id or name:

<urn:licenseModel>
    <!--Optional:-->
    <urn:uniqueId>?</urn:uniqueId>
<!--Optional:-->
   <urn:primaryKeys>
        <urn:name>?</urn:name>
   </urn:primaryKeys>
</urn:licenseModel>

You can obtain the Product ID using the getProductsQuery and the License Model ID using getLicenseModelIdentifiers but first let's see if you can get what you need by using the names instead of having to make additional calls to retrieve the IDs.

Thanks,

[ptancre]

thank you for your reply, I use v4/EntitlementOrderService/createSimpleEntitlement.
So, correct me if I'm wrong, but I need to fill up the product/partNumber and licenseModel under lineItems and then the entitledProducts to define qty ?

[ptancre]

So your solution works for the licenseModel and the productId, I am assuming I need to remove the 'HID-' in front?

[jberthold]

Hi @ptancre ,

If you choose to use the ProductID to specify the product as opposed to the Product Name and version then you do not need to remove the "HID" identifier in the Product ID.  I have attached an example where the Product ID is specified. 

Best regards,

[jberthold]

HI @ptancre ,

Note that the use of Part number in the web service will reduce the number of fields you need to supply as it ties a Product Version with a License model.   I have attached an example.

Best regards,

[ptancre]

thank you for your example(s), seems to create line items now (even though I get a '9999:java.lang.NullPointerException' a failed response, I can see the new line item populated.
Now this only works if I specify an 'id' for the entitlement.
What I would like is, to create a new entitlement and new line items. I use the createSimpleEntitlement, am I correct to assume this webservice should do both or I would need to have a 2 steps process?

[jberthold]

Hi @ptancre ,

You should not have to provide an entitlement id.  If you would like FNO to create a unique entitlement id then set autoGenerate to true:

<urn:entitlementId>
        <urn:autoGenerate>true</urn:autoGenerate>
</urn:entitlementId>

You can create a new entitlement with multiple line items in one pass.  Simply repeat the information between the lineItems tags for each entitlement line.  I have attached an example with an auto-generated entitlement id and two line items.

Best regards,