Change Log for 2024.09

Ability to Update Parent Activation ID Using updateEntitlementLineItem Web Service

Changes have been made to the EntitlementOrderService web service (version7) to provide the ability to update a parent activation ID using the updateEntitlementLineItem web service (see Managing Upgrade Relationship Using EntitlementOrderService Web Service (Version 7)).

When there are multiple entitlement line items, the updateEntitlementLineItem web service endpoint can be used to add or remove an upgrade relationship between two such valid line items.

Modifications to XSD files

Modifications were made to the following files associated with the EntitlementOrderService web service:

• commonEntitlementTypes.xsd
• commonIdentifierTypes.xsd
• entitlementLineItemTypes.xsd

commonEntitlementTypes.xsd

The following table shows what changes were made to the commonEntitlementTypes.xsd file. Additions are highlighted.

#

Change

1

<xs:simpleType name="LineItemType">

  <xs:restriction base="xs:NMTOKEN">

    <xs:enumeration value="NEW"/> 

    <xs:enumeration value="UPGRADE"/>

    <xs:enumeration value="UPSELL"/>

    <xs:enumeration value="RENEWAL"/>

  </xs:restriction>

</xs:simpleType>

commonIdentifierTypes.xsd

The following table shows what changes were made to the commonIdentifierTypes.xsd file. Additions are highlighted.

#

Change

1

<xs:complexType name="entitlementLineItemIdentifierType">

  <xs:sequence>

    <xs:element name="uniqueId" type="xs:string" minOccurs="0"/>

    <xs:element name="primaryKeys" type="tns:entitlementLineItemPKType" minOccurs="0"/>

  </xs:sequence>

</xs:complexType>

 

<xs:complexType name="parentLineItemIdentifierType"> 

  <xs:sequence> 

    <xs:element name="uniqueId" type="xs:string" minOccurs="0"/> 

    <xs:element name="primaryKeys" type="tns:entitlementLineItemPKType" minOccurs="0"/> 

    <xs:element name="lineItemType" type="tns:LineItemType" minOccurs="0"/> 

  </xs:sequence> 

</xs:complexType> 

entitlementLineItemTypes.xsd

The following table shows what changes were made to the entitlementLineItemTypes.xsd file. Additions are highlighted.

#

Change

1

<xs:complexType name="updateLineItemDataType">

  <xs:sequence>

    <xs:element name="lineItemIdentifier" type="tns:entitlementLineItemIdentifierType"/>

    <xs:element name="activationId" type="tns:idType" minOccurs="0"/>

    <xs:element name="description" type="xs:string" minOccurs="0"/>

    .

    .

    .

    <xs:element name="versionDateAttributes" type="tns:versionDateAttributesType" minOccurs="0"/>

    <xs:element name="parentLineItem" type="tns:parentLineItemIdentifierType" minOccurs="0"/>

    <xs:element name="updatedEntitledProducts" type="tns:updateEntitledProductDataListType" minOccurs="0"/>

    <xs:element name="entitledProducts" type="tns:entitledProductDataListType" minOccurs="0"/>

    <xs:element name="lineItemAttributes" type="tns:attributeDescriptorDataType" minOccurs="0"/>

  </xs:sequence>

</xs:complexType>

Note:This issue was tracked in SWM-22361.