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:
...
...
...
...
...
...
...
TRANSFER OF HOLIDAY RULES
General
...
/PACG/ECM_HCAL - Holiday calendar customizing
It is recommended to use transaction /PACG/ECM_TRIG_
...
HLDCL - Trigger transfer of Holiday Calendar to transfer
...
The holidays are selected by public holiday ID and are retrieved from table THOL.
...
...
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
...
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.
TRANSFER OF CALENDARS
General
Use transaction /PACG/ECM_TRIG_HLDCL to transfer holiday calendars from SAP ECC/S4 to SAP FSM.
...
...
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_ |
...
| Info |
|---|
If the EMPLOYEE object is assigned to a personnel area, the personnel area’s ID should correspond directly to the plant ID. Usage of plant assignment is recommended. |
A holiday calendar should be assigned to a factory calendar (in transaction SCAL) which is assigned to a specific plant in transaction OX10.
...
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 |
...
mapping in transaction /PACG/ECM_TZCNV - Time zone conversion. |
...
Send all holiday rules
...
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_ |
...
Send calendar assignments
Similarly, holiday assignments can be sent together with calendars by checking the ‘Send calendar assignment’ option.
...
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.
...
TRANSFER OF CALENDAR ASSIGNMENTS
Use transaction /PACG/ECM_TRIG_HLDAS to transfer holiday calendar assignments from SAP ECC/S4 to SAP FSM.
...
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_ |
...
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.
