/PACG/ECM_VWRKTC - Work Time Task Definition

Learn more about work time tasks: Work time and work time tasks

Table of contents

Work Time Task Definition

Within the FSM App working times are booked on the Worktimetask object and then transferred to SAP. With this customizing you can define the different Worktimetasks which can be selected within the App and with which attributes they are posted either in CATS (see activation in /PACG/ECM_TIMEF – Time Effort ) or as confirmation against service order defined in this transaction.

Each Company has its own Work Time Task Definitions

In the Work Time Task Definitions you can define:

Work Time Task Code	Unique ID of the Work Time Task
Work Time Task Name	Task name which will be shown in the App.
Activity type	The activity type as used in the SAP for posting CATS / confirmation. Note that activity type determined from settings /PACG/ECM_CTET - Time Effort Type – precisely field ActType PA0315 has higher priority.
FSM Activity Type	If entered, it is used to get not cancelled activities during inbound work time processing. Activities are selected based on the entered activity type, execution stage not cancelled and personnel number of the reporting technician. For the retrieved activities, service orders are determined and then used to create work time posting.
No book	The field is only used in classes performing the confirmation of the Service Order. If the "no book" field is checked, no confirmation will be created for the work time task and a message "Work time will be not booked in SAP" will be displayed.
SalesActiveType	OBSOLETE FOR NEW ACTIVITIES Sales Activity type for Sales support: Uniquely identifies the type of sales activity (for example, whether the sales activity is a sales call, a telephone call, and so on).
Att/Absence Type	Attendance- or Absence Type for posting in CATS
CATS Act. Type (previously Task Type)	This field will be filled in CATS booking if it exists in BAPICATS1. Also CATSDB fields EXTSYSTEM and EXTAPPLICATION will be filled. Fields TASKLEVEL and TASKCOMPONENT should be filled by a customer-specific user exit. As of Release 4.70, the CATS interfaces use fields TASKTYPE, TASKLEVEL and TASKCOMPONENT. A CATS task type represents characterisation of content of a specific task that an employee performs, for example "consulting" or "instructor function". In the Cross-Application Time Sheet (SAP CATS), the task type, task component, and task level fields enable to specify the task elements that are relevant for valuation. Check the related SAP note: https://launchpad.support.sap.com/#/notes/749838
Time posting	Determine how start/end datetime should be calculated for time confirmation/CATS. Selection options: from/to - use from/to time entered on the mobile app. Duration/work calculated based on the same data. absolute - use the system time. Duration/work calculated based on the data from FSM. fixed value - use the system time for start/end time. Fixed work amount and unit are retrieved from fields ‘Posting value’ and ‘Unit of measure’ in this transaction.
Posting value	Fixed work value for time confirmation. Used when ‘Fixed value’ is set in field ‘Time posting'
Unit of measure	Fixed work unit for time confirmation. Used when ‘Fixed value’ is set in field ‘Time posting'
Past option	Options for showing days backwards in window
Future option	Options for showing days forward in window
Inbound/Outbound	In- or outbound selectable
Color (S4)PACG 200 SP05	Absence types can be sent to FSM with the color parameter, specified in SAP ECC/S4. Please note that FSM allows usage of colors in the HEX format, e.g. #6e6858 or #17bd8b. To ensure that only the relevant colors are sent, users must select one of the 20 predefined colors. Use the ‘Color’ field’s search help to quickly select a color code. Example In transaction /PACG/ECM_VWRKTC - Work Time Task Definition, enter a color for a given work time task code (absence type). Send the worktime task type to FSM with transaction /PACG/ECM_WRKTTSND - Work Time Task. Notice that the color property can be found in the outbound idoc. Navigate to FSM Settings and Configuration, tab ‘Planning and Dispatching’ -> ‘Time slot types’. Notice that the absence type’s color reflects the customizing in SAP ECC/S4. Create an absence on the Planning and Dispatching Board. The reservation is of the selected color.

Continue learning with:

Time frames

Per Work Time Task Definition Time Frames can be assigned per day of the week, start and end time to identify different activity type or Attendance -/ Absence type. An option enables worktime to be posted with an activity type depending on a schedule and already posted time. E.g.: Mo-Fr. first 8h 100%, over 8h to 10h 150%, over 10h 200%; Saturday first 4h 150%, then 200%; Sunday and holiday 200%, day change since 0:00h

DuratSOpt

The dependency for posting the surcharges for the worktime posting is set by either selecting person or order. Leaving the field empty will not activate the dependency.

Actual start/finish

While trying to create a new time frame for a given work time task in /PACG/ECM_VWRKTC - Work Time Task Definition, the user is obliged to fill the actual start and actual finish time fields. If the fields are left empty, an error message is displayed.

As a form of additional validation, logs communicate the lack of actual start/finish values and a CAT entry is not posted.

Receiver order/WBS element

Work times can be posted on a collective service order if the order is entered in this customizing and CATS is disabled in transaction /PACG/ECM_TIMEF – Time Effort. If CATS is active, the order or WBS element [available since Service Pack 5 for add-on 200] entered in this customizing will be used as the receiver order/receiver WBS element in the CATS entries.

Please note that if both an order and WBS element are filled in one entry, then the order will be used. Maintain either an order or a WBS element in one entry.

An example resulting CATS entry, with the WBS as WBS receiver:

An example resulting CATS entry with a service order as the order receiver:

An example resulting confirmation if CATS is disabled:

Worktime Out: CATS status to IDOC Action

Define which CATS statuses are relevant for work time transfer. Work times with statuses not maintained will not be transferred (neither automatically after changes in CATS, nor with the sending transaction).

Additionally, the transaction types of outbound idocs can be defined: change or delete (the object will be deleted from SAP FSM).

Example of automatic transfer of a work time object after changes of status in CATS

The CATS status customizing is the following:

The customizing can be tested using transaction CATS_APPR_LITE - Approve Working Times. Reset approval of a CATS entry:

Observe that an outbound work time idoc is generated. Based on the customizing, its transaction type is 'D':

Make sure to check the following customizing beforehand:

· A WORKTIME object entry should be maintained for a given company in transaction /PACG/ECM_PAAS - Personnel Area assignments.

· Work time tasks should be maintained for relevant attendance/absence types and set as ‘Outbound’ in transaction /PACG/ECM_VWRKTC - Work Time Task Definition:

Work time tasks as absence types

Transfer

This work time task definition ("Absence types" in FSM) is sent via /PACG/ECM_WRKTTSND - Work Time Task.