指定基于指令的包的内容
完成创建基于指令的包的先决条件和创建包的步骤 1 到 6 后，请执行以下操作来指定基于指令的包的内容：
1. 在“创建包”页面上，选择“基于指令的包”选项卡。
2. 要选择希望交付到资产的指令类型，请单击“添加指令”。
3. 从“指令类型”列表中，选择下列指令之一，然后完成相关步骤。在本流程之后的各部分中，为您提供了每个指令类型的详情。
◦ 下载
◦ 执行
◦ 注册脚本
◦ 重新启动
◦ 运行脚本
◦ 设置属性
◦ 取消注册脚本
◦ 上传
4. 如果要添加其他指令，请重复步骤 3。可以向单个基于指令的包添加多个指令。
5. 请查阅指令列表中的指令，其中提供以下详情：
◦ “顺序” - 指定在代理上执行指令的顺序。
◦ “类型”- 指定指令的类型。
◦ “详情”- 指定在创建指令时指定的指令详情。
从列表中选择指令，并使用下列选项之一来修改指令：
◦ 要编辑指令，请单击 
。
。◦ 要重新排序指令，可单击 
或 
。
或 。
 |
确保列表中只有一个“重新开始”指令，并且“重新开始”指令是最后一个指令。
|
◦ 要删除指令，请单击 
。
。6. 单击“保存”以保存包。
7. 继续创建包的步骤 8。
以下各部分提供了有关定义每种指令类型的详情：
下载
要从 ThingWorx 信息库中选择要下载到代理的文件，请完成以下步骤：
1. “目标信息库”字段显示已配置的下载目标信息库。要更改目标下载信息库，请单击 
，然后单击 
。
，然后单击 。有关配置下载目标信息库的详情，请参阅部署设置。
2. “目录结构”和“目录内容”窗格显示选定信息库的内容。使用上述窗格，导航到要下载到资产的脚本文件。
在“目录内容”窗格中可以看到各文件的以下信息：
◦ “名称”- 指定带有扩展名的文件名。如果文件已上传到信息库，则将时间戳 (Epoch 时间) 附加到文件名中。此时间戳可区分两个同名文件。
◦ “上传日期”- 指定文件添加到 ThingWorx 信息库的日期和时间。
◦ “大小”- 指定文件的大小 (字节)。
◦ “路径”- 指定文件在 ThingWorx 信息库中的绝对路径。
3. 在“目录内容”窗格中，选择脚本文件以在“选定的内容文件名称”字段中显示其名称。
可以在“目录内容”部分下执行以下操作：
◦ 如果要交付到资产的文件在选定信息库中不存在，请单击 
将文件上传到 ThingWorx 信息库。
将文件上传到 ThingWorx 信息库。◦ 要从信息库中删除文件，请单击 
。
。4. 在“目标目录”字段中，指定下载文件所至的资产位置。
5. 如果在“目标目录”字段中提供了绝对路径，请选中“目标目录是绝对路径”复选框。
6. 如果希望资产对下载的文件进行解压缩，请选中“代理程序应在下载后解压缩此文件”复选框。
|
|
eMessage 代理只能解压缩 tar.gz 格式的文件。
要解压缩任何其他格式的文件，请将“执行”指令添加到包含解压缩可执行文件的包中。
|
7. 如果希望在将文件下载到指定目录时覆盖任何现有文件，请选择可选的“此文件下载到指定目录时覆盖现有文件”复选框。
8. 要将指令添加到指令列表，请单击“添加”。
执行
要定义用于对远程事物执行命令的“执行”指令，请完成以下步骤：
1. 在“可执行文件”字段中，输入要执行的命令。
2. 在“自变量”字段中，指定您在“可执行文件”字段中定义的命令的自变量。此字段为可选字段。
|
|
执行的命令是“可执行文件”和“自变量”字段值的组合。
|
3. 如果可执行项的路径为绝对路径，请选中“可执行文件路径是绝对路径”复选框。
4. 如果希望异步或独立执行这些命令，请选中“异步执行此命令”复选框。默认情况下将同步执行各个命令。
5. 要将指令添加到指令列表，请单击“添加”。
注册脚本
要将指令添加为可部署到 Axeda 代理程序的一个或多个资产的脚本，请完成以下步骤。注册脚本后，可以执行以下操作：
• 验证要针对资产运行的指令。
• 使用已注册的脚本名称，对同一资产或多个资产运行脚本多次。
1. 在“脚本文件”字段中，输入要注册的文件的绝对路径。
|
|
如果出现验证错误，请检查文件路径中是否作为前缀或后缀输入了空格。
|
2. 在“脚本名称”字段中，输入要作为指令添加的脚本名称。
3. 要将指令添加到指令列表，请单击“添加”。
重新启动
要定义代理重新启动指令，请完成以下步骤：
1. 要终止当前代理进程并启动新的代理进程，请选中“硬重启。若取消选中，则软重启”复选框。
如果不希望终止当前代理进程，而重新初始化所有组件并从磁盘重新加载数据，请确保清空“硬重启。若取消选中，则软重启”复选框。
2. 要将指令添加到指令列表，请单击“添加”。
|
|
请确保“重新启动”指令是指令列表中的最后一个指令。
|
运行脚本
要定义一个指令，用于运行可部署到 Axeda 代理程序的一个或多个资产上的已注册脚本，请完成以下步骤：
1. 在“脚本名称”字段中，输入要运行的脚本名称。
2. 要将指令添加到指令列表，请单击“添加”。
设置属性
要定义在远程资产上设置指定属性值的指令，请完成以下步骤：
1. 在“属性名称”和“属性值”字段中，指定属性的名称和值。
|
|
属性名称是 ThingWorx Composer 中的事物属性名称。事物属性名称必须正确映射到远程属性名称，才能使“设置属性”指令正常工作。远程属性名称将被发送到资产。
如果未将事物属性配置为远程，或者缺少指定的事物属性，则部署将被标记为不合格。
|
2. 要将指令添加到指令列表，请单击“添加”。
取消注册脚本
要定义指令以取消注册 Axeda 代理程序的一个或多个资产的脚本，请完成以下步骤：
1. 在“脚本名称”字段中，输入要取消注册的脚本名称。
2. 要将指令添加到指令列表，请单击“添加”。
上载
要定义使 Axeda eMessage 代理将一个或多个文件上传到 ThingWorx Platform 的指令，请完成以下步骤：
1. 在“目标信息库”字段中，单击 以选择上传文件的目标信息库。
以选择上传文件的目标信息库。可创建专门的上传文件信息库，例如 UploadRepository。
2. 在“目标路径”字段中，指定要在存储库中保存上载文件的位置。
例如，输入 /UploadFiles 会将文件保存到 /UploadRepository/UploadFiles 目录。
如果输入 /，则上传的文件将保存到您在步骤 1 中定义的信息库。
|
|
这些文件保存在以上传文件的事物命名的目录下。此目录位于“目标信息库”或“目标路径”字段值所表示的目录下。
例如，如果包部署到 MyThing 事物，并且“目标信息库”和“目标路径”字段值是 /UploadRepository/UploadFiles，则文件上传至 /UploadRepository/UploadFiles/MyThing 目录。
|
|
|
如果“目标路径”字段中指定的位置不存在，则系统会在部署过程中在“目标信息库”下创建该位置。
|
3. 在“要上传的文件”字段中，输入要上传的文件的名称，然后单击 
。请确保此文件存在于设备的相对路径中。
。请确保此文件存在于设备的相对路径中。如果要在成功部署包后从信息库中删除文件，请选中“上传后删除文件”复选框，然后单击
可以在文件名中包括通配符，例如 * 或 ?。* 表示多个字符，? 表示单个字符。对于在 Windows 上运行的代理程序，? 字符与 * 字符返回的结果相同。
4. “要上传的文件”字段下的表格显示要上传到 ThingWorx Platform 的文件列表及其“上传后删除文件”状况。在此表格中，您可以执行以下操作：
◦ 如果要从列表中移除任何文件，请选择列表中的条目，然后单击“移除”。要选择所有文件，请选中工具栏中“文件名”旁的复选框。
◦ 如果要更改文件的“上传后删除文件”状况，请单击 
，并根据需要选中或清除“上传后删除文件”复选框。
，并根据需要选中或清除“上传后删除文件”复选框。5. 要将指令添加到指令列表，请单击“添加”。