Определение полей для запросов веб-служб

Можно добавлять, обновлять и удалять поля для каждой веб-службы, которая будет доступна в запросах веб-служб.

Для использования будут доступны те поля, связанные с веб-службами, которые определены на странице «Веб-службы» формы «Запросы веб-служб».

Примечание. 

В данной форме нет возможности для определения языковых переводов для отображения этикеток поля. При выполнении запроса метки полей отображаются так, как были введены в форме «Поля» для выбранного запроса веб-службы. Чтобы отобразить запросы на нескольких языках, необходимо создать отдельный запрос веб-служб для каждого языка.

Для запросов веб-служб доступны определяемые пользователями поля. Поля отображаются в списке всех полей под соответствующей веб-службой для некоторых веб-служб вставки или обновления. Эти определяемые пользователями поля наследуют свойства из связанной формы ссылок. Щелкните определяемое пользователем поле правой кнопкой мыши в режиме конструктора экранов, чтобы задать для него параметры. При выделении в сетке поля, определяемого пользователем, система защищает поля «Тип поля» и «Код запроса». Данная информация определяется на основном экране, с которым связана веб-служба.

В списке подстановки объекта в определяемых пользователями полях отображаются записи для всех организаций в списке организаций пользователя, если управляющая организация недоступна. Запись не может быть отправлена, если управляющая организация и организация поля, определенного пользователем находятся в конфликте.

  1. Нажмите «Администрирование» > «Модуль запросов веб-служб» > «Запросы веб-служб».
  2. Выберите запрос веб-служб, для которого нужно определить поля для веб-служб, и перейдите на вкладку «Поля».
  3. Нажмите «Добавить поле».
  4. Укажите описанную далее информацию.
    Группа обработки, веб-служба
    Укажите группу обработки, для которой нужно добавить поле веб-службы. Поля «Экран» и «Вкладка» заполняются автоматически.
    Поле
    Укажите поле, которое нужно добавить в группу обработки. То, какие поля доступны, зависит от выбранной веб-службы.
    Метка поля
    Укажите имя для поля. Данная информация будет отображена как стандартный текст поля для настройки запросов веб-службы. Значение по умолчанию «Метка поля» равно значению в поле «Поле».
    Тип поля
    Укажите тип поля на основе выбранных поля и веб-службы. В поле «Тип поля» по умолчанию указывается тип, предоставленный системой для значения, выбранного в поле «Поле». Но это значение можно изменить. Определенное пользователем значение «Тип поля» отображается в модуле настройки запросов веб-служб. Можно изменить значение по умолчанию на один из следующих вариантов.
    • «Буквенный»
    • «Вычисленный»
    • «Дата»
    • «Фиксированное»
    • «Текст свободного формата»
    • «Ключевое поле»
    • «Число»
    • «Полученное поле»
    Примечание. 

    Вариант «Ключевое поле» доступен, только если выбрана веб-служба обновления или удаления. При настройке запроса веб-служб, который использует веб-службу обновления и (или) удаления, системный администратор должен создать «поле» для каждого ключевого поля, которое нужно веб-службе, чтобы однозначно описать запись. В параметре «Тип поля» должен быть выбран вариант «Ключевое поле». При настройке запросов веб-служб сначала предлагается ввести значения ключевых полей, которые должна обрабатывать запись, таких как «Оборудование» и «Организация оборудования». Для веб-служб обновления система запрашивает запись для отображения результатов. Необходимо обновить, а затем отправить запись. Для веб-служб удаления после ввода всех значений ключевых полей система удаляет запись.

    Вариант «Полученное поле» доступен только тогда, когда выбрана веб-служба вставки. Когда настраивается запрос веб-служб, использующий веб-службу вставки, одно или несколько значений ключевых полей должны быть извлечены из веб-службы, ранее обработанной в текущей записи запроса. Администратор должен создать значение «Поле» типа Полученное поле для каждого из ключевых полей. Например, создается запрос веб-служб, который позволяет создавать заказ-наряд и операцию для него одновременно. Эта операция должна быть связана с заказ-нарядом, который создается в предыдущей группе обработки, но данные будут вводиться в модуль настройки запросов веб-служб и обрабатываться одновременно. Чтобы обеспечить связывание операции с правильным заказ-нарядом, система должна сначала обработать заказ-наряд веб-службы вставки, а затем передать (извлечь) номер и организацию заказ-наряда обратно в веб-службу создания операции. Эта информация ключевого поля вместе с другими обязательными данными операции используется для создания операции и ее связывания с правильным заказ-нарядом. Записи полученных полей («Тип поля» = Полученное поле) будут создаваться для номера и организации заказ-наряда операции, поскольку номер и организация необходимы, чтобы привязать операцию.

    В поле «Группа извлечения, веб-служба» должна быть указана веб-служба, из которой извлекаются эти значения ключевых полей. В данном примере они извлекаются из веб-службы вставки заказ-наряда. «Поле извлечения» будет ключевым полем в веб-службе, из которой извлекаются данные. В этом примере «Номер ЗН» — это одно из извлекаемых полей. Нужно создать другое «поле» аналогичным образом, чтобы определить, как извлекать организацию заказ-наряда, которую следует использовать при создании операции. Значения полей можно извлекать только из веб-служб с меньшим номером группы обработки. Например, значение нельзя извлечь для использования в текущей веб-службе, если не была обработана предыдущая веб-служба, которая предоставит эту информацию.

    Поля «Полученное поле» и «Ключевое поле» недоступны, когда снят флажок «Не сопоставлено».

    Тип «Полученное поле» не связан с функциональностью, доступной на странице «Извлекаемые значения».

    Если поле определено как флажок, оно отображается в виде флажка на странице «Модуль запросов веб-служб».

    Тип отображения
    Укажите, как будет отображаться поле, в модуле настройки запросов веб-служб. Значение по умолчанию будет системным значением по умолчанию для выбранного поля. Пользователь может изменить значение по умолчанию на один из следующих вариантов.
    • «Необязательно»
    • «Требуется»
    • «Скрыто»
    • «Защищено»
    Примечание. 

    Если в поле «Тип поля» указано значение Фиксированное или Вычисленное, в параметре «Тип отображения» будут доступны только значения Защищено и Скрыто. Если же в поле «Тип поля» указано значение Полученное поле, то в параметре «Тип отображения» будет доступно только значение Скрыто.

    Последовательность
    Укажите числовое значение для порядкового номера. В модуле запросов веб-служб поля отображаются в порядке возрастания порядкового номера. Значение по умолчанию, предоставленное системой на основе параметра INCRLIND.
    Примечание. 

    Важно убедиться в том, что поля запроса веб-служб отображаются сгруппированными по значению поля «Группа обработки, веб-служба». Доступный диапазон значений «Последовательность» контролируется для полей выбранного значения «Группа обработки, веб-служба». Значение в поле «Последовательность» не должно накладываться на значение в поле «Последовательность», связанное с предыдущей или следующей группой обработки. Например, поля запроса веб-служб группируются в настройках запросов веб-служб сначала по параметру «Группа обработки, веб-служба», а затем по полю «Последовательность».

    Минимальная длина
    Укажите минимальное количество символов для поля.
    Максимальная длина
    Укажите максимальное количество символов для поля.
    След. последовательность
    Укажите число, с которого следует начинать следующую последовательность.
    Код запроса
    Укажите код запроса. Поле «Код запроса» определяет значения, доступные для выбора в списке значений полей при наличии подключения к серверу. Например, запрос и список доступных значений будут основаны на таблицах Infor EAM.
    Код запроса Mobile
    Укажите код запроса мобильного режима, который определяет список доступных значений для поля.
    Примечание. 

    Мобильное устройство использует список значений кода запроса, если есть подключение к серверу приложений. В противном случае используется список значений кода запроса мобильного режима. Например, список значений заполняется локальными данными.

    Поле извлечения
    Укажите имя поля, из которого нужно извлекать данные. Система автоматически заполняет поля «Группа извлечения, веб-служба» и «XPath поля извлечения».
    Веб-служба запросов
    Укажите веб-службу запросов. Вариант «Веб-служба запросов» применяется только при определении ключевого поля для веб-службы обновления. Значение «Веб-служба запросов» используется для запроса данных из записи, чтобы пользователь мог внести изменения.
    Несопоставленное поле
    Установите этот флажок, если указанное поле не сопоставлено ни одному полю в веб-службе. Значение поля может быть далее обработано запросом в рамках вычислений или извлекаемых значений.
    Использовать предыдущее значение
    Установите этот флажок, чтобы использовать предыдущее значение поля.
    Если данные
    Укажите условие «Перейти к». Данное поле описывает условие, при котором система не обращается к полю, указанному в параметре «След. последовательность», а вместо этого обращается к полю «Перейти к последовательности».
    Образец
    Укажите образец, который должен соблюдаться для условия, заданного в поле «Перейти к».
    Перейти к
    Укажите последовательность полей, которую должна использовать система вместо перехода к полю в соответствии со значением «След. последовательность», если условие выполняется.
    Очистка предыдущих значений, начиная с целевого поля
    Установите этот флажок, чтобы позволить системе переносить значения для полей с установленным флажком «Использовать предыдущее значение», если последовательность запроса меньше (<), чем последовательность целевого поля «Перейти к». Например, предыдущие значения для полей запроса > = целевого поля последовательности «Перейти к», будут удалены. В противном случае система будет переносить значения для полей с установленным флажком «Использовать предыдущее значение», если последовательность запроса меньше (<), чем последовательность целевого поля «Перейти к». Например, предыдущие значения для полей запроса <= целевого поля последовательности «Перейти к», будут удалены.
    Группа извлечения, веб-служба
    Укажите веб-службу, из которой будут возвращаться значения ключевых полей для использования в следующей группе обработки.
    Вычисленные данные
    Укажите вычисленные данные для поля, если в поле «Тип поля» выбран вариант Вычисляемое значение.
    Образец подбора
    Если в поле «Тип поля» выбран вариант Буквенный, укажите образец, которому должны соответствовать введенные данные, чтобы считаться действительными.
    Примечание. 

    При определении значения для поля «Образец подбора» поддерживаются перечисленные далее подстановочные знаки.

    • . (точка): один буквенный символ, от A до Z
    • # (решетка): одна цифра в диапазоне от 0 до 9
    • _ (подчеркивание): один буквенно-цифровой символ (от A до Z и от 0 до 9)
    • % (процент): строка буквенно-цифровых символов
    • , (запятая): Условие OR
    • : (двоеточие): условие THROUGHOUT
    • ! любые символы или числа: введенные данные не должны совпадать с теми символами или цифрами, которые следуют за восклицательным знаком NOT condition.

    См. «Определение извлекаемых значений для запросов веб-служб».

  5. Нажмите кнопку «Отправить».
    Примечание. 

    Чтобы удалить поле, выберите его и нажмите «Удалить поле». Поля, соответствующие организации, которая указана в поле «Контролирующая орг.» для веб-службы, невозможно удалить с этой страницы, поскольку они имеют принципиально важное значение для обработки веб-службы. Однако если сама веб-служба удаляется со страницы «Веб-служба», то автоматически удаляются все связанные с ней поля, в том числе и поле «Контролирующая орг.».

    Примечание. 

    На этой странице не отображаются ошибки, если не все необходимые обязательные, ключевые поля или поля извлечения определены для корректной работы запроса веб-служб с использованием модуля настройки запросов веб-служб. Ошибка выводится на экран, когда модуль запросов веб-служб обрабатывает записи, в которых не хватает полей запроса. Также ошибка отображается модулем настройки запросов веб-служб, если определен следующий порядковый номер, который не существует в определении запроса.