Отбор элементов по их ключам: Операция GetDimElements

Ниже приведен пример использования операции GetDimElements для отбора элементов по их ключам. Под ключом понимается значение атрибута «Идентификатор» для элемента. В запросе передается моникёр открытого экземпляра справочника и коллекция ключей элементов. Для отобранных элементов будут загружены идентификаторы и наименования.

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

</tDim>

<keys>

<it>

</it>

<it>

</it>

<it>

</it>

</keys>

<includeParents>false</includeParents>

<includeParentsWithSiblings>false</includeParentsWithSiblings>

</filter>

</pattern>

</tArg>

</GetDimElements>

</s:Body>

</s:Envelope>

SOAP-ответ:

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

<soapenv:Body>

<e>

<n>Первый элемент</n>

<a>

<it>Первый элемент</it>

</a>

<ea>

</ea>

</e>

<e>

<n>Второй элемент</n>

<a>

<it>Второй элемент</it>

</a>

<ea>

</ea>

</e>

<e>

<n>Третий элемент</n>

<a>

<it>Третий элемент</it>

</a>

<ea>

</ea>

</e>

</els>

</id>

</GetDimElementsResult>

</soapenv:Body>

</soapenv:Envelope>

JSON-запрос:

{
 "GetDimElements" : 
  {
   "tDim" : 
    {

     "id" : "S1!M!S!S1"
    },
   "tArg" : 
    {
     "filter" : 
      {
       "keys" : 
        {
         "it" : 
          [

            {
             "key" : "1"
            },
            {
             "key" : "2"
            },
            {
             "key" : "3"
            }
          ]

        },
       "includeParents" : "false",
       "includeParentsWithSiblings" : "false"
      },
     "pattern" : 
      {
       "attributes" : "ID;NAME"
      }
    }
  }
}

JSON-ответ:

{
 "GetDimElementsResult" : 
  {
   "els" : 
    {
     "e" : 
      [
        {
         "n" : "Первый элемент",
         "a" : 
          {
           "it" :

            [
              "1",
              "Первый элемент"
            ]
          },
         "ea" : 
          {
           "it" : 
            [
              {

               "@v" : "1"
              },
              {
               "@v" : "Первый элемент"
              }
            ]
          },
         "k" : "1",
         "h" : "0",
         "o" : "0"

        },
        {
         "n" : "Второй элемент",
         "a" : 
          {
           "it" : 
            [
              "2",
              "Второй элемент"
            ]

          },
         "ea" : 
          {
           "it" : 
            [
              {
               "@v" : "2"
              },
              {
               "@v" : "Второй элемент"

              }
            ]
          },
         "k" : "2",
         "h" : "0",
         "o" : "1"
        },
        {
         "n" : "Третий элемент",
         "a" :

          {
           "it" : 
            [
              "3",
              "Третий элемент"
            ]
          },
         "ea" : 
          {
           "it" :

            [
              {
               "@v" : "3"
              },
              {
               "@v" : "Третий элемент"
              }
            ]
          },
         "k" : "3",

         "h" : "0",
         "o" : "2"
        }
      ]
    },
   "id" : 
    {
     "id" : "S1!M!S!S1"
    }
  }
}

    public static GetDimElementsResult GetElementsByKeys(DmId moniker, ElKey[] elKeys)
    {
        var somClient = new SomPortTypeClient(); //Прокси-объект для выполнения операций
        //Параметры выполнения операции
        var tElements = new GetDimElements()
        {
            tArg = new GetDimElementsArg()
            {
                pattern = new ElsPattern()
                {
                    attributes = "ID;NAME"
                },
                //Параметры фильтрации элементов
                filter = new ElsFilter()
                {
                    keys = elKeys
                }
            },
            tDim = moniker
        };
        //Получение информации об элементах справочника
        var result = somClient.GetDimElements(tElements);
        return result;
    }