FLEXNET OPERATIONS SOAP WEB SERVICES GUIDE

FlexNet Operations Web Services Guide

Element: tns:createEntitlementLineItemRequest

Description

A createEntitlementLineItemRequest message contains an element of addOrReplaceEntitlementLineItemRequestType.

Derived By

Type addOnlyEntitlementLineItemRequestType

Content Model

Contains elements as defined in the following table.

Component  Type  Occurs  Description 
    1..1   
lineItem  addEntitlementLineItemDataType  1..*  See addEntitlementLineItemDataType.
opType  CreateOrUpdateOperationType  0..1 

One of the following:

  • CREATE_OR_UPDATE

  • CREATE_OR_IGNORE

Note: If the opType is specified as either CREATE_OR_IGNORE or CREATE_OR_UPDATE, then specifying the entitlement identifier is important. If the entitlement identified by the entitlementIdentifier is not found, then the response could be a FAILURE.

If the opType is set to CREATE_OR_UPDATE and the line item identifier exists, the system will try to handle the request as an update. Updates to the associatedLineItems and lineItemType will be ignored.

Referenced By
Name  Type 
createEntitlementLineItem  Method 
XML Example

The following XML fragment illustrates a createEntitlementLineItemRequest message:

<createEntitlementLineItemRequest>
   <lineItem>
      <entitlementIdentifier>
         <primaryKeys>
            <entitlementId>Ent-simple-test</entitlementId>
         </primaryKeys>
      </entitlementIdentifier>
      <lineItems>
         <activationId>
            <id>Ent-simple-test-1</id>
         </activationId>
         <product>
            <primaryKeys>
               <name>Basic Paint</name>
               <version>1.0</version>
            </primaryKeys>
         </product>
         <licenseModel>
            <primaryKeys>
               <name>Nodelocked Uncounted</name>
            </primaryKeys>
         </licenseModel>
         <licenseModelAttributes>
            <attribute>
               <attributeName>NOTICE</attributeName>
               <stringValue>n</stringValue>
            </attribute>
            <attribute>
               <attributeName>SERIAL_NUMBER</attributeName>
               <stringValue>sn</stringValue>
            </attribute>
         </licenseModelAttributes>
         <orderId>100</orderId>
         <orderLineNumber>1</orderLineNumber>
         <numberOfCopies>10</numberOfCopies>
         <isPermanent>true</isPermanent>
      </lineItems>
      <maintenanceLineItems>
         <activationId>
            <id>Ent-simple-test-1M</id>
         </activationId>
         <maintenanceProduct>
            <primaryKeys>
               <name>Paint Maintenance</name>
               <version>1.0</version>
            </primaryKeys>
         </maintenanceProduct>
         <startDate>2008-01-15</startDate>  
         <expirationDate>2008-01-15</expirationDate>
         <parentLineItem>
            <primaryKeys>
               <activationId>Ent-simple-test-1</activationId>
            </primaryKeys>
         </parentLineItem>
         <!--Optional:--> 
         <maintenanceLineItemAttributes>
         <!--Zero or more repetitions:-->
            <attribute>
               <attributeName>murmure montis</attributeName>
               <!--Optional:-->
               <stringValue>vinclis et</stringValue>
               <!--Optional:-->
               <dateValue>2008-11-04</dateValue>
               <!--Optional:-->
               <booleanValue>true</booleanValue>
               <!--Optional:-->
               <integerValue>100</integerValue>
               <!--Zero or more repetitions:-->
               <arrayValue>sciret dare</arrayValue>
            </attribute>
        </maintenanceLineItemAttributes>
      </maintenanceLineItems>
      <autoDeploy>true</autoDeploy>
   </lineItem>
</createEntitlementLineItemRequest>