分析¶

d2.analyticsModule().analytics()
        .withDimension(new DimensionItem.DataItem.DataElementItem("fbfJHSPpUQD"))
        .withDimension（新 DimensionItem.PeriodItem.Relative（RelativePeriod.LAST_3_MONTHS））
        .withFilter(new DimensionItem.OrganisationUnitItem.Absolute("DiszpKrYNg8"))
        。评价（）;

`DimensionalResponse` 对象中包含的属性：

- **元数据**：它包含 ID 到`MetadataItem`的映射。 id 是标识数据元素、句点（相对或绝对）、orgunits 等的字符串。id 的一些示例是“fbfJHSPpUQD”、“202108”、“LAST_3_MONTHS”、“USER_ORGUNIT”、...。此映射的目的是从其他属性（dimensionItems、过滤器或值）中使用的任何 id 快速获取可打印表示。 `MetadataItem` 接口包含两个基本属性，`id` 和 `displayName`，它可以很容易地与底层类匹配，以获取有关 DataElement、Indicator、Period 等的更多信息。
- **维度**：维度的有序列表，其中的值被分解。在上面的示例中，第一个维度是 `Data`，这意味着 values 中的 `dimensions` 属性中的第一个维度属于 `Data` 维度。第二个是时期。
- **DimensionItems**：它包含按维度类型分组的项目映射。它包含最初用于构建查询的项目：在上面的示例中，时间段是相对的，因此 Period 维度包括相对时间段`LAST_3_MONTHS`。
- **过滤器**：在查询中充当过滤器的 ID 列表。
- **值**：`维度值`列表。每个值都包含定义该值的有序 ID 列表。在上面的示例中，值“17”对应于“ANC 第一次访问”（“fbfJHSPpUQD”）和“2021 年 8 月”（“202108”）。您可以使用元数据映射从这些 ID 中获取更多信息。

DimensionItems 可以用作维度或过滤器。同一维度的多个项目可以组合在同一个查询中。例如，此查询获取“ANC 第一次访问”（数据元素“fbfJHSPpUQD”）和“ANC 1-3 辍学率”（指标“ReUHfIn0pTQ”）按类别“位置：固定/外展”（类别“fMZEcRHuamy”）分解使用UserOrganisationUnit（相对组织单位）中最近 3 个月（相对期间）内的选项“固定”（CategoryOption“qkPbeWaFsnU”）和“外展”（CategoryOption“wbrDrL2aYEc”），按数据项 legendSet 对值进行分类并覆盖聚合类型:

```java
d2.analyticsModule().analytics()
        .withDimension(new DimensionItem.DataItem.DataElementItem("fbfJHSPpUQD"))
        .withDimension(new DimensionItem.DataItem.IndicatorItem("ReUHfIn0pTQ"))
        .withDimension(new DimensionItem.CategoryItem("fMZEcRHuamy", "qkPbeWaFsnU"))
        .withDimension(new DimensionItem.CategoryItem("fMZEcRHuamy", "wbrDrL2aYEc"))

        .withFilter（新 DimensionItem.PeriodItem.Relative（RelativePeriod.LAST_3_MONTHS））
        .withFilter(new DimensionItem.OrganisationUnitItem.Relative(RelativeOrganisationUnit.USER_ORGUNIT))

        .withLegendStrategy（AnalyticsLegendStrategy.ByDataItem.INSTANCE）

        .withAggregationType(AggregationType.LAST)

        。评价（）;

d2.analyticsModule().analytics()
        .withLegendStrategy(AnalyticsLegendStrategy.ByDataItem.INSTANCE) // 数据项使用自己的LegendSet
        .withLegendStrategy(AnalyticsLegendStrategy.None.INSTANCE) // 不使用 LegendSets
        .withLegendStrategy(new AnalyticsLegendStrategy.Fixed("fqs276KXCXi")) // 提供的 LegendSet 将用于所有数据项

d2.analyticsModule().visualizations()
        .withVisualization("SwtkWZFhrFQ")
        [.withPeriods()]
        [.withOrganisationUnits()]
        。评价（）;

GridAnalyticsResponse(
        metadata = mapOf(
            "fbfJHSPpUQD" to MetadataItem.DataElementItem、
            "cYeuwXTCPkU" to MetadataItem.DataElementItem、
            将 "fMZEcRHuamy "转至 MetadataItem.CategoryItem.DataElementItem
            将 "qkPbeWaFsnU "转至 MetadataItem.CategoryOptionItem、
            将 "wbrDrL2aYEc "改为 MetadataItem.CategoryOptionItem、
            将 "YuQRtpLP10I "更改为 MetadataItem.OrganisationUnitItem、
            将 "202108 "更改为 MetadataItem.PeriodItem、
            "202109" 转至 MetadataItem.PeriodItem、
            将 "202110 "更改为元数据项.周期项
        ),
        标题 = GridHeader(
            columns = listOf(
                listOf(
                    GridHeaderItem(id=fbfJHSPpUQD, weight=2)、
                    GridHeaderItem(id=cYeuwXTCPkU, weight=2)
                ),
                listOf(
                    GridHeaderItem(id=qkPbeWaFsnU, weight=1)、
                    GridHeaderItem(id=wbrDrL2aYEc, weight=1)、
                    GridHeaderItem(id=qkPbeWaFsnU, weight=1)、
                    GridHeaderItem(id=wbrDrL2aYEc, weight=1)
                )
            ),
            rows = listOf(
                listOf(
                    GridHeaderItem(id=202108, weight=1)、
                    GridHeaderItem(id=202109, weight=1)、
                    GridHeaderItem(id=202110, weight=1)
                )
            )
        ),
        dimensions = GridDimension(
            columns = listOf(
                Dimension.Data、
                Dimension.Category(uid=fMZEcRHuamy)
            ),
            行 = listOf(
                维度.周期
            )
        ),
        dimensionItems = mapOf(
            Dimension.Data to listOf(
                DimensionItem.DataItem.DataElementItem(uid=fbfJHSPpUQD)、
                DimensionItem.DataItem.DataElementItem(uid=cYeuwXTCPkU)
            ),
            Dimension.Period to listOf(
                DimensionItem.PeriodItem.Relative(relative=LAST_3_MONTHS)
            ),
            Dimension.Category(uid=fMZEcRHuamy) to listOf(
                DimensionItem.CategoryItem(uid=fMZEcRHuamy, categoryOption=qkPbeWaFsnU)、
                DimensionItem.CategoryItem(uid=fMZEcRHuamy, categoryOption=wbrDrL2aYEc)
            ),
            Dimension.OrganisationUnit 到 listOf(
                DimensionItem.OrganisationUnitItem.Absolute(uid=YuQRtpLP10I)
            )
        ),
        filters = listOf(
            "YuQRtpLP10I"
        ),
        值 = listOf(
            listOf(
                GridResponseValue(
                    columns=[fbfJHSPpUQD, qkPbeWaFsnU]、 
                    rows=[202108]、 
                    值=23
                ),
                GridesponseValue(
                    columns=[fbfJHSPpUQD, wbrDrL2aYEc]、 
                    rows=[202108]、 
                    value=3
                ),
                GridesponseValue(
                    columns=[cYeuwXTCPkU, qkPbeWaFsnU]、 
                    rows=[202108]、 
                    值=46
                ),
                GridesponseValue(
                    columns=[cYeuwXTCPkU, wbrDrL2aYEc]、 
                    rows=[202108]、 
                    值=3
                )
            ),
            listOf(
                GridesponseValue(
                    columns=[fbfJHSPpUQD, qkPbeWaFsnU]、 
                    rows=[202109]、 
                    值=21
                ),
                GridesponseValue(
                    columns=[fbfJHSPpUQD, wbrDrL2aYEc]、 
                    rows=[202109]、 
                    value=10
                ),
                GridesponseValue(
                    columns=[cYeuwXTCPkU, qkPbeWaFsnU]、 
                    rows=[202109]、 
                    值=23
                ),
                GridesponseValue(
                    columns=[cYeuwXTCPkU, wbrDrL2aYEc]、 
                    rows=[202109]、 
                    值=8
                )
            ),
            listOf(
                GridesponseValue(
                    columns=[fbfJHSPpUQD, qkPbeWaFsnU]、 
                    rows=[202110]、 
                    值=24
                ),
                GridesponseValue(
                    columns=[fbfJHSPpUQD, wbrDrL2aYEc]、 
                    rows=[202110]、 
                    value=1
                ),
                GridesponseValue(
                    columns=[cYeuwXTCPkU, qkPbeWaFsnU]、 
                    rows=[202110]、 
                    值=47
                ),
                GridesponseValue(
                    columns=[cYeuwXTCPkU, wbrDrL2aYEc]、 
                    rows=[202110]、 
                    值=2
                )
            )
        )
)

d2.analyticsModule().trackerLineList()
            .withEnrollmentOutput("fbfJHSPpUQD")
            .withFilter(
                TrackerLineListItem.ProgramStatusItem(
                    filters = listOf(
                        EnumFilter.EqualTo(EnrollmentStatus.ACTIVE.name)
                    )
                )
            )
            .withColumn(TrackerLineListItem.OrganisationUnitItem())
            .withColumn(
                TrackerLineListItem.ProgramAttribute(
                    uid = "p4mRWMtCxtB"、
                    filters = listOf(
                        DataFilter.GreaterThan("40")、
                        DataFilter.LowerThan("50")、
                    ),
                ),
            )
            .evaluate()

可选择使用 TrackerVisualization 对象（在 API 中称为 EventVisualization）来评估预定义的行列表。TrackerVisualization 必须具有 LINE_LIST 类型。也可以覆盖特定值。

例如，该查询使用 TrackerVisualization "s85urBIkN0z "中的配置，并添加或覆盖按 ACTIVE 过滤的 ProgramStatusItem 列。

```kt
d2.analyticsModule().trackerLineList()
  .withTrackerVisualization("s85urBIkN0z")
  .withColumn(
    TrackerLineListItem.ProgramStatusItem(
      filters = listOf(
        EnumFilter.EqualTo(EnrollmentStatus.ACTIVE.name)
      )
    )
  )
  .evaluate()

d2.analyticsModule().eventLineList()
        .byProgramStage().eq("stage_id")
        .byTrackedEntityInstance().eq("tei_id")
        .withDataElement("height_id")
        .withDataElement("weight_id")
        .withProgramIndicator("BMI_id")
        .evaluate()；