已发布数据
发布日期: 2016年3月
适用于: System Center 2012 SP1 - Orchestrator,System Center 2012 - Orchestrator,System Center 2012 R2 Orchestrator
已发布数据允许活动使用相同 Runbook 内其他活动中的信息。 每个活动都具有在运行后填写的特定一组已发布数据项。 工作流中在该活动之后运行的任何其他活动都可以访问此数据。 除了特定于每个活动的数据之外,所有活动都会发布一组通用的数据项,这些数据项提供诸如活动的开始和结束时间及其完成状态之类的信息。 链接条件也使用已发布数据向 Runbook 中添加筛选和决策功能。
例如,Runbook 可能会使用“读取行”活动从文本文件中获取信息。 Runbook 中后面的“发送电子邮件”活动必须使用要在其邮件文本中包括的信息。 “发送电子邮件”活动可以使用“读取行”活动中的“行文本”已发布数据项以包含在其邮件中。
数据类型
下表描述了已发布数据值类型的类别。
已发布数据值类型 | 描述 |
---|---|
字符串值 | 文本,例如,错误消息描述。 |
日期值 | 日期和时间信息。 例如,特定错误的发生日期和时间。 |
数字值 | 数值信息。 例如,数据库查询返回的行数。 |
布尔值 | “真”或“假”。 例如,命令已完成。 |
日期和时间特征
“活动开始时间”和“活动结束时间”数据保存在数据总线内的两个字段中。 这些格式均为 ISO 8601 格式的本地时间和协调世界时 (UTC)。 通过使用 UTC,Runbook 可以在非区域设置特定的上下文或非时区特定的上下文中运行。 只有保存到数据总线的已发布数据才以 ISO 8601 格式提供 UTC 日期和时间信息。
Runbook Designer 和 Orchestration 控制台中显示的日期和时间值(包括但不限于日志历史记录、审核历史记录和事件)遵循为计算机配置的区域设置日期和时间格式。
包含多值类型的已发布数据
当 Runbook 中的活动运行时,它将为上一个活动生成的每个数据项运行一次。 例如,“查询数据库”活动运行并从数据库中检索三行。 这三行数据使下一个活动运行三次,各为返回的每一行运行一次。 此下一个活动不必订阅数据即可进行此操作。
活动还可以从外部源中检索信息。 “获取”活动和“监视”活动演示此行为。 例如,从活动输出的数据可能是计算机的列表。 数据可作为多个单独的输出继续传递,这些输出根据输出中的项数调用下一次活动多次。
你还可以选择以单一输出的形式继续传递数据。 有关如何配置包含多个值的已发布数据的信息,请参阅通用活动属性。
向活动配置中添加已返回数据
当活动订阅了已发布数据后,会在将添加数据值的位置插入一个占位符。 活动只能订阅工作流内上一个活动中的已发布数据。
使用以下过程来向活动中添加已发布数据、更改已发布数据订阅,以及复制和粘贴已发布数据项。
订阅工作流内早期活动的已发布数据。
右键单击 Runbook 中的活动以选择“属性”,然后单击“详细信息”选项卡以打开活动属性对话框。
要打开菜单,请在文本框中右键单击以选择“订阅”,然后单击“已发布数据”以打开“已发布数据”对话框。
在“活动”列表中,选择返回你要订阅的数据的活动。 默认情况下,对话框只会显示特定于该活动的已发布数据。 要包括所有活动共有的已发布数据,请单击“显示常用已发布数据”。
选择要使用的“已发布数据”项,然后单击“确定”。
更改已发布数据订阅
在文本框中,单击数据占位符以打开“已发布数据”对话框。
在“活动”下拉列表中,单击返回你要订阅的数据的活动。 默认情况下,对话框只会显示特定于该活动的已发布数据。 要包括所有活动共有的已发布数据,请单击“显示常用已发布数据”。
单击要使用的“已发布数据”项,然后单击“确定”。 已发布数据占位符将更改以反映你选择的新活动和已发布数据。
复制和粘贴已发布数据项
在活动的“属性”对话框中找到已插入到框中的已发布数据项。
选择要复制的已发布数据项。
使用键盘快捷方式 Ctrl+C,或右键单击所选项,然后单击“复制”。
打开要将已发布数据项复制到其中的“属性”对话框。
将光标置于你希望已发布数据项出现的位置,并使用键盘快捷方式 Ctrl+V,或右键单击插入点,然后单击“粘贴”。 已发布数据项将出现。
转换已发布数据项
在另一个活动中使用“已发布数据”活动中文本之前,你可能必须修改该文本。 例如,你可能必须删除部分文本或者将其替换为其他字符串。 你可以依据使用映射已发布的数据活动指定的规则将现有已发布数据内容或变量项转换为新内容。
常用已发布数据
下表描述了所有活动共有的已发布数据项。
Name | 描述 |
---|---|
活动 ID | 活动的唯一标识符。 例如,{4BD3F27A-8F1B-4F60-8245-F69469075EF1}。 |
活动名称 | 出现在工作区中的活动的名称。 如果你在工作区中自定义活动的名称,则自定义名称将出现在此处。 |
活动进程 ID | 运行活动的作业进程的进程 ID。 |
活动状态 | 运行活动的结果状态,例如,成功。 |
活动类型 | 活动的默认名称。 即使你在工作区中重命名活动,它也不会从默认值更改,在活动名称和显示图标已更改的 Runbook 中标识活动时,这可能非常有用。 |
错误摘要文本 | 活动返回的错误信息的摘要。 |
Runbook 名称 | Runbook 的名称。 |
Runbook 进程 ID | 在 Runbook 服务器上运行的 Runbook 模块可执行程序的进程 ID。 作业进程包含活动的逻辑。 它在 Runbook 服务器启动 Runbook 时启动,并在 Runbook 停止时停止。 每个 Runbook 都在它自己的作业进程可执行程序中运行。 |
服务器名称 | 运行 Runbook 的 Runbook 服务器的名称。 |
活动持续时间 | 活动运行的总时间。 |
活动结束时间 | 活动完成时的时间。 |
活动结束时间(年) | 活动完成时的年度。 |
活动结束时间(月) | 活动完成时的月份。 |
活动结束时间(日) | 活动完成时的日。 |
活动结束时间(工作日) | 活动完成时的工作日。 |
活动结束时间(小时) | 活动完成时的小时。 |
活动结束时间(分钟) | 活动完成时的小时分钟数。 |
活动结束时间(秒) | 活动完成时的分钟秒数。 |
UTC 格式的活动结束时间 | UTC 格式的活动完成时间。 |
UTC 格式的活动结束时间(年) | UTC 格式的活动完成年份。 |
UTC 格式的活动结束时间(月) | UTC 格式的活动完成月份。 |
UTC 格式的活动结束时间(日) | UTC 格式的活动完成日。 |
UTC 格式的活动结束时间(工作日) | UTC 格式的活动结束星期。 |
UTC 格式的活动结束时间(小时) | UTC 格式的活动完成小时。 |
UTC 格式的活动结束时间(分钟) | UTC 格式的活动结束小时分钟数。 |
UTC 格式的活动结束时间(秒) | UTC 格式的活动结束分钟秒数。 |
活动开始时间 | 活动的开始时的时间。 |
UTC 格式的活动开始时间 | UTC 格式的活动开始时间。 |
循环:尝试的时间间隔 | 每次循环尝试之间的时间量(以秒为单位)。 |
循环:Enabled | 用于确定是否为活动启用按活动循环的设置。 |
循环:循环错误消息 | 循环未成功的情况下的错误消息。 |
循环:尝试次数 | 循环已经过的迭代次数。 |
活动所属的 Runbook 的名称。 | |
循环:总持续时间 | 循环的活动运行的总时间量(以秒为单位)。 |