Update Method (BomItemSubst)
- Last UpdatedMar 17, 2026
- 5 minute read
The Update() method updates all columns of the specified BOM item substitute record in the Bom_Item_Subst table.
'Declaration
Public Shared Sub Update( _
ByVal sessionId As Integer, _
ByVal parentItemId As String, _
ByVal verId As String, _
ByVal bomPos As Integer, _
ByVal altNo As Integer, _
ByVal pref As Integer, _
ByVal substLevel As Integer, _
ByVal itemId As String, _
ByVal reqdGradeCd As DBInt, _
ByVal instruction As DBString, _
ByVal qtyPerParentItem As Double, _
ByVal maxQtyPerParentItem As DBDouble, _
ByVal minQtyPerParentItem As DBDouble, _
ByVal updateInv As Boolean, _
ByVal backflush As Boolean, _
ByVal defReasCd As DBInt, _
ByVal defLotNo As DBString, _
ByVal defSubLotNo As DBString, _
ByVal defStorageEntId As DBInt, _
ByVal defRejectEntId As DBInt, _
ByVal scalingFactor As DBDouble, _
ByVal mustConsumeFromInv As Boolean, _
ByVal mayChooseAltInvLoc As Boolean, _
ByVal mayCreateNewLots As Boolean, _
ByVal mustConsumeFromWip As Boolean, _
ByVal mustConsumeBeforeProd As Boolean, _
ByVal constantQty As Boolean, _
ByVal estTime As DBDouble, _
ByVal spare1 As DBString, _
ByVal spare2 As DBString, _
ByVal spare3 As DBString, _
ByVal spare4 As DBString, _
ByVal lastEditComment As DBString, _
ByRef lastEditAt As Date _
)
'Usage
Dim sessionId As Integer
Dim parentItemId As String
Dim verId As String
Dim bomPos As Integer
Dim altNo As Integer
Dim pref As Integer
Dim substLevel As Integer
Dim itemId As String
Dim reqdGradeCd As DBInt
Dim instruction As DBString
Dim qtyPerParentItem As Double
Dim maxQtyPerParentItem As DBDouble
Dim minQtyPerParentItem As DBDouble
Dim updateInv As Boolean
Dim backflush As Boolean
Dim defReasCd As DBInt
Dim defLotNo As DBString
Dim defSubLotNo As DBString
Dim defStorageEntId As DBInt
Dim defRejectEntId As DBInt
Dim scalingFactor As DBDouble
Dim mustConsumeFromInv As Boolean
Dim mayChooseAltInvLoc As Boolean
Dim mayCreateNewLots As Boolean
Dim mustConsumeFromWip As Boolean
Dim mustConsumeBeforeProd As Boolean
Dim constantQty As Boolean
Dim estTime As DBDouble
Dim spare1 As DBString
Dim spare2 As DBString
Dim spare3 As DBString
Dim spare4 As DBString
Dim lastEditComment As DBString
Dim lastEditAt As Date
BomItemSubst.Update(sessionId, parentItemId, verId, bomPos, altNo, pref, substLevel, itemId, reqdGradeCd, instruction, qtyPerParentItem, maxQtyPerParentItem, minQtyPerParentItem, updateInv, backflush, defReasCd, defLotNo, defSubLotNo, defStorageEntId, defRejectEntId, scalingFactor, mustConsumeFromInv, mayChooseAltInvLoc, mayCreateNewLots, mustConsumeFromWip, mustConsumeBeforeProd, constantQty, estTime, spare1, spare2, spare3, spare4, lastEditComment, lastEditAt)
public static void Update(
int sessionId,
string parentItemId,
string verId,
int bomPos,
int altNo,
int pref,
int substLevel,
string itemId,
DBInt reqdGradeCd,
DBString instruction,
double qtyPerParentItem,
DBDouble maxQtyPerParentItem,
DBDouble minQtyPerParentItem,
bool updateInv,
bool backflush,
DBInt defReasCd,
DBString defLotNo,
DBString defSubLotNo,
DBInt defStorageEntId,
DBInt defRejectEntId,
DBDouble scalingFactor,
bool mustConsumeFromInv,
bool mayChooseAltInvLoc,
bool mayCreateNewLots,
bool mustConsumeFromWip,
bool mustConsumeBeforeProd,
bool constantQty,
DBDouble estTime,
DBString spare1,
DBString spare2,
DBString spare3,
DBString spare4,
DBString lastEditComment,
ref DateTime lastEditAt
)
Parameters
- sessionId
Required. Holds the session ID and thus the user who is making this method call.
- parentItemId
Required. Holds the the ID of the parent item.
- verId
Required. Holds the ID of the BOM version.
- bomPos
Required. Holds the BOM position (usually sequential). For by-products, this value is negative. For this item being produced, the BOM position is 0, in which case the item_id is the same as the parent_item_id.
- altNo
Required. Holds the alternative number for the BOM position.
- pref
Required. Holds the preference of the alternative starting at 1. Lowered-numbered alternatives are preferable to higher-numbered ones.
- substLevel
Required. Holds the substitution level a user must use. The default is 0.
- itemId
Required. Holds the ID of the item being produced or consumed.
- reqdGradeCd
Required. Holds ID of the grade code for the BOM Item. A Null indicates that it is disabled.
- instruction
Required. Holds the instructions on how to consume or produce the item.
- qtyPerParentItem
Required. Holds the quantity of the item required per unit of the current parent item.
- maxQtyPerParentItem
Required. Holds the maximum quantity of the BOM component required per unit of the currentparent item.
- minQtyPerParentItem
Required. Holds the minimun quantity of the BOM component required per unit of the currentparent item.
- updateInv
Required. Holds a flag that, if set to true, specifies whether the inventory table is updated with item consumption. The default is false.
- backflush
Required. Holds a flag that, if set to true, specifies whether the consumption is backflushed. The default is false.
- defReasCd
Required. Holds the default consumption or production code for the item. If null, it will default to the value specified for the entity on which this job is run.
- defLotNo
Required. Holds the default item lot number. If null, it defaults to the lot specified for the entity on which the job is run.
- defSubLotNo
Required. Holds the default item sublot number. If null, it defaults to the sublot specified for the entity on which the job is run.
- defStorageEntId
Required. Holds the ID of the default entity of the component, product, or byproduct. If null, it defaults to the default storage entity for the entity on which the job is run.
- defRejectEntId
Required. Holds the ID of the entity for reject production items. If null, the def_storage_ent_id is used.
- scalingFactor
Required. Holds the scaling factor which is used to get the correct units from item dependent counts.
- mustConsumeFromInv
Required. Holds a flag that, if set to true, specifies whether the consumption should occur from inventory for the item. The default is false.
- mayChooseAltInvLoc
Required. Holds a flag that, if set to true, specifies whether the user can select alternate inventory locations when consuming or producing this item. The default is true.
- mayCreateNewLots
Required. Holds a flag that, if set to true, specifies whether the user can create new lots when consuming or producing this item. The default is true. This parameter is relevant only if not consuming from inventory.
- mustConsumeFromWip
Required. Holds a flag that, if set to true, specifies whether the lots consumed during a job must be limited to the lots produced to the Item_Inv table for the same work order in an upstream job.
- mustConsumeBeforeProd
Required. Holds a flag that, if set to true, specifies whether to prevent any production transactions until 'acceptable' quantities of BOM components have been consumed, as specified by the 'max_qty_per_parent_item' and 'min_qty_per_parent_item' fields. The default is false.
- constantQty
Required. Holds a flag that, if set to true, specifies whether the quantities of the item consumed are independent of the quantity of the parent item produced. The default is false.
- estTime
Required. Holds the number of hours it should take to consume or produce the component per unit of BOM position zero. The default is Null for BOM position zero.
- spare1
Required. Holds the contents of the user-defined spare1 field.
- spare2
Required. Holds the contents of the user-defined spare2 field.
- spare3
Required. Holds the contents of the user-defined spare3 field.
- spare4
Required. Holds the contents of the user-defined spare4 field.
- lastEditComment
Required. Holds comments that describe why this record is being updated.
- lastEditAt
Required. Holds the date/time when this record was added or last updated, for optimistic concurrency control. The passed value must match the lastEditAt value in the record for the update to succeed.
Output. Holds the date/time value when the record was updated by this called method.