Routines for r_dsvcs.kb


ConfirmDelete

File Name

r_dsvcs.kb

Syntax

ConfirmDelete( VAL w: WINDOW ): BOOLEAN IS

Parameters

w - Current window

Returns

Nothing

Side Effects

None

Description

This routine displays a confirmation when deleting a record.

Dialog Forms Called

None


MakeCloseFromOKCancel

File Name

r_dsvcs.kb

Syntax

MakeCloseFromOKCancel(VAL w: WINDOW, VAL OK_Name: STRING, VAL Cancel_Name: STRING) IS

Parameters

w - Current window

OK_Name - Accept_button name to be renamed

Cancel_Name - Cancel_button name to be hidden

Returns

Nothing

Side Effects

None

Description

This routine will rename the OK button to Close for view mode.

Dialog Forms Called

None


MakeOKCancelFromClose

File Name

r_dsvcs.kb

Syntax

MakeOKCancelFromClose(VAL w: WINDOW, VAL OK_Name: STRING, VAL Cancel_Name: STRING) IS

Parameters

w - Current window

OK_Name - button name to alter text on

Cancel_Name - button to make visible

Returns

Nothing

Side Effects

None

Description

This routine will name the ok button back to "OK".

Dialog Forms Called

None


R_CompletePartialAK

File Name

r_dsvcs.kb

Syntax

R_CompletePartialAK(VAL w: WINDOW, REF id: STRING, VAL table: STRING, VAL field: STRING, VAL nextField: STRING, REF oldAK: STRING): INTEGER IS

Parameters

w - Current window handle

id - People ID

table - Database table where corresponding ID and corresponding text value to be returned are located

field - Field being auto-filled

nextField - Field to move focus to upon completion of autofill

oldAK - Old text field value

Returns

Integer

Side Effects

None

Description

This routine retrieves the complete text value for a given ID and populates it into the appropriate text box.

Dialog Forms Called

None


R_CompletePersonPartialAK

File Name

r_dsvcs.kb

Syntax

R_CompletePersonPartialAK(VAL w: WINDOW, REF id: INTEGER, VAL field: STRING, VAL nextField: STRING, REF oldAK: STRING): INTEGER IS

Parameters

w - Current window handle

id - People ID

field - Text field

nextField - Field to move focus to upon autofill completion

oldAK - Old text field value

Returns

Integer

Side Effects

None

Description

This routine autofills a person's name in the appropriate text field.

Dialog Forms Called

None


R_ConvertDDEDelayTime

File Name

r_dsvcs.kb

Syntax

R_ConvertDDEDelayTime(VAL DDETime: REAL): INTEGER

Parameters

DDETime - Time in Seconds to be converted to milliseconds

Returns

Integer

Side Effects

None

Description

This routine converts DDE preference time in order to use with "SYSDELAY" and "$MsgTimer".

Dialog Forms Called

None


R_DDeacquireMSProject

File Name

r_dsvcs.kb

Syntax

R_DDeacquireMSProject IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine searches for MS Project and activiates the MS Project button.

Dialog Forms Called

None


R_DDECleanUpOnClose

File Name

r_dsvcs.kb

Syntax

R_DDECleanUpOnClose IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine terminates DDE Links and resets DDE variables.

Dialog Forms Called

None


R_DDEPromptUser

File Name

r_dsvcs.kb

Syntax

R_DDEPromptUser: BOOLEAN IS

Parameters

isActivity - Flags the current change as an activity or a change

Returns

Nothing

Side Effects

None

Description

This routine prompts the user, if needed, to close all project files. A value of TRUE is returned if the user presses the OK button, and FALSE if CANCEL.

Dialog Forms Called

None


R_DisableMSProject

File Name

r_dsvcs.kb

Syntax

R_DisableMSProject: WINDOW IS

Parameters

None

Returns

Nothing

Side Effects

None

Description

This routine disables MS Project and returns its window handle.

Dialog Forms Called

None


R_DisplayCategoryCode

File Name

r_dsvcs.kb

Syntax

FUNCTION R_DisplayCategoryCode(VAL Desc: STRING): STRING IS

Parameters

Desc - Category description

Returns

String

Side Effects

None

Description

This routine returns the code of a category given its description.

Dialog Forms Called

None


R_DisplayCategoryCode_modl

File Name

r_dsvcs.kb

Syntax

FUNCTION R_DisplayCategoryCode_modl(VAL id: STRING): STRING IS

Parameters

ID - Model ID

Returns

String

Side Effects

None

Description

This routine returns the code of a category given a model ID.

Dialog Forms Called

None


R_EnableMSProject

File Name

r_dsvcs.kb

Syntax

R_EnableMSProject(VAL wMSProject: WINDOW): INTEGER IS

Parameters

wMSProject - Window handle to MS Project

Returns

Integer

Side Effects

None

Description

This routine enables MS Project.

Dialog Forms Called

None


R_EnterBrowserField

File Name

r_dsvcs.kb

Syntax

R_EnterBrowserField(VAL w: WINDOW, VAL field: STRING, REF oldAK: STRING ): INTEGER IS

Parameters

w - Current window handle

field - Field name

oldAK - Field value

Returns

Integer

Side Effects

None

Description

This routine is invoked with $MsgEnterField to assist in autocomplete.

Dialog Forms Called

None


R_EnterPersonField

File Name

r_dsvcs.kb

Syntax

R_EnterPersonField(VAL w: WINDOW, VAL field: STRING, REF oldAK: STRING );

Parameters

w - Current window handle

field - Field name

oldAK - Field value (contents)

Returns

Integer

Side Effects

None

Description

This routine is invoked with $MsgEnterField to assist in autocomplete.

Dialog Forms Called

None


R_ExitAssetField

File Name

r_dsvcs.kb

Syntax

R_ExitAssetField(VAL w: WINDOW, VAL FieldName: STRING):INTEGER IS

Parameters

w - Current window handle

FieldName - Current field name

Returns

Integer

Side Effects

None

Description

This routine performs an autofill check on the Find Change Dialog box for a given asset tag.

Dialog Forms Called

None


R_ExitBrowserField

File Name

r_dsvcs.kb

Syntax

R_ExitBrowserField(VAL w: WINDOW, VAL field: STRING, VAL nextField: STRING, VAL table: STRING, REF id: STRING, REF oldAK: STRING): INTEGER IS

Parameters

w - Current window handle

id - People ID

table - Database table where corresponding ID and corresponding text value to be returned are located

field - Field being auto-filled

nextField - Field to move focus to upon completion of autofill

oldAK - Old text field value

Returns

Integer

Side Effects

None

Description

This routine is called when exiting a browser field. If "thisAK" <> "oldAK" then "RCompletePartialAK" is called.

Dialog Forms Called

None


R_ExitPersonField

File Name

r_dsvcs.kb

Syntax

R_ExitPersonField(VAL w: WINDOW, VAL field: STRING, REF oldAK: STRING );

Parameters

w - Current window

field - The field being exited

oldAK - The old value of this field

Returns

Nothing

Side Effects

None

Description

This function is invoked at $MsgExitField time to assist in autocomplete.

Dialog Forms Called

None


R_GetChangeMatchingMCLB

File Name

r_dsvcs.kb

Syntax

R_GetChangeMatchingMCLB(VAL w: WINDOW, VAL field_Name: STRING, REF this_Change: R_CHANGE_REC): INTEGER IS

Parameters

w - Current window

field_Name - Name of MCLB

Returns

Integer

Side Effects

None

Description

This routine gets the change record matching the selection in the MCLB.

Dialog Forms Called

None


R_GetEFMObjectName

File Name

r_dsvcs.kb

Syntax

R_GetEFMObjectName(VAL id: STRING, VAL table: STRING): STRING IS

Parameters

id - Object ID being retrieved

table - Table name

Returns

String

Side Effects

None

Description

This routine selects the object name for a given table ID.

Dialog Forms Called

None


R_GetRelevantStatusMatchingMCLB

File Name

r_dsvcs.kb

Syntax

R_GetRelevantStatusMatchingMCLB(VAL w: WINDOW, VAL field_Name: STRING, REF this_Status: R_STATUS_REC) IS

Parameters

w - Current window

field_Name - Name of MCLB

this_Status - Current status record

Returns

Nothing

Side Effects

None

Description

This routine returns the relevant status code record for a given status ID.

Dialog Forms Called

None


R_LoadFieldForHiddenID

File Name

r_dsvcs.kb

Syntax

R_LoadFieldForHiddenID(VAL w: WINDOW, VAL field: STRING, VAL id: STRING, VAL type: STRING) IS

Parameters

w - Current window

field - Name of field to set

id - ID of record to set

type - Type of record to set

Returns

Nothing

Side Effects

None

Description

This routine loads a field for a hidden ID.

Dialog Forms Called

None


R_MultipleStatusEvent

File Name

r_dsvcs.kb

Syntax

R_MultipleStatusEvent(REF this_Status: R_STATUS_REC) IS

Parameters

this_Status - Current status record

Returns

Nothing

Side Effects

None

Description

This is the event handler for status selection.

Dialog Forms Called

None


R_PersonPartialAK2PK

File Name

r_dsvcs.kb

Syntax

R_PersonPartialAK2PK(REF display: BrowsePeopleListRec, VAL w: WINDOW, VAL ak: STRING);

Parameters

display - A person or list of people

w - Current window handle

ak - Previous value of field being auto-filled

Returns

Integer

Side Effects

None

Description

This routine takes a field entry value and resolves it to it's complete value.

Dialog Forms Called

None


R_PriorityEvent

File Name

r_dsvcs.kb

Syntax

R_PriorityEvent(REF this_approval: R_APPROVAL_REC) IS

Parameters

this_approval - Current approval record

Returns

Nothing

Side Effects

None

Description

This is the event handler for updating an approver priority.

Dialog Forms Called

None


R_ProcessChangeError

File Name

r_dsvcs.kb

Syntax

R_ProcessChangeError(VAL w: WINDOW, VAL Error_Title: STRING, VAL Error_String: STRING) IS

Parameters

w - Current window

Error_Title - Title of error to display

Error_String - Text of error to display

Returns

Nothing

Side Effects

None

Description

This routine displays passed-in error message.

Dialog Forms Called

None


R_ProcessFindEntryFields

File Name

r_dsvcs.kb

Syntax

R_ProcessFindEntryFields(VAL w: WINDOW, REF this_FindChange: R_FIND_CHANGE_REC, VAL type: INTEGER) IS

Parameters

w - Current window

this_FindChange - Current find change record

type - Type of interaction to perform

Returns

Nothing

Side Effects

None

Description

This routine handles screen interactions when finding changes.

Dialog Forms Called

None


R_RetrieveCategoryAdHocValue

File Name

r_dsvcs.kb

Syntax

R_RetrieveCategoryAdHocValue( VAL category: STRING ): BOOLEAN IS

Parameters

category - Current category code

Returns

Boolean

Side Effects

None

Description

This routine returns the value for column "ADHOC" from table Category for the passed-in category code.

Dialog Forms Called

None


R_SelectModelApprovalPriority

File Name

r_dsvcs.kb

Syntax

R_SelectModelApprovalPriority(VAL w: WINDOW, REF this_approval: R_APPROVAL_REC) IS

Parameters

w - Window

this_approval - Current approval record.

Returns

Integer

Side Effects

None

Description

This routine allows model approvals to utilize the same PriorityEvent routine as changes.

Dialog Forms Called

rchg.dfc[set_priority]


R_UpdateDateEntryValue

File Name

r_dsvcs.kb

Syntax

R_UpdateDateEntryValue(VAL w: WINDOW,VAL field_Name: STRING, REF field_Value: DATE, REF Alter_Flag: INTEGER) IS

Parameters

w - Current window

field_Name - Name of field to extract

field_Value - Value of field

Alter_Flag - What state the new field has

Returns

Nothing

Side Effects

None

Description

This routine updates the value for a date entry field.

Dialog Forms Called

None