Routines for workhist.kb


AddWorkHistoryRecord

File Name

workhist.kb

Syntax

AddWorkHistoryRecord ( work );

Parameters

work - Work history record containing all data for the record

Returns

SQL Result code of the insert

Side Effects

None

Description

This function is used to add a work history record. This function sets the work_id and modify_datetime fields.

Dialog Forms Called

None


DeleteWorkHistoryRecord

File Name

workhist.kb

Syntax

DeleteWorkHistoryRecord ( work );

Parameters

work - Work history record containing work_id of record to delete

Returns

SQL Result code of the delete

Side Effects

None

Description

This function is used to delete a work history record.

Dialog Forms Called

None


FlatEvent

File Name

workhist.kb

Syntax

FlatEvent(REF FlatR: EA_FlatRecord)

Parameters

FlatR:

Returns

None

Side Effects

None

Description

Shows all of work history in text format.

Dialog Forms Called

None


processRetString

File Name

workhist.kb

Syntax

processRetString();

Parameters

1. retString: STRING

* 2. delStringLength: INTEGER

Returns

None

Side Effects

None

Description

This procedure process the retString which is the concatenation * of the list of work history and returns the length to be deleted. * For example, * IF retString is 'work id: 999 This problem is not sol', * retString will be trimmed to 'work id: 999 This problem is not' * and delStringLength will be the number of characters from the * first character of retString to the 't' in 'not'. * This procedure is used when a gigantic string is divided into * two at the threshold length. However the last word of the first * half might not be a discrete word.

Dialog Forms Called

None


SplitString

File Name

workhist.kb

Syntax

SplitString();

Parameters

None

Returns

retString: STRING

Side Effects

None

Description

This function breaks a gigantic string into two and * returns the first half of the string. The number of * characters in the first half is used to determine the * number of characters to be deleted in FlatR.FlatList.

Dialog Forms Called

None


UpdateWorkHistoryRecord

File Name

workhist.kb

Syntax

UpdateWorkHistoryRecord ( work );

Parameters

work - Work history record containing all data for the record

Returns

SQL Result code of the update

Side Effects

None

Description

This function is used to update a work history record. This function does NOT perform a passive concurency check.

Dialog Forms Called

None


WorkHistoryMainEvent

File Name

workhist.kb

Syntax

WorkHistoryMainEvent ( work );

Parameters

workHistoryRecord

Returns

On exit work.$newTime contains a value to be added to the

current problem's time spent field.

Side Effects

None

Description

This event is the main event handler for editing work history it can be invoked stand alone or can be called via a delegateEvent from any other event handler to add work history processing to another notebook. When it is called as a delegateEvent it should not be allowed to process $msgCreate, $msgClose, or $msgDestroy. When the parent event handler wants to initialize the work history page of its notebook it should send a REFRESH_WORKHISTLIST message to $Handle (which will then be delegated to WorkHistoryMainEvent.

Dialog Forms Called

resume.dfc[workwithwork]


WorkWithWorkHistories

File Name

workhist.kb

Syntax

WorkWithWorkHistories ( whdl, condition, mode );

Parameters

WINDOW - Window to parent the Work History dialog

STRING - problem ID to parent the Work Histories

STRING - Select condition to use for querying of Work

history data

BOOLEAN - Determine if coming from Callreg or not

INTEGER - Editing mode ( Edit, View, etc ...)

Returns

Nothing

Side Effects

None

Description

This function is used to create and process the Work with Work History window. The records that are displayed are a factor of a select driven off of the condition parameter passed in.

Dialog Forms Called

resume.dfc[workwithwork_form]