---
title: "What you need to set up (crossboard web services)"
id: "what-you-need-to-set-up-crossboard-web-services"
project: "EHR User Guide"
url: "https://help.cloud5.com.au/articles/ehr-user-guide/what-you-need-to-set-up-crossboard-web-services"
updated: 2026-10-19T00:52:54Z
---

# What you need to set up \(crossboard web services\)

Before you can crossboard employees via web services, you need to perform some setup tasks.

## Switch on the crossboarding web service

By default, the crossboarding 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 crossboarding web service:

1. Uncomment the crossboarding web service end point entry in the **&lt;SelfService&gt;/WEB-INF/sun-jaxws.xml** file.
2. By default, the crossboarding entry is commented out.

![](/resources/Storage/ehr-user-guide/what-you-need-to-set-up-crossboard-web-services/001%20config%20crossboard%20web%20serv.png)

1. Remove the comment instructions surrounding the crossboarding entry.

![](/resources/Storage/ehr-user-guide/what-you-need-to-set-up-crossboard-web-services/002%20config%20crossboard%20web%20serv.png)

1. Uncomment the crossboarding web service tokens entry and define the username and password tokens in the **&lt;SelfService&gt;/WEB-INF/Mawson/conf/config.xml** file.
2. By default, the crossboarding entry is commented out.

![](/resources/Storage/ehr-user-guide/what-you-need-to-set-up-crossboard-web-services/003%20config%20crossboard%20web%20serv.png)

1. Remove the comment instructions surrounding the crossboarding entry.

![](/resources/Storage/ehr-user-guide/what-you-need-to-set-up-crossboard-web-services/004%20config%20crossboard%20web%20serv.png)

1. Uncomment the crossboarding web service tokens entry and define the username and password tokens in the **&lt;SelfService&gt;/WEB-INF/Mawson/conf/config.xml** file.
2. By default, the crossboarding entry is commented out.

![](/resources/Storage/ehr-user-guide/what-you-need-to-set-up-crossboard-web-services/005%20config%20crossboard%20web%20serv.png)

1. Remove the comment instructions surrounding the crossboarding entry and set the username and password tokens.

| ![Information](/resources/Storage/ehr-user-guide/ehr-user-guide/Info.png) | The password token must be encrypted using the Encode Service Password.bat executable. |
| --- | --- |

![](/resources/Storage/ehr-user-guide/what-you-need-to-set-up-crossboard-web-services/006%20config%20crossboard%20web%20serv.png)

1. After making your changes, restart the Java servlet container (for example, Tomcat).

## Schema and WSDL files

### Schema

After you switch on the crossboarding web service, you can obtain the schema ![](/resources/Storage/ehr-user-guide/icons/leave%20-%20info%20icon.png) using the URL:
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.

* &lt;EmpowerSelfServiceUrl&gt;/CrossboardingService?xsd=1

Replace **EmpowerSelfServiceUrl** with your EmpowerHR Self Service URL, for example, **www.fusion5.com.au/CrossboardingService?xsd=1**

### WDSL

After you switch on the crossboarding web service, you can obtain the WSDL ![](/resources/Storage/ehr-user-guide/icons/leave%20-%20info%20icon.png) using the URL:
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.

* &lt;EmpowerSelfServiceUrl&gt;/CrossboardingService?wsdl

Replace **EmpowerSelfServiceUrl**with your EmpowerHR Self Service URL, for example, **www.fusion5.com.au/CrossboardingService?wsd**

## Set installation settings ![](/resources/Storage/ehr-user-guide/ehr-user-guide/icons/desktop%20icon.png)

### Movement code

The movement code is defined in the [installation setting](/articles/ehr-user-guide/installation-settings) 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

| ![Information](/resources/Storage/ehr-user-guide/ehr-user-guide/Info.png) | 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. |
| --- | --- |

### API

The [installation setting](/articles/ehr-user-guide/installation-settings) called **API employee update no value (cemv)** lets you update employee personal details via the API ![](/resources/Storage/ehr-user-guide/icons/leave%20-%20info%20icon.png). In using this installation setting, you can set a special character to use in the xml request for the fields you want the system to ignore.
API = An application programming interface is a way for two or more computer programs or components to communicate with each other.

## Set installation options ![](/resources/Storage/ehr-user-guide/ehr-user-guide/icons/desktop%20icon.png)

The [installation option](/articles/ehr-user-guide/installation-options) called **allow crossboarding movements uploaded via a spreadsheet or API automatically (ocro)** lets you choose to either automatically create crossboarding movements as they are uploaded, or require manual approval before creating movements.

See [crossboard position movements](/articles/ehr-user-guide/crossboard-position-movements) for more information about the **ocro** option.

| Next topic<br><br>[Overtime code fields](/articles/ehr-user-guide/overtime-code-fields) |
| --- |

© 2023 Fusion5. All rights reserved.