publish() 方法

将 Pandas 或 HCL 数据帧发送到活动中心数据集。

语法

hcl.publish(dataframe_name, table_name = AC_dataset_name, column_names = {"column_name":"dataset_display_name", "...n":"...n"}|dictionary_object, append = True|False)

AC = 活动中心

参数

名称	描述
dataframe_name	要保存到活动中心的 Pandas 或 HCL 数据帧的名称。 将保存数据帧中的所有列。如果您只想保存选定的列，请先适当配置的数据帧，然后再使用 publish()。
table_name = AC_dataset_name	活动中心数据集的名称。 说明 查看活动中心中现有数据集的名称，并确保指定的数据集名称是唯一的。publish() 方法不会阻止您指定重复的数据集名称，这可能会在活动中心中造成混乱的情况。
column_names = {"column_name" : "dataset_display_name", "...n" : "...n"} 可选	数据帧中的列名称与活动中心数据集中相应字段的显示名称之间的映射。 使用标准 Python 字典为一个或多个列构建该映射。 仅为目标活动中心数据集中的字段指定显示名称。活动中心中的基础字段名称保持不变。 您可以选择仅为列的子集指定显示名称。没有指定显示名称的列使用活动中心中的数据帧列名。 column_names 参数不选择要保存哪些列。默认情况下，publish() 方法会将数据帧中的所有列都保存到活动中心。 说明 确保您指定的显示名称是唯一的。publish() 方法不会阻止您指定重复的显示名称。但是，发布到活动中心将失败。 有关详细信息，请参阅列名称和显示名称必须是唯一的。
column_names = 字典对象 可选	预先存在的字典对象，将数据帧中一个或多个列名称映射到活动中心数据集中相应字段的显示名称。 作为在 publish() 内部创建列映射的替代解决方案，您可以在单独的字典中创建映射并仅在 publish() 内部指定该字典名称。如果您需要为活动中心中的多个目标数据集创建相同的显示名称集，则这种方法更有效。 在 publish() 内创建字典时适用的准则也适用于创建单独的字典时。
append = True | False	True 保存的数据被附加到活动中心数据集中的任何现有数据。 False 保存的数据覆盖活动中心数据集中的任何现有数据。 如果您省略该参数，则保存的数据默认覆盖所有现有数据。

返回

如果成功，则为返回码 202。如果失败，则返回错误消息。

返回代码 204 表示机器人应用程序已成功将数据发送到活动中心。在活动中心中成功处理后续数据后，从机器人应用程序发送的数据才能在数据中心中成为可用的数据集。

示例

备注

列名称和显示名称必须是唯一的

为了成功将数据从机器人应用程序发布到活动中心，数据帧列名必须是唯一的。如果数据帧中出现重复的列名，将会导致 publish() 方法失败，并显示错误消息。

如果为活动中心数据集中的字段指定显示名称，则显示名称也必须是唯一的。重复的显示名不会导致 publish() 方法失败，并且包含该方法的脚本也会运行到完成。但是，后续的数据处理将会失败，且向活动中心的发布也不成功。

发布能力范围

从机器人应用程序创建的活动中心数据集的写入权限基于机器人。要更新数据集，必须使用最初创建数据集的机器人。publish() 方法不支持跨机器人更新数据集。

自动添加发布日期和时间

publish() 方法自动包含发送到活动中心的数据的发布日期和时间。当您将数据作为表添加到活动中心中的分析和仪表板中时，将包括发布时间字段，以显示并动态更新表中每个记录的最新发布日期和时间。

此时间戳信息对于验证来自机器人应用程序的计划发布是否在预期的日期和时间执行非常有用。如果将记录追加到数据集，时间戳信息还会显示每条记录追加的时间，并允许您按时间戳进行排序。