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

Ниже приведен пример использования операции 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">
<GetDimElements xmlns="http://www.fsight.ru/PP.SOM.Som">
<tDim xmlns="">
  <id>S1!M!S!S1</id>
  </tDim>
<tArg xmlns="">
<filter>
<keys>
<it>
  <key>1</key>
  </it>
<it>
  <key>2</key>
  </it>
<it>
  <key>3</key>
  </it>
  </keys>
  <includeParents>false</includeParents>
  <includeParentsWithSiblings>false</includeParentsWithSiblings>
  </filter>
<pattern>
  <attributes>ID;NAME</attributes>
  <getImageIndex>true</getImageIndex>
  </pattern>
  </tArg>
  </GetDimElements>
  </s:Body>
  </s:Envelope>

SOAP-ответ:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<GetDimElementsResult 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">
<els xmlns="">
<e>
  <n>Первый элемент</n>
<a>
  <it>1</it>
  <it>Первый элемент</it>
  </a>
<ea>
  <it v="1" />
  <it v="Первый элемент" />
  </ea>
  <k>1</k>
  <h>0</h>
  <o>0</o>
  </e>
<e>
  <n>Второй элемент</n>
<a>
  <it>2</it>
  <it>Второй элемент</it>
  </a>
<ea>
  <it v="2" />
  <it v="Второй элемент" />
  </ea>
  <k>2</k>
  <h>0</h>
  <o>1</o>
  </e>
<e>
  <n>Третий элемент</n>
<a>
  <it>3</it>
  <it>Третий элемент</it>
  </a>
<ea>
  <it v="3" />
  <it v="Третий элемент" />
  </ea>
  <k>3</k>
  <h>0</h>
  <o>2</o>
  </e>
  </els>
<id xmlns="">
  <id>S1!M!S!S1</id>
  </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",
"getImageIndex" : "true"
}
}
}
}

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;
}

См. также:

GetDimElements