Goals (Preview) - Delete Goal Target Value Connection

服务:

Power BI REST APIs

API 版本:

v1.0

断开目标的目标值的连接。

所需范围

Dataset.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/scorecards({scorecardId})/goals({goalId})/DeleteGoalTargetValueConnection()

URI 参数

名称	在	必需	类型	说明
goalId	path	True	string (uuid)	目标的唯一标识符
groupId	path	True	string (uuid)	工作区的唯一标识符
scorecardId	path	True	string (uuid)	记分卡的唯一标识符

响应

名称	类型	说明
200 OK	Goal	断开连接后更新的目标对象。

示例

Example

示例请求

POST https://api.powerbi.com/v1.0/myorg/groups/bc390256-fa54-4bd8-96a1-2c80df0cf704/scorecards(c3ac3850-5d7f-4a43-a9db-549e1a44ad62)/goals(529cc37c-d224-4ff8-9e5e-669c35f3b412)/DeleteGoalTargetValueConnection()

示例响应

状态代码:

200

定义

名称	说明
Goal	Power BI 目标
GoalAggregation	描述特定时间各种 Power BI 目标属性状态（通常为当前时间）的条目
GoalAggregationType	聚合属性的类型
GoalNote	Power BI 目标值签入说明
GoalPermissions	目标权限
Goals.Rules.GoalRulesContainer	Power BI 目标上状态规则 JSON 定义的容器
GoalValue	Power BI 目标值签入

Goal

Object

Power BI 目标

名称	类型	说明
aggregations	GoalAggregation[]	目标聚合属性的列表
completionDate	string (date-time)	目标的完成日期的 UTC 时间戳。 时间戳的时间部分为零。
createdTime	string (date-time)	创建时的 UTC 时间
datesFormatString	string	datesFormatString
description	string	目标说明
goalValues	GoalValue[]	目标值签入列表
hasStatusRules	boolean	目标是否定义了状态规则
id	string (uuid)	目标 ID
lastModifiedTime	string (date-time)	上次修改时的 UTC 时间
level	integer (int32)	记分卡目标的父子层次结构中目标的嵌套级别
name	string	目标名称
notesCount	integer (int32)	notesCount
parentId	string (uuid)	父目标的 ID（如果已定义）。
permissions	GoalPermissions	目标权限
rank	integer (int64)	有序的同级目标集中目标排名
scorecardId	string (uuid)	记分卡 ID
startDate	string (date-time)	目标的开始日期的 UTC 时间戳。 时间戳的时间部分为零。
statusRules	Goals.Rules.GoalRulesContainer	目标状态规则
valuesFormatString	string	valuesFormatString

GoalAggregation

Object

描述特定时间各种 Power BI 目标属性状态（通常为当前时间）的条目

名称	类型	说明
calculationTime	string (date-time)	聚合计算的 UTC 时间戳
goalId	string (uuid)	目标 ID
id	string	聚合 ID
maxLastModifiedTime	string (date-time)	对聚合属性的最新修改的 UTC 时间戳
scorecardId	string (uuid)	记分卡 ID
timestamp	string (date-time)	与聚合属性关联的 UTC 时间戳。 时间戳的时间部分为零。
type	GoalAggregationType	聚合属性的类型
value	number (double)	聚合属性的数值
valueDisplayString	string	可选。 聚合属性值的替代文本表示形式。

GoalAggregationType

枚举

聚合属性的类型

值	说明
Change	有关更改的信息
Sparkline	有关迷你图的信息
Status	有关目标状态的信息
Target	有关目标的目标值的信息
Value	有关目标当前值的信息

GoalNote

Object

Power BI 目标值签入说明

名称	类型	说明
body	string	备注文本
content	string	此笔记的内容采用特殊格式
createdTime	string (date-time)	创建时的 UTC 时间
goalId	string (uuid)	目标 ID
id	string (uuid)	目标值签入笔记 ID
lastModifiedTime	string (date-time)	上次修改时的 UTC 时间
scorecardId	string (uuid)	记分卡 ID
valueTimestamp	string (date-time)	此笔记所属的目标值签入的 UTC 时间戳。 时间戳的时间部分为零。

GoalPermissions

枚举

目标权限

值	说明
11	可以更新当前值和备注。
13	可以更新目标值和备注。
15	可以更新当前值、目标值和备注。
19	可以更新当前值和状态。
21	可以更新目标值和状态。
23	可以更新当前值、目标值和状态。
25	可以更新备注和状态。
27	可以更新当前值、备注和状态。
29	可以更新目标值、备注和状态。
All	可以更新值、备注和状态。
None	无访问权限。
UpdateCurrentValue	可以更新当前值。
UpdateNotes	可以更新备注。
UpdateStatus	状态可以更新。
UpdateTargetValue	可以更新目标值。
UpdateValues	可以更新当前值和目标值。
View	仅查看访问权限。

Goals.Rules.GoalRulesContainer

Object

Power BI 目标上状态规则 JSON 定义的容器

名称	类型	说明
goalObjectId	string (uuid)	目标 ID
lastModifiedTime	string (date-time)	上次修改时的 UTC 时间
rules	string	规则列表
scorecardObjectId	string (uuid)	记分卡 ID

GoalValue

Object

Power BI 目标值签入

名称	类型	说明
createdTime	string (date-time)	创建时的 UTC 时间
forecast	number (double)	目标值趋势预测
goalId	string (uuid)	目标 ID
lastModifiedTime	string (date-time)	上次修改时的 UTC 时间
notes	GoalNote[]	目标说明
scorecardId	string (uuid)	记分卡 ID
status	integer (int32)	目标状态的 ID 身份证 说明 0 未启动 1 在轨道上 2 有风险 3 后 4 迟到 5 完成
target	number (double)	目标目标值
targetDisplayString	string	目标目标的文本表示形式
timestamp	string (date-time)	目标值签入的 UTC 时间戳。 时间戳的时间部分为零。
trend	integer (int32)	目标值趋势
value	number (double)	目标当前值
valueDisplayString	string	当前目标值的文本表示形式