创建基于指令的包
基于指令的包用于定义边缘设备应执行的一组指令。eMessage Connector 为基于指令的包提供内置支持。
 |
本节假定您已经完成了创建基于指令的包的先决条件。
|
完成以下步骤以创建基于指令的包：
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. 在“目录结构”部分下，浏览到要下载资产的文件，然后在“目录内容”部分中选择该文件以在“选择内容压缩文件名称”字段中显示其名称。 在“目录内容”部分下，每个文件都有以下信息： ◦ “名称”- 指定 ThingWorx 信息库中可用文件的名称以及扩展名。如果文件上载到信息库，则将时间戳（Epoch 时间）附加到文件名中。此时间戳可区分两个同名文件。 ◦ “上载日期”- 指定文件添加到 ThingWorx 信息库的日期和时间。 ◦ “大小”- 指定文件的大小 (字节)。 ◦ “路径”- 指定文件在 ThingWorx 信息库中的绝对路径。 d. 在“目标目录”字段中，指定下载文件所至的资产位置。 e. 如果在“目标目录”字段中提供了绝对路径，请选中“目标目录是绝对路径”复选框。此字段是可选的。默认情况下，此字段未启用。 f. 如果希望边缘设备对下载的文件进行解压缩，请选中“代理程序应在下载后解压缩此文件”复选框。此字段是可选的。默认情况下，此字段未启用。
g. 如果希望在文件下载到指定目录时覆盖现有文件，请选中“此文件下载到指定目录时覆盖现有文件”复选框。此字段是可选的。默认情况下，此字段未启用。 h. 单击“添加”将指令添加到指令列表。 | ||||||
执行 | 在远程事物上执行命令。 a. 在“可执行文件”字段中，输入要执行的命令。 b. 在“自变量”字段中，指定您在“可执行文件”字段中定义的命令的自变量。此字段为可选字段。
c. 如果可执行项是绝对路径，请选中“可执行文件路径是绝对路径”复选框。 默认情况下，此选项未启用。 d. 若您希望这些命令异步执行，即执行时相互独立，请选择“异步执行此命令”复选框。 默认情况下，此复选框未选中，且命令同步执行。 e. 单击“添加”将指令添加到指令列表。 | ||||||
注册脚本 | 用于将指令添加为脚本，脚本可针对 Axeda 代理的资产或多个资产进行部署。有关注册脚本的步骤，请参阅执行部署脚本 | ||||||
重新启动 | 重新启动代理。 a. 选中“硬重启。若取消选中，则软重启”复选框，以终止当前代理进程并启动新的代理进程。默认情况下，“硬重启。若取消选中，则软重启”被选中。 如果不希望终止当前代理进程，而是仅重新初始化所有组件并从磁盘重新加载数据，请确保清空“硬重启。若取消选中，则软重启”复选框。这是软重启。 b. 单击“添加”将指令添加到指令列表。
| ||||||
运行脚本 | 用于运行可针对 Axeda 代理的资产或多个资产进行部署的注册脚本。有关运行脚本的步骤，请参阅执行部署脚本 | ||||||
设置属性 | 在远程边缘设备上设置指定的属性值。 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. 继续发布包。