BOM Procedures/Macros/Buttons - Intergraph Smart Materials - Version 10.2 - Help - Hexagon

Intergraph Smart Materials Classic Help

Language
English
Product
Intergraph Smart Materials
Subproduct
Classic
Search by Category
Help
Smart Materials/Smart Reference Data Version
10.2

BOM procedures can be used to verify and maintain BOM position data.

The BOM procedures are available for execution on the B.20.03 Adv. Maintain BOM screen to those users with the EXEC_ALL_BOM_PROCEDURES privilege, as a user privilege on A.20.06.04 or as a role privilege on A.30.03.

BOM procedures and macros can be defined on the B.10.21 BOM Procedures/Macros screen.

The Procedures tab in the upper section displays the available procedures, with the procedure name in the Procedure field and a description in the Comment field. Select the Display indicator for all procedures to be displayed on the pop-up menu on B.20.03. Up to ten procedures can be displayed on the menu. An example of the menu is displayed in the picture below.

The standard procedures delivered with the software have the Standard indicator selected and cannot be changed. The available standard procedures are listed below.

Procedure

Comment

EST_SHORTAGE

Calculate Estimation Shortage

IDENT_INFO

BOM VERIFICATION JOB - IDENT_INFO

VER_BLD_IDENT

BOM VERIFICATION JOB - VER_BLD_IDENT

VER_BOM_COPY

BOM VERIFICATION JOB - VER_BOM_COPY

VER_BOM_POS

BOM VERIFICATION JOB - VER_BOM_POS

VER_FND_IDENT

BOM VERIFICATION JOB - VER_FND_IDENT

VER_IDENT

BOM VERIFICATION JOB - VER_IDENT

VER_ISSUE_DEL

BOM VERIFICATION JOB - VER_ISSUE_DEL

VER_ISSUE_REV

BOM VERIFICATION JOB - VER_ISSUE_REV

VER_PJSPEC

BOM VERIFICATION JOB - VER_PJSPEC

VER_SPEC_UPDT

BOM VERIFICATION JOB - VER_SPEC_UPDT

VER_TSQ

BOM VERIFICATION JOB - VER_TSQ

VER_TSQ_CHK

Find Nodes higher IS but not with Issued/Reserved QTYs

The Exec for Nodes check box specifies whether the BOM procedure shall run against nodes. In this case, LN_ID must be passed as one of the procedure parameters. If the check box is not selected, the procedure will run against BOM positions. In this case, LP_ID must be passed as one of the procedure parameters.

To define a procedure, enter the procedure name in the Procedure field and a description in the Comment field. Select the Display indicator to make the procedure available on the B.20.03 menu. Select the Exec for Nodes check box if the procedure should run against nodes. Then save this new record.

Click on the Procedure Parameters tab to display or define the parameters for the selected procedure.

Select the parameter to be assigned to the procedure from the LOV in the Parameter field. Parameters to be used as BOM procedure parameters must be defined on the A.30.05 Parameter screen. For more information about the parameter definition, read Parameters.

Only parameters with data type VARCHAR2, DATE, or NUMBER are allowed.

Enter a sequence number greater than 1 in the Seq field to define the order of the parameters in the BOM procedure. The value 1 is reserved for LP_ID or LN_ID. Enter a parameter default value in the Default Value field. Save the assigned parameters.

Go back to the Procedures tab and click the Edit Procedure button to open window 2, which displays the BOM procedure definition of the selected procedure.

The selected procedure and its description are displayed on top in the Procedure and Comment fields. A part of the declaration and execution section and all of the exception section of the new BOM procedure are automatically generated and displayed, but you cannot modify these parts of the procedure. You can only add missing declarations and the execution section of the procedure in the central field with the light background color.

An API (M_PCK_BOM_PROC.LOG_DETAIL_INFO) is provided to record customized log messages from within the BOM procedure. After execution of the procedure, the log messages can be viewed on the B.20.03 Adv. Maintain BOM screen.

The API takes four parameters as described below.

M_PCK_BOM_PROC.LOG_DETAIL_INFO (<KIND_OF>, <TEXT>, <RET_VAL>, P_LP_ID)

The <KIND_OF> argument is a message type of indicator for classifying the log message. You can use any three characters for the value of the <KIND_OF> argument. Do not use the argument values ‘MAR’, ‘WRN,’ or ‘ERR’ because these values are reserved for system internal logs (‘MAR’ - information log, ‘WRN’ - warning log, ‘ERR’ - error log).

For the <TEXT> argument, you can use any text value that you want to have as a log comment.

For the <RET_VAL> argument, you can use any text value that you want to have as a log comment returning from the BOM procedure.

The P_LP_ID argument must always be kept as the last argument in the list. This variable is passed as the first argument to the BOM procedure.

The first characters of the character string returned through the variable V_RET_VAL from the BOM Procedure must not be Error.

After defining the procedure, save it. The Compilation Message field at the bottom will show ‘Not Compiled.’ Click the Compile button to compile the procedure. If the procedure compiles successfully, the Compilation Message field shows ‘Function <PROC_NAME> compiled successfully.’. If the compilation is not successful, the corresponding compilation error message is shown in the Compilation Message field. Only successfully compiled procedures can be run from B.20.03 Adv. Maintain BOM.

If it is required to execute a set of BOM procedures cumulatively, you can define a BOM macro on the Macros tab in the lower section of the screen.

Enter the macro name in the Macro field and the description in the Comment field. Select the Display indicator if the macro should be displayed on the pop-up menu on B.20.03. Up to ten macros can be displayed on the menu. An example of the menu is displayed in the picture below.

In the next (BOM Macro Details) block, you can assign pre-defined procedures to the selected macro. Enter a unique sequence number in the Seq No. field; this number controls the execution order of the BOM procedures within the macro. Then select the procedure from the LOV in the Procedure field and save.

On the Buttons tab in the lower section of the screen, you can assign up to four of your favorite BOM procedures or BOM macros to buttons displayed on B.20.03.

Select the procedure or macro from the LOV in the BOM Procedure/Macro field and enter a label in the Button Label field. These buttons will be displayed on the B.20.03 Adv. Maintain BOM screen and can be used for fast access and execution of the associated BOM procedure or macro. The buttons defined on B.10.21 are displayed at the bottom of B.20.03 beside the ‘Search for’ section.

If you run a procedure from B.20.03 which is not compiled successfully, the message displayed below will appear.

Clicking OK will automatically open the B.10.21 BOM Procedures/Macros screen where you can revise and validate the procedure.

While executing a valid BOM procedure, the Selection Criteria box displayed below will pop up.

On the Node Selection Options tab. the selected node with its entire path is displayed in the Path field. Select the Include Sub-Tree check box to include all sub-nodes of the selected WBS node to be processed by the procedure.

To add additional nodes to be included in the processing, click the Select Multiple Nodes check box, this will enhance the box as displayed below.

Click the Browse button to open the BOM multi selection LOV, select the Sel check box of all nodes to be included, and click the Fill In button to close the LOV and copy the selected nodes to the Selection Criteria box.

Select an option from the Issue Status Selection radio group. The available options are:

  • Any - All positions with any issue status will be processed.

  • Best Quantity - Only positions with the highest issue status of the node (according to best quantity logic) will be processed.

  • Specified - You must specify a particular issue status by selecting it from the LOV in the Issue Status field. Only positions with this specified issue status will be processed.

Click on the Procedure Parameters tab to adjust the parameter values.

Click the Continue button to start the procedure execution. When done, the box below will appear.

Click the Show Log button to open a new window, which displays the BOM Procedure/Macro Logs screen.