The Employee Synchroniser is designed to capture records from an HR or payroll system and using key data fields (employee and site) populate your Damstra Safety system by allocating each employee and their personal records to the correct employee record and also allocating each employee to their correct site.
The synchroniser can be used to do an initial import of all your employees and then be scheduled to update your records as often as required.
Full employee files or changes only (delta files) are accepted.
Typically, initial population of is by way of a full upload then either changes only (delta files) or full files for ongoing updates.
Note: The Synchroniser settings are only visible and editable to the "superadmin" user. For security purposes, the superadmin default password should be changed and kept secure.
1. Log into the Damstra Safety Database
Click the settings icon and Select Settings.
2. Select Synchroniser - Employee from the Settings page.
3. Determine what Employee data you wish to import from your master database (HR, Payroll) into the Damstra Safety database - check the Employee data table in the table below to ensure the fields you require are supported by the Synchroniser.
4. Extract your Employee data from your master database into a CSV file in the format prescribed in the Employee data table.
The file name must begin with "employee" and finish with ".csv" e.g. "employee_31JUN2010.csv"
Save the CSV file in a known location in your network.
5. Enter the email address you wish to receive Synchroniser - Employee notifications. Note this email address can be unique for each synchroniser function.
6. Determine if you wish to receive error notifications only or error and successful synchronisation notifications.
> how many columns are in your CSV file
> the CSV Quote character
> the CSV separator
> if your file contains a title row
8. Map the columns to match your CSV file fields
9. Save your settings (generally the settings once saved are not required to be changed)
10.Using an ftp application, send your file to ftp.platinumsafety.com
FTP Host = ftp.platinumsafety.com
FTP port = 21
FTP User = YOURCOMPANYNAME
FTP Username = A user password dedicated to your company will be assigned to you when subscribing to the service
Note: The above information is displayed to the superadmin user in the Synchroniser setup pages.
Note: secure ftp is supported using port 22.
Employee data configuration
Other Person Types:
Damstra Safety has an optional feature that allows 2 additional person types to be configured. These "Other Persons" have identical fields to employees and they can also by synchronised to Damstra Safety using the Employee Synchroniser. The process is identical to that described in this section. An additional .CSV file for each "Other Person" type needs to be generated and presented to the synchroniser.
Other Person Type setup
Once you have established the synchronisation fields for employees, change the "Person Type" (in the example above configured as Students and Visitors) and establish the required fields for these persons.
Create CSV file names for the "Other Persons" in exactly the same format and capitalisation as they are presented to you in the setup window.
In the example, you should be presenting three .CSV files to the synchroniser FTP
The FTP access details including Port, User and Password are identical for all synchronisation sessions.
Once the CSV file(s) has been sent to the ftp location, it will be addressed by the daily scheduled task to run at midnight (AEST). Note the file may run anytime between midnight and 4 am.
- Synchroniser runs the CSV file and if no errors are detected the changes in the file are made to the Damstra Safety database and the CSV file is deleted from the server.
- If errors are detected, then changes are rolled back and no data is changed and the CSV file is deleted from the server. A full list of all errors is emailed back to a customer nominated email address.
- The errors should be corrected and resubmitted in a new file for synchronisation the following night.
Note: for every field mapped, there must be an entry in the CSV file, even if the field contains no data.
Data field mappings:
Required fields are indicated by red bold text
Table 1. - Data fields
|Damstra Safety field name||Synchroniser Picklist fields||CSV format parameters (# of characters)|
|Employee No.||EMPLOYEE NO||Alphanumeric (50)|
|First Name||FIRST NAME||Alphanumeric (64)|
|Middle Name||MIDDLE NAMES||Alphanumeric (64)|
|Last Name||LAST NAME||Alphanumeric (64)|
|Gender||GENDER||Male, Female OR Leave blank (unspecified):|
|Email Address||EMAIL ADDRESS||Alphanumeric (100)|
|Site (by name)||SITE (BY NAME)||Use Site by name if the site names in your CSV file match the site names in the Damstra Safety...|
|..or.. Site (by ID)||SITE (BY CODE)||...otherwise use Site (by CODE)|
|Department||DEPARTMENT||Department: Alphanumeric (255)|
|Position||POSITION||Job Position: Alphanumeric (255)|
|Supervisor||SUPERVISOR BY EMPLOYEE NO.||Supervisor : Alphanumeric (100)|
|Key Appointments checkbox||SUPERVISOR CHECK||Supervisor : Check (0/1)|
|Key Appointments checkbox||MANAGER CHECK||Manager : Check (0/1)|
|Key Appointments checkbox||INVESTIGATOR CHECK||Investigator : Check (0/1)|
|Hire Date||HIRE DATE||DD/MM/YYYY|
|Employment Ceased||EMPLOYMENT CEASED DATE||DD/MM/YYYY|
|(Employment Ceased) Archive||EMPLOYMENT CEASED DATE
|Date of birth||DOB||DD/MM/YYYY|
|Home Phone||HOME PHONE||Alphanumeric (30)|
|Work Phone||WORK PHONE||Alphanumeric (30)|
|Ext||WORK EXTENSION||Alphanumeric (10)|
|Mobile Phone||MOBILE PHONE||Alphanumeric (30)|
|Contact Street Address||CONTACT STREET ADDRESS||Alphanumeric (64)|
|Contact Suburb||CONTACT SUBURB||Alphanumeric (64)|
|Contact City||CONTACT CITY||Alpha numeric (64)|
|Contact Area Code||CONTACT AREA CODE||Alphanumeric (30)|
|(Emergency Contact) Name||NOK NAME||Next of Kin Full name: Alphanumeric (100)|
|(Emergency Contact) Address||NOK ADDRESS||Next of Kin Full address: Alphanumeric (256)|
|(Emergency Contact) Home||NOK HOME PHONE||Next of Kin: Alphanumeric (30)|
|(Emergency Contact) Work Phone||NOK WORK PHONE||Next of Kin: Alphanumeric (30)|
|(Emergency Contact) Mobile||NOK MOBILE PHONE||Next of Kin: Alphanumeric (30)|
|(ALT) Name||ALTERNATE NAME||Alternate Contact Full name: Alphanumeric (100)|
|(ALT) Address||ALTERNATE ADDRESS||Alternate Contact Full address: Alphanumeric (256)|
|(ALT) Home Phone||ALTERNATE HOME PHONE||Alternate Contact: Alphanumeric (30)|
|(ALT) Work Phone||ALTERNATE WORK PHONE||Alternate Contact: Alphanumeric (30)|
|(ALT) Mobile Phone||ALTERNATE MOBILE PHONE||Alternate Contact: Alphanumeric (30)|