UpdateSpecific(Int32,Int32,String,DBString,DBInt,DBInt,DBDouble,Nullable<Boolean>,Nullable<Boolean>,Nullable<Boolean>,Nullable<Boolean>,Nullable<Boolean>,Nullable<Boolean>,Nullable<Boolean>,Nullable<Boolean>,Nullable<Boolean>,Nullable<Boolean>,Nullable<Boolean>,Nullable<Boolean>,Nullable<Boolean>,Nullable<Boolean>,Nullable<Boolean>,Nullable<Boolean>,Nullable<Boolean>,Nullable<Boolean>,Nullable<Boolean>,DBInt,DBDateTime,DBDateTime,DBString,DBString,Nullable<Int32>,Nullable<Boolean>,Nullable<Boolean>,DBString,Nullable<Int32>,String,String,String,String,DBString,Nullable<DateTime>) Method
- Last UpdatedMar 17, 2026
- 9 minute read
The UpdateSpecific() method updates selected columns of the specified entity's record in the Ent table.
This overload of the method includes the following input parameters:
- canCaptureQmData
- entityFromGalaxy
- canSchedJobsFromGalaxy
- canRunJobsFromGalaxy
- canCaptureUtilFromGalaxy
- canTrackOeeFromGalaxy
- canStoreFromGalaxy
- defStdOperId
- equipmentType
'Declaration
Public Overloads Shared Sub UpdateSpecific( _
ByVal sessionId As Integer, _
ByVal entId As Integer, _
ByVal entName As String, _
ByVal description As DBString, _
ByVal parentEntId As DBInt, _
ByVal site As DBInt, _
ByVal hourlyCost As DBDouble, _
ByVal canSchedJobs As Nullable(Of Boolean), _
ByVal canRunJobs As Nullable(Of Boolean), _
ByVal canCaptureUtil As Nullable(Of Boolean), _
ByVal canCaptureLabor As Nullable(Of Boolean), _
ByVal canDoDNC As Nullable(Of Boolean), _
ByVal canTrackOEE As Nullable(Of Boolean), _
ByVal canSchedShifts As Nullable(Of Boolean), _
ByVal canStore As Nullable(Of Boolean), _
ByVal canLogData As Nullable(Of Boolean), _
ByVal canShip As Nullable(Of Boolean), _
ByVal canReceive As Nullable(Of Boolean), _
ByVal canCopyFolders As Nullable(Of Boolean), _
ByVal canCaptureQmData As Nullable(Of Boolean), _
ByVal entityFromGalaxy As Nullable(Of Boolean), _
ByVal canSchedJobsFromGalaxy As Nullable(Of Boolean), _
ByVal canRunJobsFromGalaxy As Nullable(Of Boolean), _
ByVal canCaptureUtilFromGalaxy As Nullable(Of Boolean), _
ByVal canTrackOeeFromGalaxy As Nullable(Of Boolean), _
ByVal canStoreFromGalaxy As Nullable(Of Boolean), _
ByVal curShiftId As DBInt, _
ByVal curShiftStartTimeLocal As DBDateTime, _
ByVal lastDomainChange As DBDateTime, _
ByVal treeIcon As DBString, _
ByVal flowDiagramImage As DBString, _
ByVal identicalJobExecs As Nullable(Of Integer), _
ByVal showInDSPTree As Nullable(Of Boolean), _
ByVal entClass As Nullable(Of Boolean), _
ByVal defStdOperId As DBString, _
ByVal equipmentType As Nullable(Of Integer), _
ByVal spare1 As String, _
ByVal spare2 As String, _
ByVal spare3 As String, _
ByVal spare4 As String, _
ByVal lastEditComment As DBString, _
ByRef lastEditAt As Nullable(Of Date) _
)
'Usage
Dim sessionId As Integer
Dim entId As Integer
Dim entName As String
Dim description As DBString
Dim parentEntId As DBInt
Dim site As DBInt
Dim hourlyCost As DBDouble
Dim canSchedJobs As Nullable(Of Boolean)
Dim canRunJobs As Nullable(Of Boolean)
Dim canCaptureUtil As Nullable(Of Boolean)
Dim canCaptureLabor As Nullable(Of Boolean)
Dim canDoDNC As Nullable(Of Boolean)
Dim canTrackOEE As Nullable(Of Boolean)
Dim canSchedShifts As Nullable(Of Boolean)
Dim canStore As Nullable(Of Boolean)
Dim canLogData As Nullable(Of Boolean)
Dim canShip As Nullable(Of Boolean)
Dim canReceive As Nullable(Of Boolean)
Dim canCopyFolders As Nullable(Of Boolean)
Dim canCaptureQmData As Nullable(Of Boolean)
Dim entityFromGalaxy As Nullable(Of Boolean)
Dim canSchedJobsFromGalaxy As Nullable(Of Boolean)
Dim canRunJobsFromGalaxy As Nullable(Of Boolean)
Dim canCaptureUtilFromGalaxy As Nullable(Of Boolean)
Dim canTrackOeeFromGalaxy As Nullable(Of Boolean)
Dim canStoreFromGalaxy As Nullable(Of Boolean)
Dim curShiftId As DBInt
Dim curShiftStartTimeLocal As DBDateTime
Dim lastDomainChange As DBDateTime
Dim treeIcon As DBString
Dim flowDiagramImage As DBString
Dim identicalJobExecs As Nullable(Of Integer)
Dim showInDSPTree As Nullable(Of Boolean)
Dim entClass As Nullable(Of Boolean)
Dim defStdOperId As DBString
Dim equipmentType As Nullable(Of Integer)
Dim spare1 As String
Dim spare2 As String
Dim spare3 As String
Dim spare4 As String
Dim lastEditComment As DBString
Dim lastEditAt As Nullable(Of Date)
Ent.UpdateSpecific(sessionId, entId, entName, description, parentEntId, site, hourlyCost, canSchedJobs, canRunJobs, canCaptureUtil, canCaptureLabor, canDoDNC, canTrackOEE, canSchedShifts, canStore, canLogData, canShip, canReceive, canCopyFolders, canCaptureQmData, entityFromGalaxy, canSchedJobsFromGalaxy, canRunJobsFromGalaxy, canCaptureUtilFromGalaxy, canTrackOeeFromGalaxy, canStoreFromGalaxy, curShiftId, curShiftStartTimeLocal, lastDomainChange, treeIcon, flowDiagramImage, identicalJobExecs, showInDSPTree, entClass, defStdOperId, equipmentType, spare1, spare2, spare3, spare4, lastEditComment, lastEditAt)
public static void UpdateSpecific(
int sessionId,
int entId,
string entName,
DBString description,
DBInt parentEntId,
DBInt site,
DBDouble hourlyCost,
Nullable<bool> canSchedJobs,
Nullable<bool> canRunJobs,
Nullable<bool> canCaptureUtil,
Nullable<bool> canCaptureLabor,
Nullable<bool> canDoDNC,
Nullable<bool> canTrackOEE,
Nullable<bool> canSchedShifts,
Nullable<bool> canStore,
Nullable<bool> canLogData,
Nullable<bool> canShip,
Nullable<bool> canReceive,
Nullable<bool> canCopyFolders,
Nullable<bool> canCaptureQmData,
Nullable<bool> entityFromGalaxy,
Nullable<bool> canSchedJobsFromGalaxy,
Nullable<bool> canRunJobsFromGalaxy,
Nullable<bool> canCaptureUtilFromGalaxy,
Nullable<bool> canTrackOeeFromGalaxy,
Nullable<bool> canStoreFromGalaxy,
DBInt curShiftId,
DBDateTime curShiftStartTimeLocal,
DBDateTime lastDomainChange,
DBString treeIcon,
DBString flowDiagramImage,
Nullable<int> identicalJobExecs,
Nullable<bool> showInDSPTree,
Nullable<bool> entClass,
DBString defStdOperId,
Nullable<int> equipmentType,
string spare1,
string spare2,
string spare3,
string spare4,
DBString lastEditComment,
ref Nullable<DateTime> lastEditAt
)
Parameters
- sessionId
- Required. Holds the session ID and thus the user who is making this method call.
- entId
Required. Holds the ID of the entity being updated.
- entName
- Optional. Holds the name for the entity.
- description
- Optional. Holds the description for the entity.
- parentEntId
- Optional. Holds the ID of the parent entity for this entity. If null, this entity will be a root entity.
- site
- Optional. Holds the ID of the ancestor entity that defines the site at which this entity is located. If null, the entity is above sites or sites are not being used in the system.
- hourlyCost
- Optional. Holds the cost of running this entity per hour.
- canSchedJobs
- Optional. Holds the flag that, if set to true, specifies that jobs can be scheduled to this entity.
- canRunJobs
- Optional. Holds the flag that, if set to true, specifies that jobs can be run on this entity.
- canCaptureUtil
- Optional. Holds the flag that, if set to true, specifies that this entity can capture utilization, subject to the number of available licenses.
- canCaptureLabor
- Optional. Holds the flag that, if set to true, specifies that this entity can capture labor data.
- canDoDNC
- Optional. Not used. Will always be set to False.
- canTrackOEE
- Optional. Holds the flag that, if set to true, specifies that this entity can capture OEE statistics.
- canSchedShifts
- Optional. Holds the flag that specifies that whether or not this entity can schedule shifts. If true, this entity will have its own shift schedules. Otherwise, the shift schedules are inherited from the entity's preferred parent or from its nearest ancestor that can schedule shifts.
- canStore
- Optional. Holds the flag that, if set to true, specifies that this entity can store items, and thus this can be used as a storage location.
- canLogData
- Optional. Holds the flag that, if set to true, specifies that this entity can log data.
- canShip
- Optional. Holds the flag that, if set to true, specifies that materials can be shipped from this entity.
- canReceive
- Optional. Holds the flag that, if set to true, specifies that materials can be received at this entity.
- canCopyFolders
- Optional. Holds the flag that, if set to true, specifies that the files in folders for this entity can be copied to its download directories.
- canCaptureQmData
- Optional. Holds the flag that, if set to true, specifies that QM data can be captured on this entity.
- entityFromGalaxy
- Optional. Holds a flag that, if true, indicates that the entity is configured in a System Platform galaxy and exported to the MES database using the Entity Model Builder.
- canSchedJobsFromGalaxy
- Optional. Holds a flag that, if true, indicates that the canSchedJobs input parameter was set by a System Platform galaxy export using Entity Model Builder.
- canRunJobsFromGalaxy
- Optional. Holds a flag that, if true, indicates that the canRunJobs input parameter was set by a System Platform galaxy export using Entity Model Builder.
- canCaptureUtilFromGalaxy
- Optional. Holds a flag that, if true, indicates that the canCaptureUtil input parameter was set by a System Platform galaxy export using Entity Model Builder.
- canTrackOeeFromGalaxy
- Optional. Holds a flag that, if true, indicates that the canTrackOee input parameter was set by a System Platform galaxy export using Entity Model Builder.
- canStoreFromGalaxy
- Optional. Holds a flag that, if true, indicates that the canStore input parameter was set by a System Platform galaxy export using Entity Model Builder.
- curShiftId
Optional. Holds the ID of the current shift for this entity. If the can_sched_shifts property for an entity is set to false, then the current shift ID and the current shift datetimes are inherited from the nearest ancestor entity (through preferred ancestor hierarchy) that can schedule shifts; otherwise the current shift ID is set to 0.
Note: This parameter is currently not used.
- curShiftStartTimeLocal
Optional. Holds the date/time of the current shift start time for this entity, in local time. If the can_sched_shifts property for an entity is set to false, then the current shift ID and the current shift datetimes are inherited from the nearest ancestor entity (through preferred ancestor hierarchy) that can schedule shifts; otherwise, the current shift start time is set to the current date and time when the entity is created.
Note: This parameter is currently not used.
- lastDomainChange
- Optional. Holds the date/time of the last domain change. Not currently implemented.
- treeIcon
- Optional. Holds a string that is the key for retrieving the hierarchy tree icon image from the Graphics table. If null, a default image will be used. Not currently implemented.
- flowDiagramImage
- Optional. Holds a string that is the key for retrieving the flow diagram image from the Graphics table. If null, a default image will be used. Not currently implemented.
- identicalJobExecs
- Optional. Holds the maximum number of jobs that can be run at the same time on this entity. The default is 0.
- showInDSPTree
Optional. Holds a flag that, if set to true, specifies that this entity will appear in the data source plug-in tree.
Note: This parameter is obsolete.
- entClass
- Optional. Holds a flag that, if set to true, specifies that this is an entity class.
- defStdOperId
- Optional. A string that specifies the identity of the standard operation to be used when creating a work order with no reference to a process.
- equipmentType
- Optional. An integer that specifies the source of utilization and production information: 1 = manual, 2 = automatic (information from UCO/OCO), 3 (= semiautomatic (either manual or from objects; this is the default value).
- spare1
- Optional. Holds user-defined content for the spare1 field.
- spare2
- Optional. Holds user-defined content for the spare2 field.
- spare3
- Optional. Holds user-defined content for the spare3 field.
- spare4
- Optional. Holds user-defined content for the spare4 field.
- lastEditComment
- Optional. Holds comments about why this record is being changed.
- lastEditAt
Optional. Holds the date/time when this record was added or last edited, for optimistic concurrency control. If it is specified, the passed value must match the lastEditAt value in the record for the update to succeed.
Output. Holds the date/time value when this record was updated by this called method.
Observe the following input parameter rules:
- Optional non-DB* parameters: Either enter a new value or leave the existing value unchanged by passing a null.
- Optional DB* parameters: To clear the existing value and enter an empty value, pass DB*.null (e.g., DBInt.null). To leave the existing value unchanged, pass a null.
If the supplied canCaptureUtil flag for the new entity is set to true, then the corresponding Middleware method validates whether there are enough licenses available for the new entity prior to updating it. If there are enough licenses in the license file, then the corresponding flag is set to true; otherwise, the corresponding flag is set to false.
The following also occurs:
- If the canSchedJobs flag is changed to true, then a new record is added to the Job_Sched_Exec table. If the flag is changed to false, then the corresponding Middleware method checks for any jobs scheduled or initiated on the specified entity. If jobs are found and are not completed or cancelled, then an error is raised. If no such jobs are found on the entity, then it deletes the rows (if present) in the Job_Exec, Oper_Ent_Route, Oper_Ent_Spec, Folder_Item_Oper_Ent_Link, and Oper_Ent_Link tables.
- If the canRunJobs flag is changed to true, then a new record is added to the Job_Exec table. If the flag is changed to false, then the corresponding Middleware method checks for any jobs scheduled or initiated on the specified entity. If jobs are found and are not completed or cancelled, then an error is raised. If no such jobs are found on the entity, then it deletes the rows (if present) in the Job_Exec table.
- If the canCaptureUtil flag is changed to true, then a new record is added to the Util_Exec table. If the flag is changed to false, then the entity's corresponding record in the Util_Exec table is removed.
- If the canCaptureLabor flag is changed to true, then a new record is added to the Labor_Exec table. If the flag is changed to false, then the entity's corresponding record in the Labor_Exec table is removed.
- If the canTrackOEE flag is changed to true, then a new record is added to the Oee_Exec table. If the flag is changed to false, then the entity's corresponding record in the Oee_Exec table is removed.
- If the canStore flag is changed to true, then a new record is added to the Storage_Exec table. If the flag is changed to false, then the entity's corresponding record in the Storage_Exec table is removed.
If an entity is a member of a line, then its canRunJobs, canCaptureUtil, and canTrackOEE parameters cannot be set to False. If an entity is a member of a line and any of these parameters are set to False, an error message will be returned.