使用ssrs矩阵

要把原代码的 Excel 导出功能转成 SSRS 报表，报表设计是最核心的环节 —— 尤其是如何用 “数据集” 准备数据，用 “矩阵” 处理动态列（比如不确定数量的维度），这部分很容易 confusion，下面用 “大白话 + 实例” 讲透。

先明确一个核心目标

报表最终要长成这样（和原 Excel 一致）：

plaintext

┌───────────┬───────────┬───────────┬───────────┬───────────┬...（其他余额列）
│ 维度1名称  │ 维度2名称  │ 科目描述   │ 交易币种   │ 期初本位币 │
├───────────┼───────────┼───────────┼───────────┼───────────┼
│ 维度1值    │ 维度2值    │ 银行存款   │ CNY       │ 1000.00   │
│ 维度1值    │ 维度2值    │ 应收账款   │ USD       │ 2000.00   │
└───────────┴───────────┴───────────┴───────────┴───────────┘

其中，“维度 1、维度 2” 的数量不固定（可能 1 个，也可能 5 个，取决于系统配置的财务维度集），这就是 “动态列”；“科目描述、币种、余额” 是固定不变的列。

一、数据集：报表的数据 “粮仓”

数据集（Dataset）就是报表的 “数据源”，相当于提前把要显示的数据整理成一张 “表格”，报表里的文字、数字都从这张 “表格” 里取。

原代码里的数据存在临时表ledgerTrialBalanceTmp中，SSRS 报表也需要基于这张表做数据集，但要拆成两个：一个存实际业务数据，一个存动态维度的名称。

1. 主数据集（MainDataset）：存业务数据

作用：存储所有要显示的行数据（比如每一行的维度值、科目描述、各种余额）。

怎么来的？对应原代码的generateData方法 —— 通过LedgerTrialBalanceTmp::calculateBalances_V2生成的ledgerTrialBalanceTmp临时表。我们只需要把这张表的字段 “挑出来” 做成数据集。

具体字段（必须包含这些）：

字段类别	例子（对应原代码）	说明
动态维度值	DimensionValues1、DimensionValues2...	第 1 个维度的值、第 2 个维度的值（最多 N 个）
固定基础信息	PrimaryFocusDescription（科目描述）	原代码里的科目文本
固定基础信息	YMZTransactionCurrency（交易币种）	原代码里的币种字段
余额数据	YMZOpeningBalanceBaseCurrency（期初本位币）	原代码里的余额字段
其他余额数据	借方 / 贷方 / 期末的本位币、交易币字段	同上，按原代码字段一一对应

配置方法：在 D365 的报表设计工具（如 Visual Studio 的 Report Designer）中，新建一个数据集，数据源选 “查询”，然后选我们提前建好的YMZLedgerTrialBalanceQuery（这个查询关联了ledgerTrialBalanceTmp临时表，并包含上述所有字段）。

2. 维度信息数据集（DimSegmentsDataset）：存动态维度的名称

作用：告诉报表 “有多少个维度”“每个维度叫什么名字”（比如 “部门”“成本中心”），用于动态生成表头。

怎么来的？对应原代码的dimensionSetSegmentNames—— 从DimensionHierarchyLevel::getDimensionHierarchyLevelNames获取的维度名称。我们需要把这些名称和对应的序号（第 1 个、第 2 个）做成数据集。

具体字段：

字段名	说明
SegmentNumber	维度序号（1、2、3...）
SegmentName	维度名称（如 “部门”“成本中心”）

配置方法：新建一个数据集，数据源可以是自定义的方法（X++），比如写一个方法getDimensionSegments()，返回包含上述字段的临时表（里面存着当前配置的维度序号和名称）。

二、矩阵（Matrix）：处理动态列的 “神器”

报表里的 “动态维度列”（数量不固定）必须用矩阵组件来做。矩阵和 Excel 的 “数据透视表” 很像，能根据数据自动生成列（或行）。

如果用普通的 “表格” 组件，列数是固定的，没法应对 “有时 3 个维度，有时 5 个维度” 的情况；而矩阵的 “列组” 可以动态生成列，完美解决这个问题。

矩阵的核心结构（先看懂这个再动手）

矩阵有 3 个核心区域，对应到我们的报表需求：

plaintext

┌───────────────────────────────────── 列组（动态维度列） ─────────────────────────────────────┐
│  ┌───────────┐  ┌───────────┐  ┌───────────┐                                                │
│  │ 维度1名称  │  │ 维度2名称  │  │ 维度3名称  │  ...（固定列：科目描述、币种、余额...）        │
│  └───────────┘  └───────────┘  └───────────┘                                                │
├────────────────────────────────── 数据区域（维度值） ──────────────────────────────────────┤
│  ┌───────────┐  ┌───────────┐  ┌───────────┐                                                │
│  │ 维度1值    │  │ 维度2值    │  │ 维度3值    │  ...（固定列的值）                           │
│  └───────────┘  └───────────┘  └───────────┘                                                │
└─────────────────────────────────────────────────────────────────────────────────────────────┘
行组（这里不需要额外分组，默认一行一条数据）

• 列组（Column Group）：控制 “动态维度列” 的表头（显示维度名称），由DimSegmentsDataset的SegmentNumber和SegmentName驱动。
• 数据区域（Data）：填充动态维度列的值（比如 “维度 1 值”“维度 2 值”），从MainDataset的DimensionValues1等字段取。
• 行组（Row Group）：这里不需要分组（因为每一行就是一条独立的数据），保持默认即可。

手把手配置矩阵（以 “3 个维度” 为例）

假设系统当前配置了 3 个维度（部门、成本中心、项目），我们一步步让矩阵显示这 3 列。

步骤 1：添加矩阵到报表

在 Report Designer 的 “工具箱” 里拖一个 “Matrix” 到报表主体（Body）中，会看到默认的矩阵结构：

plaintext

┌────────────┬────────────┐
│ [列组]     │ [数据]     │
├────────────┼────────────┤
│ [行组]     │ [数据]     │
└────────────┴────────────┘

步骤 2：配置列组（动态显示维度名称）

目标：让列组根据DimSegmentsDataset的SegmentNumber生成 3 列，每列的表头显示SegmentName（如 “部门”“成本中心”）。

• 右键矩阵的 “列组” 区域（默认显示 “[列组]” 的地方），选 “添加组”→“父组”。
• 在弹出的窗口中，“分组依据” 选DimSegmentsDataset的SegmentNumber（维度序号）。
• 勾选 “添加组头”，点确定。此时列组会生成一个基于SegmentNumber的分组。
• 把列组表头的文本框（默认显示[SegmentNumber]）改成[SegmentName]（从DimSegmentsDataset拖SegmentName字段到这里）。

此时列组会自动根据DimSegmentsDataset的数据生成列：如果有 3 个维度，就显示 3 列，表头分别是 “部门”“成本中心”“项目”。

步骤 3：配置数据区域（填充维度值）

目标：让动态列的单元格显示对应维度的值（如 “部门” 列显示DimensionValues1，“成本中心” 列显示DimensionValues2）。

• 矩阵中间的 “数据” 区域（默认显示[数据]的地方）需要根据 “当前维度序号” 动态取MainDataset的DimensionValuesN字段。
• 这里需要用 “表达式” 判断：如果SegmentNumber=1，就取DimensionValues1；SegmentNumber=2，就取DimensionValues2...
• 右键数据区域的文本框，选 “表达式”，输入：

  vb

  =Switch(Fields!SegmentNumber.Value = 1, Fields!DimensionValues1.Value,Fields!SegmentNumber.Value = 2, Fields!DimensionValues2.Value,Fields!SegmentNumber.Value = 3, Fields!DimensionValues3.Value-- 按系统最大维度数补充，比如最多10个就写到10
  )
  

  这个表达式的意思是：根据当前列的维度序号（1/2/3），显示对应的维度值字段。

步骤 4：添加固定列（科目描述、币种、余额等）

动态维度列配置完后，右侧需要添加固定列（和原 Excel 的固定列一致）。

• 右键矩阵的最右侧列，选 “插入列”→“在右侧”，插入新列（需要多少固定列就插多少）。
• 第一列固定列的表头：拖@SYS92116（原代码中的科目描述标签）到表头文本框。
• 该列的数据区域：拖MainDataset的PrimaryFocusDescription字段（科目描述的值）。
• 第二列固定列的表头：拖@SYS62786（原代码中的币种标签）到表头。
• 该列的数据区域：拖MainDataset的YMZTransactionCurrency字段（币种值）。
• 后续余额列（期初、借方、贷方等）以此类推：表头用原代码中的标签（如@YMZ:OpeningBalanceBaseCurrency），数据区域拖对应的余额字段（如YMZOpeningBalanceBaseCurrency）。

步骤 5：设置数字格式（余额字段必做）

原代码中余额字段是 “0.00” 格式，报表里也要保持一致：

• 右键余额字段的数据文本框（如[YMZOpeningBalanceBaseCurrency]），选 “文本框属性”。
• 切换到 “数字” 选项卡，选 “标准”，小数位数设为 “2”，点确定。

三、最终效果验证

配置完后，预览报表会看到：

• 动态维度列：根据系统配置的维度数量自动生成（比如 3 个维度就显示 3 列，表头是维度名称）。
• 动态列数据：每列显示对应维度的值（部门列显示部门值，成本中心列显示成本中心值）。
• 固定列：科目描述、币种、余额等字段按原格式显示，余额带 2 位小数。

和原 Excel 导出的效果完全一致，但更灵活（支持导出 PDF、打印等）。

关键总结

1. 数据集是 “粮仓”：主数据集存业务数据（维度值、余额等），维度数据集存动态列的名称和序号。
2. 矩阵是 “动态列工具”：用列组（基于维度序号）生成动态列，用表达式根据序号匹配维度值。
3. 固定列直接加：动态列右侧插固定列，绑定对应字段即可。