to_hb_results() 方法

将 HCL 数据帧保存至结果应用程序表。

说明

使用 to_hb_results() 方法还需要在 HCL 脚本编辑器的变量窗口中创建一个名为 v_hb_token 的密码变量,并分配一个 HighBond API 令牌作为变量值。有关详细信息,请参阅使用变量窗口定义 HCL 变量

语法

数据帧名称.to_hb_results(table_id = 结果应用程序表 ID 编号, column_names = {"列名称":"结果应用程序显示名称", "...n":"...n"}|字典对象, overwrite = True|False)

参数

名称 描述
table_id = 结果应用程序表 ID 编号 结果应用程序表中的数值 ID。
column_names = {"列名称" : "结果应用程序显示名称", "...n" : "...n"}

可选

数据帧中的列名称与结果应用程序中相应字段的显示名称之间的映射。

使用标准 Python 字典为一个或多个列构建该映射。

仅为目标结果应用程序表中的字段指定显示名称。结果应用程序中的基础字段名称保持不变。

column_names = 字典对象

可选

预先存在的字典对象,将数据帧中一个或多个列名称映射到结果应用程序中相应字段的显示名称。

作为在 to_hb_results() 中创建列映射的替代解决方案,您可以在单独的字典中创建映射并仅在 to_hb_results() 中指定该字典名称。如果您需要为结果应用程序中的多个目标表创建相同的显示名称集,则这种方法更有效。

仅为目标结果应用程序表中的字段指定显示名称。结果应用程序中的基础字段名称保持不变。

overwrite = True | False
  • True 保存的数据覆盖结果应用程序表中的任何现有数据。
  • False 保存的数据被附加到结果应用程序表中的任何现有数据。

如果您省略该参数,则保存的数据被默认附加。

返回

如果成功,则为返回码 202。对于失败,返回一个错误消息。

示例

将数据帧保存至结果应用程序表

您将 customer_summary 数据帧保存至具有 ID 587293 的结果应用程序表。结果应用程序表中的任何现有记录都被覆盖。

customer_summary.to_hb_results(table_id = "587293", overwrite = True)

保存数据帧并在结果应用程序中创建字段显示名称

您将 customer_summary 数据帧保存至具有 ID 587293 的结果应用程序表。与此同时,为目标结果应用程序表中的字段创建三个显示名称。

在结果应用程序中:

  • No 字段使用 Customer Number 显示名称
  • First 字段使用 First Name 显示名称
  • Last 字段使用 Last Name 显示名称
customer_summary.to_hb_results(table_id = "587293", column_names = {"No":"Customer Number", "First":"First Name", "Last":"Last Name"}, overwrite = True)

使用预先存在的字典,保存多个数据帧并创建字段显示名称

使用单个字典对象 ( display_names ) 在三个结果应用程序表中创建相同的显示名称集。

display_names = {"No":"Customer Number", "First":"First Name", "Last":"Last Name"}
customer_summary_us.to_hb_results(table_id = "587293", column_names = display_names, overwrite = True)
customer_summary_eu.to_hb_results(table_id = "587294", column_names = display_names, overwrite = True)
customer_summary_ap.to_hb_results(table_id = "587295", column_names = display_names, overwrite = True)

备注

数据类型映射

当您将 HCL 数据帧保存到结果应用程序表时,数据帧中的列数据类型会自动映射到表中的字段数据类型:

HCL 数据帧中的列数据类型 结果应用程序表中的字段数据类型
对象 字符
类别 字符
int64 数值
float64 数值
datetime64[ns] 日期时间
timedelta64[ns] 数值
布尔 逻辑

自动移除元数据和附加字段

如果数据分析工作流在结果应用程序与机器人应用程序之间往返保存数据(即,从结果应用程序保存到机器人应用程序,以及再保存回结果应用程序),则会自动从保存回结果应用程序的数据中移除 HCL 数据帧中的 metadataextras 字段。无论是将 HCL 数据帧保存回结果应用程序中的相同表或新表,都会移除这些字段。

metadataextras 字段均为结果应用程序中系统生成的字段并受到保护。只能在结果应用程序中编辑这些字段中的内容(如果可编辑)。因此,您的操作会阻止从机器人将这些内容覆盖或附加到这些字段。

说明

将往返数据保存回结果应用程序时,metadataextras 字段会与保存的数据一起出现。但是,这些新字段是由结果应用程序自动创建,而不是机器人中存在的字段。

如果以下 metadataextras 字段存在于机器人中,则会自动从保存的数据中移除:

  • metadata.priority

  • metadata.status

  • metadata.publish_date

  • metadata.publisher

  • metadata.assignee

  • metadata.group

  • metadata.updated_at

  • metadata.closed_at

  • extras.record_id

  • extras.collection

  • extras.results_table