GetObjectHistoryLog

Синтаксис

GetObjectHistoryLogResult GetObjectHistoryLog(OdId mbObject, GetObjectHistoryLogArg arg)

Параметры

mbObject. Моникёр объекта репозитория.

arg. Параметры выполнения операции.

Описание

Операция GetObjectHistoryLog получает журнал изменений объекта в репозитории.

Комментарии

Для выполнения операции укажите в поле mbObject моникёр объекта репозитория, а в поле arg даты начала и окончания периода, за который необходимо получить журнал изменений объекта. Моникёр может быть получен при выполнении операции GetObjects. Пользователь, выполняющий операцию, должен обладать привилегией «Просмотр протокола доступа».

Результатом выполнения операции будет коллекция записей из протокола доступа, содержащая информацию об изменении объекта в указанном периоде времени.

Пример

Ниже приведён пример получения журнала изменений объекта репозитория. В запросе передаётся моникёр объекта и период, за который необходимо получить журнал. В ответе возвращается коллекция записей из протокола доступа с информацией об изменении объекта.

В примере C# используется функция FindObjectById, код которой приведен в примере «Получение описания объекта по его идентификатору».

SOAP-запрос:

<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-ответ:

<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>Версия платформы: 10.11.10086.0 Master x64 Веб-приложение</comment>
  <commentOut />
  </logon>
<oper>
  <operation>1362</operation>
  <position>0</position>
  <level>1</level>
  <name>Изменение</name>
  <mask>4</mask>
  <objectKey>6947</objectKey>
  <objectId>OBJ6947</objectId>
  <objectName>Запрос (параметры)</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>Версия платформы: 10.11.10086.0 Master x64 Веб-приложение</comment>
  <commentOut />
  </logon>
<oper>
  <operation>1381</operation>
  <position>0</position>
  <level>1</level>
  <name>Изменение</name>
  <mask>4</mask>
  <objectKey>6947</objectKey>
  <objectId>OBJ6947</objectId>
  <objectName>Запрос (параметры)</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>Версия платформы: 10.11.10086.0 Master x64 Веб-приложение</comment>
  <commentOut />
  </logon>
<oper>
  <operation>782</operation>
  <position>0</position>
  <level>1</level>
  <name>Изменение</name>
  <mask>4</mask>
  <objectKey>6947</objectKey>
  <objectId>OBJ6947</objectId>
  <objectName>Запрос (параметры)</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>Версия платформы: 10.11.10086.0 Master x64 Веб-приложение</comment>
  <commentOut />
  </logon>
<oper>
  <operation>808</operation>
  <position>0</position>
  <level>1</level>
  <name>Изменение</name>
  <mask>4</mask>
  <objectKey>6947</objectKey>
  <objectId>OBJ6947</objectId>
  <objectName>Запрос (параметры)</objectName>
  <objectClass>770</objectClass>
  <comment />
  <objectLabel>-1</objectLabel>
  </oper>
  </r>
  </rs>
  </GetObjectHistoryLogResult>
  </soapenv:Body>
  </soapenv:Envelope>

JSON-запрос:

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

JSON-ответ:

{
 "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" : "Версия платформы: 10.11.10086.0 Master x64 Веб-приложение",
           "commentOut" : ""
          },
         "oper" : 
          {
           "operation" : "1362",
           "position" : "0",
           "level" : "1",
           "name" : "Изменение",
           "mask" : "4",
           "objectKey" : "6947",
           "objectId" : "OBJ6947",
           "objectName" : "Запрос (параметры)",
           "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" : "Версия платформы: 10.11.10086.0 Master x64 Веб-приложение",
           "commentOut" : ""
          },
         "oper" : 
          {
           "operation" : "1381",
           "position" : "0",
           "level" : "1",
           "name" : "Изменение",
           "mask" : "4",
           "objectKey" : "6947",
           "objectId" : "OBJ6947",
           "objectName" : "Запрос (параметры)",
           "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" : "Версия платформы: 10.11.10086.0 Master x64 Веб-приложение",
           "commentOut" : ""
          },
         "oper" : 
          {
           "operation" : "782",
           "position" : "0",
           "level" : "1",
           "name" : "Изменение",
           "mask" : "4",
           "objectKey" : "6947",
           "objectId" : "OBJ6947",
           "objectName" : "Запрос (параметры)",
           "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" : "Версия платформы: 10.11.10086.0 Master x64 Веб-приложение",
           "commentOut" : ""
          },
         "oper" : 
          {
           "operation" : "808",
           "position" : "0",
           "level" : "1",
           "name" : "Изменение",
           "mask" : "4",
           "objectKey" : "6947",
           "objectId" : "OBJ6947",
           "objectName" : "Запрос (параметры)",
           "objectClass" : "770",
           "comment" : "",
           "objectLabel" : "4294967295"
          }
        }
      ]
    }
  }
}
public static GetObjectHistoryLogResult GetObjectHistoryLog(MbId mb, string objectId, DateTime startPeriod, DateTime endPeriod)
{
    var somClient = new SomPortTypeClient(); // Прокси-объект для выполнения операций
    // Параметры выполнения операции
    var tGet = new GetObjectHistoryLog()
    {
        arg = new GetObjectHistoryLogArg()
        {
            minDate = startPeriod,
            maxDate = endPeriod
        },
        mbObject = new OdId() { id = mb.id + "!" + PP7SOMSampleClass.FindObjectById(mb, objectId).k }
    };
    // Получение журнала изменений объекта
    var result = somClient.GetObjectHistoryLog(tGet);
    return result;
}

См. также:

Работа с репозиторием