Alpha.Community

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

Импорт/экспорт элементов

Элементы можно экспортировать в файл и импортировать из файла. Файл *.omx-export имеет xml-формат содержимого и может быть отредактирован (или создан) в другой программе.

Импорт/экспорт элементов используется для:

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

Экспорт элементов

Чтобы экспортировать элементы:

  1. В обозревателе решений в контекстном меню решения, проекта или элемента выберите Экспортировать элементы....

    Откроется мастер экспорта.

  2. (Если экспорт вызван для решения) Выберите проект.

  3. Выберите элементы.

  4. (Опционально) В плане экспорта посмотрите, какие элементы будут экспортированы в файл.

  5. Укажите файл.

  6. Нажмите Готово.

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

  • Будет создан указанный файл. Если файл существует, он будет перезаписан.
  • В файле будут сохранены выбранные элементы. Для каждого элемента сохраняются:

    • свойства
    • атрибуты
    • вложенные элементы

Импорт элементов

Чтобы импортировать элементы:

  1. В обозревателе решений в контекстном меню решения, проекта или элемента выберите Импортировать элементы....

    Откроется мастер импорта.

  2. Выберите файл.

  3. Выберите элементы в файле, которые нужно импортировать.

  4. (Если импорт вызван для решения) Выберите проект.

  5. Укажите место в проекте, куда следует импортировать элементы.

  6. Выберите файл проекта, в который будет записана информация об импортируемых элементах.

  7. (Опционально) В плане импорта посмотрите изменения, которые будут внесены в проект при импорте.

    При необходимости, снимите флаги с тех изменений, которые вносить не нужно.

  8. Нажмите Готово.

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

  • Если элемент отсутствует в проекте – он будет добавлен в указанное место.

    Наличие элемента проверяется по его идентификатору – атрибут uuid у элемента в файле. Если идентификатор не указан, он будет сгенерирован при добавлении элемента.

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

  • Если элемент есть в проекте – он будет заменён на элемент, описанный в файле, и перемещён в указанное место.

    При замене элемента будет заменено всё его описание, включая вложенные элементы.

  • Если в файле элементу добавлен атрибут удаления isDeleted="true" – при импорте элемент будет удалён из проекта.

    Если удаляется объект – будут также удалены объекты, представляющие его. Если удаляется тип – будут также удалены типы, представляющие его, и объекты всех удалённых типов.

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

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

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

Пример импорта/экспорта

В этом примере будет продемонстрировано, как:

  • экспортировать элементы из проекта;
  • изменять описания элементов в файле экспорта;
  • импортировать изменённый файл в проект.

Подготовка элементов

  1. В новом проекте добавьте Пространство имён с именем Types и перейдите в него.

  2. Добавьте Логический тип с именем Sensor-type и перейдите в него.

  3. Добавьте Параметр с именем Value.

    Укажите свойства добавленного элемента:

    • Тип – float
    • Направление – Выход

  4. Вернитесь в пространство имён Types и добавьте здесь еще один Логический тип с именем Valve-type, затем перейдите в него.

  5. Добавьте сигналы:

    • Событие с именем Open:

      • Тип – bool
      • Направление – Вход
    • Параметр с именем Is_opened:

      • Тип – bool
      • Направление – Выход

  6. Перейдите в корень проекта, добавьте здесь Тип приложения и перейдите в него.

  7. Добавьте Логический объект с именем Sensor. В свойстве Тип добавленного элемента укажите ранее созданный тип Sensor-type.

  8. Добавьте Логический объект с именем Valve. В свойстве Тип добавленного элемента укажите ранее созданный тип Valve-type.

Получившееся дерево решения будет иметь вид как на рисунке ниже.

Экспорт элементов

  1. В обозревателе решений выберите пространство имён Types, и в контекстном меню выбранного элемента выберите Экспортировать элементы....

  2. В открывшемся окне выберите Sensor-type и Valve-type.

  3. Укажите файл экспорта.

  4. Нажмите Готово.

    Выбранные элементы будут экспортированы.

Внесение изменений в файл

Отредактируйте файл таким образом, чтобы один тип был удален, один – изменен, и ещё один тип – добавлен:

  1. Откройте файл в любом текстовом редакторе.

    <omx xmlns="system" xmlns:ct="automation.control">
      <ct:type name="Sensor-type" uuid="6a5ba1bd-66b8-44dd-9f2e-d43808d938fd">
        <ct:parameter name="Value" access-level="public" access-scope="global" direction="out" type="float32" uuid="9a2bb99c-ff2d-4a4a-9ee2-b1d42e770b93" />
      </ct:type>
      <ct:type name="Valve-type" uuid="bdecffc4-4874-49a9-b5d4-ba153c665464">
        <ct:parameter name="Is_opened" access-level="public" access-scope="global" direction="out" type="bool" uuid="7b1ffe2d-4948-4825-a5a5-7b84f80dc51c" />
        <ct:event name="Open" access-level="public" access-scope="global" direction="in" type="bool" uuid="a617e3c0-0ccd-48dd-8141-c75b78815025" />
      </ct:type>
    </omx>
  2. Типу Sensor-type добавьте атрибут удаления: isDeleted="true".

    <omx xmlns="system" xmlns:ct="automation.control">
      <ct:type name="Sensor-type" uuid="6a5ba1bd-66b8-44dd-9f2e-d43808d938fd" isDeleted="true">
        <ct:parameter name="Value" access-level="public" access-scope="global" direction="out" type="float32" uuid="9a2bb99c-ff2d-4a4a-9ee2-b1d42e770b93" />
      </ct:type>
      <ct:type name="Valve-type" uuid="bdecffc4-4874-49a9-b5d4-ba153c665464">
        <ct:parameter name="Is_opened" access-level="public" access-scope="global" direction="out" type="bool" uuid="7b1ffe2d-4948-4825-a5a5-7b84f80dc51c" />
        <ct:event name="Open" access-level="public" access-scope="global" direction="in" type="bool" uuid="a617e3c0-0ccd-48dd-8141-c75b78815025" />
      </ct:type>
    </omx>
  3. Типу Valve-type добавьте входящий сигнал Close типа bool. Тип сигнала такой же, как у Open – Событие.

    Идентификатор элемента (uuid) сигналу можно не указывать: он будет сгенерирован при импорте.

    <omx xmlns="system" xmlns:ct="automation.control">
      <ct:type name="Sensor-type" uuid="6a5ba1bd-66b8-44dd-9f2e-d43808d938fd" isDeleted="true">
        <ct:parameter name="Value" access-level="public" access-scope="global" direction="out" type="float32" uuid="9a2bb99c-ff2d-4a4a-9ee2-b1d42e770b93" />
      </ct:type>
      <ct:type name="Valve-type" uuid="bdecffc4-4874-49a9-b5d4-ba153c665464">
        <ct:parameter name="Is_opened" access-level="public" access-scope="global" direction="out" type="bool" uuid="7b1ffe2d-4948-4825-a5a5-7b84f80dc51c" />
        <ct:event name="Open" access-level="public" access-scope="global" direction="in" type="bool" uuid="a617e3c0-0ccd-48dd-8141-c75b78815025" />
        <ct:event name="Close" access-level="public" access-scope="global" direction="in" type="bool" />
      </ct:type>
    </omx>
  4. Добавьте тип Device-type.

    <omx xmlns="system" xmlns:ct="automation.control">
      <ct:type name="Sensor-type" uuid="6a5ba1bd-66b8-44dd-9f2e-d43808d938fd" isDeleted="true">
        <ct:parameter name="Value" access-level="public" access-scope="global" direction="out" type="float32" uuid="9a2bb99c-ff2d-4a4a-9ee2-b1d42e770b93" />
      </ct:type>
      <ct:type name="Valve-type" uuid="bdecffc4-4874-49a9-b5d4-ba153c665464">
        <ct:parameter name="Is_opened" access-level="public" access-scope="global" direction="out" type="bool" uuid="7b1ffe2d-4948-4825-a5a5-7b84f80dc51c" />
        <ct:event name="Open" access-level="public" access-scope="global" direction="in" type="bool" uuid="a617e3c0-0ccd-48dd-8141-c75b78815025" />
        <ct:event name="Close" access-level="public" access-scope="global" direction="in" type="bool" />
      </ct:type>
      <ct:type name="Device-type" />
    </omx>
  5. Сохраните изменения в файле.

Импорт элементов

  1. В обозревателе решений выберите пространство имён Types, в контекстном меню выбранного элемента выберите Импортировать элементы....

  2. В открывшемся окне укажите измененный выше файл.

  3. Выберите элементы файла, которые будете импортировать.

  4. Выберите файл проекта.

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

  5. Нажмите Готово.

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

  • Тип Sensor-type будет удалён из проекта. Вместе с ним будет удалён объект этого типа – Sensor.
  • В тип Valve-type будет добавлен сигнал Close.
  • Будет добавлен тип Device-type.

Дерево решений после импорта будет иметь вид как на рисунке ниже.