[for more information refer to: https://docs.coresystems.net/workforce-management/tool-assignment-reservation.html]
Tool Assignment and Reservation is an SAP FSM feature used to manage and reserve tools for use in activities.
Source: https://docs.coresystems.net/workforce-management/tool-assignment-reservation.html
Tool Assignment | Booking of a tool against an activity. |
Tool Reservation | Direct booking of a tool (normally used for calibrations, certifications, etc, where the tool should not be used by any assignment). |
Offset | Refers to the offset in hours, with respect to the starting time and end time of the activity. |
1. FSM Setup
In order to activate the feature in a given company, the following company setting's value must be set to 'true' - CoreSystems.CoresystemsFSM.Tool.Reservation.Enabled.
The tools functionality can then be enabled under Planning and Dispatching > Settings > Tools.
The following tool reservation settings are available:
Source: https://docs.coresystems.net/workforce-management/tool-assignment-reservation.html
Enable | Allows to enable/disable the tool functionality. Once enabled, it will be possible to see tools folder in the activity sidebar and add/remove/cancel tools. Tools will be as well displayed in the Master Data module. |
Reserve tool | In Cloud / In ERP: if set to "In Cloud" all the tool reservation will be handled in cloud. If "In ERP" then FSM will first validate if there are no tool reservations and if successful it will pass control to the ERP for the final booking. ERP will respond with a reservation or rejection. This will be persisted and visible on the activity sidebar under tools. |
Attempt to book tool when releasing | If an activity has tools in status OPEN or REJECTED, once the activity gets released the system will try to reserve the tools. Note that the activity will be released in any case, also in case some reservation requests will be rejected. |
Alert when releasing activity with unreserved tools | In case you want to be notified when releasing in case your activity does not have all added tools as reserved, you can activate this setting. |
Once the Tools have been enabled, a new tab is displayed in FSM Master Data.
It's not possible to reserve tools in ERP until another company setting - CoreSystems.CoresystemsFSM.Tool.Reservation.Type is set to 'FSM-ERP' (default value: 'FSM').
Source: https://docs.coresystems.net/workforce-management/tool-assignment-reservation.htmlTo view the tools functionality on mobiles the following permissions are required:
CRUD | Business Object | Operation Permission |
Read, Update | Activity | OWN or ALL |
Read, Update | Equipment | OWN or ALL |
Read, Update | ToolAssignment | ALL |
Create, Read, Update, Delete | ReservedTool | All |
Create, Read, Update, Delete** | UsedTool | ALL |
2. SAP ERP Setup
To activate the usage of tools it is necessary to make the following one-time settings in the SAP FSM Cloud Connector. All mentioned settings are transportable. The settings mentioned in steps 1 to 4 are set-up automatically by executing the SAP FSM cloud connector set-up program: /PACG/ECM_SETUP - E4C Setup. The settings are individually mentioned below for the purpose of information and reference.
Under transaction: /PACG/ECM_EODEF - ERP Object Definition, maintain Tool Assignment as an ERP object.
Under transaction: /PACG/ECM_CMSGTYPE - External Message Type Definition, maintain the external message types TOOLASSIGNMENT and USEDTOOL.
Under transaction: /PACG/ECM_EOAS - Object Assignment, maintain ERP object ID TOOLASS.
Outbound and Inbound IDOC and class definitions, should be all prepopulated via the set-up program.
/PACG/ECM_IOUTDEF - Definition of IDOC creation classes: 
/PACG/ECM_DATASELDEF - Data selection class definitions: 
/PACG/ECM_CLSASSIG - E4C Outgoing Messages Configuration: 
/PACG/ECM_IINDEF - Definition of inbound data creator: 
/PACG/ECM_ICONVDEF - Definition of XML-_IDOC converter: 
/PACG/ECM_CLSASSIGIN - E4C Incoming Messages Configuration: 
Under transaction: /PACG/ECM_PLAS - Plant Assignment, maintain ERP object ID ITEMTOOL for each relevant company.
Under transaction: /PACG/ECM_NOAS - No Object Assignment , for each relevant company maintain ERP object ID TOOLASS.
3. Master data
In terms of master data, the main requirement is it must be possible to maintain and send tools of the type material and equipment from SAP ERP to FSM.
SAP ERP Material Master Record
There is no fixed or specific general set-up or material type required for the material master record which represents a tool. The prerequisite is that the 'Prod.resources/tools' view is active and maintained.
For the tool material master records to be recognised as relevant for send from SAP ERP to FSM, the specific material type/types which will represent tools need to be maintained and flagged as 'Is Tool' in the SAP FSM cloud connector configuration (transportable setting) under configuration step:
/PACG/ECM_ITYPE - Material Group and Company Assignment
The image below shows an example of the required configuration. 
Making this setting results in all materials of the relevant type being sent to SAP FSM as tools. The tools master data can be viewed via the Master Data view in SAP FSM WFM.
The image below shows an example of a material type tool in SAP FSM WFM.
Tools records in FSM display the following information:
Serial Number | The serial number for the equipment/item tool. |
Name | The name of the tool. |
Status | The current status of the tool. Options include Active or Inactive. |
Remarks | If applicable, any remarks associated with the tool (example: must be recharged after 12 hours usage). |
Skills | If applicable, any skills associated with the tool. This skills tag is then used to filter technicians to ensure that the assigned technician possesses the required skills. |
Attachments | If applicable, any attachments associated with the tool. By selecting the + button, you can upload an attachment from your local machine. |
Source: https://docs.coresystems.net/workforce-management/tool-assignment-reservation.html
SAP ERP Equipment Master Record
For a tool equipment master records to be recognised as relevant for send from SAP ERP to FSM, per country, the specific equipment category type/types which will represent tools need to be maintained and flagged as 'Is Tool' in the SAP FSM cloud connector configuration (transportable setting) via transaction: /PACG/ECM_CINC01 - Included types of equipment. The image below shows an example of the configuration.
The main prerequisites for an equipment master record type which represents a tool are:
The 'PRT data' view for the equipment category is active and maintained.
The material code used in the 'SerData' of the equipment must be that of a tool material master record (which has the 'Prod.resources/tools' view maintained).
If the tool is in the possession of a specific person, the person responsible should be assigned as a partner function against the equipment record. The person responsible partner number corresponds to the unique personnel number of the technician.
The person responsible partner relationship type is important as it is sent to the SAP FSM cloud and used to filter the available tools by 'Mine' within the FSM mobile application.
The tools master data can be viewed via the Master Data module in SAP FSM WFM.
The image below shows an example of an equipment type tool in SAP FSM WFM. Note that the tools of type equipment are grouped under the material tool which they are based upon (derived from the 'SerData' information of the equipment record).
4. Integrated process
The process flow diagram below outlines the integrated core process flow for the Tools Management and Usage solution which incorporates SAP ERP (master system), SAP FSM WFM (planning) and SAP FSM Mobile (usage and confirmation).
Master Data
Plan and Reserve Required Tool
Record Tool Usage
