Создание пакета на основе инструкций
Технология пакетов на основе инструкций позволяет создавать пакеты, в которых определен набор инструкций, обязательных для выполнения на периферийном устройстве. В соединителе eMessage имеется встроенная поддержка для пакетов на основе инструкций.
 |
В этом разделе предполагается, что уже выполнены предварительные требования, необходимые для создания пакета на основе инструкций.
|
Чтобы создать пакет на основе инструкций, выполните следующие шаги.
1. На левой панели в ThingWorx Software Content Management в разделе Пакеты выберите > .
Откроется страница Создать пакет.
2. В поле Наименование пакета введите наименование пакета.
3. Введите краткое описание пакета в поле Описание пакета.
4. В поле Версия войдите в номер версии для пакета.
К версии пакета применяются следующие правила.
◦ Необходимо ввести номер основной версии пакета.
◦ Можно вводить только неотрицательные целые числа.
◦ В каждое поле составного поля версии можно ввести числовую строку длиной до 4 цифр для версии пакета, как показано на следующем изображении:
| | По умолчанию номер основной версии заполняется значением 1, а остальные поля считаются равными 0. Ниже приведены примеры неверных значений: • Если в последнем поле составного поля Версия имеется значение, пустое значение для предыдущих полей недопустимо, и это поле подсвечивается красным цветом, как показано ниже:  Не оставляйте поля незаполненными, вместо этого введите в пустые поля следующие (или любые другие) значения:  • При вводе в какое-либо из полей отрицательного значения это отдельное поле подсвечивается красным цветом, как показано ниже:  Исправьте ошибку - введите в эти поля только неотрицательные целые числа. • При вводе в какое-либо из полей буквенного или буквенно-цифрового значения это отдельное поле подсвечивается красным цветом, как показано ниже:  Исправьте ошибку - введите в эти поля только неотрицательные целые числа. |
5. Чтобы указать, имеет ли пакет дату окончания срока действия, выберите одну из следующих опций в поле Срок действия.
◦ Никогда - пакет не имеет даты окончания срока действия. По умолчанию для этой опции задается дата окончания срока действия на 100 лет позже даты создания пакета.
◦ Дата - используйте виджет селектора даты и времени, чтобы указать нужный срок действия пакета.
| | Нельзя создать два пакета с одним и тем же наименованием и номером версии. Если появится сообщение о том, что это сочетание наименования пакета и версии существует, укажите уникальное сочетание наименования и версии. |
6. Чтобы связать тип актива (шаблон вещи) с пакетом, выберите тип актива в средстве выбора сущности Тип актива. По умолчанию в этом средстве выбора сущности перечислены все шаблоны вещей, соответствующие конфигурации, упоминаемой в разделе Конфигурация ThingWorx Software Content Management
Если пользователь выбирает шаблон вещи для активов, которые должны получать пакеты на основе инструкций, отображается только вкладка Пакет на основе инструкций, а вкладка Пакет на основе файлов скрыта.
Типы активов, отображаемые в средстве выбора сущности, также зависят от конфигурации Типов пакетов. Если в качестве видимого выбран только тип пакета на основе инструкций, в средстве выбора сущностей будут отображаться только шаблоны, поддерживающие пакеты на основе инструкций.
7. Выберите вкладку Пакет на основе инструкций.
8. Щелкните Добавить инструкцию, чтобы выбрать тип инструкции, которую нужно доставить в актив.
9. В зависимости от инструкции, которую требуется добавить, выберите в списке Тип инструкции одну из следующих инструкций и выполните соответствующее задание.
Инструкция | Задание | ||||||
Загрузить | Выберите файл, который нужно загрузить в агент, из репозитория ThingWorx. Выполните следующие шаги, чтобы добавить файл из репозитория ThingWorx. a. В поле Целевой репозиторий отображается сконфигурированный Целевой репозиторий загрузки на странице Конфигурация развертывания. Щелкните значок  , чтобы изменить сконфигурированный репозиторий загрузки.Дополнительные сведения см. в разделе настройки развертывания. b. В разделе Структура каталога отображается содержимое выбранного репозитория. В разделе Структура каталога можно выполнить следующие действия. ◦ Если файл, который нужно доставить в актив, недоступен в выбранном репозитории, щелкните значок  , чтобы выгрузить файл в репозиторий ThingWorx.◦ Щелкните значок  , чтобы загрузить файл в расположение загрузки по умолчанию на вашем компьютере.◦ Щелкните значок  , чтобы удалить этот файл из репозитория.c. В разделе Структура каталога перейдите к файлу, который нужно загрузить в актив, и в разделе Содержимое каталога выберите файл, чтобы отобразить его наименование в поле Имя выбр. ZIP-файла содержимого. В разделе Содержимое каталога для каждого файла доступна следующая информация. ◦ Наименование - если файл доступен в репозитории ThingWorx, этот параметр указывает наименование файла с его расширением. Если файл выгружен в репозиторий, то к наименованию файла присоединяется метка времени (от начала отсчета в системе). Эта метка времени различна для двух файлов с одним и тем же наименованием. ◦ Дата выгрузки - указывает дату и время добавления файла в репозиторий ThingWorx. ◦ Размер - указывает размер файла в байтах. ◦ Путь - указывает абсолютный путь к файлу в репозитории ThingWorx. d. В поле Целевой каталог укажите расположение в активе, в которое нужно загрузить файл. e. Если в поле Целевой каталог вы указываете абсолютный путь, установите флажок Целевой каталог является абсолютным. Делать это необязательно. По умолчанию этот флажок не установлен. f. Если нужно, чтобы файл после загрузки на устройство Edge был распакован, установите флажок После загрузки этот файл должен быть распакован агентом. Делать это необязательно. По умолчанию этот флажок не установлен.
g. Установите флажок Перезаписать существующие файлы при загрузке этого файла в данный каталог, если нужно, чтобы существующие файлы были перезаписаны при загрузке этого файла в указанный каталог. Делать это необязательно. По умолчанию этот флажок не установлен. h. Щелкните Добавить, чтобы добавить инструкцию в список инструкций. | ||||||
Выполнить | Выполнение команды в удаленной вещи. a. В поле Исполняемый файл введите команду, которую нужно выполнить. b. В поле Аргументы укажите аргументы команды, которые вы определили в поле Исполняемый файл. Это необязательное поле.
c. Если для исполняемого файла используется абсолютный путь, установите флажок Путь к исполняемому файлу является абсолютным. По умолчанию эта опция не выбрана. d. Если нужно, чтобы команды были асинхронными, т. е. независимыми друг от друга во время выполнения, установите флажокВыполнить эту команду асинхронно. По умолчанию этот флажок не установлен и выполнение синхронизируется. e. Щелкните Добавить, чтобы добавить инструкцию в список инструкций. | ||||||
Зарегистрировать сценарий | Позволяет добавить инструкции в виде сценария, который можно развернуть для актива или нескольких активов для агента Axeda. Шаги по регистрации сценария см. в разделе Выполнение сценариев для развертывания | ||||||
Перезапустить | Перезапускает агент. a. Установите флажок Жесткий перезапуск. Снимите этот флажок для мягкого перезапуска, чтобы прервать текущий процесс агента и запустить новый процесс. Флажок Жесткий перезапуск. Снимите этот флажок для мягкого перезапуска по умолчанию установлен. Если нужно только повторно инициировать все компоненты и перезагрузить данные с диска, не прерывая текущего процесса агента, убедитесь, что флажок Жесткий перезапуск. Снимите этот флажок для мягкого перезапуска снят. Такой перезапуск называется мягким. b. Щелкните Добавить, чтобы добавить инструкцию в список инструкций.
| ||||||
Выполнить сценарий | Позволяет выполнить зарегистрированный сценарий, который можно развернуть для актива или нескольких активов для агента Axeda. Шаги для выполнения сценария см. в разделе Выполнение сценариев для развертывания | ||||||
Задать свойство | Задает значение указанного свойства на удаленном устройстве Edge. a. В полях Наименование свойства и Значение свойства укажите имя и значение свойства.
b. Щелкните Добавить, чтобы добавить инструкцию в список инструкций. | ||||||
Отменить регистрацию сценария | Позволяет отменить регистрацию зарегистрированного сценария для актива или нескольких активов для агента Axeda. Шаги по отмене регистрации сценария см. в разделе Выполнение сценариев для развертывания | ||||||
Выгрузить | Позволяет агентам Axeda eMessage выгрузить один или несколько файлов в платформу ThingWorx. a. В поле Целевой репозиторий щелкните значок  , чтобы выбрать репозиторий, в который нужно выгрузить файлы.Можно создать репозиторий файлов для выгрузки и выбрать этот репозиторий файлов, например UploadRepository. b. В поле Целевой путь укажите расположение в репозитории, где нужно сохранить выгруженные файлы. Например: /UploadFiles - для сохранения файлов в каталоге /UploadRepository/UploadFiles. Значение / используется для сохранения выгруженных файлов в каталоге UploadRepository.
c. В поле рядом со значком  введите имя файла, который нужно выгрузить, и щелкните значок . В имена файлов можно включать подстановочные символы, такие как звездочка (*) или знак вопроса (?). Используйте символ "*" для представления нескольких символов и символ "?" для представления отдельного символа. Убедитесь, что этот файл существует в относительном пути устройства.Для агентов Linux разрешены подстановочные символы (*,?). Для агентов, выполняющихся в Windows, символ ? действует так же, как символ *.
В сетке Файлы для выгрузки отображается список файлов, которые должны быть выгружены в платформу ThingWorx, а также статус их флага удаления. Для удаления какого-нибудь файла из списка выберите запись в списке и щелкните значок .d. После добавления файла для выгрузки можно удалить файл из репозитория после успешного развертывания пакета. Чтобы удалить файл после выгрузки, выберите файл и переключите кнопку Действия в стр. табл. Статус Удалить файл после выгрузки изменится на true, а файл будет удален после успешного развертывания пакета. Можно выбрать отдельные файлы, выбирая каждый файл в сетке, или выбрать все файлы, добавленные для выгрузки, установив флажок Имя файла. По умолчанию статус Удалить файл после выгрузки имеет значение false. Кнопка переключения может изменять статус с true на false или с false на true e. Щелкните Добавить, чтобы добавить инструкцию в список инструкций. |
| | В один пакет на основе инструкций можно добавить несколько инструкций. |
10. Просмотрите инструкции в списке инструкций, в котором содержатся следующие сведения.
◦ "Порядок" - указывает порядок, в котором инструкции должны выполняться в агенте.
◦ "Тип" - указывает тип инструкции, который может быть одним из следующих:
▪ Загрузить
▪ Выполнить
▪ Зарегистрировать сценарий
▪ Перезапустить
▪ Выполнить сценарий
▪ Задать свойство
▪ Отменить регистрацию сценария
▪ Выгрузить
◦ "Подробно" - указывает сведения об инструкции, которые были определены при создании инструкции.
Выберите инструкцию в списке и используйте для ее изменения одну из следующих опций.
◦ Щелкните значок 
, чтобы отредактировать инструкцию.
, чтобы отредактировать инструкцию.◦ Щелкните значок 
или 
, чтобы изменить место инструкции в списке.
или , чтобы изменить место инструкции в списке.| | Убедитесь, что в списке инструкций существует только одна инструкция "Перезапустить" и эта инструкция является последней в списке инструкций. |
◦ Щелкните значок 
, чтобы удалить инструкцию.
, чтобы удалить инструкцию.11. Щелкните Сохранить, чтобы сохранить пакет.
Откроется страница Добавить или изменить зависимости. Добавление или изменение зависимостей - это необязательный шаг. Дополнительные сведения см. в разделе Добавление или изменение зависимостей пакета.
12. Если вы добавили зависимости пакета, щелкните Сохранить.
Откроется страница Создать тестовое развертывание. Создание тестового развертывания - это необязательный шаг. Дополнительные сведения см. в разделе Тестовое развертывание пакета.
13. (Необязательно) Можно также указать уровень доступа, предоставляемый конкретным пользователям или группам пользователей. Дополнительные сведения см. в разделе Определение управления доступом пользователей.
14. Для продолжения перейдите к публикации пакета.