Выполнить функции
В OData действия используются для добавления операций с сущностями на стороне сервера. Целью функции может быть одна сущность или набор сущностей. Функции возвращают данные, которые не соответствуют непосредственно сущности или набору сущностей.
Используйте действие Выполнить функции, чтобы выполнить функции, определенные в метаданных OData.
Выполните следующие шаги, чтобы использовать действие Выполнить функции в рабочем процессе:
1. Перетащите действие Выполнить функции из списка соединителя OData на канву, наведите указатель на это действие и щелкните значок 
или дважды щелкните действие. Откроется окно "Выполнить функции".
или дважды щелкните действие. Откроется окно "Выполнить функции".2. При необходимости измените поле Метка. По умолчанию наименование метки совпадает с наименованием действия.
3. Сведения о добавлении типа соединителя OData см. в разделе Поддерживаемые типы соединителей OData.
Если тип соединителя был добавлен ранее, выберите подходящий Тип соединителя и в поле Наименование соединителя выберите соединитель.
4. Щелкните Тестировать, чтобы проверить соединитель.
5. Щелкните Сопоставить соединитель, чтобы выполнить действие с помощью соединителя, отличного от используемого для заполнения полей ввода. В поле Соединитель времени выполнения укажите действительное наименование соединителя OData. Дополнительные сведения о команде Сопоставить соединитель см. в разделе Использование сопоставления соединителя.
6. Установите флажок Включить области привязки, чтобы отобразить все функции, описанные для FunctionImport в областях привязки.
7. В списке Функции выберите функцию OData, которую нужно выполнить.
Поля в форме ввода изменяются динамически в зависимости от выбранной функции.
8. Выберите Форма, чтобы указать входные данные для отдельных свойств, перечисленных в форме, или выберите Назначить JSON, чтобы указать один файл JSON, содержащий все требуемые свойства.
9. Используйте опции в списке Тип запроса для фильтрации выходных данных на основе свойств объекта, которые требуются в выходных данных. Если функция не возвращает объект, опция Тип запроса недоступна.
В зависимости от типа возвращаемого значения функции запрос имеет следующие параметры:
◦ Одиночный объект: Выбрать свойства, Добавить связанные элементы.
◦ Набор объектов: Фильтры, Выбрать свойства, Добавить связанные элементы, Предел, Пропустить.
В списке Тип запроса выберите Запрос на основе формы, Дискретный запрос или Неформатированный запрос для указания параметров запроса.
Запрос на основе формы a. (Доступно только для набора объектов) В группе Фильтр выполните следующие действия. a. В списке Соединение с помощью выберите логический оператор для соединения операторов фильтра. Значение по умолчанию: И. b. В разделе Предложения фильтращелкните Добавить, чтобы добавить фильтр: ▪ Свойство - выберите свойство. ▪ Подходящее условие - выберите условие. Условия зависят от типа выбранного свойства, такого как String, Boolean и т. д. ▪ Значение - введите значение свойства. Щелкните Добавить, чтобы добавить несколько фильтров. Щелкните значок  , чтобы удалить любой добавленный фильтр.Если добавляются одни и те же свойства и выбирается И в списке Соединение с помощью, атрибуты объединяются оператором ИЛИ. b. В разделе Выбрать свойства щелкните Добавить и в списке Свойство выберите свойство, для которого нужно загрузить значения. Щелкните Добавить, чтобы добавить несколько свойств. Щелкните значок , чтобы удалить любое добавленное свойство.По умолчание, если выбрать любое свойство, то значения для выбранных свойств и "ключевые" свойства загружаются в выходные данные. Если не выбрано ни одно свойство, то по умолчанию в выходные данные включаются все свойства сущности. c. В разделе Добавить связанные элементы щелкните Добавить и в списке Связанный элемент выберите связанный элемент, для которого нужно загрузить значения. Щелкните Добавить, чтобы добавить несколько связанных элементов. Щелкните значок , чтобы удалить любой добавленный связанный элемент.Любое свойство, помеченное как NavigationProperty, рассматривается как Связанный элемент. d. (Доступно только для набора объектов) В поле Предел введите значение, чтобы ограничить выходные данные определенным количеством сущностей. e. (Доступно только для набора объектов) В поле Пропустить введите число ресурсов, которые требуется пропустить. |
Дискретный запрос a. (Доступно только для набора объектов) В поле Фильтры укажите критерии фильтра OData в формате propertyName operator 'value' [and | or | not].... Например, number eq '0000222341' или name eq 'PTC' или startswith(name, 'PTC') b. В поле Выбрать свойства укажите выражение выбора OData в виде разделенного запятыми списка наименований свойств. По умолчание, если указать любое свойство в запросе, то значения для выбранных свойств загружаются в выходные данные. Если не указано ни одно свойство, то по умолчанию в выходные данные включаются все свойства сущности. c. В поле Добавить связанные элементы укажите выражение выбора OData в виде разделенного запятыми списка связанных элементов. Любое свойство, помеченное как NavigationProperty, рассматривается как Связанный элемент. d. (Доступно только для набора объектов) В поле Предел введите число результатов поиска, которые требуется загрузить. e. (Доступно только для набора объектов) В поле Пропустить введите число первых результатов поиска, которые требуется пропустить. |
Неформатированный запрос В поле Запрос укажите выражение запроса OData. Например: $select=name,number&$expand=context&$top=2&$skip=1&$orderby=name asc&$filter=name eq 'PTC' По умолчание, если указать любое свойство в запросе, то значения для выбранных свойств загружаются в выходные данные. Если не указано ни одно свойство, то по умолчанию в выходные данные включаются все свойства сущности. Любое свойство, помеченное как NavigationProperty, рассматривается как Связанный элемент. В зависимости от типа возвращаемых результатов функции можно указать параметры фильтров, предела и пропускаемых результатов в выражении запроса. |
10. Щелкните Показать дополнительные поля.
11. В группе Заголовки щелкните Добавить, чтобы добавить пользовательский заголовок в запрос. Укажите пару Ключ и Значение.
Щелкните Добавить, чтобы добавить несколько пар ключ-значение. Щелкните значок , чтобы удалить любой добавленный пользовательский заголовок.
, чтобы удалить любой добавленный пользовательский заголовок.12. Нажмите кнопку Готово.
Схема вывода
В зависимости от выбранной функции OData, действие Выполнить функции Возвращает динамическую схему вывода. Если функция не имеет тип возврата, она возвращает строку сообщения.
Если для задания параметров запроса был выбран Запрос на основе формы, схема вывода предоставляет подробные сведения только для выбранных свойств.
Для опций Дискретный запрос или Неформатированный запрос схема вывода содержит все свойства возвращенного объекта, но предоставляет значения только для указанных свойств.