Calendar integration
Common reasons why calendars are not displayed properly in FSM:
Older FSM Cloud Connector version, or relevant SAP notes not implemented. It is recommended to upgrade to Service Pack 5 of add-on 200. We try our best to keep fixing spotted issues with SAP notes but it is not possible to deliver them for older service packs.
Missing time zone in the calendars - mapping in transaction /PACG/ECM_TZCNV -Time zone conversion not maintained for relevant time zones. This is necessary because FSM uses another time zone format than SAP.
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:
https://proaxia-prod-doc.atlassian.net/wiki/spaces/PFCC/pages/564166714
https://proaxia-prod-doc.atlassian.net/wiki/spaces/PFCC/pages/564199455
https://proaxia-prod-doc.atlassian.net/wiki/spaces/PFCC/pages/564035640
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:
ADD-ON 200 SP04
Starting from add-on 200, SP04, apart from Personnel Subareas and Plants, holiday calendars can be determined also based on work center’s calendar. Learn more:
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
Holiday rules are maintained with SAP-standard transaction SCAL.
Holiday rule types
The integration supports the following holiday rule types: F (fixed), U (floating), V (counted from Easter) and 'W' (fixed weekdays).
Fixed holidays (Holiday rule = ‘F’) without public holiday guaranteed flag (Guaranteed = ‘ ‘) will be transferred to SAP FSM as ‘FIXED’. All other holidays will be transferred as ‘FLOATING’.
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 NumOfYearsForCalend 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 .
Guaranteed holidays
Dates of holidays with the ‘Guaranteed’ flag are calculated depending on the type of movement.
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 and customizing in transaction /PACG/ECM_HCAL - Holiday calendar customizing.
Learn more about plant, personnel area and work center approaches:
The calendars are sent in idocs of type /PACG/ECM_ITYPE_HOLCALENDAR. Each related holiday is included as a separate segment.
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 (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, personnel areas or work centers, depending on assignment of the ‘HOLIDAYCALENDAR’ object and customizing in transaction /PACG/ECM_HCAL - Holiday calendar customizing.
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.