Ungroup Method

Ungroup is a business component-based version of Explode. It creates multiple instances of a product. The number of instances is determined by the value of the field specified by the Quantity Field argument. For each new instance, the value of the Quantity Field is set to 1. An existing instance is considered for ungrouping only if it meets the conditions specified by the Condition Field Names and Condition Values arguments. The updated business component instances are written to the database.

Arguments

Line Item BC Name

[In] Name of the line item business component to be ungrouped. (Required)

Extended Attribute BC Name

[In] Name of the XA business component associated with the line item business component. (Required)

Quantity Field

[In] Name of field in the line item business component that is used to determine the number of instances to be created. (Required)

Header Id

[In] Row Id of the header business component instance. (Required)

Header Id Field

[In] Name of the field in the header business component that stores the Row Id. (Required)

Root Item Id

[In] Id of the root item in the line item business component. (Required)

Root Item Id Field

[In] Name of the field in the line item business component that stores the Root Item Id. (Required)

Parent Item Id Field

[In] Name of the field in the line item business component that stores the Parent Item Id. (Required)

Line Number Field

[In] Name of the field in the line item business component that stores the Line Number. (Required)

XA Header Id Field

[In] Name of the field in the XA business component that stores the Header Id. (Required)

XA Parent Root Id Field

[In] Name of the field in the XA business component that stores the Parent Root Id. (Required)

XA Line Item Id Field

[In] Name of the field in the XA business component that stores the Line Item Id. (Required)

Condition Field Names

[In] Comma separated list of field names. An existing instance is ungrouped only if the conditions specified by Condition Field Names and Condition Values are met. (Optional)

Condition Values

[In] Comma separated list of condition values. Standard Siebel expressions (such as LookupValue) are supported. An existing instance is ungrouped only if the conditions specified by Condition Field Names and Condition Values are met. (Optional)

Integer Fields to Split

[In] Comma separated list of fields of type Integer for which the value is to split between the multiple instances. For example, if an instance has a field value of 12 and a quantity of 4, the integer field will have a value of 3 in each of the multiple instances. (Optional)

Number Fields to Split

[In] Comma separated list of fields of type Number for which the value is to split between the multiple instances. (Optional)