В этой статье:
Особенности входных параметров ресурса источника данных SAP
Особенности входных параметров ресурса источника данных JSON
Особенности входных параметров ресурса источника данных Foresight
Параметры ресурса
Входные параметры позволяют получить срез данных ресурса. Частичная загрузка данных уменьшает время ожидания при запросе данных из источника данных. Для указания входных параметров в запросах к ресурсу источника данных задайте значения параметров, которые доступны после импорта ресурса. При указании значений параметров из ресурса выбираются только те данные, которые соответствуют заданным условиям запроса данных.
Входные параметры табличного ресурса делятся на два типа: скалярные и табличные.
Примечание. Настройка значений по умолчанию доступна только для скалярных значений параметров. Для табличных значений параметров значением по умолчанию является пустая таблица.
Добавление входных параметров ресурса осуществляется через запросы с мобильного устройства или в консоли администратора.
Важно. Для интеграции с табличными источниками данных входные параметры должны удовлетворять условиям.
Выберите способ добавления входных параметров с помощью статуса для мобильного приложения в раскрывающемся списке столбца «Статус для мобильного приложения»:
Доступен. Значение параметра доступно для редактирования с мобильного устройства, после чего это значение передается на сервер мобильной платформы;
Примечание. Значение параметра задается только при запросе данных. Запрос должен содержать значение параметра для избежания ошибок.
Недоступен. Значение параметра недоступно для редактирования с мобильного устройства. Задайте значение в консоли администратора, которое будет являться значением по умолчанию при запросе данных:
при установленном флажке в столбце «Null» значение параметра для фильтрации данных будет не задано;
при снятом флажке в столбце «Null» задайте значение параметра в столбце «Значение», по которому будет осуществляться фильтрация данных в ресурсе;
Переменная. Значение переменной в формате <%credential/username/client_ip>. Начните вводить значение переменной. При вводе осуществляется автопоиск среди возможных значений переменной в зависимости от ресурса источника данных. Значение параметра автоматически вычисляется сервером мобильной платформы на основе данных запроса с мобильного устройства;
Функция. Имя функции в формате <%sign>. Задайте значение параметра для работы с цифровой подписью.
Примечание. Тип данных параметра в базе данных мобильной платформы, оригинальный тип данных в источнике данных, имя параметра недоступны для изменения.
Настройте кеширование при необходимости и нажмите кнопку «Сохранить». Ресурс будет добавлен в список содержащихся ресурсов источника данных.
Особенности входных параметров ресурса источника данных SAP
Передача пустых значений (null, "null" или "") для входных параметров ресурса источника данных SAP отличается в зависимости от версии продукта «Форсайт. Мобильная платформа»:
в версии 23.12:003 и ниже входные параметры с пустыми значениями передаются в источник данных SAP с явным обозначением пустой переменной "null", несмотря на нарушения ABAP-типов. В этом случае сервер мобильной платформы вызывает SAP ABAP FM-модуль;
в версиях 23.12:004, 23.12:005 входные параметры со значениями "" или "null" не передаются в источник данных SAP. Запрос в интеграционной библиотеке (производитель SAP) завершается с ошибкой;
в версии 25.03:001 и выше входные параметры с пустыми значениями обрабатываются в соответствии с правилами приведения типов данных SAP.
Совет. Рекомендуется использовать продукт Форсайт. Мобильная платформа версии 25.03 и выше для корректной передачи пустых значений входных параметров в источник данных SAP.
При взаимодействии сервера мобильной платформы с источником данных SAP применяется строгая зависимость от типа данных и его значения в соответствии с правилами:
для типов данных NUMC, CURR, QUAN, DEC, INT4, DATS, UNIT, CUKY, FLTP, INT2, TIMS, INT1 значения null, "null", "" считаются пустыми;
для типов данных RAWSTRING, RAW значение null считается пустым, "null", "" - не пустым;
для типов данных CHAR, STRING значения null, "" считаются пустыми, "null" - не пустым.
Пустые значения не передаются в источник данных SAP.
Примечание. Значения "Null", "NULL", "nUlL" и подобные автоматически приводятся к нижнему регистру "null" сервером мобильной платформы. Если значение "null" для типа данных считается не пустым, то оно передаётся в источник данных SAP в исходном виде. Например, если сервер мобильной платформы получил параметр с типом данных RAWSTRING и значением "Null", то оно приводится к значению "null" для дальнейшей проверки. В данном случае "null" для типа данных RAWSTRING считается не пустым, поэтому сервер мобильной платформы передаёт исходное значение "Null" в источник данных SAP.
Пример обработки
пустых значений скалярных входных параметров
Пример обработки
пустых значений табличных входных параметров
Особенности входных параметров ресурса источника данных JSON
При редактировании ресурса источника данных JSON набор входных параметров задается вручную:
Для добавления набора параметров:
Введите имя параметра в поле столбца «Имя параметра».
Выберите статус для мобильного приложения в раскрывающемся списке столбца «Статус для мобильного приложения».
Задайте значение параметра в поле столбца «Значение» в зависимости от выбранного статуса для мобильного приложения.
Примечание. Поле доступно, если задан статус для мобильного приложения «Недоступен», «Переменная» или «Функция».
При необходимости нажмите кнопку «Добавить» для добавления следующего параметра и повторите предыдущие шаги.
Нажмите кнопку «Сохранить».
После выполнения действий будет добавлен набор параметров.
Для редактирования параметра измените содержимое полей таблицы и нажмите кнопку «Сохранить».
Для удаления параметра в таблице нажмите кнопку «Удалить» напротив параметра.
Особенности входных параметров ресурса источника данных Foresight
При кешировании данных ресурса источника данных Foresight набор входных параметров ресурса зависит от типа объекта:
куб:
Параметр. Введите наименование параметра при наличии параметров в кубе. Если параметр не указан, то с сервера продукта «Форсайт. Аналитическая платформа» будет получен пустой куб;
Группы элементов. Введите наименование группы элементов в виде строк с идентификатором группы для каждого справочника, из которого состоит куб. Если группы не указаны, то фильтрация по группам элементов не осуществляется;
Отметка элементов измерения. Введите наименование отметки элементов для каждого справочника, из которого состоит куб. Для фильтрации данных необходимо передать список ключей в соответствующее измерение. Если передано пустое значение, то фильтрация не осуществляется, возвращаются все значения.
Примечание. Параметры задаются из консоли администратора. Группа элементов и отметка элементов измерения задается через мобильное устройство с помощью API-запроса.
справочник:
Параметр. Введите наименование параметра при наличии параметров в справочнике. Если параметр не указан, то с сервера продукта «Форсайт. Аналитическая платформа» будет получен пустой справочник;
Группы элементов. Введите наименование группы элементов в виде строк с идентификатором группы справочника. Если группа не указана, то фильтрация по группе элементов не осуществляется;
Атрибуты. Введите наименование атрибута справочника. Для выборки данных укажите значение атрибута, по которому будет выполняться фильтрация данных. Если значение для фильтрации не задано, то фильтрация не осуществляется, возвращаются все значения.
Примечание. Параметр и группы элементов задаются из консоли администратора. Атрибуты задаются через мобильное устройство с помощью API-запроса.
таблица:
Параметр. Введите наименование параметра при наличии параметров в таблице. Параметр влияет на значения атрибутов, к которым привязан параметр, но не на количество возвращаемых элементов.