Получение истории изменения элементов: Операция GetRdsElements

Ниже приведен пример использования операции GetRdsElements для получения истории изменения элементов справочника НСИ. В запросе передается моникёр открытого экземпляра справочника. В ответе приходит информация об истории изменений элементов. Каждая запись истории содержит: наименование элемента в соответствующий период, значения всех атрибутов, дату начала и окончания периода действия.

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">

</tRds>

<key />

</parent>

<includeRoot>false</includeRoot>

<onlySelected>false</onlySelected>

</filter>

<attributeValuesOnly>false</attributeValuesOnly>

</pattern>

</tArg>

</GetRdsElements>

</s:Body>

</s:Envelope>

SOAP-ответ:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">

<soapenv:Body>

<ea>

<it />

<it />

</ea>

<hist>

<it>

<ea>

<it />

<it />

</ea>

</it>

<it>

<ea>

<it />

<it />

</ea>

</it>

<it>

<n>Первый факт</n>

<ea>

<it />

<it />

</ea>

</it>

</hist>

</e>

</els>

</id>

</GetRdsElementsResult>

</soapenv:Body>

</soapenv:Envelope>

JSON-запрос:

{
 "GetRdsElements" : 
  {
   "tRds" : 
    {
     "id" : "S1!M!S!N10"
    },
   "tArg" : 
    {
     "parent" : 
      {
       "key" : ""
      },
     "filter" : 
      {
       "levels" : "-1",
       "includeRoot" : "false",
       "onlySelected" : "false",
       "includeParents" : "true",
       "includeParentsWithSiblings" : "true"
      },
     "pattern" : 
      {
       "attributes" : "*",
       "attributeValuesOnly" : "false",
       "extendedAttributeValuesOnly" : "true",
       "getSelectState" : "true",
       "getParentKey" : "true",
       "getHasChildren" : "true",
       "getLevel" : "true",
       "getHasSelectedChildren" : "true",
       "getHistory" : "true",
       "getImageIndex" : "true"
      }
    }
  }
}

JSON-ответ:

{
 "GetRdsElementsResult" : 
  {
   "els" : 
    {
     "e" : 
      {
       "@hc" : "0",
       "@l" : "1",
       "n" : "Факт",
       "ea" : 
        {
         "it" : 
          [
            {
             "@v" : "430"
            },
            {
             "@v" : "Факт"
            },
            "",
            {
             "@v" : "430"
            },
            {
             "@v" : "430"
            },
            {
             "@v" : "2012-01-01"
            },
            {
             "@v" : "2012-01-02"
            },
            "",
            ""
          ]
        },
       "k" : "430",
       "h" : "0",
       "o" : "0",
       "p" : "4294967294",
       "hist" : 
        {
         "it" : 
          [
            {
             "n" : "Факт",
             "ea" : 
              {
               "it" : 
                [
                  {
                   "@v" : "430"
                  },
                  {
                   "@v" : "Факт"
                  },
                  "",
                  {
                   "@v" : "430"
                  },
                  {
                   "@v" : "430"
                  },
                  {
                   "@v" : "2012-01-01"
                  },
                  {
                   "@v" : "2012-01-02"
                  },
                  "",
                  ""
                ]
              },
             "inDate" : "2012-01-01",
             "outDate" : "2012-01-02"
            },
            {
             "n" : "Факт 1",
             "ea" : 
              {
               "it" : 
                [
                  {
                   "@v" : "430"
                  },
                  {
                   "@v" : "Факт 1"
                  },
                  "",
                  {
                   "@v" : "430"
                  },
                  {
                   "@v" : "431"
                  },
                  {
                   "@v" : "2012-01-02"
                  },
                  {
                   "@v" : "2012-01-03"
                  },
                  "",
                  ""
                ]
              },
             "inDate" : "2012-01-02",
             "outDate" : "2012-01-03"
            },
            {
             "n" : "Первый факт",
             "ea" : 
              {
               "it" : 
                [
                  {
                   "@v" : "430"
                  },
                  {
                   "@v" : "Первый факт"
                  },
                  "",
                  {
                   "@v" : "430"
                  },
                  {
                   "@v" : "432"
                  },
                  {
                   "@v" : "2012-01-03"
                  },
                  {
                   "@v" : "2999-12-31"
                  },
                  "",
                  ""
                ]
              },
             "inDate" : "2012-01-03",
             "outDate" : "2999-12-31"
            }
          ]
        }
      }
    },
   "id" : 
    {
     "id" : "S1!M!S!N10"
    }
  }
}

Функция GetHistoryElements возвращает список элементов с историей изменения каждого элемента. Моникёр экземпляра справочника передается в качестве входного параметра. В примере используется функция FindObjectById, код которой приведен в разделе «Получение описания объекта по его идентификатору». После выполнения функция вернет результат выполнения операции GetRdsElements.

public static GetRdsElementsResult GetHistoryElements(RdsId moniker)
{
    var somClient = new SomPortTypeClient(); // Прокси-объект для выполнения операции
    //Параметры выполнения операции
    var tGet = new GetRdsElements()
    {
        tArg = new GetRdsElementsArg()
        {   
            parent = new ElKey
            {
                key = string.Empty
            },
            filter = new ElsFilter
            {
                includeRoot = false,
                includeParents = true,
                includeParentsWithSiblings = true,
                onlySelected = false,
                levels = -1
            },
            pattern = new ElsPattern // Шаблон получения данных
            {
                getParentKey = true,
                getHasChildren = true,
                getHasSelectedChildren = true,
                getLevel = true,
                getSelectState = true,
                getHistory = true,
                attributes = "*",
                attributeValuesOnly = false,
                extendedAttributeValuesOnly = true
            },
        },
        tRds = moniker
    };
    // Получаем историю изменения элементов
    var tResult = somClient.GetRdsElements(tGet);
    return tResult;
}