Ansicht
Dokumentation
/SAPAPO/OM_CAPA_PROFILE_GET - Get Capacity Profiles of Resources
Vendor Master (General Section) CPI1466 during BackupThis documentation is copyright by SAP AG.
Functionality
This function module determines the capacity profile (supply/use curve) of resources, either aggregated in a time buckets profile - such as the shift period split of the time stream of a resource - or in the form of a "capacity graph", where all changes in supply or use are displayed. You have the option of including terminated breaks in a resource's time stream into the capacity profile. With mixed resources, you can use either the PP/DS or the SNP view of the resources as the basis for the calculation.
Capacity data in a row (in a time period [from,to]) are:
- Capacity supply (CAPA_SUPPLY)
- Capacity use (CAPA_USED)
- For bucketed resources: Initial capacity consumption (CAPA_INIT_USED)
- Break (non-working time) in the time stream? Yes or No
During aggregation of the capacity data of a mixed resource in PP/DS view, the planned activities and the pro rata net time which overlap with a time period in the calculated capacity profile are also determined.
IMPORT PARAMETER
- IT_RES: Table with the internal APO keys (GUID) RESID for the resources that the capacity profile will be determined for.
- IV_AGGREGATE:
- IV_AGGREGATE = GC_FALSE: Determine capacity graph.
- IV_AGGREGATE = GC_TRUE: Aggregate capacities (dynamically) in a time buckets profile.
- IV_USE_SHIFT_GRID
- (Only relevant for aggregation, that is, if IV_AGGREGATE = GC_TRUE):
- IV_USE_SHIFT_GRID = GC_FALSE: Aggregation to the time buckets profile that is defined in IT_GRID.
- IV_USE_SHIFT_GRID = GC_TRUE: Aggregation to the shift period split of the resource's time stream.
- IT_GRID (Table with time intervals):
- If you want to determine the capacity graph (that is, if IV_AGGREGATE = GC_FALSE) or aggregate the time stream of resource RESID to the shift period split (that is, if IV_AGGREGATE = GC_TRUE and IV_USE_SHIFT_GRID = GC_TRUE):
- The table contains precisely one time interval that specifies the time horizons to be taken into account.
- If you want to aggregate with a time buckets profile specified as default from outside (that is, if IV_AGGREGATE = GC_TRUE and IV_USE_SHIFT_GRID = GC_FALSE):
- The table must contain at least one time interval to define the time buckets profile for the aggregation.
- IV_CAPACITY_VIEW_FOR_MIX (only relevant if resource RESID is a mixed resource):
- IV_CAPACITY_VIEW_FOR_MIX = GC_CONTINUOUS_VIEW: Determines the capacity profile of the PP/DS view on the resource RESID (Gantt chart + time stream).
- IV_CAPACITY_VIEW_FOR_MIX = GC_TRUE: Determines the capacity profile of the SNP view on the resource RESID (bucket vector).
- If the resource is a purely time-continuous resource (such as a single resource), there is of course only an PP/DS view. With bucketed resources, on the other hand, there is only the SNP view.
- Selection parameters: Determines the capacity data of those time frames for which the following apply to the resource:
- IV_UNUSED = GC_TRUE: Use = 0.
- IV_USED_LESS_THAN_SUPPLY = GC_TRUE: Use < supply.
- IV_USED_EQUAL_SUPPLY = GC_TRUE: Use = supply.
- IV_USED_MORE_THAN_SUPPLY = GC_TRUE: Use > supply.
- IV_SHOW_BREAKS = GC_TRUE: Integrate the breaks in the resource's time stream into the capacity profile.
EXPORT PARAMETERS
- ET_CAPA_ENTRY: ,,
- This table contains the required capacity profile for each of the specified resources. Each row has the following structure:
- RES_ID: Code (GUID) of the resource that the row's capacity data refers to.
- FROM_TIME and TO_TIME Specify the time period in which the row's capacity data is valid.
- CAPA_SUPPLY: The capacity supply for the resource in the time period from FROM_TIME to TO_TIME
- CAPA_USED: The capacity use for the resource in the time period from FROM_TIME to TO_TIME
- CAPA_INIT_USED: (Only relevant if the resource is a bucketed resource and the PP/DS view has been chosen for a mixed resource): The initial capacity supply of the bucketed resource in the time period from FROM_TIME to TO_TIME.
- TSTREAM_BREAK (only relevant if completed breaks will be integrated into the time stream, that is, if IV_SHOW_BREAKS = GC_TRUE): Specifies whether or not a break (that is, a non-working time) will be entered in the time stream of the resource from FROM_TIME to TO_TIME.
Break: GC_TRUE, No break: GC_FALSE.
- ET_ACT_OVERLAP
- (Only relevant for aggregration with the PP/DS view, that is, IV_AGGREGATE = TRUE and IV_CAPACITY_VIEW_FOR_MIX = GC_CONTINUOUS):
- RES_ID: Code (GUID) of the resource that the row's activity ACTID is scheduled for.
- FROM_TIME and TO_TIME Specify the time period that the row's activity ACTID overlaps.
- ACTID: Code (GUID) of the activity that is scheduled in for RESID in time period for this row.
- PROC_TIME: Net time that the activity used in the time period for this row.
Parameters
ET_ACT_OVERLAPET_CAPA_ENTRY
ET_PPDS_CAPA_ENTRY
ET_RC
IS_GEN_PARAMS
IT_GRID
IT_RES
IT_RES_PPDS_BUCKETVECTOR_ID
IV_ACTIVITY_STATE
IV_AGGREGATE
IV_CAPACITY_VIEW_FOR_MIX
IV_CAPACITY_VIEW_PPDS
IV_GET_LOAD_DETAILS
IV_INTERVAL_OVERLAP_ALLOWED
IV_SHOW_BREAKS
IV_SIMSESSION
IV_UNUSED
IV_USED_EQUAL_SUPPLY
IV_USED_LESS_THAN_SUPPLY
IV_USED_MORE_THAN_SUPPLY
IV_USE_BUCKET_GRID
IV_USE_SHIFT_GRID
Exceptions
LC_APPL_ERRORLC_COM_ERROR
LC_CONNECT_FAILED
Function Group
APO/SAPLOM_RESOURCErdisp/max_wprun_time - Maximum work process run time BAL_S_LOG - Application Log: Log header data
This documentation is copyright by SAP AG.
Length: 7717 Date: 20240427 Time: 063651 sap01-206 ( 103 ms )