Ansicht
Dokumentation

/SAPAPO/OM_CAPA_PROFILE_GET - Get Capacity Profiles of Resources

/SAPAPO/OM_CAPA_PROFILE_GET - Get Capacity Profiles of Resources

Vendor Master (General Section)   CPI1466 during Backup  
This documentation is copyright by SAP AG.
SAP E-Book

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_OVERLAP
ET_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_ERROR
LC_COM_ERROR
LC_CONNECT_FAILED

Function Group

APO/SAPLOM_RESOURCE

rdisp/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 )