Данная функция обеспечивает параметрирование контекстных меню.

Рисунок: Показать контекстное меню 

Structure

Далее приводится перечень всех полей и опций функции «открытие справки в формате HTML» с описанием их использования.

Каталог сообщений

Здесь перечислены все записи создаваемых контекстных меню. Их можно настроить при помощи следующих кнопок.

Ввести запись 

Создает новую запись контекстного меню.

Добавить подзапись 

Создает подзапись контекстного меню.

Переместить запись вверх/вниз 

Данные кнопки используются для изменения порядка записей.

Удалить запись 

Удаляет созданные записи.

Тип

Определяет тип записи: либо кнопка, либо разделитель. Кнопка вызывает функцию и открывает другую подзапись. Разделитель добавляет разделительную линию между записями.

Например:

Данная настройка отображает следующее контекстное меню:

Усл. актив.

Создает условие включения записи. Условия состоят из доступных переменных и (или) $-параметров, связанных друг с другом операторами.

Рисунок: Усл. актив. 

Переменные

Список всех доступных переменных.

$-параметр

Список всех доступных $-параметров, которые можно использовать как переменные.

Операторы

Список операторов, которые связывают переменные и $-параметры друг с другом.

Функция

Задает созданную функцию, которая будет выполнена при щелчке по связанной с ней записью.

Help

Более подробная информация о функции «показать контекстное меню» приведена в справке «КАСКАД Цифра» 3.11, которая открывается щелчком по кнопке «Справка».

Применить

Щелкните по кнопке «Применить», чтобы применить заданные настройки для контекстных меню.

«Cancel» («Отмена»)

Нажатием на кнопку «Отменить» настройка отклоняется. Затем можно выбрать новую функцию.

Рисунок. Контекстное меню задано успешно

Данная функция мастера сценариев обеспечивает настройку вызова справки в формате HTML.

Рисунок: Открыть HTML-справку

Structure

Далее приводится перечень всех полей и опций функции «открытие справки в формате HTML» с описанием их использования.

Ключевое слово

При использовании конкретного ключевого слова можно непосредственно вызвать соответствующую страницу справки в формате HTML.

Все определенные ключевые слова сохраняются в файле &apos;keywords.txt&apos;, который должен находится в каталоге …/help/<LANG>/.

ПРИМЕЧАНИЕ

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

Рисунок: Предупреждение о несвязанной странице

Help

Более подробная информация о функции «открыть HTML-справку» приведена в справке «КАСКАД Цифра» 3.11, которая открывается щелчком по кнопке «Справка».

Применить

Нажатием на кнопку «Применить» будет применено введенное ключевое слово для открытия справки в формате HTML.

«Cancel» («Отмена»)

Нажатием на кнопку «Отменить» настройка отклоняется. Затем можно выбрать новую функцию.

Рисунок: Вызов справки в формате HTML настроен успешно

Функция «чтение записи в каталоге сообщений» обеспечивает возможность чтения значений (записей) из каталогов сообщений при помощи ключевых слов. Значения (записи) будут записаны в выбранный целевой каталог.

Рисунок: Чтение записи из каталога сообщений 

Structure

Далее приводится перечень всех полей и опций функции «чтение записи из каталога сообщений» с описанием их использования.

Каталог сообщений

Выпадающий список содержит все доступные для выбора каталоги сообщений.

Ключевое слово

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

Целевая переменная

Список содержит заранее заданные переменные, на которые записан текст каталога сообщений с использованием ключевых слов. Определенные переменные dpConnects отображаются вместе с описанием и именем переменной (в скобках) в выпадающем меню.

Также можно записать имя несуществующей переменной, которая будет создана автоматически.

Текст

Представляет текст для ключевого слова, который хранится в каталоге сообщений.

Help

Более подробная информация о функции «чтение записи из каталога сообщений» приведена в справке «КАСКАД Цифра» 3.11, которая открывается щелчком по кнопке «Справка».

Применить

Щелкните по кнопке «Применить», при этом, выполняется чтение записи из каталога сообщений с последующей его записью в целевую переменную. Затем данная настройка применяется к текущей функции.

«Cancel» («Отмена»)

Нажатием на кнопку «Отменить» настройка отклоняется. Затем можно выбрать новую функцию.

Рисунок: Запись из каталога сообщений прочитана успешно

Функция «прочитать полномочия пользователя» обеспечивает возможность пользователям чтения текущего уровня полномочий пользователей и его копирования в целевую переменную.

Рисунок: Прочитать полномочия пользователя 

Structure

Далее приводится перечень всех полей и опций функции «прочитать полномочия пользователя» с описанием их использования.

Выбрать ур. полномочий

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

Если пользователь обладает достаточными полномочиями, установленными в данной функции, то выдается обратный сигнал TRUE, и значение TRUE копируется в целевую переменную.

Целевая переменная

В выпадающем списке приведены переменные для выбора. Текущий уровень полномочий пользователей копируется в выбранную переменную. Определенные переменные dpConnects отображаются вместе с описанием и именем переменной (в скобках) в выпадающем меню.

Help

Более подробная информация о функции «прочитать полномочия пользователя» приведена в справке «КАСКАД Цифра» 3.11, которая открывается щелчком по кнопке «Справка».

Применить

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

Отменить

Нажатием на кнопку «Отменить» настройка отклоняется. Затем можно выбрать новую функцию.

Рисунок: Чтение полномочий пользователя выполнено успешно

Функция «прочитать свойство объекта» обеспечивает возможность чтения указанного свойства элемента графического объекта и сохранения его значения в целевой переменной.

Рисунок: Прочитать свойство объекта

Structure

Далее приводится перечень всех полей и опций функции «прочитать свойство объекта» с описанием их использования.

Объект

В выпадающем списке приводятся все доступные графические объекты, которые можно выбрать.

Только объекты, совместимые с UltraLight

– Если данная опция не выбрана, то для графического объекта доступны для выбора все свойства объекта.

– Если данная опция выбрана, то для графического объекта доступны для выбора только свойства объекта, совместимые с ультралегким клиентом.

ПРИМЕЧАНИЕ

Панель может быть использована ультралегким клиентом только в случае, когда используются свойства объекта, совместимые с ультралегким клиентом!

Свойство объекта

В выпадающем списке приведены все свойства объекта, которые доступны для выбранного графического объекта.

Целевая переменная

В данной таблице можно присвоить значение соответствующему параметру свойства объекта, для этого, либо выберите уже определенную переменную, либо введите вручную значение. Большинство свойств переменной содержат только один единственный доступный параметр. Тем не менее, некоторые свойства содержат больше одного параметра. Например, свойство объекта «размер» имеет 2 параметра, соответственно, «ширина» и «высота».

Help

Более подробная информация о функции «прочитать свойство объекта» приведена в справке «КАСКАД Цифра» 3.11, которая открывается щелчком по кнопке «Справка».

Применить

Нажатием на кнопку «Применить» задается свойство графического объекта. Затем данная настройка применяется к текущей функции.

«Cancel» («Отмена»)

Нажатием на кнопку «Отменить» настройка отклоняется. Затем можно выбрать новую функцию.

Рисунок: Свойство объекта прочитано успешно

Данная функция в мастере сценариев обеспечивает установку свойства графического объекта.

Рисунок: Установка свойства

Structure

Далее приводится перечень всех полей и опций функции «установить свойство объекта» с описанием их использования.

Объект

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

Только объекты, совместимые с UltraLight

– Если данная опция не выбрана, то для графического объекта доступны для выбора все свойства объекта.

– Если данная опция выбрана, то для графического объекта доступны для выбора только свойства объекта, совместимые с ультралегким клиентом.

ПРИМЕЧАНИЕ

Панель может быть использована ультралегким клиентом только в случае, когда используются свойства объекта, совместимые с ультралегким клиентом!

Свойство объекта

В выпадающем списке приведены все свойства объекта, которые доступны для выбранного графического объекта.

Value (Значение)

В данной таблице можно присвоить значение соответствующему параметру свойства объекта, для этого, либо выберите уже определенную переменную, либо введите вручную значение. Большинство свойств переменной содержат только один единственный доступный параметр. Тем не менее, некоторые свойства содержат больше одного параметра. Например, свойство объекта «размер» имеет 2 параметра, соответственно, «ширина» и «высота».

Новая переменная с именем «getValueVar_1» создается по умолчанию.

ПРИМЕЧАНИЕ

Значения типа строки должны записываться в пределах апострофов.

Help

Более подробная информация о функции «установить свойство объекта» приведена в справке «КАСКАД Цифра» 3.11, которая открывается щелчком по кнопке «Справка».

Применить

Нажатием на кнопку «Применить» задается свойство графического объекта. Затем данная настройка применяется к текущей функции.

«Cancel» («Отмена»)

Нажатием на кнопку «Отменить» настройка отклоняется. Затем можно выбрать новую функцию.

Рисунок: Свойство объекта установлено успешно.

Мастер сценариев обеспечивает возможность создания структуры условной функции (аналогично «if-else») при помощи функции «добавить условие (If)».

Рисунок: Добавление условия

Structure

В нижеприведенном списке даются соответствующие пояснения каждой доступной настройки, а также кнопок функции «добавить условие (If)».

Переменные

Список содержит все доступные переменные, которые можно использовать для формирования условия.

$-параметр

Перечислены также существующие $-параметры, и они также могут быть использованы в условии.

Операторы

Операторы обеспечивают создание логических функций простым щелчком мыши. Функцию можно также вставить вручную при помощи сокращений, например, «==», «<=», «||», «&&» и т.д.

Условие

В поле ввода для условия создается логическое условие, которое затем используется в качестве критерия условия. Элементы, которые нужно вставить, вводятся двойным щелчком по переменным, $-параметрам и операторам. Возможен также ручной ввод.

ПРИМЕЧАНИЕ

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

Цель заключается в создании условия, которое обеспечивает распознавание состояний «применимо» (TRUE) и «не применимо» (FALSE). В списке под текстовым полем условия можно выбрать только одну существующую функцию, которая будет активирована в случае, если условие «применимо» (TRUE).

ПРИМЕР

На рисунке 1 приведен следующий пример:

Если значение переменной «MyVariable» не равно («!=») значению $-параметра «$ANYTYPE_MyDollarParam», тогда вызывается функция «MyDoSomethingFunction». Например, если значение переменной «MyVariable» равно 42, а значение переменной «$ANYTYPE_MyDollarParam» равно 13, т. е. переменные имеют разные значения, тогда вызывается функция «MyDoSomethingFunction».

Альтернативная ветка

Можно определить функцию, которая будет вызвана в случае, когда условие не соблюдено. Для этого используется опция «Альтернативная ветка».

ПРИМЕР

В приведенном выше примере на рисунке 1 использование альтернативной ветки определяет, что, если значение переменной «MyVariable» и значение переменной «$ANYTYPE_MyDollarParam» равны, то вместо функции «MyDoSomethingFunction» вызывается функция «MyDoNothingFunction».

Help

При нажатии кнопки «Справка» открывается файл справки «КАСКАД Цифра» 3.11, в котором приводится дополнительная информация о функции «добавить условие (If)».

Применить

При нажатии кнопки «Применить» мастер сценариев применяет условия и функции, выбранные пользователем, и панель «добавить условие (If)» закрывается.

«Cancel» («Отмена»)

При нажатии кнопки «Отменить» функции, которые пользователь определил, отклоняются, и панель «Добавить условие (If)» закрывается. Таким образом, для мастера сценариев можно выбрать новую функцию.

Рисунок: Условие успешно добавлено

Функция «выполнить вычисление» обеспечивает создание выражения при помощи арифметических и логических операторов. Результат присваивается переменной и используется в дальнейшем. Полномочия пользователей можно задать таким образом, чтобы предотвратить использование функции неавторизированными пользователями.

Рисунок: Выполнение вычисления 

Structure

Далее приводится перечень всех полей и опций функции «выполнить вычисление» с описанием их использования.

ВНИМАНИЕ

Система не проверяет использование совместимых типов данных. Совместимость типов проверяется пользователем вручную. При помощи функции «Определение переменной» типы данных переменных должны быть правильно указаны, чтобы обеспечить правильное вычисление.

Переменные

Список переменных содержит все доступные переменные, которые можно использовать для вычисления.

$-параметр

Список $-параметров содержит все уже определенные $-параметры, которые можно использовать для вычисления.

Выражение

Создайте выражение в поле «Выражение» при помощи арифметических и логических операторов. Результат выполнения арифметических/логических операций сохраняется в переменной, указанной в поле «Результат в».

Целевая переменная

Данный список содержит все доступные переменные, которым будет присвоен результат вычисления. Определенные переменные dpConnects отображаются вместе с описанием и именем переменной (в скобках) в выпадающем меню.

ВНИМАНИЕ

Тип данных переменной должен быть либо таким же, как и тип данных результата вычисления (int => int), либо тип данных переменной должен быть преобразуем в тип данных результата вычисления (например, float => string, int => string, int => любой тип и т.д.).

Требуемые полномочия

Настройка полномочий пользователей определяет, какие полномочия требуются пользователю для выполнения вычисления. Выпадающий список содержит все уровни полномочий пользователей, доступные в «КАСКАД Цифра».

Help

Более подробная информация о функции «выполнить вычисление» приведена в справке «КАСКАД Цифра» 3.11, которая открывается щелчком по кнопке «Справка».

Применить

Нажатием на кнопку «Применить» создается выражение, которое будет присвоено переменной, указанной в поле «Результат в». Затем данная настройка применяется к текущей функции.

«Cancel» («Отмена»)

Нажатием на кнопку «Отменить» вычисление отклоняется. Затем можно выбрать новую функцию.

Рисунок: Новое вычисление успешно добавлено

Функция «определение переменной» в мастере сценариев обеспечивает определение новых переменных, которые можно использовать в мастере сценариев.

Рисунок: Определение переменной 

Structure

Далее приводится перечень всех полей и опций функции «определение переменной» с описанием их использования.

Имя переменной

В данном текстовом поле можно ввести имя для новой переменной, которое используется для доступа к ней (например, «MyVariable»).

ПРИМЕЧАНИЕ

При определении имени переменной необходимо учитывать 2 ограничения:

• Можно использовать только цифры от 0 до 9, буквы a-z, A-Z и символ «_» (подчеркивание)
• Каждое имя переменной должно быть уникальным и может использоваться только для одной единственной переменной

Тип переменной

В выпадающем списке перечислены все доступные в «КАСКАД Цифра» типы переменных. Выберите тип из списка, чтобы определить тип переменной, например, string, int, bool, float, dyn_string и др.

В зависимости от выбираемого типа переменная может хранить разные значения. Более подробная информация приведена в разделе «Тип данных».

Нач. значение

Начальное значение представляет собой значение переменной непосредственно после определения.

ПРИМЕЧАНИЕ

При определении начального значения необходимо учитывать тип переменной. Более подробная информация о типе переменной в разделе «Тип данных».

Help

Более подробная информация о функции «определение переменной» приведена в справке «КАСКАД Цифра» 3.11, которая открывается щелчком по кнопке «Справка».

Применить

Нажатием на кнопку «Применить» определяется новая переменная. Затем определенная переменная применяется к текущей функции.

«Cancel» («Отмена»)

Нажатием на кнопку «Отменить» новая переменная отклоняется. Затем можно выбрать новую функцию.

Рисунок: Новая переменная определена успешно

Функция «пользовательский раздел сценария» позволяет вставить код, написанный пользователем, в код, который генерирует мастер сценариев. Благодаря этому реализуются функциональные возможности, которые не могут быть реализованы только при помощи мастера сценариев.

Рисунок: Пользовательский раздел сценария 

Structure

Далее приводится перечень всех полей и опций функции «пользовательский раздел сценария» с описанием их использования.

Имя/Описание

Имя / краткое описание облегчает поиск пользовательского кода в сценарии. Имя / краткое описание также используется в списке функциональных возможностей функции, генерируемой мастером сценариев.

Секция кода

Секция кода охватывает большую часть области на данной панели. В текстовом поле «Секция кода» можно вручную ввести собственный сценарий. Поскольку сценарий – это сценарий, написанный на языке CTRL, то необходимо соблюдать синтаксис написания сценариев на языке CTRL. В коде можно использовать функции CTRL.

ПРИМЕЧАНИЕ

Проверяется только синтаксис пользовательского раздела сценария. Ошибки логики программы не будут обнаружены, а, следовательно, не будут скорректированы. За правильную работу сценария отвечает пользователь.

ВНИМАНИЕ

Если панель, формируемая при помощи мастера сценариев, также будет использоваться ультралегким клиентом, тогда при написании пользовательского раздела сценария можно использовать только функции, доступные для ультралегкого клиента. Кроме того, убедитесь в том, что используется только синтаксис, совместимый с ультралегким клиентом.

Добавить логическое выражение

Щелкните по кнопке «Добавить выражение» , при этом откроется диалоговое окно, в котором можно создать логические выражения. Более подробная информация приведена в разделе «Логические выражения».

Help

Более подробная информация о функции «пользовательский раздел сценария» приведена в справке «КАСКАД Цифра» 3.11, которая открывается щелчком по кнопке «Справка».

Применить

Нажатием на кнопку «Применить» пользовательский раздел сценария завершается и принимается. Затем сценарий применяется к текущей функции.

«Cancel» («Отмена»)

Нажатием на кнопку «Отменить» пользовательский раздел сценария отклоняется. Затем можно выбрать новую функцию.

Рисунок: Пользовательская секция кода успешно добавлена