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.
| Table of Contents |
|---|
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:
/PACG/ECM_TRIG_HLDCL - Trigger transfer of Holiday Calendar
/PACG/ECM_TRIG_HLDRL - Trigger transfer of Holiday Rules
/PACG/ECM_TRIG_HLDAS - Trigger transfer of Holiday Assignments
/PACG/ECM_HCAL - Holiday calendar customizing
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:
| Status | ||
|---|---|---|
|
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: https://proaxia-prod-doc.atlassian.net/wiki/spaces/PFCC/pages/564166714/PACG+ECM+TRIG+HLDCL+-+Trigger+transfer+of+Holiday+Calendar#Holiday-calendar-and-assignments-determination
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.
| Info |
|---|
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 /PACG/ECM_COMP - Company definition.
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.
| Info |
|---|
Learn more about plant, personnel area and work center approaches: /PACG/ECM_TRIG_HLDCL - Trigger transfer of Holiday Calendar |
The calendars are sent in idocs of type /PACG/ECM_ITYPE_HOLCALENDAR. Each related holiday is included as a separate segment.
| Note |
|---|
Calendars won’t be displayed correctly in FSM if they’re sent without proper time zones, in the so-called TZ database name format (e.g. Europe/Warsaw). For the calendar time zones to be sent correctly, it is necessary to maintain proper time zone conversion entries mapping in transaction /PACG/ECM_TZCNV - Time zone conversion. The time zone for which the mapping will be retrieved is the system or company time zone (see fields ‘Tzone Syst’ - to use system time zone, or ‘Time zone’ in transaction /PACG/ECM_COMP -Company definition). If none is maintained, CET will be used by default. |
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 /PACG/ECM_COMP - Company definition (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.
| Info |
|---|
Learn more about plant, personnel area and work center approaches: /PACG/ECM_TRIG_HLDCL - Trigger transfer of Holiday Calendar |
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.
