# 在仪表板中使用直连模型

本章将详细介绍Wyn中仪表板使用直连模型的操作流程。

## Content

## 1\. 概述

### 1.1 功能概述

**直连模型已成功创建后，可无缝在仪表板中使用**。本节将详细介绍如何在仪表板中使用直连模型进行数据展示。

## 2.操作步骤

### 2.1 前提条件

1. **数据源：** 确保系统已成功创建可用的直连模型。

### 2.2 操作步骤

直连模型通过**实时数据库连接**，确保仪表板中的数据实时更新，让您随时洞察最新业务动态。
**步骤一：创建仪表板并添加直连模型文档**

1. 在**文档门户**页面，单击**工作空间**进入文档列表，选中**仪表板**，进入仪表板列表，在该界面单击 **+创建仪表板** 按钮，即可进入仪表板模板选择界面，然后选择**空白仪表板**，单击**创建**按钮，进入仪表板设计界面。
    ![PixPin_2025-10-23_11-39-00](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/53718c5b-c627-4bb8-afaf-3db83ed6dcd8/PixPin_2025-10-23_11-39-00.42ecb7.png?width=700)
2. 仪表板设计界面，单击右上角的**数据绑定**，然后单击**添加**按钮，快速搜索已经创建好的直连模型文档，文档名称为直连模型Test。
    ![PixPin_2025-10-23_15-11-01](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/53718c5b-c627-4bb8-afaf-3db83ed6dcd8/PixPin_2025-10-23_15-11-01.a979f0.png?width=700)
3. 选中模型文档后，数据绑定栏将显示所选文档的信息。

* **左侧：** 显示直连模型的文档名称。
* **右侧：** 显示直连模型的所有表。
    ![PixPin_2025-04-10_09-37-28](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/f5870867-da83-4de9-a405-f6a43930a548/PixPin_2025-04-10_09-37-28.247d92.png?width=400)

**步骤二：添加可视化组件**
直连模型创建完成后，在仪表板设计器界面，可使用设计器中的任意组件来进行数据可视化呈现，以下示例通过饼图组件展示所有大区的促销金额。

1. 仪表板设计器界面左侧的可视化区，选择**组件**，然后选择**基础图表**下的的**柱状图**组件，将其拖拽至仪表板设计器区域。
    ![PixPin_2025-10-24_10-18-48](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/53718c5b-c627-4bb8-afaf-3db83ed6dcd8/PixPin_2025-10-24_10-18-48.e00c3f.png?width=700)

**步骤三：绑定数据**

1. 数据绑定下拉列表中，选中直连模型（如“直连模型Test“），并将数据集中的`大区`字段拖拽绑定到饼图组件的系列，将`销售预算`字段拖拽绑定到饼图组件的数值。
    ![饼图绑定](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/53718c5b-c627-4bb8-afaf-3db83ed6dcd8/%E9%A5%BC%E5%9B%BE%E7%BB%91%E5%AE%9A.1330ee.gif?width=700)
    如上动图所示，可视化组件支持从多个关联模型表中选取字段，但某些表字段会因过滤关系约束而变为禁用状态，这体现了底层数据模型的关联规则。

* **绑定说明：** 在仪表板设计中，当我们将字段绑定至可视化组件时，其可用性遵循数据模型的过滤关系约束。这种约束的本质是：**只有存在直接或间接过滤关系的表字段，才能在同一图表中作为维度（分类/系列）和数值组合使用**。
* **绑定关系法则：**
    * **法则一：维度绑定决定数值范围**
        * 维度区绑定的字段所在表，必须能通过关系链“到达”（过滤）数值区字段的表
        * 多维度字段绑定时，数值区表必须同时被所有维度表过滤
    * **法则二：数值绑定影响维度选择**
        * 数值区绑定的字段会反向约束维度区选择
        * 多数值字段绑定时，维度区表必须能过滤所有数值表
    * **法则三：数值字段间的特殊关系**
        * 多个数值字段可自由组合 (无需互相过滤)
        * 但后续添加维度字段时需满足对全部数值表的过滤关系
* 以上述饼图绑定为例：
    * 当我们将销售大区表的大区字段绑定到系列时，数值区域可以绑定销售预算、组织结构、门店信息、订单、订单明细这些表中的任意字段作为数值。这是因为在数据模型中，销售大区表能通过关系箭头过滤这些表。
    * ![image](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/48444c3b-4b5b-453e-9c49-487ccec1706e/image-20260616.c13f71.png?width=700)
* 为帮助您更直观地掌握这些规则，下面将通过几个典型示例，结合数据模型关系图进行对照解析。

    | **绑定字段** | **说明** | **数据模型关系对照图** |
    | ---- | --- | --------- |
    | **绑定一个维度字段** | 当您将`订单`表的`支付方式`设为分类后，数值区仅限`订单明细`表字段（受模型关系约束），但其他表仍可用于其他维度区域。 | ![image](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/48444c3b-4b5b-453e-9c49-487ccec1706e/image-20260616.aace3a.png?width=500) |
    | **绑定多个维度字段** | 当同时将`商品信息表`的`分类编号`和`订单表`的`购买渠道`设为维度时，数值区仅支持绑定订单明细表字段——因为在数据模型中，`订单明细表`是唯一同时被 `商品信息表`和`订单表`过滤的中间表。 | ![image](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/48444c3b-4b5b-453e-9c49-487ccec1706e/image-20260616.39f1ec.png?width=500) |
    | **绑定一个数值字段** | 当您将`会员表`字段绑定到数值区时，维度区仅允许绑定同表字段——这是因为`会员表`位于模型关系链的末端，没有其他表能过滤它。反之，若改用`订单明细表`作为数值源（作为模型关系网的根节点），则除`销售预算表`外的所有关联表字段都可作为维度使用，完整呈现数据模型的层级关系。 | ![image](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/48444c3b-4b5b-453e-9c49-487ccec1706e/image-20260616.9864c6.png?width=500) |
    | @rows=3:**绑定多个数值字段** | 当同时绑定`商品信息表`和`订单表`字段到数值区时，维度区将无可用选项——因为模型中不存在能同时过滤这两个表的公共上游表。 | ![image](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/48444c3b-4b5b-453e-9c49-487ccec1706e/image-20260616.34b887.png?width=500) |
    | 当使用`商品信息表`和`订单明细表`组合作为数值源，则可选用`商品分类表`或`商品信息表`作为维度（二者均可过滤这两个数值表）。 | ![image](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/48444c3b-4b5b-453e-9c49-487ccec1706e/image-20260616.121175.png?width=500) |
    | 当使用`商品信息表`和`订单明细表`组合作为数值源，使用`商品分类表`作为维度后，界面将智能禁用`会员/订单/门店信息/组织结构/销售大区/销售预算/预算日期表`字段，因其既无法被`商品分类表`表过滤，也无法同时过滤`商品信息表`和`订单明细表`，此时`商品信息表、订单明细表和商品分类表`已形成完整的查询树结构。 | ![image](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/48444c3b-4b5b-453e-9c49-487ccec1706e/image-20260616.ed0727.png?width=700) |

**步骤四：查看仪表板**

1. 完成设置后，保存仪表板并关闭仪表板设计器。
2. 文档门户，单击「**工作空间>仪表板**」，找到刚才保存的仪表板，单击**仪表板名称进行预览**，即可查看仪表板的具体信息。
    ![PixPin_2025-04-10_10-00-31](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/f5870867-da83-4de9-a405-f6a43930a548/PixPin_2025-04-10_10-00-31.2231eb.png?width=500)

%PRODUCT\_NAME% 成功创建仪表板后，可以在「**文档门户>工作空间>仪表板**」列表中找到创建成功的仪表板。单击名称即可预览文档，也可以对文档进行其他管理操作。更多介绍，请见[文档门户](/solutions/wyn/help/docs/portal-intro)。

## 3\. 注意事项

1. 直连模型仅限仪表板使用，在报表中尚不可用。
2. **维度显示控制：**

* **默认行为：** 当维度表（如产品表）包含4类产品，但事实表（如销售表）仅有部分产品销售记录时，默认自动过滤无数据的维度项。
    ![PixPin_2025-04-10_13-44-36](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/f5870867-da83-4de9-a405-f6a43930a548/PixPin_2025-04-10_13-44-36.e522af.png?width=700)
* **全维度显示：** 需展示维度表所有值（含无数据项），可在组件的数据设置属性中开启**显示维度所有内容**属性。
    ![PixPin_2025-04-10_13-45-43](https://gccndocumentsitestorage.blob.core.chinacloudapi.cn/document-site-files/images/f5870867-da83-4de9-a405-f6a43930a548/PixPin_2025-04-10_13-45-43.32efec.png?width=700)