Complex Type: tns:transferEntitlementInfoType

Component	Type	Occurs	Description
		1..1
entitlementIdentifier	entitlementIdentifierType	1..1	Required. See entitlementIdentifierType.
accountTo	string	1..1	Required. Account identifier of the account to which the entitlement is to be transferred.
retainExistingIds	boolean	0..1	Optional. Set to true to preserve entitlement and activation IDs associated with the entitlement after it is transferred. Set to false (the default) to have FlexNet Operations generate new entitlement and activation IDs for the entitlement. If custom IDs are required, they must be set in subsequent update requests.
returnActiveFulfillments	boolean	0..1	Optional. Set to true (the default) to return any active fulfillments that have been activated against this entitlement before the transfer is done. The transfer cannot proceed if there are active fulfillments against the entitlement.
returnRemainingLineItems	boolean	0..1	The returnRemainingLineItems setting is used during the transfer of entitlements when the configuration property Transfer entitlement with remaining quantity only is enabled. If this configuration is disabled, the returnRemainingLineItems setting has no impact on the transfer process. When returnRemainingLineItems is enabled (true): During an entitlement transfer, if some line items are already deployed, the remaining undeployed line items will be transferred to the target entitlement. Example: Suppose entitlement E1 with activation AC1 has a quantity of 100, and 20 line items have been deployed. If returnRemainingLineItems is enabled, the remaining 80 undeployed line items will be transferred to the target entitlement. When returnRemainingLineItems is disabled (false): If some line items are already deployed during an entitlement transfer, an error message will be returned, indicating that the entitlement cannot be transferred because certain line items are already deployed. Example: Suppose entitlement E1 with activation AC1 has a quantity of 100, and 20 line items have been deployed. If returnRemainingLineItems is disabled, an error message will be returned as part of the response. By default, returnRemainingLineItems is set to false. This property only takes effect if the Transfer entitlement with remaining quantity only configuration property is enabled.
forceTransferEvenIfNoTargetUsers	boolean	0..1	Optional. Set to true to force the transfer even in cases where product category constraints prevent all current users at the target account from seeing the entitlement. Default: false.
forceTransferEvenIfParentAndChildSeparated	boolean	0..1	Optional. Set to true to force the transfer even in cases where the transfer causes the parent and child line items to be separated. There are two cases in which this separation might occur: If the entitlement has line items that are child line items that have a specified parent, and the parent line item does not belong to this same entitlement or the target account, then all such child line items will have the parents set to null. If the entitlement has line items such that any one is a parent (has child line items) and the child line items belong to other entitlements. Default: false.

entitlementIdentifier

entitlementIdentifierType

1..1

Required. See entitlementIdentifierType.

accountTo

string

1..1

Required. Account identifier of the account to which the entitlement is to be transferred.

retainExistingIds

boolean

0..1

Optional. Set to true to preserve entitlement and activation IDs associated with the entitlement after it is transferred. Set to false (the default) to have FlexNet Operations generate new entitlement and activation IDs for the entitlement. If custom IDs are required, they must be set in subsequent update requests.

returnActiveFulfillments

boolean

0..1

Optional. Set to true (the default) to return any active fulfillments that have been activated against this entitlement before the transfer is done. The transfer cannot proceed if there are active fulfillments against the entitlement.

returnRemainingLineItems

boolean

0..1

The returnRemainingLineItems setting is used during the transfer of entitlements when the configuration property Transfer entitlement with remaining quantity only is enabled. If this configuration is disabled, the returnRemainingLineItems setting has no impact on the transfer process.

When returnRemainingLineItems is enabled (true): During an entitlement transfer, if some line items are already deployed, the remaining undeployed line items will be transferred to the target entitlement.

Example: Suppose entitlement E1 with activation AC1 has a quantity of 100, and 20 line items have been deployed. If returnRemainingLineItems is enabled, the remaining 80 undeployed line items will be transferred to the target entitlement.
When returnRemainingLineItems is disabled (false): If some line items are already deployed during an entitlement transfer, an error message will be returned, indicating that the entitlement cannot be transferred because certain line items are already deployed.

Example: Suppose entitlement E1 with activation AC1 has a quantity of 100, and 20 line items have been deployed. If returnRemainingLineItems is disabled, an error message will be returned as part of the response.

By default, returnRemainingLineItems is set to false. This property only takes effect if the Transfer entitlement with remaining quantity only configuration property is enabled.

forceTransferEvenIfNoTargetUsers

boolean

0..1

Optional. Set to true to force the transfer even in cases where product category constraints prevent all current users at the target account from seeing the entitlement.

Default: false.

forceTransferEvenIfParentAndChildSeparated

boolean

0..1

Optional. Set to true to force the transfer even in cases where the transfer causes the parent and child line items to be separated. There are two cases in which this separation might occur:

If the entitlement has line items that are child line items that have a specified parent, and the parent line item does not belong to this same entitlement or the target account, then all such child line items will have the parents set to null.
If the entitlement has line items such that any one is a parent (has child line items) and the child line items belong to other entitlements.

Default: false.

Complex Type: tns:transferEntitlementInfoType

Derived By

Content Model