Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Добавление атрибутов

Атрибут – это значение, которое указывается элементу и каким-то образом на него влияет:

  • одни атрибуты добавляют или изменяют характеристики элемента. Например, атрибут Начальное значение задаёт значение сигнала при запуске/перезапустке Alpha.Server.
  • другие атрибуты добавляют элементу новое поведение. Например, при наличии у параметра атрибута События изменение значения сигнала будет приводить к генерации события.
  • есть атрибуты, которые влияют на поведение элемента в проекте. Например, атрибут Комментарий добавляет элементу комментарий, который отображается при наведении мышью на элемент.

Некоторые атрибуты добавляются элементу автоматически при выполнении определенных действий. Например:

  • Если в контекстном меню элемента добавить ему комментарий, элементу будет добавлен атрибут Комментарий, в котором будет сохранён текст комментария.
  • Если в окне События сигналу настроить генерацию событий, ему будет добавлен атрибут События, в значении которого будут заданы параметры, указанные при настройке.

По умолчанию в проектах, созданных из шаблонов, есть ссылки на системные модули Om.System и Om.Server. Они предоставляют системные атрибуты, используемые для работы программы (например, при построении конфигурации Alpha.Server).

Чтобы использовать другие атрибуты, нужно добавить в проект ссылки на модули, в которых они находятся. Чтобы добавить ссылку на модуль:

  1. Перейдите в Содержимое модуля (корень проекта).
  2. Добавьте элемент Ссылка на модуль.

    В свойстве Модуль укажите нужный модуль.

После добавления ссылки на модуль, в проекте будут доступны атрибуты, которые находятся в этом модуле.

Добавление атрибутов объектам

Атрибуты можно добавлять как отдельным элементам, так и типам. Атрибуты, добавленные типу, при построении применяются к объектам этого типа. В объекте нельзя редактировать атрибуты вложенных элементов (сигналов, вложенных объектов и других), если они описаны в типе объекта. Есть два способа изменить значения таких атрибутов:

На вкладке Атрибуты

Чтобы добавить объекту атрибут:

  1. Выберите объект.
  2. В окне Атрибуты в контекстном меню выберите Добавить новые атрибуты... или нажмите клавишу Insert.

    Откроется окно выбора атрибутов, в нём будут только те атрибуты, которые применимы к выбранному объекту.

  3. Выберите один или несколько атрибутов и нажмите Ок.

    Атрибуты будут добавлены объекту.

  4. Каждому атрибуту укажите его значение.

    Формат значения зависит от атрибута: в одних атрибутах нужно указать число, в других – строку, в третьих – структуру данных в определённом формате.

Атрибутам, которые вы добавили объекту, можно добавить свои атрибуты – подробнее об этом можно почитать в разделе Добавление вложенных атрибутов. Атрибуту можно добавить только такие атрибуты, которые являются для него допустимыми. Атрибуту можно добавить несколько атрибутов. Для вложенного атрибута вы можете добавить его вложенный атрибут.

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

В табличном представлении

Чтобы добавить объекту атрибут:

  1. Найдите в таблице ячейку на пересечении строки объекта, которому нужно добавить атрибут, и столбца с названием нужного атрибута.
  2. Щелкните по ячейке правой кнопкой мыши и выберите пункт Добавить атрибут. Ячейка станет активна: это значит, что атрибут добавлен объекту, но его значение еще не указано.
  3. Укажите значение атрибута в активированной ячейке. Изменить ранее указанное значение атрибута можно здесь же.

    Формат значения зависит от атрибута: в одних атрибутах нужно указать число, в других – строку, в третьих – структуру данных в определённом формате.

Переопределение значений с помощью карты атрибутов

Значения атрибутов, добавленных типам и вложенным в них элементам, можно переопределить с помощью карты атрибутов. Карта атрибутов создаётся в приложении и позволяет изменить значения атрибута для элементов в этом приложении. Для каждого типа атрибута нужно создать свою карту значений атрибутов.

Чтобы создать карту атрибутов:

  1. Перейдите в Приложение.
  2. Добавьте элемент Значения атрибутов.
  3. Создайте или выберите файл для хранения атрибутов:

    1. Нажмите на иконку папки на изображении элемента.

      Откроется окно выбора файла.

    2. Создайте или выберите файл.

      В результате:

      • Файл будет добавлен в список файлов проекта.
      • Выбранный файл будет указан на символе элемента Значения атрибутов на Диаграмме и в его свойствах.
  4. На символе элемента Значения атрибутов нажмите и в открывшемся окне выберите нужные типы атрибутов, значения которых будут редактироваться в создаваемой карте атрибутов.
  5. Перейдите в карту атрибутов.

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

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

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

Для вычисления некоторых атрибутов может потребоваться компиляция решения.