更新时间:2024-11-14 GMT+08:00
分享

新建衍生指标

功能介绍

根据参数,新建衍生指标指标。

调用方法

请参见如何调用API

URI

POST /v2/{project_id}/design/derivative-indexs

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方法请参见项目ID和账号ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

[数组元素]

Array of DerivativeIndexVO objects

创建衍生指标的请求体参数。

表3 DerivativeIndexVO

参数

是否必选

参数类型

描述

id

String

衍生指标ID,ID字符串。更新时必填。

name_en

String

衍生指标英文名称。

name_ch

String

衍生指标名称。

create_by

String

创建人。

data_type

String

字段类型。

l2_id

String

主题域ID。

l3_id

String

业务对象guid,ID字符串。

status

String

实体的发布状态,只读,创建和更新时无需填写。

枚举值:

  • DRAFT: 草稿

  • PUBLISH_DEVELOPING: 发布待审核

  • PUBLISHED: 已发布

  • OFFLINE_DEVELOPING: 下线待审核

  • OFFLINE: 已下线

  • REJECT: 已驳回

atomic_index_id

String

原子指标ID,ID字符串。

time_condition_id

String

时间限定ID,ID字符串。

time_field_id

String

时间限定关联字段ID,ID字符串。

common_conditions

Array of CommonConditionVO objects

通用限定信息。

dimension_groups

Array of DerivativeIndexDimensionVO objects

统计维度,更新时不可修改。

monitor

MetricMonitorVO object

指标监控。

l1

String

主题域分组中文名,只读,创建和更新时无需填写。

l2

String

主题域中文名,只读,创建和更新时无需填写。

l3

String

业务对象中文名,只读,创建和更新时无需填写。

approval_info

ApprovalVO object

审批信息,只读参数。业务对象最近一次的审批信息,包括审批的业务详情、审核人信息、审核时间等。

new_biz

BizVersionManageVO object

业务版本管理,只读。

表4 CommonConditionVO

参数

是否必选

参数类型

描述

name

String

名称。

field_ids

Array of strings

字段id信息,格式:table_id.field_id。

field_names

Array of strings

字段名称信息,格式:表名称.字段名称。

cal_exp

String

计算表达式,形如'${table_id.column_id} > 1',其中table_id表示引用字段所属表ID,column_id表示引用字段ID。

cal_fn_ids

Array of strings

引用函数ID,ID字符串。

front_configs

String

前端表达式配置,用于前端数据恢复。

表5 DerivativeIndexDimensionVO

参数

是否必选

参数类型

描述

group_id

String

维度分组ID。

role

String

维度角色。

dimension_id

String

维度ID,ID字符串。

hierarchies_id

String

维度层级ID,ID字符串。

group_name

String

维度分组名称。

group_code

String

维度分组编码。

biz_type

String

业务实体类型。

枚举值:

  • AGGREGATION_LOGIC_TABLE: 汇总表

  • ATOMIC_INDEX: 原子指标

  • ATOMIC_METRIC: 原子指标(新)

  • BIZ_CATALOG: 流程架构目录

  • BIZ_METRIC: 业务指标

  • CODE_TABLE: 码表

  • COMMON_CONDITION: 通用限定

  • COMPOSITE_METRIC: 复合指标(新)

  • COMPOUND_METRIC: 复合指标

  • CONDITION_GROUP: 限定分组

  • DEGENERATE_DIMENSION: 退化维度

  • DERIVATIVE_INDEX: 衍生指标

  • DERIVED_METRIC: 衍生指标(新)

  • DIMENSION: 维度

  • DIMENSION_ATTRIBUTE: 维度属性

  • DIMENSION_HIERARCHIES: 维度层级

  • DIMENSION_LOGIC_TABLE: 维度表

  • DIMENSION_TABLE_ATTRIBUTE: 维度属性

  • DIRECTORY: 目录

  • FACT_ATTRIBUTE: 事实表属性

  • FACT_DIMENSION: 事实表维度

  • FACT_LOGIC_TABLE: 事实表

  • FACT_MEASURE: 事实表度量

  • FUNCTION: 函数

  • INFO_ARCH: 信息架构(批量修改主题使用)

  • MODEL: 模型

  • QUALITY_RULE: 质量规则

  • SECRECY_LEVEL: 密级

  • STANDARD_ELEMENT: 数据标准

  • STANDARD_ELEMENT_TEMPLATE: 数据标准模板

  • SUBJECT: 主题

  • SUMMARY_DIMENSION_ATTRIBUTE: 汇总表维度属性

  • SUMMARY_INDEX: 汇总表指标属性

  • SUMMARY_TIME: 汇总表时间周期属性

  • TABLE_MODEL: 关系模型(逻辑模型/物理模型)

  • TABLE_MODEL_ATTRIBUTE: 关系模型属性(逻辑模型/物理模型)

  • TABLE_MODEL_LOGIC: 逻辑实体

  • TABLE_TYPE: 表类型

  • TAG: 标签

  • TIME_CONDITION: 时间限定

l2_id

String

主题域ID。

dw_type

String

数据连接类型。

表6 MetricMonitorVO

参数

是否必选

参数类型

描述

id

String

编码,ID字符串。

other_metric_ids

Array of strings

其他指标ID,ID字符串。

other_compound_metric_ids

Array of strings

其他复合指标ID。

expression

String

告警表达式。

metric_id

String

挂载指ID,ID字符串。

front_configs

String

前端表达式配置,用于前端数据恢复。

metric_type

String

挂载指标类型。

表7 ApprovalVO

参数

是否必选

参数类型

描述

id

String

审批单ID,ID字符串。

tenant_id

String

项目ID,获取方式参考接口路径参数“project_id”。

name_ch

String

业务中文名。

name_en

String

业务英文名。

biz_id

String

业务ID,ID字符串。

biz_type

String

业务实体类型。

枚举值:

  • AGGREGATION_LOGIC_TABLE: 汇总表

  • ATOMIC_INDEX: 原子指标

  • ATOMIC_METRIC: 原子指标(新)

  • BIZ_CATALOG: 流程架构目录

  • BIZ_METRIC: 业务指标

  • CODE_TABLE: 码表

  • COMMON_CONDITION: 通用限定

  • COMPOSITE_METRIC: 复合指标(新)

  • COMPOUND_METRIC: 复合指标

  • CONDITION_GROUP: 限定分组

  • DEGENERATE_DIMENSION: 退化维度

  • DERIVATIVE_INDEX: 衍生指标

  • DERIVED_METRIC: 衍生指标(新)

  • DIMENSION: 维度

  • DIMENSION_ATTRIBUTE: 维度属性

  • DIMENSION_HIERARCHIES: 维度层级

  • DIMENSION_LOGIC_TABLE: 维度表

  • DIMENSION_TABLE_ATTRIBUTE: 维度属性

  • DIRECTORY: 目录

  • FACT_ATTRIBUTE: 事实表属性

  • FACT_DIMENSION: 事实表维度

  • FACT_LOGIC_TABLE: 事实表

  • FACT_MEASURE: 事实表度量

  • FUNCTION: 函数

  • INFO_ARCH: 信息架构(批量修改主题使用)

  • MODEL: 模型

  • QUALITY_RULE: 质量规则

  • SECRECY_LEVEL: 密级

  • STANDARD_ELEMENT: 数据标准

  • STANDARD_ELEMENT_TEMPLATE: 数据标准模板

  • SUBJECT: 主题

  • SUMMARY_DIMENSION_ATTRIBUTE: 汇总表维度属性

  • SUMMARY_INDEX: 汇总表指标属性

  • SUMMARY_TIME: 汇总表时间周期属性

  • TABLE_MODEL: 关系模型(逻辑模型/物理模型)

  • TABLE_MODEL_ATTRIBUTE: 关系模型属性(逻辑模型/物理模型)

  • TABLE_MODEL_LOGIC: 逻辑实体

  • TABLE_TYPE: 表类型

  • TAG: 标签

  • TIME_CONDITION: 时间限定

biz_info

String

序列化之后的业务详情,类型是string。

biz_info_obj

Object

业务详情,类型是object。

biz_version

Integer

业务版本。

biz_status

String

实体的发布状态,只读,创建和更新时无需填写。

枚举值:

  • DRAFT: 草稿

  • PUBLISH_DEVELOPING: 发布待审核

  • PUBLISHED: 已发布

  • OFFLINE_DEVELOPING: 下线待审核

  • OFFLINE: 已下线

  • REJECT: 已驳回

approval_status

String

业务审批状态,只读。

枚举值:

  • DEVELOPING: 审核中

  • APPROVED: 审核通过

  • REJECT: 审核驳回

  • WITHDREW: 审核撤销

approval_type

String

业务审核类型。

枚举值:

  • PUBLISH: 发布

  • OFFLINE: 下线

submit_time

String

提交时间。

create_by

String

创建者。

l1

String

主题域分组中文名,只读,创建和更新时无需填写。

l2

String

主题域中文名,只读,创建和更新时无需填写。

l3

String

业务对象中文名,只读,创建和更新时无需填写。

approval_time

String

审核时间。

approver

String

审核人。

email

String

审核人邮箱。

msg

String

审核信息。

directory_path

String

目录树。

表8 BizVersionManageVO

参数

是否必选

参数类型

描述

id

String

ID信息,ID字符串。

biz_type

String

业务实体类型。

枚举值:

  • AGGREGATION_LOGIC_TABLE: 汇总表

  • ATOMIC_INDEX: 原子指标

  • ATOMIC_METRIC: 原子指标(新)

  • BIZ_CATALOG: 流程架构目录

  • BIZ_METRIC: 业务指标

  • CODE_TABLE: 码表

  • COMMON_CONDITION: 通用限定

  • COMPOSITE_METRIC: 复合指标(新)

  • COMPOUND_METRIC: 复合指标

  • CONDITION_GROUP: 限定分组

  • DEGENERATE_DIMENSION: 退化维度

  • DERIVATIVE_INDEX: 衍生指标

  • DERIVED_METRIC: 衍生指标(新)

  • DIMENSION: 维度

  • DIMENSION_ATTRIBUTE: 维度属性

  • DIMENSION_HIERARCHIES: 维度层级

  • DIMENSION_LOGIC_TABLE: 维度表

  • DIMENSION_TABLE_ATTRIBUTE: 维度属性

  • DIRECTORY: 目录

  • FACT_ATTRIBUTE: 事实表属性

  • FACT_DIMENSION: 事实表维度

  • FACT_LOGIC_TABLE: 事实表

  • FACT_MEASURE: 事实表度量

  • FUNCTION: 函数

  • INFO_ARCH: 信息架构(批量修改主题使用)

  • MODEL: 模型

  • QUALITY_RULE: 质量规则

  • SECRECY_LEVEL: 密级

  • STANDARD_ELEMENT: 数据标准

  • STANDARD_ELEMENT_TEMPLATE: 数据标准模板

  • SUBJECT: 主题

  • SUMMARY_DIMENSION_ATTRIBUTE: 汇总表维度属性

  • SUMMARY_INDEX: 汇总表指标属性

  • SUMMARY_TIME: 汇总表时间周期属性

  • TABLE_MODEL: 关系模型(逻辑模型/物理模型)

  • TABLE_MODEL_ATTRIBUTE: 关系模型属性(逻辑模型/物理模型)

  • TABLE_MODEL_LOGIC: 逻辑实体

  • TABLE_TYPE: 表类型

  • TAG: 标签

  • TIME_CONDITION: 时间限定

biz_id

String

业务ID,ID字符串。

biz_info

String

业务对象信息。

status

String

实体的发布状态,只读,创建和更新时无需填写。

枚举值:

  • DRAFT: 草稿

  • PUBLISH_DEVELOPING: 发布待审核

  • PUBLISHED: 已发布

  • OFFLINE_DEVELOPING: 下线待审核

  • OFFLINE: 已下线

  • REJECT: 已驳回

响应参数

状态码: 200

表9 响应Body参数

参数

参数类型

描述

data

data object

创建衍生指标的返回结果,成功的个数。

表10 data

参数

参数类型

描述

value

BatchOperationVO object

创建衍生指标操作返回结果。

表11 BatchOperationVO

参数

参数类型

描述

id

String

批量审批ID,ID字符串。

tenant_id

String

项目ID。

group_id

String

组ID,ID字符串。

biz_name

String

业务名。

biz_id

String

业务ID,ID字符串。

operation_status

String

操作结果类型枚举。RUNNING(运行中)、SUCCESS(操作成功)、FAILED(操作失败)。

枚举值:

  • RUNNING: 运行中

  • SUCCESS: 操作成功

  • FAILED: 操作失败

operation_type

String

类型。

biz_info

String

业务详情。

create_by

String

创建人。

remark

String

remark信息。

total

Integer

总数。

success

Integer

操作成功个数。

failed

Integer

操作失败个数。

rate

String

当前进度。

logs

String

日志。

groups

Array of BatchOperationVO objects

分组信息。

状态码: 400

表12 响应Body参数

参数

参数类型

描述

error_code

String

错误码,如DS.6000,请求处理失败。

error_msg

String

错误信息。

data

Object

返回的数据信息。

状态码: 401

表13 响应Body参数

参数

参数类型

描述

error_code

String

错误码,如DS.6000,请求处理失败。

error_msg

String

错误信息。

data

Object

返回的数据信息。

状态码: 403

表14 响应Body参数

参数

参数类型

描述

error_code

String

错误码,如DS.6000,请求处理失败。

error_msg

String

错误信息。

data

Object

返回的数据信息。

请求示例

根据请求参数进行衍生指标的创建。

POST https://{endpoint}/v2/{project_id}/design/derivative-indexs

[ {
  "name_ch" : "总车费(供应商,行程订单.车费)",
  "name_en" : "sum_total_amount",
  "data_type" : "STRING",
  "l3_id" : "1169309252771299328",
  "atomic_index_id" : "1170005876631875584",
  "dimension_groups" : [ {
    "biz_type" : "DIMENSION",
    "group_id" : "1169322847009742848",
    "group_name" : "供应商",
    "dimension_id" : "1169322847009742848",
    "role" : null,
    "hierarchies_id" : null
  }, {
    "biz_type" : "DEGENERATE_DIMENSION",
    "group_id" : "1169329693619625984.1169329693695123463",
    "group_name" : "行程订单.车费",
    "dimension_id" : null,
    "role" : null,
    "hierarchies_id" : null
  } ],
  "time_condition_id" : null,
  "time_field_id" : null,
  "common_conditions" : [ ],
  "monitor" : null,
  "description" : ""
} ]

响应示例

状态码: 200

Success,返回data数据是 BatchOperationVO。

{
  "data" : {
    "value" : {
      "id" : null,
      "tenant_id" : "0833a5737480d53b2f25c010dc1a7b88-workspace-9ce2cfd08fda4f3b95faa5ba65fa5ec3",
      "group_id" : "1300493983935508480",
      "biz_name" : null,
      "biz_id" : null,
      "operation_status" : "SUCCESS",
      "operation_type" : "BATCH_CREATE",
      "biz_info" : null,
      "create_by" : "test_uesr",
      "remark" : null,
      "total" : 1,
      "success" : 1,
      "failed" : 0,
      "rate" : "1.00",
      "logs" : null,
      "groups" : [ {
        "id" : "1300493984405270528",
        "tenant_id" : "0833a5737480d53b2f25c010dc1a7b88-workspace-9ce2cfd08fda4f3b95faa5ba65fa5ec3",
        "group_id" : "1300493983935508480",
        "biz_name" : "总车费(供应商,行程订单.车费)",
        "biz_id" : "1300493984245886976",
        "operation_status" : "SUCCESS",
        "operation_type" : "BATCH_CREATE",
        "biz_info" : "{\"atomic_index_id\":1170005876631875584,\"create_by\":\"test_uesr\",\"data_type\":\"STRING\",\"description\":\"\",\"id\":1300493984245886976,\"l3_id\":1169309252771299328,\"name_ch\":\"总车费(供应商,行程订单.车费)\",\"name_en\":\"sum_total_amount\",\"status\":\"DRAFT\"}",
        "create_by" : "test_uesr",
        "remark" : "CREATE",
        "total" : 0,
        "success" : 0,
        "failed" : 0,
        "rate" : null,
        "logs" : null,
        "groups" : null
      } ]
    }
  }
}

状态码: 400

{
  "error_code" : "DS.60xx",
  "error_msg" : "The user request is illegal."
}

状态码: 401

{
  "error_code" : "DS.60xx",
  "error_msg" : "User authentication failed."
}

状态码: 403

{
  "error_code" : "DS.60xx",
  "error_msg" : "The user does not have permission to call this API."
}

状态码

状态码

描述

200

Success,返回data数据是 BatchOperationVO。

400

BadRequest

401

Unauthorized

403

Forbidden

相关文档