Ansicht
Dokumentation
SRP_BASIC_8A - Business Add-In: Resource List Display
rdisp/max_wprun_time - Maximum work process run time BAL Application Log DocumentationThis documentation is copyright by SAP AG.
This BAdI enables you to enrich the resource list areas within the Resource Planner Application.
Before you can use this enhancement to set information columns for either the daily, weekly, or Gantt resource views, you must enhance the UI structure for the resource list area via the Easy Enhancement Workbench for the business object Service Workforce Management (SERVICE_WFM).
A default implementation of this BAdI is delivered. If you wish to define your own BAdI implementation, you must specify a name for your new implementation.
To see the default implementation, you can use the menu path Goto → Default Code → Display within the customizing activity Business Add-In: Resource List Display. You can find the default implementation code in the class CL_DEF_IM_WFDS_RES_LIST. Note that you can also access this class using the Class Buildertransaction.
The following enhancements are available:
1. SET_DV_INFO_COLUMNS. Set information columns for daily resource view
In this method, you enhance the daily view of the resource list display.
| Parameter | Type | Function |
|---|---|---|
| IV_RESOURCE_GUID | Importing | GUID to identify the resource for which additional data should be retrieved |
| IV_RESOURCE_TYPE | Importing | identifies the type of a resource, i.e. employee or service provider |
| IS_RESOURCE_CUSTOMER_FIELDS | Importing carries customer-defined fields within the resource object itself | |
| IV_DATE | Importing | key date to determine the relevant data of the resource |
| IV_TIMEZONE | Importing | relevant timezone for converting the date into internal often used timestamp format |
| CS_ADDITIONAL_INFO | Changing | return structure of the additional information columns (based on the enhanced the UI structure for the resource list area for the Easy Enhancement Workbench business object Service Workforce Management) |
Data of the return structure CS_ADDITIONAL_INFO will be automatically provided in the daily resource view. This structure includes a field DUMMY, which can be ignored for the implementation (as it is never evaluated at the UI), and the extension include INCL_EEW_WFDS_RES_DISP.
To see this data, the user must personalize the table settings of the daily resource view.
2. SET_WV_INFO_COLUMNS. Set information columns for weekly resource view
In this method, you enhance the weekly view of the resource list.
| Parameter | Type | Function |
|---|---|---|
| IV_RESOURCE_GUID | Importing | GUID to identify the resource for which additional data should be retrieved |
| IV_RESOURCE_TYPE | Importing | identifies the type of a resource, i.e. employee or service provider |
| IS_RESOURCE_CUSTOMER_FIELDS | Importing carries customer defined fields within the resource object itself | |
| IV_BEGIN_DATE | Importing | begin date of displayed period |
| IV_END_DATE | Importing | end date of displayed period |
| IV_TIMEZONE | Importing | relevant timezone for converting the date into internal often used timestamp format |
| CS_ADDITIONAL_INFO | Changing | return structure of the additional information columns (based on the enhanced the UI structure for the resource list area for the business object Service Workforce Management (see above) |
Data of the return structure CS_ADDITIONAL_INFO will be automatically provided in the weekly resource view. This structure includes a field DUMMY, which can be ignored for the implementation (as it is never evaluated at the UI), and the extension include INCL_EEW_WFDS_RES_DISP.
To see this data, the user must personalize the table settings of the weekly resource view.
3. SET_GV_INFO_COLUMNS. Set information columns for gantt resource view
In this method, you enhance the Gantt view of the resource list.
| Parameter | Type | Function |
|---|---|---|
| IV_RESOURCE_GUID | Importing | GUID to identify the resource for which additional data should be retrieved |
| IV_RESOURCE_TYPE | Importing | identifies the type of a resource, i.e. an employee or service provider |
| IS_RESOURCE_CUSTOMER_FIELDS | Importing carries customer defined fields within the resource object itself | |
| IV_BEGIN_DATE | Importing | begin date of displayed period |
| IV_END_DATE | Importing | end date of displayed period |
| IV_TIMEZONE | Importing | relevant timezone for converting the date into internal often used timestamp format |
| CS_ADDITIONAL_INFO | Changing | return structure of the additional information columns (based on the enhanced the UI structure for the resource list area for the business object Service Workforce Management (see above) |
Data of the return structure CS_ADDITIONAL_INFO will be automatically provided in the Gantt resource view. This structure includes a field DUMMY, which can be ignored for the implementation (as it is never evaluated at the UI), and the extension include INCL_EEW_WFDS_RES_DISP.
To see this data, the user must personalize the table settings of the Gantt resource view.
4. SET_WV_CELL_CONTENT_TYPES. Define cell content types for weekly view
In this method you can redefine the cell content types for the weekly resource view. A cell content type drive the data to be displayed for each day of the displayed week.
| Parameter | Type | Function |
|---|---|---|
| CT_CONTENT_TYPES | Changing | return table of possible cell content types |
Data of return table CT_CONTENT_TYPES appears automatically within the cell content navigator (i.e. the drop down list box named as "show cell content") of the weekly resource list. The structure of the table consists of the field CONTENT_TYPE, to identify the content type, and the field TEXT, which is displayed for the content type in the cell content navigator.
Note: There is a default implementation of possible cell content types (see class CL_DEF_IM_WFDS_RES_LIST). This includes:
- assigned / available time
- remaining time
- booked / available time
- remaining (available minus booked) time
- description of the most relevant time allocation
- customer name (derived from existing assignment)
- demand description (derived from existing assignment)
- location (derived from existing assignment)
5. SET_WV_CELL_CONTENT. Determine cell content for weekly view
Note: Before you can use this enhancement you have to define the possible cell content types through the method SET_WV_CELL_CONTENT_TYPES Define cell content types for weekly view.
Within this method you define the cell content to be displayed within the weekly resource view for each possible cell content type.
| Parameter | Type | Function |
|---|---|---|
| IV_RESOURCE | Importing | Table of GUIDs to identify the resources for which additional data should be retrieved |
| IV_BEGIN_DATE | Importing | Begin date of displayed period |
| IV_END_DATE | Importing | End date of displayed period |
| IV_TIMEZONE | Importing | Relevant timezone for converting the date into internal often used timestamp format |
| IV_CELL_CONTENT_TYPE | Importing | Selected cell content type on the UI. Data of this content type has to be detertmined |
| CT_CELLS_OF_THE_WEEK | Changing | Return table for each weekday within the resource weekly view. This table carries already a line for each relevant day - filled with the begin and end timestamp (in UTC time zone). The field CELL has to carry the value to be displayed, the table ADD_INFO is used to fill the tooltip for each cell. |
Note: There is a default implementation of the cell content types defined in the default implementation of method SET_WV_CELL_CONTENT_TYPES Define cell content types for weekly view (see class CL_DEF_IM_WFDS_RES_LIST):
- Assigned / available time: the two values of 'assigned time' and 'available time' in format (hours:minutes) concatenated.
- Remaining time: remaining time in format (hours:minutes)
- Booked / available time: the two values of 'booked assigned time' (i.e. without reserved time) and 'available time' in format (hours:minutes) concatenated.
- Remaining (available minus booked) time: 'available time' minus 'booked assigned time' in format (hours:minutes).
- Description of the most relevant time allocation: table of all time allocations intersecting the relevant day is sorted and the time allocation type text is determined. The sort is done examplarily by:
- Priority (descending)
- Duration on this day [day_duration] (descending)
- Begin timestamp on this day [day_beg_tstmp] (ascending)
- End timestamp on this day [day_end_tstmp] (ascending)
- Begin timestamp of the overall time allocation [beg_tstmp] (ascending)
- End timestamp of the overall time allocation [end_tstmp] (ascending)
- Customer name (derived from existing assignment): table of all assignments intersecting the relevant day is sorted and the customer name of the corresponding demand is determined. The sort is done examplarily by
- Booking_type (descending)
- Concrete (descending)
- Day_duration (descending)
- Day_beg_tstmp (ascending)
- Day_end_tstmp (ascending)
- Demand description (derived from existing assignment): table of all assignments intersecting the relevant day is sorted and the description of the corresponding demand is determined. The sort is done examplarily by
- Booking_type (descending)
- Concrete (descending)
- Day_duration (descending)
- Day_beg_tstmp (ascending)
- Day_end_tstmp (ascending)
- Location (derived from existing assignment): table of all assignments intersecting the relevant day is sorted and the description of the corresponding demand is determined. The sort is done examplarily by
- Booking_type (descending)
- Concrete (descending)
- Day_duration (descending)
- Day_beg_tstmp (ascending)
- Day_end_tstmp (ascending)
BAL Application Log Documentation rdisp/max_wprun_time - Maximum work process run time
This documentation is copyright by SAP AG.
Length: 15755 Date: 20240523 Time: 162521 sap01-206 ( 161 ms )
