GetObjectHistoryLog

Syntax

GetObjectHistoryLogResult GetObjectHistoryLog(OdId mbObject, GetObjectHistoryLogArg arg)

Parameters

mbObject. Repository object moniker.

arg. Operation execution parameters.

Description

The GetObjectHistoryLog operation gets object version history in the repository.

Comments

To execute the operation, in the mbObject field specify repository object moniker, and in the arg field specify start and end dates of the period, for which one should get object version history. The moniker can be obtained on executing the GetObjects operation. The user who executes the operation must have the View Access Protocol privilege.

The operation results in the collection of access protocol records with information about object changes for the specified time period.

Example

Below is the example of getting the version history of repository object. The request contains object moniker and the period, for which the version history must be obtained. The response contains the collection of access protocol records with information about object changes.

The C# example uses the FindObjectById function, which code is given in the Getting Object Description by Its Identifier example.

SOAP request:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<GetObjectHistoryLog xmlns="http://www.fsight.ru/PP.SOM.Som">
<mbObject xmlns="">
  <id>IDKPGDAOEDPHGOAENMGHNIECCAEHGKKELJMJDFGGOACBDEAA!M!6947</id>
  </mbObject>
<arg xmlns="">
  <minDate>2026-02-15T00:00:00</minDate>
  <maxDate>2026-02-20T00:00:00</maxDate>
  </arg>
  </GetObjectHistoryLog>
  </s:Body>
  </s:Envelope>

SOAP response:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<GetObjectHistoryLogResult xmlns="http://www.fsight.ru/PP.SOM.Som" xmlns:q1="http://www.fsight.ru/PP.SOM.Som" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<rs xmlns="">
<r>
  <session>462</session>
  <stamp>2026-02-19T05:57:08.275Z</stamp>
  <succeeded>1</succeeded>
  <isLogon>0</isLogon>
<logon>
  <stampIn>2026-02-19T05:09:35.494Z</stampIn>
  <stampOut>2026-02-19T06:54:45.994Z</stampOut>
  <userSid>PS-1-1</userSid>
  <userName>ADMIN</userName>
  <userDescription>Admin</userDescription>
  <station>BI-SERVER</station>
  <userOs>IUSR</userOs>
  <userIp>10.30.137.4</userIp>
  <comment>Platform version: 10.11.10086.0 Master x64 Web application</comment>
  <commentOut />
  </logon>
<oper>
  <operation>1362</operation>
  <position>0</position>
  <level>1</level>
  <name>Change</name>
  <mask>4</mask>
  <objectKey>6947</objectKey>
  <objectId>OBJ6947</objectId>
  <objectName>Query (parameters)</objectName>
  <objectClass>770</objectClass>
  <comment />
  <objectLabel>-1</objectLabel>
  </oper>
  </r>
<r>
  <session>462</session>
  <stamp>2026-02-19T05:57:24.572Z</stamp>
  <succeeded>1</succeeded>
  <isLogon>0</isLogon>
<logon>
  <stampIn>2026-02-19T05:09:35.494Z</stampIn>
  <stampOut>2026-02-19T06:54:45.994Z</stampOut>
  <userSid>PS-1-1</userSid>
  <userName>ADMIN</userName>
  <userDescription>Admin</userDescription>
  <station>BI-SERVER</station>
  <userOs>IUSR</userOs>
  <userIp>10.30.137.4</userIp>
  <comment>Platform version: 10.11.10086.0 Master x64 Web application</comment>
  <commentOut />
  </logon>
<oper>
  <operation>1381</operation>
  <position>0</position>
  <level>1</level>
  <name>Change</name>
  <mask>4</mask>
  <objectKey>6947</objectKey>
  <objectId>OBJ6947</objectId>
  <objectName>Query (parameters)</objectName>
  <objectClass>770</objectClass>
  <comment />
  <objectLabel>-1</objectLabel>
  </oper>
  </r>
<r>
  <session>464</session>
  <stamp>2026-02-19T07:03:03.129Z</stamp>
  <succeeded>1</succeeded>
  <isLogon>0</isLogon>
<logon>
  <stampIn>2026-02-19T07:00:53.504Z</stampIn>
  <stampOut>2028-11-15T07:00:53.504Z</stampOut>
  <userSid>PS-1-1</userSid>
  <userName>ADMIN</userName>
  <userDescription>Admin</userDescription>
  <station>BI-SERVER</station>
  <userOs>IUSR</userOs>
  <userIp>10.30.137.4</userIp>
  <comment>Platform version: 10.11.10086.0 Master x64 Web application</comment>
  <commentOut />
  </logon>
<oper>
  <operation>782</operation>
  <position>0</position>
  <level>1</level>
  <name>Change</name>
  <mask>4</mask>
  <objectKey>6947</objectKey>
  <objectId>OBJ6947</objectId>
  <objectName>Query (parameters)</objectName>
  <objectClass>770</objectClass>
  <comment />
  <objectLabel>-1</objectLabel>
  </oper>
  </r>
<r>
  <session>464</session>
  <stamp>2026-02-19T07:03:21.176Z</stamp>
  <succeeded>1</succeeded>
  <isLogon>0</isLogon>
<logon>
  <stampIn>2026-02-19T07:00:53.504Z</stampIn>
  <stampOut>2028-11-15T07:00:53.504Z</stampOut>
  <userSid>PS-1-1</userSid>
  <userName>ADMIN</userName>
  <userDescription>Admin</userDescription>
  <station>BI-SERVER</station>
  <userOs>IUSR</userOs>
  <userIp>10.30.137.4</userIp>
  <comment>Platform version: 10.11.10086.0 Master x64 Web application</comment>
  <commentOut />
  </logon>
<oper>
  <operation>808</operation>
  <position>0</position>
  <level>1</level>
  <name>Change</name>
  <mask>4</mask>
  <objectKey>6947</objectKey>
  <objectId>OBJ6947</objectId>
  <objectName>Query (parameters)</objectName>
  <objectClass>770</objectClass>
  <comment />
  <objectLabel>-1</objectLabel>
  </oper>
  </r>
  </rs>
  </GetObjectHistoryLogResult>
  </soapenv:Body>
  </soapenv:Envelope>

JSON request:

{
 "GetObjectHistoryLog" : 
  {
   "mbObject" : 
    {
     "id" : "IDKPGDAOEDPHGOAENMGHNIECCAEHGKKELJMJDFGGOACBDEAA!M!6947"
    },
   "arg" : 
    {
     "minDate" : "2026-02-15T00:00:00",
     "maxDate" : "2026-02-20T00:00:00"
    }
  }
}

JSON response:

{
 "GetObjectHistoryLogResult" : 
  {
   "rs" : 
    {
     "r" : 
      [
        {
         "session" : "462",
         "stamp" : "2026-02-19T05:57:08.275Z",
         "succeeded" : "1",
         "isLogon" : "0",
         "logon" : 
          {
           "stampIn" : "2026-02-19T05:09:35.494Z",
           "stampOut" : "2026-02-19T06:54:45.994Z",
           "userSid" : "PS-1-1",
           "userName" : "ADMIN",
           "userDescription" : "Admin",
           "station" : "BI-SERVER",
           "userOs" : "IUSR",
           "userIp" : "10.30.137.4",
           "comment" : "Platform version: 10.11.10086.0 Master x64 Web application",
           "commentOut" : ""
          },
         "oper" : 
          {
           "operation" : "1362",
           "position" : "0",
           "level" : "1",
           "name" : "Change",
           "mask" : "4",
           "objectKey" : "6947",
           "objectId" : "OBJ6947",
           "objectName" : "Query (parameters)",
           "objectClass" : "770",
           "comment" : "",
           "objectLabel" : "4294967295"
          }
        },
        {
         "session" : "462",
         "stamp" : "2026-02-19T05:57:24.572Z",
         "succeeded" : "1",
         "isLogon" : "0",
         "logon" : 
          {
           "stampIn" : "2026-02-19T05:09:35.494Z",
           "stampOut" : "2026-02-19T06:54:45.994Z",
           "userSid" : "PS-1-1",
           "userName" : "ADMIN",
           "userDescription" : "Admin",
           "station" : "BI-SERVER",
           "userOs" : "IUSR",
           "userIp" : "10.30.137.4",
           "comment" : "Platform version: 10.11.10086.0 Master x64 Web application",
           "commentOut" : ""
          },
         "oper" : 
          {
           "operation" : "1381",
           "position" : "0",
           "level" : "1",
           "name" : "Change",
           "mask" : "4",
           "objectKey" : "6947",
           "objectId" : "OBJ6947",
           "objectName" : "Query (parameters)",
           "objectClass" : "770",
           "comment" : "",
           "objectLabel" : "4294967295"
          }
        },
        {
         "session" : "464",
         "stamp" : "2026-02-19T07:03:03.129Z",
         "succeeded" : "1",
         "isLogon" : "0",
         "logon" : 
          {
           "stampIn" : "2026-02-19T07:00:53.504Z",
           "stampOut" : "2028-11-15T07:00:53.504Z",
           "userSid" : "PS-1-1",
           "userName" : "ADMIN",
           "userDescription" : "Admin",
           "station" : "BI-SERVER",
           "userOs" : "IUSR",
           "userIp" : "10.30.137.4",
           "comment" : "Platform version: 10.11.10086.0 Master x64 Web application",
           "commentOut" : ""
          },
         "oper" : 
          {
           "operation" : "782",
           "position" : "0",
           "level" : "1",
           "name" : "Change",
           "mask" : "4",
           "objectKey" : "6947",
           "objectId" : "OBJ6947",
           "objectName" : "Query (parameters)",
           "objectClass" : "770",
           "comment" : "",
           "objectLabel" : "4294967295"
          }
        },
        {
         "session" : "464",
         "stamp" : "2026-02-19T07:03:21.176Z",
         "succeeded" : "1",
         "isLogon" : "0",
         "logon" : 
          {
           "stampIn" : "2026-02-19T07:00:53.504Z",
           "stampOut" : "2028-11-15T07:00:53.504Z",
           "userSid" : "PS-1-1",
           "userName" : "ADMIN",
           "userDescription" : "Admin",
           "station" : "BI-SERVER",
           "userOs" : "IUSR",
           "userIp" : "10.30.137.4",
           "comment" : "Platform version: 10.11.10086.0 Master x64 Web application",
           "commentOut" : ""
          },
         "oper" : 
          {
           "operation" : "808",
           "position" : "0",
           "level" : "1",
           "name" : "Change",
           "mask" : "4",
           "objectKey" : "6947",
           "objectId" : "OBJ6947",
           "objectName" : "Query (parameters)",
           "objectClass" : "770",
           "comment" : "",
           "objectLabel" : "4294967295"
          }
        }
      ]
    }
  }
}
public static GetObjectHistoryLogResult GetObjectHistoryLog(MbId mb, string objectId, DateTime startPeriod, DateTime endPeriod)
{
    var somClient = new SomPortTypeClient(); // Proxy object for operation execution
    // Operation execution parameters
    var tGet = new GetObjectHistoryLog()
    {
        arg = new GetObjectHistoryLogArg()
        {
            minDate = startPeriod,
            maxDate = endPeriod
        },
        mbObject = new OdId() { id = mb.id + "!" + PP7SOMSampleClass.FindObjectById(mb, objectId).k }
    };
    // Get object version history
    var result = somClient.GetObjectHistoryLog(tGet);
    return result;
}

See also:

Working with Repository