Skill Replication To FSM - SAP Community

Configure the FSM replication settings in the SAP IMG by navigating to: SAP Customizing Implementation Guide → Service → Integration with Other SAP Solutions → SAP Field Service Management → Configure Integration. This activity sets the RFC destination, Account/Company IDs, Client Version, and the REST API paths used to communicate with the FSM cloud tenant.

Single Company Setup

For a single-company deployment, provide the FSM Account ID and Company ID in the same IMG node: SAP Customizing Implementation Guide → Service → Integration with Other SAP Solutions → SAP Field Service Management → Configure Integration. These values uniquely identify your FSM tenant and ensure that replicated objects are routed to the correct company context.

Multiple Company Setup

When multiple SAP company codes need to replicate data to different FSM companies, define the company-to-company mapping in: SAP Customizing Implementation Guide → Service → Integration with Other SAP Solutions → SAP Field Service Management → Configure Multiple Company Replication. Each entry maps an S/4HANA company code to its corresponding FSM company, allowing fine-grained control over which data is shared with which FSM tenant.

Scale replication is a ‘manual’ activity — unlike Qualification replication, it does not trigger automatically when a Scale is created or changed. You must explicitly execute the replication program described below.
Before proceeding, verify that all prerequisite configuration steps have been completed. Refer to the ‘Configure Replication of Scales’ IMG activity for the full checklist (RFC destination, API paths, Account/Company IDs).Configure Replication of Scales

Step 1: Create Scales in S/4HANA

Open the IMG activity ‘Maintain Scales’ by navigating to: SAP Customizing Implementation Guide → Service → Basic Functions → Qualifications → Maintain Scales. This is the starting point for defining all proficiency scales that will later be replicated to FSM as ‘Levels’ within a skill category.

Press ‘New Entries’ and provide a unique Scale ID (e.g., 51) and a descriptive Scale Name (e.g., Hydraulic_Technician). Save the entry. The system will then prompt you to define the scale type — choose ‘Quality Scale’ (as opposed to Quantity Scale) because FSM skills use named proficiency levels rather than numeric ranges.

Select the ‘Characteristic Values’ node in the dialog structure on the left. Add one row per proficiency level, assigning a sequential ID and a meaningful name. For example, for the Hydraulic_Technician scale: ID 1 = Basic, ID 2 = Advanced, ID 3 = Experienced. These names will appear verbatim as skill levels inside FSM.

Optionally, select the ‘Proficiency descriptions’ node to add longer descriptions for each level (e.g., “Awareness; requires supervision” for the Basic level). These descriptions provide additional context to dispatchers when matching technician skills to service order requirements.
Create a second Scale to cover a different skill category. For example, create ‘Safety_Certifications’ (ID 52) as a Quality Scale with two characteristic values: ID 1 = Pass, ID 2 = Fail. This binary scale is appropriate for certification checks such as safety training or compliance tests.

Step 2: Replicate Scales to FSM

Once the scales are created and saved, replicate them to FSM by executing the IMG activity ‘Replicate Scales’ found at: SAP Customizing Implementation Guide → Service → Integration with Other SAP Solutions → SAP Field Service Management → Master Data Replication → Replicate Scales. This launches a selection screen where you specify which scales to send.

Enter one or more Scale IDs in the ‘Scales ID (Multiple)’ field, or use the F4 value help to select from the list. Ensure the ‘Test Mode’ checkbox is —unchecked— so the replication is executed for real. Click the Execute button (F8) to start the process.

The system processes the replication synchronously and immediately displays an execution log. Green information messages confirm success; red error messages indicate failures that need to be investigated. Key log messages to look for include: “Scale Found”, “Relevant scale data found!”, “RFC destination is maintained”, “Account and company determination is successful”, and “Scale Replications started”.

After successful replication, open the FSM application and navigate to Settings and Configuration → Master Data → Scales. Both replicated scales (e.g., Hydraulic_Technician and Safety_Certifications) should now be visible in the list, along with their proficiency levels on the right-hand panel.

Deleting Scales in FSM

To remove all scales from FSM, first delete or deactivate the relevant Scale entries in S/4HANA, then re-run the same ‘Replicate Scales’ IMG activity. This time, leave the Scale ID field empty and check the ‘Delete Scale/Proficiency’ checkbox before executing. This instructs the program to clear all existing scale data in FSM.
After the deletion run is completed, you can re-run the replication (without the checkbox and with specific Scale IDs) to reload only the desired scales into FSM. This is the recommended approach for refreshing scale data after bulk changes.

Error Log and Troubleshooting — Scales

Scale replication communicates with FSM asynchronously via HTTP. If an HTTP-level error occurs (e.g., authentication failure, network timeout, or malformed payload), it will not appear in the ABAP short dump but can be traced in the AIF (Application Interface Framework) error log. Navigate to transaction ‘AIF’ or use the Monitoring and Error Handling screen, filtering on Namespace ‘/FSM’ and Interface Name ‘SCALE_OUT’.

In the AIF error log, select a failed message from the left-hand panel. The right-hand panel displays the full JSON payload that was sent to FSM, along with detailed error information. Common issues include: invalid Scale IDs, missing RFC destination configuration, incorrect Account/Company mapping, or FSM API rate limiting. After fixing the root cause, you can restart failed messages directly from the AIF screen.

Qualification (also referred to as ‘Skill’ in FSM) replication is triggered both automatically (real-time, whenever a Qualification Group or Qualification is created or changed in S/4HANA) and manually (on demand via transaction DRFOUT). This dual-mode approach ensures the FSM skill catalog stays in sync with the S/4HANA qualification catalog without requiring scheduled batch jobs.
Before creating qualifications, verify that all prerequisite configuration steps have been completed. Refer to the IMG activity ‘Configure Replication of Qualifications’ for the full checklist, including the Outbound Implementation settings and DRF (Data Replication Framework) configuration.Configure Replication of Qualifications

Step 1: Create a Qualification Group

A Qualification Group acts as a category or container for related individual qualifications. Create a new group using the IMG activity: SAP Customizing Implementation Guide → Service → Basic Functions → Qualifications → Edit Qualifications Catalog, or by calling transaction ‘OOQA’ directly. The Qualifications Catalog is structured as a tree; groups are the parent nodes.

In the Qualifications Catalog screen, click the ‘Create’ button and choose ‘Qualification group’ from the popup. Enter a short ID (e.g., QK prefix is auto-assigned), a descriptive name (e.g., ‘Hydraulic Systems’), a validity period, and optionally a longer description. In the ‘Scale’ dropdown, select the scale you created earlier (e.g., 51 Hydraulic_Technician). This links the proficiency levels to all qualifications within this group.

After saving the Qualification Group, switch to the ‘Proficiencies’ tab in the dialog. The proficiency levels are automatically inherited from the selected scale (e.g., 1 = Basic, 2 = Advanced, 3 = Experienced). Select the radio button next to the level that represents the ‘default’ required proficiency — this default is used when a service order does not specify an explicit proficiency requirement.

Step 2: Create Individual Qualifications (Skills)

Individual qualifications represent specific skills or competencies (e.g., ‘Component maintenance’, ‘Hydraulic System design’). To create one, place the cursor on the parent Qualification Group in the catalog tree and press ‘Create’. In the popup, choose ‘Qualification’ (not ‘Qualification group’). Fill in a name, description, and confirm the inherited scale.

Repeat this process to build a complete skill catalog. For example, under the ‘Hydraulic Systems’ group you might add: Hose & Fitting Assembly, Hydraulic System design, Pressure testing & Fault finding, and Component maintenance. Create additional groups as needed (e.g., ‘Safety Certifications’ linked to scale 52) with their own qualifications (e.g., Forklift/MEWP license, Lockout/Tagout (LOTO)). The resulting tree structure mirrors the skill hierarchy that will be visible in FSM.

Qualification replication to FSM is triggered automatically upon save. Once replication completes successfully, open the FSM application and navigate to Master Data → Skills. You will see the qualification groups mapped as ‘skill categories’ and the individual qualifications mapped as ‘skills’, each with their assigned scale levels.

Manual Replication (On Demand)

While automatic replication handles most day-to-day synchronization, you may need to trigger replication manually — for example after a bulk import, a system migration, or to force-resend a specific qualification. Use transaction ‘DRFOUT’ (Execute Data Replication) for this purpose.
Open transaction DRFOUT. Set the ‘Replication Model’ to ‘FSM_INT’ (RM for BO replication to FSM) and the ‘Outbound Implementation’ to ‘ORG_REPL’. Set the ‘Replication Mode’ to ‘Manual’ and tick the ‘Manual Replication Filter Criteria Available’ checkbox. Then click the ‘Manual Replication Filter Criteria’ button at the top of the screen.

In the filter selection screen, expand the ‘Filter for org data’ node. Enter the Qualification Group ID or Qualification ID in the ‘Object ID’ field (use F4 help to browse). Set the ‘Object type’ accordingly (e.g., ‘OK’ for Qualification Group, ‘Q’ for individual Qualification). Save the filter, return to the previous screen, and click ‘Execute’ (F8).

The system displays a replication log screen. Green messages indicate that the qualification data was successfully packaged and sent to FSM. If errors appear, check the AIF error log (see ‘Error Log and Troubleshooting’ section below).

Deleting a Qualification Group or Qualification in FSM

Deletions and changes are handled in real time. When you delete or change a Qualification Group or individual Qualification in S/4HANA (via OOQA or the IMG activity), the change event is immediately captured by the Data Replication Framework and sent to FSM. There is no need to manually trigger a replication after a deletion. If an error occurs during the sync, investigate it in the AIF error log described below.

Error Log and Troubleshooting — Qualifications

Qualification replication communicates with FSM asynchronously via HTTP. If an error occurs at the HTTP transport layer, it will be recorded in the AIF error log. Navigate to AIF Monitoring and Error Handling, and filter on Namespace ‘/FSM’ and Interface Name ‘QUAL_OUT’ to see qualification-specific messages. Select the date range that covers when the replication was triggered.

Expand a failed message in the left panel to see its individual transfer records. Select a record to view the JSON payload and the specific error in the right panel. The payload follows the ‘PAYLOAD:/AIF/JSON_LINE_S’ structure, showing the qualification tree sent to FSM. After diagnosing the issue (e.g., missing skill category mapping, FSM authentication error, or invalid external ID), fix the root cause and restart the failed message from the AIF screen.

Step 1: Create the Employee Master Record

Employee records in S/4HANA are created and maintained in HR Master Data transaction ‘PA30’ (Maintain HR Master Data). Open PA30, leave the Personnel Number field blank, select the ‘Actions’ infotype from the list, and press ‘Create’ to start a new hiring action.

In the ‘Create Actions’ screen, set the Action Type (e.g., 01 Hiring), Reason for Action, and the Start Date. Proceed through the infotype screens to provide: Personal Data (name, birthdate, gender, language, nationality), Organizational Assignment (company code, personnel area, employee group/subgroup, position, org unit), and Communication details (email, SAP user ID link if applicable). Save each infotype screen to create the complete employee record.

If the employee will log on to the SAP system, link the employee record to their SAP user ID using the ‘Communication’ infotype (IT0105, subtype 0001 SY-BNAME). This connection is required for certain self-service and approval workflows.

After the employee record is saved, run program ‘/SHCM/RH_SYNC_BUPA_EMPL_SINGLE’ with the new Personnel Number. This program creates or updates the Business Partner (BP) record in S/4HANA that corresponds to this employee. The BP record is the object that is ultimately replicated to FSM as a ‘Person’ (technician).

You can verify that the BP was created successfully by checking the CDS view ‘I_BUSINESSUSER’. Search for the employee’s last name or Personnel Number. The result should show one row with the BP GUID, Business Partner number, and the linked SAP user name, confirming the employee-BP linkage is intact.

Step 2: Assign Skills (Qualifications) to the Employee

Use transaction ‘PPPM’ (Maintain Qualifications Profile) to assign qualifications to the employee. Open PPPM and switch to the ‘Person’ search tab. Search by name or Personnel Number. Select the employee from the ‘Hit List’ at the bottom-left and open the record in Change mode. Navigate to the ‘Qualifications’ tab.

Click ‘Create’ to add a new qualification entry. In the dialog, search for the qualification either by ‘Description’ (e.g., ‘Forklift / MEWP license’) or by ‘Qualification group’ (e.g., ‘Safety Certifications’). Once a qualification is selected, the ‘Proficiency’ dropdown becomes active — choose the appropriate level (e.g., Pass). Set the validity dates and save. Repeat for each skill the employee holds. The assigned qualifications will be automatically replicated to FSM as part of the person’s skill profile.

Step 3: Replicate the Business Partner (Employee) to FSM

While qualification changes trigger automatic replication, the initial BP replication must be triggered manually. Open transaction ‘DRFOUT’ and set: Replication Model = FSM_INT, Outbound Implementation = 986_3 (or the BP-specific implementation in your system). Set Replication Mode to ‘Manual’ and click ‘Manual Replication Filter Criteria’.

In the filter screen, enter the Business Partner number in the ‘Business Partner’ field (obtained from the /SHCM/RH_SYNC_BUPA_EMPL_SINGLE run or from I_BUSINESSUSER). Save the filter, return to the main screen, and execute. After successful replication, open FSM and navigate to Master Data → People. The employee should appear as an active person entry with their skills visible under the ‘Skills’ tab of their People record.

Skill requirements can be attached to a Service Order to indicate which technician competencies are needed for the job. Open the relevant Service Order in the S/4HANA Service application, navigate to the ‘Qualification Requirements’ tab on the Service Order Header, and click ‘Edit’. Assign newly created skills to Service Order Header and Item in ‘Qualification Requirements’ tab, save and ‘Release’ the Service Order.FSM will use these skill requirements during scheduling to match the order with qualified technicians.

Skills assignment at header level

Skills assignment at item level

Skills as shown in FSM activity: