Определение полей для запросов веб-служб
Можно добавлять, обновлять и удалять поля для каждой веб-службы, которая будет доступна в запросах веб-служб.
Для использования будут доступны те поля, связанные с веб-службами, которые определены на странице «Веб-службы» формы «Запросы веб-служб».
В данной форме нет возможности для определения языковых переводов для отображения этикеток поля. При выполнении запроса метки полей отображаются так, как были введены в форме «Поля» для выбранного запроса веб-службы. Чтобы отобразить запросы на нескольких языках, необходимо создать отдельный запрос веб-служб для каждого языка.
Для запросов веб-служб доступны определяемые пользователями поля. Поля отображаются в списке всех полей под соответствующей веб-службой для некоторых веб-служб вставки или обновления. Эти определяемые пользователями поля наследуют свойства из связанной формы ссылок. Щелкните определяемое пользователем поле правой кнопкой мыши в режиме конструктора экранов, чтобы задать для него параметры. При выделении в сетке поля, определяемого пользователем, система защищает поля «Тип поля» и «Код запроса». Данная информация определяется на основном экране, с которым связана веб-служба.
В списке подстановки объекта в определяемых пользователями полях отображаются записи для всех организаций в списке организаций пользователя, если управляющая организация недоступна. Запись не может быть отправлена, если управляющая организация и организация поля, определенного пользователем находятся в конфликте.
- Нажмите «Администрирование» > «Модуль запросов веб-служб» > «Запросы веб-служб».
- Выберите запрос веб-служб, для которого нужно определить поля для веб-служб, и перейдите на вкладку «Поля».
- Нажмите «Добавить поле».
-
Укажите описанную далее информацию.
- Группа обработки, веб-служба
- Укажите группу обработки, для которой нужно добавить поле веб-службы. Поля «Экран» и «Вкладка» заполняются автоматически.
- Поле
- Укажите поле, которое нужно добавить в группу обработки. То, какие поля доступны, зависит от выбранной веб-службы.
- Метка поля
- Укажите имя для поля. Данная информация будет отображена как стандартный текст поля для настройки запросов веб-службы. Значение по умолчанию «Метка поля» равно значению в поле «Поле».
- Тип поля
- Укажите тип поля на основе выбранных поля и веб-службы. В поле «Тип поля» по умолчанию указывается тип, предоставленный системой для значения, выбранного в поле «Поле». Но это значение можно изменить. Определенное пользователем значение «Тип поля» отображается в модуле настройки запросов веб-служб. Можно изменить значение по умолчанию на один из следующих вариантов.
- «Буквенный»
- «Вычисленный»
- «Дата»
- «Фиксированное»
- «Текст свободного формата»
- «Ключевое поле»
- «Число»
- «Полученное поле»
Примечание.Вариант «Ключевое поле» доступен, только если выбрана веб-служба обновления или удаления. При настройке запроса веб-служб, который использует веб-службу обновления и (или) удаления, системный администратор должен создать «поле» для каждого ключевого поля, которое нужно веб-службе, чтобы однозначно описать запись. В параметре «Тип поля» должен быть выбран вариант «Ключевое поле». При настройке запросов веб-служб сначала предлагается ввести значения ключевых полей, которые должна обрабатывать запись, таких как «Оборудование» и «Организация оборудования». Для веб-служб обновления система запрашивает запись для отображения результатов. Необходимо обновить, а затем отправить запись. Для веб-служб удаления после ввода всех значений ключевых полей система удаляет запись.
Вариант «Полученное поле» доступен только тогда, когда выбрана веб-служба вставки. Когда настраивается запрос веб-служб, использующий веб-службу вставки, одно или несколько значений ключевых полей должны быть извлечены из веб-службы, ранее обработанной в текущей записи запроса. Администратор должен создать значение «Поле» типа Полученное поле для каждого из ключевых полей. Например, создается запрос веб-служб, который позволяет создавать заказ-наряд и операцию для него одновременно. Эта операция должна быть связана с заказ-нарядом, который создается в предыдущей группе обработки, но данные будут вводиться в модуль настройки запросов веб-служб и обрабатываться одновременно. Чтобы обеспечить связывание операции с правильным заказ-нарядом, система должна сначала обработать заказ-наряд веб-службы вставки, а затем передать (извлечь) номер и организацию заказ-наряда обратно в веб-службу создания операции. Эта информация ключевого поля вместе с другими обязательными данными операции используется для создания операции и ее связывания с правильным заказ-нарядом. Записи полученных полей («Тип поля» = Полученное поле) будут создаваться для номера и организации заказ-наряда операции, поскольку номер и организация необходимы, чтобы привязать операцию.
В поле «Группа извлечения, веб-служба» должна быть указана веб-служба, из которой извлекаются эти значения ключевых полей. В данном примере они извлекаются из веб-службы вставки заказ-наряда. «Поле извлечения» будет ключевым полем в веб-службе, из которой извлекаются данные. В этом примере «Номер ЗН» — это одно из извлекаемых полей. Нужно создать другое «поле» аналогичным образом, чтобы определить, как извлекать организацию заказ-наряда, которую следует использовать при создании операции. Значения полей можно извлекать только из веб-служб с меньшим номером группы обработки. Например, значение нельзя извлечь для использования в текущей веб-службе, если не была обработана предыдущая веб-служба, которая предоставит эту информацию.
Поля «Полученное поле» и «Ключевое поле» недоступны, когда снят флажок «Не сопоставлено».
Тип «Полученное поле» не связан с функциональностью, доступной на странице «Извлекаемые значения».
Если поле определено как флажок, оно отображается в виде флажка на странице «Модуль запросов веб-служб».
- Тип отображения
- Укажите, как будет отображаться поле, в модуле настройки запросов веб-служб. Значение по умолчанию будет системным значением по умолчанию для выбранного поля. Пользователь может изменить значение по умолчанию на один из следующих вариантов.
- «Необязательно»
- «Требуется»
- «Скрыто»
- «Защищено»
Примечание.Если в поле «Тип поля» указано значение Фиксированное или Вычисленное, в параметре «Тип отображения» будут доступны только значения Защищено и Скрыто. Если же в поле «Тип поля» указано значение Полученное поле, то в параметре «Тип отображения» будет доступно только значение Скрыто.
- Последовательность
- Укажите числовое значение для порядкового номера. В модуле запросов веб-служб поля отображаются в порядке возрастания порядкового номера. Значение по умолчанию, предоставленное системой на основе параметра INCRLIND.
Примечание.
Важно убедиться в том, что поля запроса веб-служб отображаются сгруппированными по значению поля «Группа обработки, веб-служба». Доступный диапазон значений «Последовательность» контролируется для полей выбранного значения «Группа обработки, веб-служба». Значение в поле «Последовательность» не должно накладываться на значение в поле «Последовательность», связанное с предыдущей или следующей группой обработки. Например, поля запроса веб-служб группируются в настройках запросов веб-служб сначала по параметру «Группа обработки, веб-служба», а затем по полю «Последовательность».
- Минимальная длина
- Укажите минимальное количество символов для поля.
- Максимальная длина
- Укажите максимальное количество символов для поля.
- След. последовательность
- Укажите число, с которого следует начинать следующую последовательность.
- Код запроса
- Укажите код запроса. Поле «Код запроса» определяет значения, доступные для выбора в списке значений полей при наличии подключения к серверу. Например, запрос и список доступных значений будут основаны на таблицах Infor EAM.
- Код запроса Mobile
- Укажите код запроса мобильного режима, который определяет список доступных значений для поля.
Примечание.
Мобильное устройство использует список значений кода запроса, если есть подключение к серверу приложений. В противном случае используется список значений кода запроса мобильного режима. Например, список значений заполняется локальными данными.
- Поле извлечения
- Укажите имя поля, из которого нужно извлекать данные. Система автоматически заполняет поля «Группа извлечения, веб-служба» и «XPath поля извлечения».
- Веб-служба запросов
- Укажите веб-службу запросов. Вариант «Веб-служба запросов» применяется только при определении ключевого поля для веб-службы обновления. Значение «Веб-служба запросов» используется для запроса данных из записи, чтобы пользователь мог внести изменения.
- Несопоставленное поле
- Установите этот флажок, если указанное поле не сопоставлено ни одному полю в веб-службе. Значение поля может быть далее обработано запросом в рамках вычислений или извлекаемых значений.
- Использовать предыдущее значение
- Установите этот флажок, чтобы использовать предыдущее значение поля.
- Если данные
- Укажите условие «Перейти к». Данное поле описывает условие, при котором система не обращается к полю, указанному в параметре «След. последовательность», а вместо этого обращается к полю «Перейти к последовательности».
- Образец
- Укажите образец, который должен соблюдаться для условия, заданного в поле «Перейти к».
- Перейти к
- Укажите последовательность полей, которую должна использовать система вместо перехода к полю в соответствии со значением «След. последовательность», если условие выполняется.
- Очистка предыдущих значений, начиная с целевого поля
- Установите этот флажок, чтобы позволить системе переносить значения для полей с установленным флажком «Использовать предыдущее значение», если последовательность запроса меньше (<), чем последовательность целевого поля «Перейти к». Например, предыдущие значения для полей запроса > = целевого поля последовательности «Перейти к», будут удалены. В противном случае система будет переносить значения для полей с установленным флажком «Использовать предыдущее значение», если последовательность запроса меньше (<), чем последовательность целевого поля «Перейти к». Например, предыдущие значения для полей запроса <= целевого поля последовательности «Перейти к», будут удалены.
- Группа извлечения, веб-служба
- Укажите веб-службу, из которой будут возвращаться значения ключевых полей для использования в следующей группе обработки.
- Вычисленные данные
- Укажите вычисленные данные для поля, если в поле «Тип поля» выбран вариант Вычисляемое значение.
- Образец подбора
- Если в поле «Тип поля» выбран вариант Буквенный, укажите образец, которому должны соответствовать введенные данные, чтобы считаться действительными. Примечание.
При определении значения для поля «Образец подбора» поддерживаются перечисленные далее подстановочные знаки.
- . (точка): один буквенный символ, от A до Z
- # (решетка): одна цифра в диапазоне от 0 до 9
- _ (подчеркивание): один буквенно-цифровой символ (от A до Z и от 0 до 9)
- % (процент): строка буквенно-цифровых символов
- , (запятая): Условие OR
- : (двоеточие): условие THROUGHOUT
- ! любые символы или числа: введенные данные не должны совпадать с теми символами или цифрами, которые следуют за восклицательным знаком NOT condition.
См. «Определение извлекаемых значений для запросов веб-служб».
-
Нажмите кнопку «Отправить».
Примечание.
Чтобы удалить поле, выберите его и нажмите «Удалить поле». Поля, соответствующие организации, которая указана в поле «Контролирующая орг.» для веб-службы, невозможно удалить с этой страницы, поскольку они имеют принципиально важное значение для обработки веб-службы. Однако если сама веб-служба удаляется со страницы «Веб-служба», то автоматически удаляются все связанные с ней поля, в том числе и поле «Контролирующая орг.».
Примечание.На этой странице не отображаются ошибки, если не все необходимые обязательные, ключевые поля или поля извлечения определены для корректной работы запроса веб-служб с использованием модуля настройки запросов веб-служб. Ошибка выводится на экран, когда модуль запросов веб-служб обрабатывает записи, в которых не хватает полей запроса. Также ошибка отображается модулем настройки запросов веб-служб, если определен следующий порядковый номер, который не существует в определении запроса.