Professional Documents
Culture Documents
App Subcomponent
For use with ClickMobile Touch
ClickSoftware Confidential
Legal Notice
The software with this guide is furnished under a license agreement and may be used only according to
the terms of that agreement.
Copyright
Copyright ClickSoftware Technologies Ltd. All rights reserved.
No part of this publication may be copied without the express written permission of ClickSoftware
Technologies Ltd.
Contact Information
Contact information is available from the ClickSoftware web site: http://www.clicksoftware.com.
For general information, email to sales@clicksoftware.com.
For ClickSoftware Worldwide Support, email to support@clicksoftware.com or see the support page on
the ClickSoftware web site.
For Partner Enablement, email to partnerenablement@clicksoftware.com.
Publication Notice
This guide has been carefully compiled. The information in this guide does not constitute a warranty of
performance. Furthermore, ClickSoftware reserves the right to revise this publication and make changes
from time to time in the content thereof, without obligation to notify any person of such revisions or
changes. ClickSoftware assumes no liability for losses incurred as a result of out-of-date or incorrect
information in this guide.
Version
Employee Daily Routine
App version: 1.0
Date: August 2015
Contents
E M P L O Y E E D A I L Y R O U T I N E .............................................4
Use............................................................................................................ 4
Prerequisites............................................................................................. 5
Installation................................................................................................. 5
Configuration............................................................................................. 6
Step 1. Configure the Agents Manager................................................6
Step 2. Enabling Server-Side Event.....................................................6
Step 3. Configure Loading Criteria.......................................................7
Step 4. Configure an EmployeeDailyRoutine Business View...............8
Reference Information: Object Model...................................................9
Reference Information: Components Imported by the Configuration
Installer Tool..................................................................................11
Comments...............................................................................................12
Use
ClickMobile users do not use Employee Daily Routine directly. Rather, Employee
Daily Routine is a back-office component that collects employee schedule data and
sends the data to ClickMobile.
Prerequisites
This app runs on ClickMobile Touch. For information about the certified versions,
see the ClickSoftware AppStore page of this app.
Before you install Employee Daily Routine, you must install the Timesheets (Touch)
app, version 2.0 or later (app #1175). Employee Daily Routine requires the
ActivityType dictionary that is installed with Timesheets (Touch).
Installation
1
On one computer where you run the Mobility Studio, download the Employee
Daily Routine app subcomponent and extract the compressed file.
Use the Configuration Installer Tool (build 79 and later) to load and import the
following file.
Note: To verify the version build of the Configuration Installer Tool, right-click
C:\Program Files (x86)\ClickSoftware\Service
Optimization\Bin\W6ConfigurationInstaller.exe and select Properties > Details.
In the filename, V.V is the script version number.
2.
Use the App Installer to import the following app file, where V.V is the app
version number:
Employee Daily Routine App (V.V).wcma
For instructions, see the Building and Installing Apps chapter of the
ClickMobile Configuration Guide. When complete, the app icon is displayed in
the Available Apps pane.
Configuration
To configure Employee Daily Routine, you must perform the following steps:
1
3.
4.
The following sections provide detailed instructions for each step. The instructions
are for ClickMobile version 8.3 Patch 003. The instructions might vary slightly for
other versions.
5.
In the settings window, click Add, and configure an event with the following
options:
Collection
EmployeeDailyRoutine
Type
W6CMServer.W6CMGenericObjectEvent, W6CMServer
Active
Select this option.
Breaks
(Multivalue) Breaks that the employee must take during the day.
Note: You must define employee breaks. Breaks are not defined by default. See
Step 3. Define Employee Breaks.
Each element of the multivalue has the following nested properties:
ActivityType
(Key to ActivityType dictionary) The activity type of the break, such as
Break or Idle. For an explanation of activity types, see the Timesheets
(Touch) documentation (app #1175).
BreakName
(String) A name for the break, such as Lunch, Coffee, or Rest.
MaximumBreakDuration
MinimumBreakDuration
(Duration) The required break duration in seconds.
MaximumTimeFromPreviousBreak
MinimumTimeFromPreviousBreak
(Duration) The required break start time, in seconds from the start time when
the employee actually took the previous break.
MaximumTimeFromStartOfDay
MinimumTimeFromStartOfDay
(Duration) The required break start time, in seconds from the start of the
employee's working day as defined in the Calendar object.
BreaksDefined
(Boolean) True if the Breaks property has been assigned. If false, Employee
Daily Routine ignores the property.
MinimumWorkPerDay
(Duration) The minimum working time in seconds.
MinimumWorkPerDay
(Boolean) True if the MinimumWorkPerDay property has been assigned. If
false, Employee Daily Routine ignores the property.
11
EmployeeDailyRoutine Object
The EmployeeDailyRoutine object stores the collected employee data for a
single day. The object has the following properties:
Breaks
(Multivalue) Breaks that the employee must take during the day, copied from
the ContractInfo object.
CalendarEndOfDay
CalendarStartOfDay
(Date) The employee's working period on the specific day, copied from the
Calendar object, including both regular and optional work time.
CalendarStartOfOvertime
(Date) The time at which the employee's regular hours end and overtime starts,
as defined in the Calendar object.
District
Region
(Key to District or Region dictionary) The region and district where the
employee is located.
Employee
(Key to Engineer collection) The engineer to whom the data applies.
EntryDate
(Date) The start of the day (midnight) to which the EmployeeDailyRoutine
object applies. All the EmployeeDailyRoutine properties refer to this day.
ExpectedStartOfTravel
(Date) The time when the employee must start travelling from the employee's
homebase to the first assignment of the day. The system computes this time by
subtracting the travel time from the start time of the employee's first assignment
on that day.
LastUpdate
(Date) The time when the EmployeeDailyRoutine object was created or
last updated.
MaximumWorkPerDay
MinimumWorkPerDay
(Duration) The required working time of the employee, copied from the
ContractInfo object.
MobileKey
(String) An identifier assigned by ClickMobile.
Comments
The ClickMobile appearance is configurable. The layout might differ on your
device.