Timecard Soap API

The timecard SOAP API

The timecard SOAP API is similar to the EService SOAP API, in that it provides methods for retrieving, updating, and deleting data stored on the server.

The API is published seperately at the moment, as another interface for linking into the timecard server, although there is some progress on integrating the two products together in a future release.

The Interface Definition

Below are listed the various functions that make up the timecard API. Each function is called, passing in at least one parameter, a UserIDBean. This bean contains the user name and password of a previously registered EService User, with administrative rights. This ensures only authorised users are able to access the interface.

Please select a link to see documentation on each method's function and features.

Job Creation and Management Functions

Method	Summary
createJob	Creates a new job based on the job data passed in.

Notes

Timecard SOAP API v1.0

Methods to Retrieve Raw Event Data

getUserEvents(UserIDBean, userPrimaryKey, start date, end date) returns array of Event Objects (detailed further below) for a given user in a selected period, e.g. clock in/out dates and times and task descriptions

getAllUserEvents(UserIDBean, start date, end date) returns array of Event Objects for all users in a selected period

getUnsynchronizedEvents(UserIDBean, synchronisationID, createdOnOrAfter) Retrieves array of Event Objects (detailed further below) that have not previously been synchronized and acknowledged and all events that have changed since their last synchronization

ackEventSynchronization(UserIDBean, eventSynchronizationBean) Acknowledges that synchronization has been performed on the selected events

Methods to Manage Users

These are equivalent to those provided for EService and detailed at: https://iweb.econz.co.nz/wiki/index.php/SOAP_3_Documentation#EService_User_Management_Functions

Timecard also has equivalent Field Device handling methods to those listed for EService at: https://iweb.econz.co.nz/wiki/index.php/SOAP_3_Documentation#EService_Field_Device_Management_Functions

createUser(UserIDBean, UserBean, password) Creates a new user based on the user data passed in

getUserDetail(UserIDBean, UserPK) Gets all the details of a specified user

updateUser(UserIDBean, UserBean) Updates a particular user with new details

updateUserPassword(UserIDBean, UserPK, oldPassword, newPassword) Updates a user's password

deleteUser(UserIDBean, UserPK) Deletes an existing user

getUnsynchronizedUsers(UserIDBean, synchronisationID, createdOnOrAfter) Retrieves all users who have not previously been synchronized and acknowledged and all users that have changed since their last synchronization

ackUserSynchronization(UserIDBean, userSynchronizationBean) Acknowledges that synchronization has been performed on the selected users

Methods to Retrieve Processed Data

getUserHoursSummary(UserIDBean, UserPrimaryKey, start, end) Returns single HourBreakdownObject

getHourSummaries(UserIDBean, start, end) Returns array of HourBreakdownObject

getUserTypeNames(UserIDBean) Returns array of UserType Names

getOvertimeRules(UserIDBean) Returns array of OverTimeRule

Main Data Type Definitions

EventObject Event Occurred Timestamp (the date and time at which a clock in, clock out, start break, end break start task or end task event occurred) Event ID Event Type (Clock in, Clock out, Start break, End break, Task start, Task end) Name of User DeviceID of User UserPrimaryKey UserType

TaskEventObject extends EventObject Task ID

HourBreakdownObject UserPrimaryKey UserType UserName Device ID Normal Hours as int Normal mins as int Normal seconds as int (always zero currently) Overtime Hours as int Overtime mins as int Overtime seconds as int (always zero currently) Extratime Hours as int Extratime mins as int Extratime seconds as int (always zero currently)