2105 | Calendar integration

Bank Holiday Management

The Bank Holiday Management screen is used to create and manage public holidays and events displayed in the Planning and Dispatching. Holidays and events can be assigned to specific calendars. Calendars can be maintained for specific countries or states that have differing public holidays.

 

An ongoing holiday affecting a technician can be seen on the Planning Board.

FSM Cloud Connector integration

As part of the holiday calendar integration solution, three transactions have been created:

·       [2.0] /PACG/ECM_TRIG_HLDRL - Trigger transfer of Holiday Rulesarchived

·       [2.0] /PACG/ECM_TRIG_HLDCL - Trigger transfer of Holiday Calendararchived

·       [2.0] /PACG/ECM_TRIG_HLDAS - Trigger transfer of Holiday Assignmentsarchived

 

It is recommended to use transaction /PACG/ECM_TRIG_HLDCL - Trigger transfer of Holiday Calendar to transfer holiday calendars, holidays and assignments at once (enabled by the checkboxes).

 

Holiday calendars and their assignments can be retrieved based on plant or personnel area data. Learn more from the diagram below:

Sending process

Navigate to transaction /PACG/ECM_TRIG_HLDCL - Trigger transfer of Holiday Calendar and execute it for a specific company. Check the ‘Send all related Holiday rules’ and ‘Send calendar assignment’ options.

It might be necessary to execute this transaction twice, to ensure that holiday rules are created before calendar creation.

 

Holiday rules

The holidays are retrieved from table THOL for each relevant holiday calendar.

 

The mentioned table stores public holidays maintained with SAP-standard transaction SCAL.

 

Holiday rule types

The implementation supports the following holiday rule types: F (fixed), U (floating), V (counted from Easter) and 'W' (fixed weekdays).

 

F (fixed) – holidays with specified, fixed day and month

 

The holiday is sent to SAP FSM in /PACG/ECM_ITYPE_HOLIDAYRULE idocs as type ‘FIXED’ and contains one month and day value.  

 

U (floating) – with a set of month/day values

 

The holiday is sent to SAP FSM in /PACG/ECM_ITYPE_HOLIDAYRULE idocs as type ‘FLOATING’. A range of dates is stored in separate ‘FLOATING_DATES’ segments.

 

V (calculated with Easter)

 

The holiday is sent to SAP FSM in /PACG/ECM_ITYPE_HOLIDAYRULE idocs as type ‘FLOATING’.

 

The dates are stored in ‘FLOATING_DATES’ segments and are calculated by default for one year, unless a different value is specified in field of transaction /PACG/ECM_COMP.

 

W (fixed weekdays)

 

The holiday is sent to SAP FSM in /PACG/ECM_ITYPE_HOLIDAYRULE idocs as type ‘FLOATING’. The dates are stored in ‘FLOATING_DATES’ segments and are calculated by default for one year, unless a different value is specified in field ‘NumOfYears’ of transaction https://proaxia-prod-doc.atlassian.net/wiki/spaces/PFCC/pages/31953211.

 

Half-day holidays

Holidays set as half-day (Holiday Class ‘2’) are sent to SAP FSM as the second-half-of-day holidays (the ‘Part of the day’ field).

Other holidays are sent as full-day.

 

Holiday calendars

The holiday calendars are retrieved from table THOCI which stores calendars maintained in transaction SCAL.

 

The holiday calendars relevant for sending to a given company are retrieved based on plant or personnel area assignment of the 'HOLIDAYCALENDAR' object. 

 

The calendars are sent in idocs of type /PACG/ECM_ITYPE_HOLCALENDAR. Each related holiday is included as a separate segment.

 

For the calendar time zones to be sent correctly, it is necessary to maintain proper time zone conversion entries in transaction /PACG/ECM_TZCNV - Time zone conversion.

 

Valid years

In SAP FSM, calendars valid from a year which is in the past are not correct and cannot be changed. During calendar transfer it is checked if its ‘valid from’ year in table THOCI is at least the current year (e.g. 2020). The ‘valid to’ year should be at least (current year + 1).   

 

If this is not the case, the current year is assigned automatically as ‘valid from’ and the ‘valid to’ year is determined based on the number of years specified in field ‘NumOfYears’ in transaction https://proaxia-prod-doc.atlassian.net/wiki/spaces/PFCC/pages/31953211 (e.g. add 5 years to the current year).  If this field is empty, one year is added to the current year value.

 

 

Holiday calendar assignments

The person assignments are determined based on plant or personnel areas, depending on assignment of the ‘HOLIDAYCALENDAR’ object.

 

Holiday calendar assignments are sent in idocs of type /PACG/ECM_ITYPE_HOLCALASS.

 

In SAP FSM a user can be assigned to one calendar only.

 

Assignment sent with an employee 

Holiday calendar assignments can be transferred automatically when an employee is transferred (e.g. after user modification in transaction /PACG/ECM_MAINT_USER). The functionality can be enabled by checking the ‘SendClAssg’ field in transaction /PACG/ECM_USERG – User - general settings.

 

If you'd like to help us improve the documentation, please provide your feedback using the communication channels listed /wiki/spaces/PFCC/pages/1561427969. Learn about support possibilities here.