Timecard Soap API

stay alive video stoik video converter 2.1 download liquid weight loss dvi to vga adapter joan severance movie new hampshire state map high jefferson school thomas adobe after affects serial number free sopranos ringtones express scripts black girls so thick aphs pharmacy car wash nude optimem gibco composable polyphonic ringtones slocumb company celebertys body modification shailendra group movie porn principal victoria amateur clip elephant list video california refinance home mortgage art fantasies of women trace adkins hot mama shadow the hedgehog videos url buzzword mobile ringtones actos heroicos pocket real estate crack www.muchosucko.com william optics swan eyepieces music video for crazy train wet tees india vision channel sopwith camel hollywood love scenes free adult porn video site sex site video clip pocket watch wenger mini mobile movies used cars in germany ethernet to serial webmap national guard activations metal gear solid movie clips everywhere map airport in international mexico michigan accutane attorney probe alabama cheap hosting package web 87 big big tits arabic comedy movies indiana vendor license tulip tree leaf childrens vitamins lacquer head music video denise austin dvd luxury beach rentals in orange county win a free ipod robert palmer video my report links.com abc bit torrent client angel and cordelia music videos shake that ass bitch types of marijuana pics black cock teen white page motorola t720c ringtones mpeg4 psp video midtown madness 2 no cd crack http abaqus cracks flat breast webmap acyclovir fda sitemap perma column lyrics another brick in the wall korn new knight rider movie beach beach club orange racquet seaside tetris techno reggae videos download bobrick toilet accessory it puts the lotion on the skin video jordan katie price and videos thong bikini gallery republic movie serials linux video modes free tarot reading index popcap bejeweled 2 crack non-profit jobs pdf995 crack key curio and relic rifle antonio banderas gay movie cheat connection tamagotchi v3 swapping swinger mandarina duck laptop bag casino gambling online stock video footage of calendar flipping months stevie wonder grammy wins withholdings irs movie theaters in lexington ky nude model video clip maya 6 activation domain run dmc its tricky music video page mccallum napoleon video japanese kogul movies kate playground videos movie theater salisbury nc love so divine movie poker slot video spy hard movie myspace movie backgrounds pc powerscan serial played james bond in a 1967 movie movie store london domain iistracer crack movie westward the women kostya tszyu video clips links say yes quickly movie movie at the grove kanata national ont specialty video movie showing whats apple 1984 commercial video japanese horror movie reviews sir mix alot baby got back video moonlight movies movie downloading programs sex video of celebrity scandal in the philippine kara movie samples regal entertainment movie http invader zim video game kalan porter single video matrix movie review outlaw star video afro centric videos r kelly video tapes merengue dance video man movie muscle sex xxx exercise video for the leg kung fu movie site movie paranoid movie trailer site myspace.com need activation code for internet radio recorder movie star hairdos movie teach that jarrod mccracken rugby league noggin music videos music shakira tortura video angeles corporate los production video movie s.w.a.t lyric to disney song from movie easy rider movie reggie and the full effect get well soon video lagrange il movie theater muertes video movie rate recommendation links picture from the movie holes mario flash movies rayearth music video av ejaculation japanese movie uncensored mistake in disney movie jurassic park movie picture webmap star wars 3 movie trailer download adhocracy pirate pictures for children rocky the movie pics soccer freestyle videos softcore video amber music videos sankranthi telugu movie songs page pablo petey vibrate video anal big movie tit lowes movie theater waterfront easy video capture download mac video cards movie check if knew mother only rahzel video mpeg video player free download readiris cracks sexy woman smoking video silver spring md movie theater sitemap super millionaire video prince charming movie quotes aoe rise of rome no cd ping pong movie torrent movie dvd of 2006 aviator trailer movie snl key party video clip scarriest movies ever inspirational posters jokes phantom planet video california refrigeration training videotapes sitemap se7en movie isohunt torrentspy maple8 serial adult free game hentai movie online pic adobe after effects trial crack launched movie film volta cipher relationship advice lingerie video samples ratings of baby video monitor eric prydes video april flower movie movie northwest passage sitemap top maple story video clip rave movie theatre peoria il silent hill movie review public sharefolder crack movie munich trailer amateur blog video xxx picture of a movie stub macgourmet crack index intervideo home theater 2 key generator movie selleck tom western madoka ozawa videos activation norton systemworks 2005 mclaren f1 top speed video asscrack.com http pink video get the party started asian cum hardcore movie shot rammstein video clips image of journeyman electrical license movie wimbledon last of the mohicans movie review movie coming to dvd oklahoma bombing videos top muffdiving videos adams song video blink 182 pacers videos sunshine movie theatre ice cube it was a good day video sky lopez video clip sitcdellao

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 separately 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 is a summary of the important functions that make up the Timecard API (a full java doc style specification can be found here). Each function is called, passing in at least one parameter, a UserIDBean. This bean contains the user name and password of a previously registered Timecard User, with administrative rights. This ensures only authorised users are able to access the interface.

Timecard User Management Functions

Method	Summary
createUser	Creates a new user based on the user data passed in.
getUserDetail	Gets all the details of a specified user.
updateUser	Updates a particular user with new details.
updateUserPassword	Updates a user's password.
deleteUser	Deletes an existing user.
getUnsynchronisedUsers	Retrieves all users who have not previously been synchronised and acknowledged, and all users that have changed since their last synchronisation.
ackUserSynchronisation	Acknowledges that synchronisation has been performed on the selected users.

Timecard Field Device Management Functions

Method	Summary
createFieldDevice	Creates a new field device based on the field device data passed in.
getFieldDeviceDetail	Gets the full set of details for a specified field device.
getFieldDeviceDetails	Gets the full set of details for all specified field devices.
getFieldDeviceDetailsUpdatedSince	Gets the full set of details for all field devices that have been updated since the specified date and time.
updateFieldDevice	Updates a field device with new details.
deleteFieldDevice	Marks a field device as deleted.
getFieldDevicePKForName	Gets the primary key of a field device, based on the name passed in.
getFieldDevicePKForDeviceID	Gets the primary key of a field device, based on the device id passed in.

Timecard functions to Retrieve Raw Event Data

Returns	Method	Parameters	Description
Array of EventBean	getUserEvents	UserIDBean, userPrimaryKey, start date, end date	For a given user in a selected period, retrieves clock in/out dates and times and task descriptions.
Array of EventBean	getAllUserEvents	UserIDBean, start date, end date	Retrieves clock in/out dates and times and task descriptions for all users in a selected period.
Array of EventBean	getUnsynchronizedEvents	UserIDBean, synchronisationID, createdOnOrAfter	Retrieves array of EventObjectBean (detailed further below) that have not previously been synchronized and acknowledged and all events that have changed since their last synchronization.
return	ackEventSynchronization	UserIDBean, EventSynchronizationBean	Acknowledges that synchronization has been performed on the selected events.

Methods to Retrieve Processed Data

Returns	Method	Parameters	Description
HourBreakdownBean	getUserHoursSummary	UserIDBean, UserPrimaryKey, start, end	Gets the hourly breakdown for a single user.
Array of HourBreakdownBean	getHourSummaries	UserIDBean, start, end	Hourly breakdowns for all users in the given time period.
Array of Strings	getUserTypes	UserIDBean	Returns array of UserType Names.
Array of OverTimeRuleBean	getOvertimeRulesBean	UserIDBean	Returns array of OverTimeRuleBean.

Retrieving and updating Organisation Details

Returns	Method	Parameters	Description
OrganisationDetailsBean	getOrganisationDetail	UserIDBean	Returns all details from admin screen (including standard open hours).
updateOrganisationDetailResult	updateOrganisationDetail	UserIDBean, OrganisationDetailsBean	Updates all details on admin screen (including standard open hours).

Various Maintenance Functions

Returns	Method	Parameters	Description
sendMessageToUserResult	sendMessageToUser	UserIDBean, userPrimaryKey, messageString	Sends a string message to the specified user.
wakeFieldDeviceResult	wakeFieldDevice	UserIDBean, userPrimaryKey	Sends a message to the phone, which forces the application to start and connect to the server.
createNewTeamResult	createNewTeam	UserIDBean, teamName, teamLeaderUserPrimaryKey	Creates a new team with the specified user as the team leader.
deleteTeamResult	deleteTeam	UserIDBean, teamName	Deletes the specified team. Members of this team should be reallocated to existing teams.
addUserToTeamResult	addUserToTeam	UserIDBean, teamName, userPrimaryKey	Adds the specified user to the specified team. Note that each user can only belong to one team.
removeUserFromTeamResult	removeUserFromTeam	UserIDBean, teamName, userPrimaryKey	Removes the user from the team specified.
sendMessageToTeamResult	sendMessageToTeam	UserIDBean, teamName, messageString	Sends a string message to all users in the specified team.
wakeTeamFieldDevicesResult	wakeTeamFieldDevices	UserIDBean, teamName	Sends a message to all phone devices, which forces the application to start and connect to the server.
Array of strings	getTaskList	UserIDBean	Gets the tasks/customers list from the server.
addNewTaskResult	addNewTask	UserIDBean, taskName	Adds a new task/customer to the server list.
removeTaskResult	removeTask	UserIDBean, taskName	Remove task/customer from the server.

Main Data Type Definitions

EventBean

Name	Type	Size	Required	Description
whenOccured	Calendar	N/A	N/A	The date and time at which a clock in, clock out, start break, end break start task or end task event occurred
eventID	String	9	N/A	Unique identifier for the event
eventType	Enumerated String	9	N/A	One of the following: CLOCK_IN, CLOCK_OUT, TASK_START, TASK_END, BREAK_START, BREAK_END.
userName	String	25	N/A	The name of the user who generated the event.
deviceID	String	30	N/A	Device ID of the user who generated the event (unique identifier for the device).
userPK	String	9	N/A	Unique identifier for the user.
userType	String	50	N/A	Describes the type of user.

TaskEventBean extends EventBean

Name	Type	Size	Required	Description
taskName	String	50	N/A	The task name associated with the TASK_START or TASK_END event.

HourBreakdownBean

Name	Type	Size	Required	Description
userType	String	50	N/A	Describes the type of user.
userName	String	25	N/A	The name of the user who generated the event.
deviceID	String	30	N/A	Device ID of the user who generated the event (unique identifier for the device).
userName	String	25	N/A	The name of the user who generated the event.
normalHours	Int	0-24	N/A	The hours component of a normal working day.
normalMinutes	Int	0-59	N/A	The minutes component of a normal working day.
normalSeconds	Int	0-59	N/A	The seconds component of a normal working day.
overTimeHours	Int	0-24	N/A	The hours component of overtime in excess of a normal working day.
overTimeMinutes	Int	0-59	N/A	The minutes component of overtime in excess of a normal working day.
overTimeSeconds	Int	0-59	N/A	The seconds component of overtime in excess of a normal working day.
extraHours	Int	0-24	N/A	The hours component of extra time in excess of overtime and the normal working day.
extraMinutes	Int	0-59	N/A	The minutes component of overtime in excess of overtime and the normal working day.
extraSeconds	Int	0-59	N/A	The seconds component of overtime in excess of overtime and the normal working day.

OverTimeRuleBean

Name	Type	Size	Required	Description
userTypeAppliedTo	String	50	N/A	User type this is applied to.
startDate	Calendar	N/A	N/A	When the overtime rule starts
endDate	Calendar	N/A	N/A	When the overtime rule ends. This may be null if there is no definite end date for the rule.
includeBreakInTimeWorked	boolean	N/A	N/A	Defines if break time should be included in time worked calulations
overTimeRule	OverTimeBean	N/A	N/A	Which overtime rule
extraTimeRule	OverTimeBean	N/A	N/A	Which extratime rule

OverTimeBean

Name	Type	Size	Required	Description
applicable	boolean	N/A	N/A	Determines if this overtime information is applicable or not.
hoursPerDay	HoursPeriodBean	N/A	N/A	Defines the limit of normal work per day (anything over this is considered as a form of overtime or extratime).
hoursPerWeek	HoursPeriodBean	N/A	N/A	Defines the limit of normal work per week (anything over this is considered as a form of overtime or extratime).

HoursPeriodBean

Name	Type	Size	Required	Description
applicable	boolean	N/A	N/A	Determines if this hours period information is applicable or not.
hours	Int	0-168	N/A	Number of hours in this period.
minutes	Int	0-59	N/A	Numberof minutes in this period.

OrganisationDetailsBean

Name	Type	Size	Required	Description
name	String	25	N/A	The name of the organisation.
description	String	50	N/A	The description of the organisation.
accountNumber	String	25	N/A	The account number of the organisation.
contactName	String	30	N/A	The name of the contact person for the organisation.
contactWorkPhone	String	30	N/A	The contact person's work number.
contactMobilePhone	String	30	N/A	The contact person's mobile number.
contactEmailAddress	String	30	N/A	The contact person's email address.
address1	String	200	N/A	Address line 1 for the organisation (street address)
address2	String	30	N/A	Address line 2 for the organisation (suburb/town)
address3	String	30	N/A	Address line 3 for the organisation (city)
address4	String	30	N/A	Address line 4 for the organisation (state/region)
locale	String	10	N/A	Locale of the organisation (made up of language, country and variant codes - see java doc for more info)