Power BI
Power BI는 데이터를 분석하고 인사이트를 공유하는 비즈니스 분석 도구 모음입니다. 연결하여 Power BI 대시보드, 보고서 및 데이터 세트의 데이터에 쉽게 액세스할 수 있습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | 스탠다드 | 모든 Power Automate 지역 |
| 논리 앱 | 스탠다드 | 모든 Logic Apps 지역 |
| Power Apps | 스탠다드 | 모든 Power Apps 지역 |
| Power Automate | 스탠다드 | 모든 Power Automate 지역 |
| 연락처 | |
|---|---|
| 이름 | Microsoft |
| URL | https://powerbi.microsoft.com/en-us/support/ |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://powerbi.microsoft.com/ |
| 개인 정보 보호 정책 | https://privacy.microsoft.com/privacystatement |
| 카테고리 | 비즈니스 인텔리전스; 웹 사이트 |
이 통합을 사용하려면 Power BI 계정에 액세스해야 합니다. 연결을 만들려면 로그인을 선택합니다. 계정을 제공하고 화면의 나머지 부분에 따라 연결을 만들라는 메시지가 표시됩니다.
연결을 사용하는 경우 Power BI 계정에 특정 구성이 필요할 수 있습니다. 예를 들어 데이터 기반 경고 트리거를 사용하려면 데이터 기반 경고가 이미 구성되어 있어야 합니다.
이제 이 통합을 사용할 준비가 되었습니다.
알려진 문제 및 제한 사항
Power BI 커넥터는 Power BI 소버린 클라우드 클러스터(예: 중국, 독일 및 미국 정부 클러스터)에서 지원되지 않습니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| Power BI 보고서에 대한 파일로 내보내기 |
Power BI Rest API를 사용하여 Power BI 보고서에 대한 내보내기 완화 |
| 데이터 세트 새로 고침 |
Power BI REST API를 사용하여 powerbi 데이터 세트를 새로 고칩니다. |
| 데이터 세트에 대해 json 쿼리 실행 |
Power BI REST API를 사용하여 json 형식으로 쿼리를 실행합니다. |
| 데이터 세트에 대해 쿼리 실행 |
Power BI REST API를 사용하여 쿼리를 실행합니다. |
| 데이터 세트에 행 추가 |
Power BI REST API를 사용하여 데이터 세트에 행을 추가합니다. |
| 목표 가져오기(미리 보기) |
성과 기록표에서 지정된 Power BI 목표를 가져옵니다. |
| 목표 만들기(미리 보기) |
지정된 성과 기록표에 Power BI 목표를 만듭니다. |
| 목표 업데이트(미리 보기) |
Power BI 목표의 상태를 업데이트합니다. |
| 목표 체크 인 가져오기(미리 보기) |
Power BI 목표에 대한 체크 인을 가져옵니다. |
| 목표 체크 인 가져오기(미리 보기) |
Power BI 목표에 대한 모든 체크 인을 가져옵니다. |
| 성과 기록표 가져오기(미리 보기) |
지정된 작업 영역에서 Power BI 성과 기록표 목록을 가져옵니다. |
| 성과 기록표 만들기(미리 보기) |
Power BI 목표에 대한 성과 기록표를 만듭니다. |
| 여러 목표 가져오기(미리 보기) |
지정된 성과 기록표에서 Power BI 목표 목록을 가져옵니다. |
| 체크 인 만들기(미리 보기) |
Power BI 목표 체크 인을 만듭니다. |
| 체크 인 업데이트(미리 보기) |
Power BI 목표 체크 인을 업데이트합니다. |
| 체크 인에 메모 추가(미리 보기) |
Power BI 목표의 체크 인에 새 메모를 추가합니다. |
| 페이지를 매긴 보고서의 파일로 내보내기 |
Power BI Rest API를 사용하여 페이지를 매긴 보고서에 대한 내보내기 완화 |
Power BI 보고서에 대한 파일로 내보내기
Power BI Rest API를 사용하여 Power BI 보고서에 대한 내보내기 완화
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
보고서
|
reportid | True | string |
pbi 보고서의 고유 식별자입니다. |
|
내보내기 형식
|
format | True | string |
Power BI 보고서의 내보내기 형식입니다. 지원되는 형식은 PPTX(PowerPoint), PDF 및 PNG입니다. |
|
로케일
|
locale | string |
적용할 로캘 |
|
|
숨겨진 페이지 포함
|
includeHiddenPages | boolean |
전체 보고서를 내보낼 때 숨겨진 페이지를 포함할지 여부를 나타내는 플래그입니다(특정 페이지를 전달할 때 이 속성은 무시됨). 제공되지 않은 경우 기본 동작은 숨겨진 페이지를 제외하는 것입니다. |
|
|
책갈피 이름
|
name | string |
책갈피 이름 |
|
|
책갈피 상태
|
state | string |
책갈피 상태 |
|
|
Filter
|
filter | string |
적용할 필터 |
|
|
pageName
|
pageName | string |
페이지 이름 |
|
|
visualName
|
visualName | string |
(선택 사항) 내보낼 시각적 개체 이름 |
|
|
책갈피 이름
|
name | string |
책갈피 이름 |
|
|
책갈피 상태
|
state | string |
책갈피 상태 |
|
|
사용자 이름
|
username | True | string |
RLS 규칙을 적용하기 위한 토큰에 의해 반영된 유효 사용자 이름입니다(OnPrem 모델의 경우 사용자 이름은 알파 숫자 문자 또는 다음 문자 '.', '-', '_', '!', '#', '^', '~', '\', '@'로 구성될 수 있으며 사용자 이름에는 공백을 포함할 수 없습니다. 클라우드 모델의 경우 사용자 이름은 모든 ASCII 문자로 구성될 수 있습니다. 사용자 이름은 최대 256자여야 합니다. |
|
데이터세트
|
datasets | array of string |
이 ID가 적용되는 데이터 세트의 배열입니다. |
|
|
역할
|
roles | array of string |
RLS 규칙을 적용할 때 토큰에 의해 반영되는 RLS 역할의 배열입니다(ID는 최대 50개의 역할을 포함할 수 있으며 역할은 ',' 이외의 문자로 구성될 수 있으며 최대 50자여야 합니다). |
|
|
CustomData
|
customData | string |
RLS 규칙을 적용하는 데 사용할 customdata의 값입니다. Azure Analysis Services에 대한 라이브 연결에 대해서만 지원됩니다. |
|
|
Blob 값
|
value | True | string |
SQL Azure에 대한 OAuth2 액세스 토큰 |
|
보고서
|
reports | array of string |
이 ID가 적용되는 보고서의 배열이며 페이지를 매긴 보고서에만 지원됩니다. |
반환
파일의 내용입니다.
- File Content(파일 내용)
- binary
데이터 세트 새로 고침
Power BI REST API를 사용하여 powerbi 데이터 세트를 새로 고칩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
Dataset
|
datasetid | True | string |
데이터 세트의 고유 식별자입니다. |
데이터 세트에 대해 json 쿼리 실행
Power BI REST API를 사용하여 json 형식으로 쿼리를 실행합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
Dataset
|
datasetid | True | string |
데이터 세트의 고유 식별자입니다. |
반환
- response
- object
데이터 세트에 대해 쿼리 실행
Power BI REST API를 사용하여 쿼리를 실행합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
Dataset
|
datasetid | True | string |
데이터 세트의 고유 식별자입니다. |
|
쿼리 텍스트
|
query | True | string |
쿼리의 텍스트입니다. 여러 줄 텍스트일 수 있습니다. |
|
Null 포함
|
includeNulls | boolean |
null 값을 결과에 포함해야 합니다. 기본값은 아니요입니다. |
|
|
사용자 가장
|
impersonatedUserName | string |
쿼리를 다른 사용자로 실행하는 UPN 형식의 사용자 ID입니다. |
반환
쿼리 실행의 결과입니다.
데이터 세트에 행 추가
Power BI REST API를 사용하여 데이터 세트에 행을 추가합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
Dataset
|
datasetid | True | string |
데이터 세트의 고유 식별자입니다. |
|
Table
|
tablename | True | string |
테이블의 이름입니다. |
|
보낼 페이로드
|
Payload | dynamic |
목표 가져오기(미리 보기)
성과 기록표에서 지정된 Power BI 목표를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
성과 기록표 ID
|
scorecardId | True | string |
성과 기록표의 고유 식별자입니다. |
|
목표 ID
|
goalId | True | string |
목표의 고유 식별자입니다. |
반환
목표 정보입니다.
- 목표
- FetchedGoal
목표 만들기(미리 보기)
지정된 성과 기록표에 Power BI 목표를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
성과 기록표 ID
|
scorecardId | True | string |
성과 기록표의 고유 식별자입니다. |
|
이름
|
name | True | string |
목표의 이름입니다. |
|
소유자
|
owner |
목표 소유자의 이메일 주소입니다. 예: foo@bar.com |
||
|
현재 값
|
value | string |
추적 중인 목표의 현재 값입니다. |
|
|
대상 값
|
target | string |
목표의 대상 값입니다. |
|
|
상태
|
status | string |
목표의 현재 상태입니다. |
|
|
시작 날짜
|
startDate | date |
목표의 시작 날짜입니다. 예: 2021-07-15. |
|
|
완료 날짜
|
completionDate | date |
완료할 목표 날짜입니다. 예: 2021-07-29. |
|
|
비고
|
note | string |
목표 생성 시 초기 체크 인에 연결합니다. 여러 줄 텍스트일 수 있습니다. |
|
|
부모 목표 ID
|
parentId | string |
이 목표가 하위 항목인 경우 부모 목표의 고유 ID입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
목표의 고유 식별자입니다. |
목표 업데이트(미리 보기)
Power BI 목표의 상태를 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
성과 기록표 ID
|
scorecardId | True | string |
성과 기록표의 고유 식별자입니다. |
|
목표 ID
|
goalId | True | string |
목표의 고유 식별자입니다. |
|
이름
|
name | string |
제공된 경우 목표의 새 이름입니다. |
|
|
소유자
|
owner |
제공된 경우 새 목표 소유자의 이메일 주소입니다. |
||
|
현재 값
|
value | number |
제공된 경우 목표의 새 값을 설정합니다. |
|
|
대상 값
|
target | number |
제공된 경우 새 목표 목표를 설정합니다. |
|
|
상태
|
status | string |
제공된 경우 목표의 새 상태를 설정합니다. |
|
|
시작 날짜
|
startDate | date |
제공된 경우 목표에 대한 새 시작 날짜입니다. 예: 2021-07-15. |
|
|
완료 날짜
|
completionDate | date |
제공된 경우 목표의 새 날짜가 완료됩니다. 예: 2021-07-29. |
목표 체크 인 가져오기(미리 보기)
Power BI 목표에 대한 체크 인을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
성과 기록표 ID
|
scorecardId | True | string |
성과 기록표의 고유 식별자입니다. |
|
목표 ID
|
goalId | True | string |
목표의 고유 식별자입니다. |
|
체크 인 날짜
|
goalCheckin | True | date |
예: 2021-07-21 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
날짜
|
timestamp | date |
체크 인한 날짜입니다. |
|
가치
|
value | number |
설정된 경우 체크 인 시의 값입니다. |
|
상태
|
status | string |
체크 인 시의 목표 상태입니다. |
|
비고
|
notes | GoalNotes |
노트 목록입니다. |
목표 체크 인 가져오기(미리 보기)
Power BI 목표에 대한 모든 체크 인을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
성과 기록표 ID
|
scorecardId | True | string |
성과 기록표의 고유 식별자입니다. |
|
목표 ID
|
goalId | True | string |
목표의 고유 식별자입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
체크 인
|
value | array of object |
체크 인 목록입니다. |
|
날짜
|
value.timestamp | datetime |
체크 인한 날짜입니다. |
|
가치
|
value.value | number |
체크 인 시의 값입니다. |
|
상태
|
value.status | string |
체크 인 시의 목표 상태입니다. |
|
비고
|
value.notes | GoalNotes |
노트 목록입니다. |
성과 기록표 가져오기(미리 보기)
지정된 작업 영역에서 Power BI 성과 기록표 목록을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
반환
전체 응답 본문입니다.
성과 기록표 만들기(미리 보기)
Power BI 목표에 대한 성과 기록표를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
이름
|
name | True | string |
성과 기록표 이름 |
|
Description
|
description | string |
성과 기록표 설명 |
반환
성과 기록표를 만들었습니다.
- 성과 기록표 만들기
- CreatedScorecard
여러 목표 가져오기(미리 보기)
지정된 성과 기록표에서 Power BI 목표 목록을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
성과 기록표 ID
|
scorecardId | True | string |
성과 기록표의 고유 식별자입니다. |
반환
전체 응답 본문입니다.
- 검색
- FetchedGoals
체크 인 만들기(미리 보기)
Power BI 목표 체크 인을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
성과 기록표 ID
|
scorecardId | True | string |
성과 기록표의 고유 식별자입니다. |
|
목표 ID
|
goalId | True | string |
목표의 고유 식별자입니다. |
|
날짜
|
timestamp | True | date |
체크 인 날짜입니다. 예: 2021-07-21 |
|
가치
|
value | number | ||
|
상태
|
status | string |
목표의 상태입니다. |
|
|
비고
|
note | string |
여러 줄 텍스트일 수 있습니다. |
체크 인 업데이트(미리 보기)
Power BI 목표 체크 인을 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
성과 기록표 ID
|
scorecardId | True | string |
성과 기록표의 고유 식별자입니다. |
|
목표 ID
|
goalId | True | string |
목표의 고유 식별자입니다. |
|
체크 인 날짜
|
goalCheckin | True | date |
예: 2021-07-21 |
|
가치
|
value | number | ||
|
상태
|
status | string |
목표의 상태입니다. |
체크 인에 메모 추가(미리 보기)
Power BI 목표의 체크 인에 새 메모를 추가합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
성과 기록표 ID
|
scorecardId | True | string |
성과 기록표의 고유 식별자입니다. |
|
목표 ID
|
goalId | True | string |
목표의 고유 식별자입니다. |
|
체크 인 날짜
|
goalCheckin | True | date |
예: 2021-07-21 |
|
비고
|
note | True | string |
여러 줄 텍스트일 수 있습니다. |
페이지를 매긴 보고서의 파일로 내보내기
Power BI Rest API를 사용하여 페이지를 매긴 보고서에 대한 내보내기 완화
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
보고서
|
reportid | True | string |
페이지를 매긴 보고서의 고유 식별자입니다. |
|
내보내기 형식
|
format | True | string |
페이지를 매긴 보고서의 내보내기 형식입니다. 지원되는 형식은 PPTX(PowerPoint), PDF, ACCESSIBLEPDF(접근성 있는 PDF), XLSX(Excel), DOCX(Word), CSV, XML, MHTML 및 이미지(BMP, EMF, GIF, JPEG, PNG 또는 TIFF)입니다. |
|
사용자 이름
|
username | True | string |
RLS 규칙을 적용하기 위한 토큰에 의해 반영된 유효 사용자 이름입니다(OnPrem 모델의 경우 사용자 이름은 알파 숫자 문자 또는 다음 문자 '.', '-', '_', '!', '#', '^', '~', '\', '@'로 구성될 수 있으며 사용자 이름에는 공백을 포함할 수 없습니다. 클라우드 모델의 경우 사용자 이름은 모든 ASCII 문자로 구성될 수 있습니다. 사용자 이름은 최대 256자여야 합니다. |
|
데이터세트
|
datasets | array of string |
이 ID가 적용되는 데이터 세트의 배열입니다. |
|
|
역할
|
roles | array of string |
RLS 규칙을 적용할 때 토큰에 의해 반영되는 RLS 역할의 배열입니다(ID는 최대 50개의 역할을 포함할 수 있으며 역할은 ',' 이외의 문자로 구성될 수 있으며 최대 50자여야 합니다). |
|
|
CustomData
|
customData | string |
RLS 규칙을 적용하는 데 사용할 customdata의 값입니다. Azure Analysis Services에 대한 라이브 연결에 대해서만 지원됩니다. |
|
|
Blob 값
|
value | True | string |
SQL Azure에 대한 OAuth2 액세스 토큰 |
|
보고서
|
reports | array of string |
이 ID가 적용되는 보고서의 배열이며 페이지를 매긴 보고서에만 지원됩니다. |
|
|
FormatSettings
|
formatSettings | object |
형식 설정의 사전입니다. 키는 요청된 파일 형식의 디바이스 정보 속성 이름입니다. |
|
|
이름
|
name | string |
보고서 매개 변수 이름 |
|
|
value
|
value | string |
보고서 매개 변수 값 |
반환
파일의 내용입니다.
- File Content(파일 내용)
- binary
트리거
| Power BI 단추를 클릭했습니다. |
이 트리거를 사용하면 Power BI 단추를 클릭할 때 흐름을 실행할 수 있습니다. (Power Automate에만 사용 가능) |
| 누군가가 목표 체크 인을 추가하거나 편집하는 경우(미리 보기) |
일부 Power BI 목표 체크 인 또는 메모 변경에 대해 트리거합니다. |
| 누군가가 목표에 새 소유자를 할당하는 경우(미리 보기) |
누군가가 Power BI 목표에 새 소유자를 할당하는 경우 |
| 데이터 기반 경고가 트리거되는 경우 |
경고가 트리거될 때 Power BI에서 지정된 데이터 기반 경고의 세부 정보를 반환합니다. |
| 목표 상태가 변경되는 경우(미리 보기) |
일부 Power BI 목표의 상태가 변경되는 경우 |
| 목표가 변경되는 경우(미리 보기) |
일부 Power BI 목표의 속성이 변경되는 경우 |
| 목표에 대한 데이터 새로 고침이 실패하는 경우(미리 보기) |
Power BI 목표에 대한 데이터 새로 고침이 실패하는 경우 |
| 목표의 현재 값이 변경되는 경우(미리 보기) |
일부 Power BI 목표의 현재 값이 변경되는 경우 |
Power BI 단추를 클릭했습니다.
이 트리거를 사용하면 Power BI 단추를 클릭할 때 흐름을 실행할 수 있습니다. (Power Automate에만 사용 가능)
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
operationId
|
operationId | True | string | |
|
host
|
host | object | ||
|
parameters
|
parameters | True | object | |
|
headersSchema
|
headersSchema | object | ||
|
schema(스키마)
|
schema | object |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
행
|
body.rows | array of object | |
|
items
|
body.rows | object | |
|
사용자 전자 메일
|
headers.x-ms-user-email-encoded | byte |
흐름을 트리거한 사용자의 이메일 주소입니다. |
|
사용자 이름
|
headers.x-ms-user-name-encoded | byte |
흐름을 트리거한 사용자의 표시 이름입니다. |
|
시간표시
|
headers.x-ms-user-timestamp | string |
흐름이 트리거된 시간입니다. |
|
사용자 ID
|
headers.x-ms-user-id | guid |
AAD에서 흐름을 트리거한 사용자의 고유 식별자입니다. |
누군가가 목표 체크 인을 추가하거나 편집하는 경우(미리 보기)
일부 Power BI 목표 체크 인 또는 메모 변경에 대해 트리거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
성과 기록표 ID
|
scorecardId | True | string |
성과 기록표의 고유 식별자입니다. |
|
목표 ID
|
goalId | True | string |
목표의 고유 식별자입니다. |
|
폴링 간격(초)
|
pollingInterval | True | number |
새 데이터에 대한 검사 사이의 시간(초)입니다. 최소값은 300입니다. |
반환
목표 체크 인 또는 노트가 추가되거나 변경되었습니다.
- 업데이트된 목표
- GoalValueOrNoteUpserted
누군가가 목표에 새 소유자를 할당하는 경우(미리 보기)
누군가가 Power BI 목표에 새 소유자를 할당하는 경우
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
성과 기록표 ID
|
scorecardId | True | string |
성과 기록표의 고유 식별자입니다. |
|
소유자
|
owner |
소유자의 전자 메일입니다. 당신의 수 있습니다. 소유자를 추적할 때 비워 둘 수 있습니다. |
||
|
폴링 간격(초)
|
pollingInterval | True | number |
새 데이터에 대한 검사 사이의 시간(초)입니다. 최소값은 300입니다. |
반환
할당된 목표 정보입니다.
- 할당됨
- GoalsAssigned
데이터 기반 경고가 트리거되는 경우
경고가 트리거될 때 Power BI에서 지정된 데이터 기반 경고의 세부 정보를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
경고 ID
|
alertId | True | string |
추적할 경고 ID입니다. |
반환
목표 상태가 변경되는 경우(미리 보기)
일부 Power BI 목표의 상태가 변경되는 경우
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
성과 기록표 ID
|
scorecardId | True | string |
성과 기록표의 고유 식별자입니다. |
|
목표 ID
|
goalId | True | string |
목표의 고유 식별자입니다. |
|
폴링 간격(초)
|
pollingInterval | True | number |
새 데이터에 대한 검사 사이의 시간(초)입니다. 최소값은 300입니다. |
반환
목표 속성이 변경되었습니다.
- 변경된 목표
- GoalStatusChanged
목표가 변경되는 경우(미리 보기)
일부 Power BI 목표의 속성이 변경되는 경우
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
성과 기록표 ID
|
scorecardId | True | string |
성과 기록표의 고유 식별자입니다. |
|
목표 ID
|
goalId | True | string |
목표의 고유 식별자입니다. |
|
폴링 간격(초)
|
pollingInterval | True | number |
새 데이터에 대한 검사 사이의 시간(초)입니다. 최소값은 300입니다. |
반환
목표 속성이 변경되었습니다.
- 변경된 목표
- GoalChanged
목표에 대한 데이터 새로 고침이 실패하는 경우(미리 보기)
Power BI 목표에 대한 데이터 새로 고침이 실패하는 경우
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
성과 기록표 ID
|
scorecardId | True | string |
성과 기록표의 고유 식별자입니다. |
|
목표 ID
|
goalId | True | string |
목표의 고유 식별자입니다. |
|
대상 원본 추적
|
trackTargetSource | True | string |
목표 대상에 대한 링크를 추적합니다. |
|
값 원본 추적
|
trackValueSource | True | string |
목표 값에 대한 링크를 추적합니다. |
|
폴링 간격(초)
|
pollingInterval | True | number |
새 데이터에 대한 검사 사이의 시간(초)입니다. 최소값은 300입니다. |
반환
목표 새로 고침 실패 문제
- 새로 고침 실패
- GoalRefreshIssues
목표의 현재 값이 변경되는 경우(미리 보기)
일부 Power BI 목표의 현재 값이 변경되는 경우
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
작업 공간
|
groupid | True | string |
작업 영역의 고유 식별자입니다. |
|
성과 기록표 ID
|
scorecardId | True | string |
성과 기록표의 고유 식별자입니다. |
|
목표 ID
|
goalId | True | string |
목표의 고유 식별자입니다. |
|
폴링 간격(초)
|
pollingInterval | True | number |
새 데이터에 대한 검사 사이의 시간(초)입니다. 최소값은 300입니다. |
반환
목표 속성이 변경되었습니다.
- 변경된 목표
- GoalValueChanged
정의
QueryExecutionResults
쿼리 실행의 결과입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
첫 번째 테이블 행
|
firstTableRows | array of object |
결과를 행 배열로 쿼리합니다. |
CreatedScorecard
성과 기록표를 만들었습니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
성과 기록표의 고유 식별자입니다. |
ListedScorecards
전체 응답 본문입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
채점표
|
value | array of ListedScorecard |
성과 기록표 목록입니다. |
ListedScorecard
성과 기록표.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
성과 기록표의 고유 식별자입니다. |
|
이름
|
name | string |
성과 기록표의 이름입니다. |
|
연락처
|
contact | string |
성과 기록표의 연락처 정보입니다. |
FetchedGoals
전체 응답 본문입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
목표
|
value | array of FetchedGoal |
목표 목록입니다. |
FetchedGoal
목표 정보입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
목표의 고유 식별자입니다. |
|
이름
|
name | string |
목표의 이름입니다. |
|
소유자
|
owner |
목표 소유자의 이메일 주소입니다. |
|
|
시작 날짜
|
startDate | date |
목표의 시작 날짜입니다. 예: 2021-07-15. |
|
완료 날짜
|
completionDate | date |
목표 완료 기한입니다. 예: 2021-07-29. |
|
부모 목표 ID
|
parentId | string |
이 목표가 하위 항목인 경우 부모 목표의 고유 ID입니다. |
|
현재 값
|
currentValue | number |
추적 중인 목표의 현재 값입니다. |
|
현재 값 타임스탬프
|
currentValueTimestamp | date |
목표의 현재 값이 설정된 타임스탬프입니다. |
|
대상 값
|
targetValue | number |
목표의 대상 값입니다. |
|
대상 값 타임스탬프
|
targetValueTimestamp | date |
목표의 대상 값이 설정된 타임스탬프입니다. |
|
상태
|
status | string |
목표의 상태입니다. |
|
상태 타임스탬프
|
statusTimestamp | date |
목표 상태가 설정된 타임스탬프입니다. |
|
빈도
|
cycle | string |
이 목표의 시각적 개체에 표시된 추적 주기 빈도 간격입니다. |
|
추적 주기 날짜
|
cyclePeriod | date |
추적 주기의 추가 속성을 확인할 날짜입니다. |
GoalChanged
목표 속성이 변경되었습니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
목표의 고유 식별자입니다. |
|
이전 이름
|
oldName | string |
목표의 이름입니다. |
|
이전 소유자
|
oldOwner |
목표 소유자의 이메일 주소입니다. |
|
|
이전 시작 날짜
|
oldStartDate | date |
목표의 시작 날짜입니다. 예: 2021-07-15. |
|
이전 완료 날짜
|
oldCompletionDate | date |
목표 완료 기한입니다. 예: 2021-07-29. |
|
이전 부모 목표 ID
|
oldParentId | string |
이 목표가 하위 항목인 경우 부모 목표의 고유 ID입니다. |
|
이전 현재 값
|
oldCurrentValue | number |
추적 중인 목표의 현재 값입니다. |
|
이전 대상 값
|
oldTargetValue | number |
목표의 대상 값입니다. |
|
이전 상태
|
oldStatus | string |
목표의 상태입니다. |
|
이전 빈도
|
oldCycle | string |
이 목표의 시각적 개체에 표시된 이전 추적 주기 빈도 간격입니다. |
|
이전 추적 주기 날짜
|
oldCyclePeriod | date |
추적 주기의 추가 속성을 확인하기 위한 이전 날짜입니다. |
|
새 이름
|
newName | string |
목표의 이름입니다. |
|
새 소유자
|
newOwner |
목표 소유자의 이메일 주소입니다. |
|
|
새 시작 날짜
|
newStartDate | date |
목표의 시작 날짜입니다. |
|
새 완료 날짜
|
newCompletionDate | date |
목표 완료 기한입니다. |
|
새 부모 목표 ID
|
newParentId | string |
이 목표가 하위 항목인 경우 부모 목표의 고유 ID입니다. |
|
새 현재 값
|
newCurrentValue | number |
추적 중인 목표의 현재 값입니다. |
|
새 대상 값
|
newTargetValue | number |
목표의 대상 값입니다. |
|
새 상태
|
newStatus | string |
목표의 상태입니다. |
|
새 빈도
|
newCycle | string |
이 목표의 시각적 개체에 표시되는 새 추적 주기 간격입니다. |
|
새 추적 주기 날짜
|
newCyclePeriod | date |
추적 주기의 추가 속성을 확인할 수 있는 새 날짜입니다. |
|
변경 내용 목록
|
changeList | string |
쉼표로 구분된 변경 내용 목록입니다. 예: 'status,currentValue'. |
GoalStatusChanged
목표 속성이 변경되었습니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
목표의 고유 식별자입니다. |
|
이전 상태
|
oldStatus | string |
목표의 상태입니다. |
|
새 상태
|
newStatus | string |
목표의 상태입니다. |
GoalValueChanged
목표 속성이 변경되었습니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
목표의 고유 식별자입니다. |
|
이전 현재 값
|
oldCurrentValue | number |
추적 중인 목표의 현재 값입니다. |
|
새 현재 값
|
newCurrentValue | number |
추적 중인 목표의 현재 값입니다. |
GoalRefreshIssues
목표 새로 고침 실패 문제
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
문제
|
issues | array of GoalRefreshIssue |
목표 새로 고침 문제. |
GoalRefreshIssue
목표 새로 고침 문제.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
연결 유형
|
connectionType | string |
연결 형식(현재 또는 대상)입니다. |
|
시간표시
|
timestamp | string |
실패한 새로 고침이 발생한 시기의 타임스탬프입니다. |
|
오류 메시지
|
message | string |
오류에 대한 설명입니다. |
GoalAssigned
할당된 목표 정보입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
목표
|
assignedGoals | array of object |
새 소유자에게 할당된 목표 목록입니다. |
|
아이디
|
assignedGoals.id | string |
목표의 고유 ID입니다. |
|
성과 기록표 ID
|
assignedGoals.scorecardId | string |
성과 기록표의 고유 식별자입니다. |
|
이름
|
assignedGoals.name | string |
목표의 이름입니다. |
|
소유자
|
assignedGoals.owner | string |
목표가 할당된 새 소유자입니다. |
|
마지막 수정 날짜
|
assignedGoals.lastModifiedBy | string |
목표를 마지막으로 수정한 사용자입니다. |
|
시작 날짜
|
assignedGoals.startDate | date |
목표의 시작 날짜입니다. |
|
완료 날짜
|
assignedGoals.completionDate | date |
완료할 목표 날짜입니다. |
GoalValueOrNoteUpserted
목표 체크 인 또는 노트가 추가되거나 변경되었습니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
체크 인
|
values | array of object |
체크 인이 추가되거나 업데이트되었습니다. |
|
날짜
|
values.timestamp | date |
체크 인한 날짜입니다. |
|
가치
|
values.value | number |
체크 인 시 목표 값입니다. |
|
상태
|
values.status | string |
체크 인 시 목표의 상태입니다. |
|
비고
|
notes | array of object |
노트가 추가되거나 변경되었습니다. |
|
체크 인 날짜
|
notes.valueTimestamp | date |
이 메모가 추가된 체크 인 날짜입니다. |
|
문자 메시지
|
notes.body | string |
새로 추가된 메모의 텍스트입니다. |
|
생성 시간
|
notes.createdTime | datetime |
메모를 만든 날짜입니다. |
GoalNotes
노트 목록입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
문자 메시지
|
body | string |
메모의 내용입니다. |
|
생성 시간
|
createdTime | datetime |
메모를 만든 날짜입니다. |
EvaluatedAlert
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
경고 제목
|
alertTitle | string |
경고의 제목입니다. |
|
경고 임계값
|
alertThreshold | number |
경고가 트리거되는 임계값입니다. |
|
경고가 트리거됨
|
isAlertTriggered | boolean |
경고가 트리거되었는지 여부를 결정하는 부울 값(true, false)입니다. |
|
타일 URL
|
tileUrl | string |
경고가 설정된 대시보드 타일에 대한 URL 연결입니다. |
|
타일 값
|
tileValue |
타일의 값입니다. |
이진법
기본 데이터 형식 'binary'입니다.
객체
'object' 형식입니다.