Функции, относящиеся к контексту
Раздел описывает функции языка выражений, относящиеся к извлечению данных из контекстов и работе с ними.
Функция | Описание | Тип результата | Серверная поддержка | Фронтенд-поддержка | |
available(String context [, String schema]) | Возвращает true, если контекст с путем контекст существует и доступен вызывающему. | Boolean | Да | Да | |
callFunction(String context, String function, Object parameter1, Object parameter2, ...) | Вызывает функцию под названием функция контекста с путем контекст и возвращает ее выход. Ввод функции таблица данных строится из массива параметров (parameter1, parameter2, ...). Правила, используемые для заполнения таблицы данными, описаны здесь. | DataTable | Да | Да | |
callFunctionEx(String context, String function, DataTable parameters [, String schema]) | Аналогичный callFunction(...) вызывает функцию под названием функция контекстас путем контекст и возвращает ее результат. Параметры функции представлены таблицей данных. | DataTable | Да | Да | |
dc([String schema]) | Возвращает путь контекста по умолчанию, определенный во время оценки выражения. | String | Да | Да | |
Другой способ получения пути контекста по умолчанию - это использование ссылки | |||||
dr() | Возвращает строку по умолчанию, определенную во время оценки выражения. | Integer | Да | Да | |
dt() | Возвращает таблицу по умолчанию, определенную во время оценки выражения. | DataTable | Да | Да | |
Другой способ получения пути контекста по умолчанию - это использование ссылки | |||||
eventAvailable(String context, String event [, String schema]) | Возвращает true, если контекст с путем, определенный аргументом контекст, имеет переменную, определенную аргументом событие, и это событие доступно вызывающему. | Boolean | Да | Да | |
eventFormat(String context, String event [, String schema [, Boolean asTable]]) | Возвращает строковое представление формата события или ноль, если контекст/событие недоступен или формат события динамический. По умолчанию используется режим кодирования невидимых разграничителей для кодирования таблицы в виде строки. Чтобы вернуть результат в виде таблицы данных, задайте для asTable значение Обратите внимание, что при вычесление выражений в редакторе выражений веб-интерфейса функция eventFormat должна вычисляться на сервере при использовании параметра asTable. | String | Да | Да | |
eventGroup(String context, String event [, String schema]) | Возвращает имя группы, к которой принадлежит событие, или значение null, если оно не принадлежит ни одной группе. | String | Да | Нет | |
fireEvent(String context, String event, Integer level, Object parameter1, Object parameter2, ...) | Запускает событие под названием событие в контексте. Использует определенный уровень или уровень события по умолчанию, если параметр уровня - NULL. Коды уровня события описаны здесь. Если предоставляется лишь один параметр типа Data Table, эта таблица будет использоваться в качестве таблицы данных. В ином случае Таблица данных, представляющая данные события, строится из массива параметров (parameter1, parameter2, ...). Правила, используемые для заполнения таблицы данными, описаны здесь. Эта функция возвращает идентификатор сгенерированного события или ноль, если генерация событий блокируется системой. | Long | Да | Да | |
Функция fireEvent() сработает лишь в выражении, которое оценивается в SberMobile Server. Выражения, которые оцениваются в SberMobile IIoT Platform Client или Agent, не вызовут генерирование событий сервера. | |||||
fireEventEx(String context, String event, Integer level, DataTable value [, String schema]) | Работает так же, как и fireEvent(), но принимает данные события в виде таблицы value и позволяет указать схему при помощи параметра schema. | ||||
fullDescription(String context [, String delimiter]) | Возвращает полное описание определенного контекста, т.e. описания всех родительских контекстов, разделенных строкой-разделителем. Строка-разделитель по умолчанию "-". | String | Да | Да | |
functionAvailable(String context, String function [, String schema]) | Возвращает true, если контекст с путем, указанным аргументом контекст, имеет функцию, определенную аргументом функция, и эта функция доступна для вызывающего. | Boolean | Да | Да | |
functionGroup(String context, String function[, String schema]) | Возвращает имя группы, которой принадлежит функция, или значение null, если она не принадлежит ни одной группе. | String | Да | Нет | |
functionInputFormat(String context, String function [, String schema [, Boolean asTable]]) | Возвращает строковое представление формата ввода функции или ноль, если контекст/функция недоступны или формат ввода функции динамический. По умолчанию используется режим кодирования невидимых разграничителей для кодирования таблицы в виде строки. Чтобы вернуть результат в виде таблицы данных, задайте для asTable значение Обратите внимание, что при вычесление выражений в редакторе выражений веб-интерфейса функция eventFormat должна вычисляться на сервере при использовании параметра asTable. | String | Да | Да | |
functionOutputFormat(String context, String function [, String schema [, Boolean asTable]]) | Возвращает строковое представление формата вывода функции или ноль, если контекст/функция недоступны или формат вывода функции динамический. По умолчанию используется режим кодирования невидимых разграничителей для кодирования таблицы в виде строки. Чтобы вернуть результат в виде таблицы данных, задайте для asTable значение Обратите внимание, что при вычесление выражений в редакторе выражений веб-интерфейса функция eventFormat должна вычисляться на сервере при использовании параметра asTable. | String | Да | Да | |
getVariable(String context, String variable [, String schema]) | Получает переменную под названием переменная из контекста с путем контекст и возвращает ее значение. | DataTable | Да | Да | |
setVariable(String context, String variable, Object parameter1, Object parameter2, ...) | Устанавливает переменную под названием переменная контекста с путем контекста. Если обеспечивается лишь один параметр типа Data Table, эта таблица будет использоваться в качестве нового значения переменной. В ином случае Таблица данных, представляющая новое значение переменной, строится из массива параметров (parameter1, parameter2, ...). Правила, используемые для заполнения таблицы данными, описаны здесь. | Null | Да | Да | |
setVariableEx(String context, String variable, DataTable value [, String schema]) | Аналогичный setVariable(...) Устанавливает переменную под названием переменная контекста с путем контекста. Параметры функции представлены таблицей данных. | Null | Да | Да | |
setVariableField(String context, String variable, String field, Integer record, Object value) | Устанавливает значение ячейки указанной переменной контекста. Ячейка задается параметрами поле и запись. | Null | Да | Да | |
setVariableRecord(String context, String variable, Integer record, Object parameter1, Object parameter2, ...) | Изменяет значения определенного ряда переменной контекста. Номер ряда задается параметром запись. Другие параметры используются для изменения значений этого ряда. | Null | Да | Да | |
variableAvailable(String context, String variable [, String schema]) | Возвращает true, если контекст с путем, определенный аргументом контекст, имеет переменную, определенную аргументом переменная, и эта переменная доступна вызывающему. | Boolean | Да | Да | |
variableFormat(String context, String variable [, String schema [, Boolean asTable]]) | Возвращает строковое представление формата переменной или ноль, если контекст/переменная недоступны или формат переменной динамический. По умолчанию используется режим кодирования невидимых разграничителей для кодирования таблицы в виде строки. Чтобы вернуть результат в виде таблицы данных, задайте для asTable значение Обратите внимание, что при вычесление выражений в редакторе выражений веб-интерфейса функция eventFormat должна вычисляться на сервере при использовании параметра asTable. | String | Да | Да | |
variableGroup(String context, String variable[, String schema]) | Возвращает имя группы, которой принадлежит переменная, или значение null, если она не принадлежит ни одной группе. | String | Да | Нет | |
variableReadable(String context, String variable [, String schema]) | Возвращает true, если контекст с путем, определенный аргументом контекст, имеет переменную, определенную аргументом переменная, и эта переменная читается вызывающим. | Boolean | Да | Да | |
variableWritable(String context, String variable [, String schema]) | Возвращает true, если контекст с путем, определенный аргументом контекст, имеет переменную, определенную аргументом переменная, и эта переменная записывается вызывающим. | Boolean | Да | Да |