bw_create_aggregation_level
Creates a new aggregation level on a planning-enabled aDSO or CompositeProvider, enabling Integrated Planning and embedded BPC scenarios. It exposes the provider's characteristics and key figures, with optional field restriction.
Instructions
Create a new Aggregation Level (TLOGO ALVL) on top of a planning-enabled InfoProvider (aDSO or CompositeProvider), for Integrated Planning / embedded BPC. Sequence: lock → POST the shell → unlock → lock → PUT the field list → unlock. The Aggregation Level is created inactive — activate it with bw_activate using object_type "alvl" and lock_handle "". By default every characteristic and key figure of the InfoProvider is exposed; pass fields to restrict the selection. A selection needs at least one characteristic and one key figure, and it must contain every key field of the underlying provider, otherwise activation reports the missing ones. The InfoProvider must be planning-enabled, otherwise the create fails with a message saying it cannot serve as the basis of an aggregation level.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | Yes | Description of the Aggregation Level. | |
| fields | No | Characteristics and key figures to expose, by their name on the InfoProvider (e.g. ["FIELD_NAME", "IOBJ_NAME"]). Omit to expose every field of the provider. Read the provider with bw_get_adso or bw_get_composite_provider to see the names. On a CompositeProvider the fields carry a generated prefix ("<prefix>-FIELD_NAME"); both that form and the bare name are accepted. | |
| package | No | Development package. Defaults to "$TMP" (local, not transported). | |
| info_area | Yes | InfoArea the Aggregation Level is created in (e.g. "AREA_NAME"). | |
| transport | No | Transport request number. Required on systems with transport obligation. | |
| info_provider | Yes | Technical name of the underlying planning-enabled InfoProvider — an aDSO or a CompositeProvider (e.g. "OBJECT_NAME"). | |
| aggregation_level_name | Yes | Technical name of the new Aggregation Level (e.g. "OBJECT_NAME"). |