1 概述

Python组件支持编写代码自定义复杂的数据可视化效果，灵活拓展分析展示能力。另外，也可以在使用AIChat问数过程中，将高频数据问答结果一键转化为仪表盘的Python组件，生成主题看板。

2 业务场景

2.1 自定义复杂组件样式

1、场景描述：通过编写Python代码自定义复杂的数据可视化效果。

2、操作步骤

（1）在仪表盘的组件中，点击 + 添加 Python 组件，如下图所示：

（2）在代码编辑器中，输入所需的Python代码，如下图所示：

示例的Python代码如下：

import plotly.graph_objects as go

# 查询2023年各区域的销售额
sql_json = {"sel": ["商店所在区域", "销售额"], "from": "销售表", "conds": [${销售_年}]}
df_sales = detail_trend_data_query_assistant(sql_json)

# 按照销售额降序排序
df_sorted = df_sales.sort_values(by='销售额', ascending=False)

# 使用柱状图展示数据
fig = go.Figure(data=[go.Bar(
    x=df_sorted['商店所在区域'],
    y=df_sorted['销售额'],
    text=df_sorted['销售额'],
    textposition='auto'
)])

# 设置图表标题和坐标轴标签
fig.update_layout(
    title_text="2023年各区域销售额",
    title_x=0.5,
    xaxis_title="区域",
    yaxis_title="销售额"
)

# 输出需要的结果，并且将结果按照json格式输出
import json

json_result = json.dumps([{"output_variable_name": "fig", "type": "plotly", "desc": "2023年各区域销售额柱状图"}])
json_result

（3）点击 运行 ，可查看效果：

2.2 添加AI问数结果到仪表盘中

1、场景描述：在使用AIChat问数过程中，将高频数据问答结果一键转化为仪表盘的Python组件，生成主题看板。

2、操作步骤

（1）将AI问数结果添加到仪表盘的操作入口有两个，如下图所示：

• 入口1：AIChat主界面中

• 入口2：在仪表盘编辑界面工具栏的AI问答中

（2）输入问句，得到问数结果，如下图所示，AIChat的使用说明详见：AIChat 白泽帮助中心。

（3）点击 添加到仪表盘 按钮，将问数结果添加到仪表盘中，如下图所示：

• 将问数结果的条件转换成仪表盘的筛选器组件
• 问数的图文内容转换成仪表盘的Python组件，支持点击 图标，编辑Python代码变更Python组件效果
• 支持切换筛选器的选中值，刷新Python组件的数据

3 更多功能

• 更多的组件属性设置项的详细介绍，可参考文档： 组件设置 。

4 注意事项

1、不支持多选问数结果插入到仪表盘。

2、Python组件本身不支持绑定字段，仅支持通过接口获取动态数据，或在代码中写静态数据。

3、Python组件编辑器不支持Ctrl+F搜索。

4、仅支持将 分析模式 下的问数结果添加到仪表盘中，不支持专家模式、不支持报表查询模式。

5、Python组件内容样式，仅支持通过Python代码修改，仪表盘无相关的样式设置项。