std.SetHistory

This job adds an entry to the DB table osobjhist for the specified object.

1. Input Parameters

Name Type Required Description

sInfo

STRING

Yes

Information about the performed action

dwObjectID

INT

Yes

ID of the object

dwObjectType

INT

Yes

Type of the object

2. Behavior

  • The server creates a history entry of type OBJECT_INFORMATION (action ID 31).

  • UserNameShort, UserNameFull, Station and Time are automatically populated by the server based on the current session.

  • The entry can subsequently be retrieved via dms.GetObjectHistory.

  • Works for all object types (folders, registers, documents).

2.1. Example Entry in the History

After the call, the DMSHistory XML contains an entry like:

<Modification osguid="...">
  <Time>09.04.2026 10:50:00</Time>
  <Action id="31">Object information</Action>
  <Description>Log entry from the business model.</Description>
  <UserNameShort>ROOT</UserNameShort>
  <UserNameFull>Administrator</UserNameFull>
  <Station station_id="...">ECM4</Station>
  <Info>Custom log entry</Info>
</Modification>

3. Return Value

(INT): 0 = Job successful, otherwise error code.