                                        Worklog3a
     Activity logging program for Psion Series 3a
                          (c) Alfa Computing 1996
                                  Richard Schmidt
                       Richard Sturenberghlaan 50
                                2273 GX  VOORBURG
                            THE NETHERLANDS (EUR)
                  Email @ Compuserve : 100735,331
       Email @ Internet : rschmidt@worldonline.nl
  Homepage : http://www.worldonline.nl/~rschmidt/   
                                                 
                                   Version V1.5.1
                                         09/12/96


Index
=====
1.     INTRODUCTION
2.     INSTALLATION
2.1    REQUIREMENTS
2.2    HOW TO INSTALL
2.3    DISTRIBUTION
3.     KEYBOARD REFERENCE
4.     THE AUTHOR
4.1    HOW TO CONTACT THE AUTHOR
4.2    DISCLAIMER
4.3    HOW TO REGISTER
5.     FUTURE DEVELOPMENT
6.     HISTORY

1. Introduction
===============
Welcome to WorkLog3a!

WorkLog3a is a project activity logging 
program. It can log activities for specific 
projects during a work day and save time 
spend on these activities to a database.

This program can be useful for people 
working on several projects having to 
monitor their labour and creating time-sheets.

Features of WorkLog3a:
- input of projects and recording activities
  for this projects.
- calculation of:
  * total work hours per project within a
    specific period, and all projects
    cumulated;
  * total work hours per project today;
  * total work hours per project in a;
    specific week; totals are specified
    per day;
  * available and remaining budget;
- export to CSV;
- memo per project;
- notification when exceeding workday hours
  and project duration;
- (audible)notification when activity has
  expired on user specified duration forcing
  application to come to foreground;
- printing projects and its activities/totals;
- tracking remaining vacation hours
- and lots of other stuff...

WorkLog3a is only available in English for the
Psion Series 3a.

2. Installing WorkLog3a
=======================
Before using the application you should install
it from your PC to your Psion.

2.1 Requirements
================
The application requires 77K RAM memory and
approximately 55K ram of disk space. If your
machine appears to be out of memory try to close
a few applications or erase files from internal
memory (after making a backup first!).

2.2 How to install
==================
To install WorkLog3a:

- start RCOM or MCLINK;
- connect and switch on Psion link in system
  screen with Psion-L;
- copy file WORKLOG.OPA to an \APP directory on
  any disk
- copy file WORKLOG.HLP to an \APP\WORKLOG
  directory on any disk.
- Create directory \WORKLOG\ on any drive for
  the data files.
- Install the WorkLog3a application in the system
  screen by pressing Psion-I.

Make sure you have an \OPD directory on your
default drive. WorkLog3a will save its
configuration to \OPD\WORKLOG.INI.

2.3 Distribution
================
An unregistered copy of this application may be
distributed freely. The application itself
consists of the following files:

WORKLOG.OPA    Main application
WORKLOG.HLP    Help screens
MANUAL.TXT     This manual

3. Keyboard reference
=====================

File - Open - Psion-O
---------------------
Opens new projects file. A projects file
contains project descriptions and all the
activities. A projects file consists of
three files and optionally some memo files:

\WORKLOG\EXAMPLE.WKL    projects
\WORKLOG\EXAMPLE.WKT    activities
\WORKLOG\EXAMPLE.WKI    project info
\WORKLOG\EXAMPLE\*.WKM  memos for EXAMPLE

File - New - Psion-N
---------------------
Create new projects file. New files will
be stored in the \WORKLOG\ directory.

File - Tidy up - Psion-K
------------------------
This option can be used to tidy up the
activities file. All activities for all or
marked projects will be removed before or 
after a specific date. 

File - Export - Shift-Psion-Q
-----------------------------
Export all or marked projects to a CSV text
file.

FILE - CSV text file

TYPE - All field in the current WorkLog 
database will be exported to a text file.
It's possible to include project information
for each activity as well.

PROJECTS - Select between exporting activities
for all or only marked projects.

SEPARATOR - Select between four types of field
separators. Record separator will always be a
carriage return and line feed.

Search - Find - Psion-F or F
----------------------------
Find project in list. Searches through
projects and makes an occurrence current
project.

Search - Find next - Psion-G or G
---------------------------------
Find next project in list. Searches from
current project to end.

Search - Jump - Psion-J
-----------------------
Jumps to project by number. Every project
in the list is preceded by its record
number. Use jump to jump to a project
by entering this record number.

Search - Jump - Esc
-------------------
Bring up speed list, jump to project

Project - Enter - Psion-E
-------------------------
Add a new project to the project file.
A maximum of 999 projects can be entered.
The unregistered version of WorkLog3a allows
for 5 projects.

PROJECT - short description for project

DESCRIPTION - long description for project

CHARGE/HOUR - internal charge per hour,
this information is used to determine the
remaining budget.

BUDGET - budget (money value) for this project

Project - Enter - Psion-U or ENTER
----------------------------------
Update current project. Updated project
are always moved to the end of the list.

Project - Delete - Psion-D or DELETE
------------------------------------
Delete current or marked projects.

Project - Details - Shift-Psion-E
---------------------------------
Edit details for current project. These detail
are just extra project information. The duration
field is used to check if activities exceed
this duration.

Project - Info - Psion-I
------------------------
Display information about:
1. number of projects in current project file
2. number of activities for ALL projects
3. number of activities for CURRENT project

Project - Mark current - Psion-M
--------------------------------
Mark current project. Marked projects can be
deleted, exported or printed in one pass. All 
reports on screen or printer apply to either 
ALL projects or MARKED projects.

Project - Mark all - Psion-A
----------------------------
Mark all projects.

Project - Unmark all - Shift-Psion-U
------------------------------------
Unmark all projects

Memo - Edit - Psion-+
---------------------
Create or edit memo for current project.
Each project can have one memo. This option
launches the built in WORD application. 
Therefore memos are limited to 40000 characters.
Memos are stored in a subdirectory (with same
name as projects file) in the directory that 
contains the project files (usually 
\WORKLOG\). The names for the memo files 
are equal to the internal project id number 
(invisible for user).

Be aware when renaming a projects file to
rename also the memos subdirectory.

If a project has a memo a '' character will
be shown next to the project number.

Memo - Delete - Shift-Psion-K
-----------------------------
Delete memo file for current project. The 
'' character will disappear.

Activity - Start - Psion-S, S or SPACE
--------------------------------------
Start activity for current project. Depending
on your settings, a dialog box appears (at the
end or start of an activity) querying the
description for the activity.

In time stamp mode this key combination can 
also be used to start or stop an activity

RECORD MODE
During the activity a dialog box is displayed
showing the elapsed time and remaining
duration time. The duration of an activity
acts as a countdown timer for activities.

TIME STAMP MODE
During the activity almost all program 
functionality is available. Except for functions
that modify the activities database.

Depending on your settings, an activity can
be stopped automatically forcing WorkLog3a to
come to foreground and beep optionally.

WorkLog3a allows for a maximum of 3000
activities per projects file.

Activity - Manual entry - Shift-Psion-M
---------------------------------------
Add activity to activity database manually
without having to start (record) an activity. 
This option can be used when you "forgot" to
start a new activity and want to add it
afterwards.

It is possible to enter:
- a period with start and end date;
- a duration with start date and a duration
  of 15min, 30min, 1hr, 2hrs, 4hrs or 8hrs.

Activity - View - Psion-V or TAB or Shift-TAB
---------------------------------------------
List all activities for current project.
This dialog shows categories, descriptions, 
start/end date and duration for all activities. 

Shift-TAB shows all activites for all projects

Psion-U or Enter    Update activity
Psion-D or Delete   Delete activity
Psion-S             Sort activities
Psion-F             Find activity
Psion-G             Find next activity
Psion-P             Move current activity to
                    other project. Select project
                    from list to move activity to
Esc                 Close activity list
Help                Help
Menu                Menu

Activity - Categories - Psion-C
-------------------------------
Every activity has a description. Categories can
be used to categorize or group activities.
A maximum of 10 categories can be entered.

Activity - Vacation - Psion-V
-----------------------------
Update remaining vacation hours for this year.
It is possible to add or substract hours.

remaininghours=remaininghours+add-subtract

Totals - None - Psion--
-----------------------
Stop display of totals in project table view.
Switching off totals speeds up scroling.

Totals - Period - Shift-Psion-P
-------------------------------
Calculates total labour per project in a
specific period. If projects are marked than
only marked project will be calculated.

Totals - Day - Shift-Psion-D
----------------------------
Calculates total labour per day for a maximum 
of 7 consecutive days starting at a specific
date.

Totals - Week - Psion-W
-----------------------
Calculates total labour per day in a week.
The number of working days (1-7) in a week 
depends on your settings in the preferences 
dialog (default 5).

Totals - Today - Psion-* or *
-----------------------------
Calculates total labour today.

Totals - Remaining budget - Psion-B
-----------------------------------
Calculates remaining budget per project.
Uses budget and charge/hour specified
with project.

Totals - Set filter - Shift-Psion-F
-----------------------------------
Normally the calculation of totals applies to
all activities. By setting a filter, only
activities with same cagegory description as 
filter will be taken in account when 
calculating totals.

Special - About - Shift-Psion-A
-------------------------------
Displays about information.

Special - Register - Psion-R
----------------------------
Register your copy of WorkLog3a.

Special - Set preferences - Psion-Q
-----------------------------------
Set global preferences. These preferences are
devided over three pages.

TIME FORMAT - time format for displaying,
exporting and printing time.

WORK HOURS PER DAY - length of workday in 
hours. Used in time calculations.

START OF WORK DAY - start time of work day
used for default time in manual entries.

WORK DAYS PER WEEK - number of work days
per week. This field determines the number
of work days shown in a week report. 

DEFAULT CHARGE FOR NEW PROJECTS - default
charge per hour used when entering new 
projects.

DEFAULT BUDGET FOR NEW PROJECTS - default
budget used when entering new projects.

MODE
activities can be logged in record or time
stamp mode. 
In record mode a modal dialog will be shown
with activity progress information. The
application is suspended until the pending
activity is stopped. In stamp mode almost all
functionality is available between starting
and stopping an activity. In this mode
the progress dialog is not shown.

PROMPT FOR DESCRIPTION - prompt for activity
description when starting or stopping a task. 
Three types of prompt are available:
- Do not ask;
- Before starting;
- When stopping.

CONFIRM STOP ACTIVITY - Requires confirmation
for stopping activities in case of accidently
pressing the space bar.

WORKHOURS NOTIFICTION - totals for today
are calculated when an activity is
stopped.

DEFAULT TIME ENTRY - option for setting 
default time when entering manual activities. 
Selectable system time or start of work day 
time. 

TIME UNIT - default time unit for new
activities. Some lawyer use time units of
6 minutes. Set to 00:00:00 if you do not want
to use time units.

DEFAULT ACTIVITY DURATION (only record mode)
Default activity duration for new activities. 
Depending on setting the activity will continue 
or terminate after this time has elapsed. 
It's also possible to select an audible warning. 

ON EXPIRATION DURATION (only record mode)
Determines what action to take when activity 
duration has elapsed (see setting above).

DISPLAY GRID LINES
Display of horizontal grid lines for better
reading.

SURPRES ZERO VALUES
Display of zero time/money values.

DISPLAY DESCRIPTION
Display of description or category in activity
view.

DISPLAY TIME
Display/edit of end date/time or duration in
activity view.

PERFORM OVERFLOW CHECK
Check for each project if total activity 
time exceeds project duration when calculating
totals. Projects exceeding their duration will
show a up arrow next to the project number.
Otherwise a down arrow will be displayed in the
project list.

Settings are saved to \OPD\WORKLOG.INI

Special - Zoom in - Psion-Z
---------------------------
Enlarge screen font used for displaying projects.

Special - Zoom out - Shift-Psion-Z
----------------------------------
Reduce screen font used for displaying projects.

Special - Print setup - Psion-Y
-------------------------------
Select between printing to file or parallel
port.

LINES/PAGE - maximum lines per page for
work hours reports.

HEADER - text header to appear on top of
each page.

Special - Print - Psion-P
-------------------------
Print totals for period, week or subsequent
days. Set "Include activities" to yes if 
all activities are to be printed as well.

Special - Exit - Psion-X
------------------------
Exit application. 

4. The author
=============

4.1 How to contact the author
=============================
The author can be reached by mailing to:
Alfa Computing
Richard Schmidt
Richard Sturenberghlaan 50
2273 GX  VOORBURG
THE NETHERLANDS (EUR)
Email @ Compuserve : 100735,331

<<PREFERRABLE>>
Email @ Internet : rschmidt@worldonline.nl
Homepage : http://www.worldonline.nl/~rschmidt/
(check out this home page for the latest versions)

4.2 Disclaimer
==============
The author takes no responsibility for any lost
data or hardware malfunctions of any kind due to
the use of this software or any other software
that ships with WorkLog3a.

4.3 How To register
===================
The cost for this application is:
$10      [US]
5-10    [UK]
Hfl 20,= [NL]
DM 20,-  [DU]
Fr 60,-  [FR]

- send cash in envelope to my postal address or
- use SwReg on compuserve to register
  SWReg id : 10384
  Product  : WorkLog3a
  Price    : $20 or equivalent
- Only for Dutch users
  Stort voor registratie Hfl 20,-- op
  girorekening 6338889 tnv R.G.Schmidt
  te Voorburg o.v.v. uw adresgegevens.

  **********************************
  * registered PTM3a users receive *
  * a free update                  *
  **********************************

OTHER SOFTWARE : CALC3a and TRIPS3a
  
5. Future development
=====================
- tidy up, move (marked) activities to other 
  projects file;
- serial printing/PsiWin;
- configurable column widths;
- sorting projects;
etc.

6. History
==========
09/03/96 Version 1.0 test
* Initial test release.

26/03/96 Version 1.0.1
* Bug fixes
  - insufficient memory message for reports;
  - bug in calculating total cost per period;
  - bug in auto terminating tasks and coming
    to foreground.
* Tracking remaining vacation hours
* Enter task manually: period or hours
* Configurable number of work days a week (1..7)
* Faster calculation of totals
* Activity filter option in totals dialog
* Maximum of 3000 activities per database (was 1000)
* Indication of attached memo to project
* Memo files are also deleted when deleting
  projects
* Find also searches in description field
* Default category for new activities

12/04/96 Version 1.1.0
* Table view for activities 
  - delete activity
  - update activity
  - find(next) activity
  - move activity to other project
  - sort activities on description, date/time
* Speed list for jumping to projects
  ESCAPE in project view brings up a list of 
  projects
* Optionally search from top or current position
* Default system time for manual entry
  - system time
  - start of workday
* Tidy up before or after specific date
* Tidy up only marked projects
* Confirmation when stopping activity
* Suppres zero values

29/04/96 Version 1.1.3, 1.1.4
* Time stamp recording mode
* Form feed at end of print job
* Two fontsizes in project view caused overlap
  in activity view
* Project name in record dialog
* More relexaed activity filter
* Default is curent week in totals for week dialog
* Days were calculated in 24hrs now it depends
  on the number of hours per workday
* Bug fix font activity list
* Bug fix stamp mode

08/12/96 Version V1.5
* ESC in preferences dialog cancels subsequent 
  dialogs
* "include activities" option in print dialog
  moved to top of dialog
* NEW display formats : dddd:hh:mm, dddd:hh and
  hh:mm
* Notification when exceeding project duration
  with up and down arrows next to project number
* Separate field for catagory in activities
  database. In previous versions activity 
  description and category shared the same field
* When printing activities, category an activity
  duration are also printed
* Cosmetic changes and correction of typos
* Displaying of totals: totals workdays spend per
  project
* Configurable time-unit per activity
* Removed confusing workday alternative of 24hrs
* Option to delete project memos 
* Project details added:
  - project start date
  - project end date
  - fixed cost
  - expenses
  - address and telephone number
* Updating activities: now allows for displaying,
  sorting and entering of start time and duration 
* Improved font zoom
* CSV ascii export
  
09/12/96 Version V1.5.1
* bug fix, div by zero in case of workhours per
  day 00:00
