Before you can onboard employees via a web service, you need to perform some setup tasks.
Switch on the onboarding web service
By default, the onboarding web service is switched off. Use the following instructions to switch it on. Your organisation, or your organisation's third party application suppliers, will know about creating web service clients in order to use this service.
To switch on the onboarding web service:
- Uncomment the onboarding web service end point entry in the <SelfService>/WEB-INF/sun-jaxws.xml file.
- By default, the onboarding entry is commented out.

- Remove the comment instructions surrounding the onboarding entry.

- Uncomment the onboarding web service servlet mapping entry in the <SelfService>/WEB-INF/web.xml file.
- By default, the onboarding entry is commented out.

- Remove the comment instructions surrounding the onboarding entry.

- Uncomment the onboarding web service tokens entry and define the username and password tokens in the <SelfService>/WEB-INF/Mawson/conf/config.xml file.
- By default, the onboarding entry is commented out.

- Remove the comment instructions surrounding the onboarding entry and set the username and password tokens.
|
The password token must be encrypted using the Encode Service Password.bat executable. |

- After making your changes, restart the Java servlet container (for example, Tomcat).
Schema and WSDL files
The schema
is described in the document:
The schema describes the static structure of the complex data types being exchanged. It describes the types, their fields, any restriction on those fields (like max length), and so on.
It's a description of data types and static properties of the service - it's about data.
- OnboardingServiceSchema1.xml
The WSDL
is described in the document:
WSDL (Web Services Description Language) is a XML document that describes a web service. It shows which operations are available and how data should be structured to send to those operations.
It's a description of the behaviour of the service - it's functionality.
- OnboardingServiceWSDL.xml
Check transaction rules and data validation 
Aligning transaction rules and validation with your organisation's requirements is a vital part of ensuring data loads successfully. The transaction rules that apply to the onboarding process depend on the movement type you use.
As your business changes, we recommend you regularly review and maintain the rules attached to the movement code. You can check the rules at:
- Administration > Screen Management > Transaction Rules > Rules by Frame/Function
Set installation setting (movement code) 
The movement code is defined in the installation setting called define ns (new starter) movement code, operator code (obns), where:
- Character Variable contains the movement reason code your organisation uses
- Text Variable contains the operator code capable of loading any new employee and their employment details
|
The operator must have a privacy level to load the data for any employee and access to functions normally used to enter new employee data in the EmpowerHR desktop. |
Set installation option (no pay details) 
If you want to onboard employee position data without the pay details, set the installation option called on board employee position data only, without pay data (opos) to y (yes).
© 2023 Fusion5. All rights reserved.