SQL-008: Insert a new menu item¶

This statement is the InsertSQL implementation of clsMenuItem.Criteria, executed from BeforeInsert against MENU_ITEM. Insert a new menu item.

Classification¶

Field	Value
SQL ID	SQL-008
Operation type	Create
Execution method	Inline SQL
Database	Oracle
Schema	`[unqualified]`**
Command type	Text
Business object	`clsMenuItem`
Criteria property	`InsertSQL`
Lifecycle method	`BeforeInsert`

Parameters¶

Parameter	Direction	Type	Max length	Description
`:MenuItemSeqNum`	Input	Decimal	N/A	Sequence-assigned primary key (from SQL-002)
`:MenuPageSeqNum`	Input	Decimal	N/A	Page placed by this item
`:MenuCategoryCode`	Input	String	5	Owning category code
`:ToolTip`	Input	String	1000	Item tooltip text
`:VisibleFlag`	Input	String	1	Visibility as `Y`/`N` (`IsVisible.ToY_N_String`)
`:PageOrder`	Input	Decimal	N/A	Display order within the category
`:UserId`	Input	String	30	Acting user, trimmed and upper-cased, stamped as `UPDATE_USER`

Tables¶

Table	Access	Columns used
MENU_ITEM	INSERT	MENU_ITEM_SEQ_NUM, MENU_PAGE_SEQ_NUM, MENU_CATEGORY_CODE, TOOL_TIP_TXT, VISIBLE_FLAG, PAGE_ORDER_NUM, UPDATE_DATE, UPDATE_USER

Sample SQL¶

-- Insert a new menu item
Insert into
  MENU_ITEM
  (
  MENU_ITEM_SEQ_NUM,
  MENU_PAGE_SEQ_NUM,
  MENU_CATEGORY_CODE,
  TOOL_TIP_TXT,
  VISIBLE_FLAG,
  PAGE_ORDER_NUM,
  UPDATE_DATE,
  UPDATE_USER
  )
Values
  (
  :MenuItemSeqNum,
  :MenuPageSeqNum,
  :MenuCategoryCode,
  :ToolTip,
  :VisibleFlag,
  :PageOrder,
  SYSDATE,
  :UserId
  )

Operations and processes¶

Create a menu item

Business rules¶

BR-MENU-016: Audit stamp on insert and update
BR-MENU-019: Y/N boolean flag storage
BR-MENU-020: Single-row write verification

Note: Statements marked with ** could not be confirmed; treat as unknown until verified.

Sources¶

SAIF.Business.Menu/clsMenuItem.vb