数据排序

使用模板单元格中的排序选项，您可以按照希望的顺序对数据进行排序，比如升序、降序或自定义顺序。

要在报表模板中配置排序选项，您首先必须在 DataManager 中定义表源。然后，在模板单元格中配置dataColumn选项中的tableName和columnName，然后指定所需的sortOptions。

注意事项：

排序是在生成报表数据之前进行的，因此在生成报表数据后不能获取公式计算结果。
排序值必须以"="开始，以便使用sortByCell和sortByFormula方法，因为排序值始终是字符串。
sortByCell方法仅支持'=A1'格式，并不支持R1C1、绝对引用或自定义名称。

您可以通过多种方式对数据进行排序：

按列值排序数据

用户可以指定当前cellNode根据哪个数据列进行排序，然后currentNode和子节点将在currentNode父组内重新排序。列必须在当前节点绑定表中。

以下代码示例展示了如何在组/列表内排序，如何使用多个规则排序，以及如何在没有规则的情况下排序。

// Sort within the group.
// Sort by column "shipCounty" ascending.
templateSheet.setTemplateCell(2, 0, {
        type: "Group",
        binding: `Orders[shipCountry]`,
        sortOptions: [
            {
               asc: "shipCountry"
            }
        ]
});
// Sort within the list.
// Sort by column "customerId" descending.
templateSheet.setTemplateCell(2, 1, {
        type: "List",
        binding: `Orders[customerId]`,
        sortOptions: [
           {
              dsc: "customerId"
           }
       ]
});

// Sort by multiple rules.
// Sort by column "shipCounty" then by "sales".
templateSheet.setTemplateCell(0, 0, {
    type: "List",
    binding: `Orders[shipCountry]`,
    sortOptions: [
      {
          asc: "shipCountry"
      },
      {
          asc: "sales"
      }
    ]
});

// Default (no sorting applied).
templateSheet.setTemplateCell(2, 2, {
       type: "List",
       binding: `Orders[freight]`
});

按单元格值排序

用户可以指定当前单元节点（cellNode）根据哪个单元节点值进行排序，该单元节点值必须是当前单元节点的子节点。

注意：
如果所引用的单元节点中有多个值，则将使用第一个值。
如果所引用的单元节点是当前单元节点本身，则会按当前单元格值排序。

以下代码示例展示了如何按单元格值排序。

// Sort by the B3 cell value.
templateSheet.setTemplateCell(2, 0, {
      type: "Group",
      binding: `Products[ProductName]`,
      sortOptions: [
          {
              asc: "=B3"
          }
     ]
});

templateSheet.setTemplateCell(2, 1, {
      type: "List",
      binding: `Products[UnitsInStock]`,
});

按公式值排序

用户可以使用公式作为排序选项，按公式计算结果对数据进行排序。公式必须以“=”符号开头。

以下代码示例展示了如何按公式值排序。

// Sort by the "=YEAR([@OrderDate])&\"/\"&MONTH([@OrderDate])" formula.
templateSheet.setTemplateCell(3, 0, {
           type: "Group",
           binding: `Orders[orderDate]`,
           "formula": "=YEAR([@OrderDate])&\"/\"&MONTH([@OrderDate])",  // Formula
           "sortOptions": [
                    {
                        "desc": "=YEAR([@OrderDate])"
                    },
                    {
                        "asc": "=MONTH([@OrderDate])",
                        // Custom list.
                        "list": [
                            4,
                            5,
                            6,
                            7,
                            8,
                            9,
                            10,
                            11,
                            12,
                            1,
                            2,
                            3
                        ]
                    }
           ]
});

templateSheet.setTemplateCell(3, 1, {
         type: "List",
         binding: `Orders[freight]`,
});

按列表值排序

用户可以在每个排序选项中使用指定的值数组，然后排序结果将按照列表的顺序以及升序/降序排列。

以下代码示例展示了如何根据列表值对数据进行排序。

// Sort by the "Product" in the list ["Tofu", "Thin Bread", "Ikura Caviar"].
// The rest of the products are in the ascending order. 
templateSheet.setTemplateCell(3, 0, {
       type: "List",
       binding: `Products[Id]`,
       sortOptions: [
             {
                 asc: "=B4",
                 list: ["Tofu", "Thin Bread", "Ikura Caviar"]
             },
       ]
});
templateSheet.setTemplateCell(3, 1, {
        type: "Group",
        binding: `Products[ProductName]`,
});
templateSheet.setTemplateCell(3, 2, {
        type: "List",
        binding: `Products[UnitPrice]`,
});

使用设计器排序单元格数据

您也可以通过使用报表单元格属性面板中可用的排序选项，通过设计器对数据进行排序。点击添加按钮来创建排序规则。您可以更改排序顺序为升序或降序，按列或单元格对数据进行排序，甚至可以使用自定义列表选项设置自定义排序列表。您还可以点击上移/下移/删除按钮来重新排列或删除排序规则。