Routines for i_asset.kb


AEVAssetEvent

File Name

i_asset.kb

Syntax

AEVAssetEvent(REF AEVAssetData: AEVAssetEventInstRec)

Parameters

AEVAssetData - instance data used for AEVAssetEvent

Returns

Nothing

Side Effects

None

Description

Event handler used for adding, editing, and viewing assets in the Asset dialog box.

Dialog Forms Called

i_asset.dfc[aevassetsubform]

people.dfc[peoplesearchonly]

i_asset.dfc[container]

i_asset.dfc[notesform]


AssetCopyEvent

File Name

i_asset.kb

Syntax

AssetCopyEvent(REF invCopies: LIST OF IS_InventoryRec)

Parameters

invCopies - list of assets to be copied

Returns

Nothing

Side Effects

None

Description

Event handler used to copy assets in the Asset dialog box.

Dialog Forms Called

None


AssetQBEEvent

File Name

i_asset.kb

Syntax

AssetQBEEvent(REF AssetQbeData: AssetQbeEventInstRec)

Parameters

AssetQbeData - instance data used in the AssetQbeEvent

Returns

Nothing

Side Effects

None

Description

Event handler used for finding assets based on search criteria. This event handler is also used for selecting and returning assets to other applications such as Contracts.

Dialog Forms Called

None


BrowseContainerEvent

File Name

i_asset.kb

Syntax

BrowseContainerEvent(REF BSR: HierarchyEventInstRec)

Parameters

BSR - hierarchy record used for viewing the container trees.

Returns

Nothing

Side Effects

None

Description

Browse container event handler used for viewing containers linked to a particular asset.

Dialog Forms Called

None


ChangeAttribValue

File Name

i_asset.kb

Syntax

ChangeAttribValue(VAL wHdl: WINDOW, VAL eeInvEffect: INTEGER, REF attribValueList: LIST OF AttribValueRec, REF physAttribList: LIST OF PhysAttribRec, REF physAttribBeforeList: LIST OF PhysAttribRec, REF physAttribAfterList: LIST OF PhysAttribRec)

Parameters

whdl - parent window handle

eeInvEffect - inventory ID

attribValueList - list of attributes

physAttribList - list of container attributes

physAttribBeforeList - before list of container attributes

physAttribAfterList - after list of container attributes

Returns

Nothing

Side Effects

None

Description

Inserts, updates, and deletes attributes in a list.

Dialog Forms Called

None


ClearPhysAttribValues

File Name

i_asset.kb

Syntax

ClearPhysAttribValues(REF thisPm_object_id: STRING, REF thisPhysAttribBeforeList: LIST OF PhysAttribRec, REF thisPhysAttribAfterList: LIST OF PhysAttribRec )

Parameters

thisPm_object_id - container ID

thisPhysAttribBeforeList - old attibute list for selected container

thisPhysAttribAfterList - new attribute list for selected container

Returns

Nothing

Side Effects

None

Description

Clears the attributes associated with a container.

Dialog Forms Called

None


ClearSearchCriteria

File Name

i_asset.kb

Syntax

None

Parameters

None

Returns

Nothing

Side Effects

None

Description

This procedure clears the instance data used to create the search string.

Dialog Forms Called

None


ExamineAsset

File Name

i_asset.kb

Syntax

ExamineAsset(VAL w: WINDOW, VAL mode: STRING, VAL eeInvEffect: INTEGER, REF invRec: IS_InventoryRec)

Parameters

w - parent window handle

mode - dialog mode (either view or edit)

eeInvEffect - 0,1 to identify if being called from the eeInvEffect dialog box

invRec - instance data for the Asset dialog box

Returns

Nothing

Side Effects

None

Description

This routine is called in the context of a current asset and is used to display the Asset dialog box for the current asset.

Dialog Forms Called

None


ExitFieldProcessing

File Name

i_asset.kb

Syntax

ExitFieldProcessing (VAL wHdl: WINDOW, VAL field:STRING, VAL formName: STRING, REF oldAK: STRING, REF ContinueEdit: BOOLEAN, REF AssetValue: IS_InventoryRec, REF thisPmObject: PM_ObjectRec, REF lastExitedField: STRING, REF AttribPageLoaded: BOOLEAN, REF thisModelList: LIST OF I_ObjectRec, REF attribValueList: LIST OF attribValueRec, REF physAttribList: LIST OF physAttribRec, REF physAttribBeforeList: LIST OF physAttribRec, REF physAttribAfterList: LIST OF physAttribRec)

Parameters

whdl - parent window handle

field - entry field on form being used

formName - name of form being used

oldak - previous field entered

ContinueEdit - true if the user wishes to continue editing an incorrect value, \

false if the user does not wish to continue editing the field

AssetValue - current asset being edited

thisPmObject - container record

lastExitedField - last field exited on form

AttribPageLoaded - true if attribute page is already loaded, false if it is not loaded

thisModelList - list of models associated with a category

attribValueList - list of attributes

physAttribList - list of container attributes

physAttribBeforeList - before list of container attributes

physAttribAfterList - after list of container attributes

Returns

result of CompletePartialTreeAK function

Side Effects

None

Description

Completes a partial entry in an entry field on exiting. The user is prompted to continue editing the entry field if no match is found.

Dialog Forms Called

None


ExitTreeField

File Name

i_asset.kb

Syntax

None

Parameters

None

Returns

Nothing

Side Effects

None

Description

None

Dialog Forms Called

None


FillAsset_MCLB

File Name

i_asset.kb

Syntax

None

Parameters

None

Returns

Nothing

Side Effects

None

Description

This fills the asset MCLB.

Dialog Forms Called

None


FillAttribValues

File Name

i_asset.kb

Syntax

FillAttribValues(VAL InvRec: IS_InventoryRec, REF massDefinition: MassDefRec, REF attribValueList: LIST OF AttribValueRec, REF physAttribList: LIST OF PhysAttribRec, VAL eeInvEffect: INTEGER, VAL efmMass: INTEGER, VAL mode: STRING, VAL wHdl: WINDOW)

Parameters

InvRec - current asset record

massDefinition - mass definition record

attribValueList - list of attributes associated with asset

physAttribList - list of attributes associated with container

eeInvEffect - inventory ID

efmMass - mass upate mode or regular mode

mode - current mode of the Asset dialog box

whdl - parent window handle

Returns

Nothing

Side Effects

None

Description

Fills in attributes or their values upon setting of category.

Dialog Forms Called

None


FindButtonProcessing

File Name

i_asset.kb

Syntax

None

Parameters

None

Returns

Nothing

Side Effects

None

Description

This procedure creates the search string based on the search criteria entered.

Dialog Forms Called

None


InitAssetQbeFields

File Name

i_asset.kb

Syntax

None

Parameters

None

Returns

Nothing

Side Effects

None

Description

None

Dialog Forms Called

None


NotesEvent

File Name

i_asset.kb

Syntax

NotesEvent(REF NotesEventData: NotesEventInstRec)

Parameters

NotesEventData - instance data used for notes event

Returns

Nothing

Side Effects

None

Description

Event handler used for adding, editing, and deleting notes associated with a asset.

Dialog Forms Called

None


RefillIsaAttribValues

File Name

i_asset.kb

Syntax

RefillIsaAttribValues (VAL wHdl: WINDOW, VAL AssetValue: IS_InventoryRec, REF attribValueList: LIST OF attribValueRec, REF physAttribList: LIST OF physAttribRec, REF physAttribBeforeList: LIST OF physAttribRec, REF physAttribAfterList: LIST OF physAttribRec)

Parameters

whdl - parent window handle

AssetValue - current asset record

attribValueList - list of attributes for asset

physAttribList - physical attribute list

physAttribBeforeList - original list of physical attribute records

physAttribAfterList - updated list of physical attribute records

Returns

Nothing

Side Effects

None

Description

Fills in attributes or their values upon setting of model.

Dialog Forms Called

None


RefreshModelNameList

File Name

i_asset.kb

Syntax

RefreshModelNameList(VAL w: WINDOW, VAL field: STRING, VAL h_object_id: STRING, REF modelList: LIST OF I_ObjectRec)

Parameters

w - parent window handle

field - currently selected field

h_object_id - category ID

modelList - list of models associated with a category

Returns

Nothing

Side Effects

None

Description

The model names are refreshed when a different category is selected.

Dialog Forms Called

None


RequestAddAsset

File Name

i_asset.kb

Syntax

RequestAddAsset(VAL wHdl: WINDOW, REF AEVAssetData: AEVAssetEventInstRec)

Parameters

whdl - parent window handle

AEVAssetData - AEVAssetEvent instance data

Returns

dlgbox result

Side Effects

None

Description

The common routine called by both this system action and other in-context requests for adding a new asset in the Asset Find dialog box. This routine accepts initialized instance data for the Asset dialog box.

Dialog Forms Called

None


RequestAddNewAsset

File Name

i_asset.kb

Syntax

RequestAddNewAsset(VAL wHdl: WINDOW)

Parameters

whdl - parent window handle

Returns

Nothing

Side Effects

None

Description

System action for adding a new asset. This routine calls the requestAddAsset routine. RequestAddAsset is the common routine called by both this system action and other in-context requests for adding a new asset.

Dialog Forms Called

None


RequestAssetQuickFind

File Name

i_asset.kb

Syntax

RequestAssetQuickFind(VAL wHdl: WINDOW)

Parameters

whdl - window handle

Returns

Nothing

Side Effects

None

Description

System action for finding assets. This routine calls the requestAssetQuickInquiry routine. RequestAssetQuickInquiry is the common routine called by both this system action and other in-context requests for finding assets.

Dialog Forms Called

None


RequestAssetQuickInquiry

File Name

i_asset.kb

Syntax

RequestAssetQuickInquiry(VAL wHdl: WINDOW, REF AssetQbeData: AssetQbeEventInstRec)

Parameters

whdl - window handle

AssetQbeData - instance data for the AssetQbeEvent

Returns

Nothing

Side Effects

None

Description

The common routine for requesting the Asset Quick Find dialog. This routine is called from the system action or other routines that want to display the Asset Find dialog box. This routine accepts initialized instance data for the Asset Find dialog box.

Dialog Forms Called

i_asset.dfc[assetqbe]


RequestAssetQuickInvApi

File Name

i_asset.kb

Syntax

RequestAssetQuickInvApi(VAL wHdl: WINDOW, VAL people_id: INTEGER, VAL location_id: STRING, VAL organization_id: STRING, VAL h_object_id: STRING, VAL connection_id: STRING, VAL fromCallReg: BOOLEAN, VAL fromContract: BOOLEAN, VAL supported_organization: STRING)

Parameters

wHdl - parent window handle

people_id - people ID

location_id - location ID

organiztaion_id - organization ID

h_object_id - category ID

connection_id - connection ID

fromCallReg - TRUE if from call registration, FALSE if not from call registration

fromContract - TRUE if from contract, FALSE if not from contract

supported_organization - supported organization ID

Returns

Nothing

Side Effects

None

Description

This procedure is used to call the Quick Find Assets dialog box from other applications.

Dialog Forms Called

i_asset.dfc[assetqbems]

i_asset.dfc[assetqbe]


SendAssetBackToCallReg

File Name

i_asset.kb

Syntax

None

Parameters

None

Returns

Nothing

Side Effects

None

Description

None

Dialog Forms Called

None


SendAssetBackToContract

File Name

i_asset.kb

Syntax

None

Parameters

None

Returns

Nothing

Side Effects

None

Description

This procedure is used by Contracts to return a selected asset from Asset Quick Find to Contracts.

Dialog Forms Called

i_asset.dfc[assetqbesubform]

people.dfc[peoplesearchonly]

i_asset.dfc[copy]

c_prnt.dfc[printchoice]

i_asset.dfc[assetnb]

i_asset.dfc[viewchoice]


SetAssetQbeButtons

File Name

i_asset.kb

Syntax

None

Parameters

None

Returns

Nothing

Side Effects

None

Description

This procedure sets the dialog box buttons.

Dialog Forms Called

None


TagCharacteristic

File Name

i_asset.kb

Syntax

TagCharacteristic(VAL eeInvEffect: INTEGER, VAL wHdl: WINDOW, REF attribValueList: LIST OF AttribValueRec)

Parameters

eeInvEffect - inventory ID

whdl - parent window handle

attribValueList - list of attributes

Returns

currently selected attribute index

Side Effects

None

Description

Marks asset attributes as included/excluded in a mass update definition and returns a new MCLB index.

Dialog Forms Called

None


UpdateListOfInventoryItems

File Name

i_asset.kb

Syntax

UpdateListOfInventoryItems(VAL mode:STRING, VAL inTran: BOOLEAN, REF updateList: LIST OF InvUpdateRec, REF newInv_PeopleList: LIST OF Inv_PeopleRec, REF Inv_PeopleList: LIST OF Inv_PeopleRec, REF newInv_ConnectionList: LIST OF Inv_ConnectionRec, REF Inv_ConnectionList: LIST OF Inv_ConnectionRec)

Parameters

mode - current mode of AssetNotebook (add, edit, view)

inTran - in a transaction or not

updateList - record containing inventory data to be updated

newInv_PeopleList - new list of users associated with an asset

Inv_PeopleList - users associated with an asset

newInv_ConnectionList - new list of connections associated with an asset

Inv_ConnectionList - list of connections associated with an asset

Returns

Boolean - update successful or not

Side Effects

None

Description

This function updates the IS_Inventory table and all other related records for the asset (for instance, history, inv_people).

Dialog Forms Called

None


WWContainers

File Name

i_asset.kb

Syntax

WWContainers

Parameters

None

Returns

Nothing

Side Effects

None

Description

This procedure is used to edit a container while editing a asset.

Dialog Forms Called

i_asset.dfc[container]


WWContainersEvent

File Name

i_asset.kb

Syntax

None

Parameters

BSR - hierarchy record used for working with container trees

Returns

Nothing

Side Effects

None

Description

Event handler used for editing and adding containers.

Dialog Forms Called

None