다음을 통해 공유

마이크로소프트 데이터버스

환경에 대한 Microsoft Dataverse 작업 및 Power Platform 트리거에 대한 액세스를 제공합니다.

이 커넥터는 다음 제품과 지역에서 사용할 수 있습니다.

Service 클래스 지역
Copilot Studio 프리미엄 모든 Power Automate 지역
Power Apps 프리미엄 모든 Power Apps 지역
Power Automate (파워 오토메이트) 프리미엄 모든 Power Automate 지역
연락 상대
입력 Microsoft
URL https://make.powerautomate.com/en-us/support/
커넥터 메타데이터
게시자 Microsoft
웹사이트 https://make.powerautomate.com/
개인 정보 보호 정책 https://privacy.microsoft.com
카테고리 데이터

연결 생성

커넥터는 다음과 같은 인증 유형을 지원합니다.
클라이언트 인증서 인증 PFX 인증서 및 암호를 사용하여 Microsoft Entra ID 자격 증명 제공 모든 지역 공유 가능
Oauth Oauth 모든 지역 공유 불가
서비스 프린시펄 클라이언트 ID 및 비밀을 사용하여 Microsoft Entra ID 자격 증명 제공 모든 지역 공유 가능
기본값 [사용되지 않음] 이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다. 모든 지역 공유 불가

클라이언트 인증서 인증

인증 ID: CertOauth

적용 가능 지역: 모든 지역

PFX 인증서 및 암호를 사용하여 Microsoft Entra ID 자격 증명 제공

공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs

입력 유형 Description 필수
임차인 문자열 진실
클라이언트 ID 문자열 Microsoft Entra ID 애플리케이션의 클라이언트 ID 진실
클라이언트 인증서 비밀 클라이언트 인증서 이 애플리케이션에서 허용하는 클라이언트 인증서 비밀 진실

Oauth

인증 ID: Oauth

적용 가능 지역: 모든 지역

Oauth

공유할 수 없는 연결입니다. Power App이 다른 사용자와 공유되는 경우, 다른 사용자에게는 명시적으로 새로운 연결을 생성하라는 메시지가 표시됩니다.

서비스 프린시펄

인증 ID: ServicePrincipalOauth

적용 가능 지역: 모든 지역

클라이언트 ID 및 비밀을 사용하여 Microsoft Entra ID 자격 증명 제공

공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs

입력 유형 Description 필수
클라이언트 ID 문자열 Microsoft Entra ID 애플리케이션의 클라이언트(또는 애플리케이션) ID입니다. 진실
클라이언트 암호 시큐어스트링 (보안 문자열) Microsoft Entra ID 애플리케이션의 클라이언트 암호입니다. 진실
임차인 문자열 Microsoft Entra ID 애플리케이션의 테넌트 ID입니다. 진실

기본값 [사용되지 않음]

적용 가능 지역: 모든 지역

이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.

공유할 수 없는 연결입니다. Power App이 다른 사용자와 공유되는 경우, 다른 사용자에게는 명시적으로 새로운 연결을 생성하라는 메시지가 표시됩니다.

제한 한도

Name 호출 갱신 기간
연결당 API 호출 6000 300초

동작

D365 Sales MCP Server

잠재 고객 자격, 아웃리치 이메일 초안 작성 및 고객에게 전자 메일을 보내는 데 도움이 되는 MCP 판매용 서버 시나리오입니다.
D365 서비스 MCP 서버

D365 Customer Service MCP 서버는 사례(인시던트) 및 계정 엔터티에 기록된 정보를 기반으로 고객의 문제를 해결하는 도구를 제공합니다.
Dataverse MCP Server(미리 보기)

Dataverse에 대한 원격 MCP 서버 액세스 제공
Dataverse MCP 서버(사용되지 않음)

Dataverse MCP 서버. 이 서버를 사용하여 Dataverse에서 정보를 가져올 뿐만 아니라 Dataverse 및 기타 다양한 테이블 형식 원본에서 정보를 얻을 수 있습니다. 이 서버에서 액세스할 수 있는 모든 원본을 확인하려면 list_knowledge_sources 도구를 사용합니다. 이 서버에서 액세스할 수 있는 원본 및 테이블을 사용하여 list_knowledge_sources.
Dynamics 365 Contact Center MCP(미리 보기)

Dynamics 365 Contact Center MCP with tools(미리 보기)
Dynamics 365 Conversation Orchestrator MCP(미리 보기)

도구를 사용하는 Dynamics 365 Conversation Orchestrator MCP(미리 보기)
Dynamics 365 ERP MCP

도구를 사용하는 Dynamics 365 ERP MCP
ID 기준으로 행 가져오기

이 작업을 사용하면 Microsoft Dataverse 테이블에서 ID와 일치하는 행을 가져올 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.
바인딩 작업 수행

이 작업을 사용하면 선택한 테이블과 관련된 작업을 수행할 수 있습니다. Microsoft Dataverse 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.
바인딩되지 않은 작업 수행

이 작업을 사용하면 어떤 테이블과도 연관되지 않은 환경에서 사용 가능한 작업을 수행할 수 있습니다. Microsoft Dataverse 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.
백그라운드 작업 수행(프리뷰)

이 작업을 사용하면 함수로 분류되지 않은 사용자 지정 API를 사용하여 백그라운드에서 Microsoft Dataverse 작업을 수행할 수 있습니다. 드롭다운 메뉴에 나열된 API 목록은 이 작업과 호환되는 API만 나열되어 있습니다.
변경 집합 요청 실행

이 작업을 사용하면 여러 Microsoft Dataverse 커넥터 작업을 단일 트랜잭션으로 수행할 수 있습니다. 작업 중 하나가 실패하면 성공한 모든 작업이 롤백됩니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.
새 행 추가

이 작업을 사용하면 선택한 Microsoft Dataverse 테이블에 새 행을 추가할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.
선택한 환경에 새 행 추가

Power Platform 환경에서 테이블에 새 행을 만듭니다.
선택한 환경에 파일 또는 이미지 업로드

Power Platform 환경에서 행으로 파일이나 이미지 콘텐츠를 업데이트합니다.
선택한 환경에서 ID로 행 가져오기

Power Platform 환경에 있는 테이블에서 행을 가져옵니다.
선택한 환경에서 관계 없는 행

Power Platform 환경에서 개별 행 간의 연결을 제거합니다.
선택한 환경에서 제한 해제된 작업 수행

사용자 지정 작업을 포함하여 Dataverse 환경에서 글로벌 Power Platform 작업을 실행합니다.
선택한 환경에서 제한된 작업 수행

사용자 지정 작업을 포함하여 Dataverse 환경의 테이블에 바인딩된 Power Platform 작업을 실행합니다.
선택한 환경에서 파일 또는 이미지 다운로드

Power Platform 환경의 행에서 파일이나 이미지 데이터를 검색합니다.
선택한 환경에서 행 나열

Power Platform 환경에 있는 테이블의 행을 나열합니다.
선택한 환경에서 행 삭제

Power Platform 환경에서 테이블의 행을 삭제합니다.
선택한 환경의 관계 행

동일한 Power Platform 환경에서 일대다 또는 다대다 관계가 있는 테이블의 개별 행을 연결합니다.
선택한 환경의 행 Upsert

Power Platform 환경에서 테이블의 행을 업데이트하거나 추가(업셋)합니다.
선택한 환경의 행 업데이트

Power Platform 환경의 테이블에 행을 업데이트합니다.
파일 또는 이미지 다운로드

이 작업을 사용하면 Microsoft Dataverse 테이블에서 파일이나 이미지 콘텐츠를 다운로드할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.
파일 또는 이미지 업로드

이 작업을 사용하면 호환되는 열 유형이 있는 Microsoft Dataverse 테이블에 파일이나 이미지 콘텐츠를 업로드할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.
행 Upsert

이 작업을 사용하면 Microsoft Dataverse 테이블에서 선택한 행을 수정하거나, 행이 없으면 새 행을 추가할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.
행 검색(미리 보기)

이 작업을 수행하면 관련성 검색을 사용하여 환경을 검색할 수 있으며 검색어와 가장 일치하는 행이 반환됩니다. Microsoft Dataverse 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.
행 나열

이 작업을 사용하면 선택한 옵션과 일치하는 Microsoft Dataverse 테이블의 행을 나열할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.
행 삭제

이 작업을 사용하면 Microsoft Dataverse 테이블에서 행을 삭제할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.
행 업데이트

이 작업을 수행하면 Microsoft Dataverse 테이블에서 선택한 행을 수정할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.
행 연결

이 작업을 사용하면 두 테이블이 일대다 또는 다대다 관계인 경우 한 Microsoft Dataverse 테이블의 행을 다른 테이블과 연결할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.
행 연결 취소

이 작업을 사용하면 두 테이블이 일대다 또는 다대다 관계인 경우 한 Microsoft Dataverse 테이블의 행과 다른 테이블의 행 간의 링크를 제거할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.

D365 Sales MCP Server

작업 ID:
mcp_SalesMCPServer

잠재 고객 자격, 아웃리치 이메일 초안 작성 및 고객에게 전자 메일을 보내는 데 도움이 되는 MCP 판매용 서버 시나리오입니다.

매개 변수

Name 키 필수 형식 Description
jsonrpc
 jsonrpc string
아이디
 id string
method
 method string
params
 params object
결과
 result object
오류
 error object
세션 ID
 sessionId string

반환

Body
MCPQueryResponse

D365 서비스 MCP 서버

작업 ID:
mcp_ServiceMCPServer

D365 Customer Service MCP 서버는 사례(인시던트) 및 계정 엔터티에 기록된 정보를 기반으로 고객의 문제를 해결하는 도구를 제공합니다.

매개 변수

Name 키 필수 형식 Description
jsonrpc
 jsonrpc string
아이디
 id string
method
 method string
params
 params object
결과
 result object
오류
 error object
세션 ID
 sessionId string

반환

Body
MCPQueryResponse

Dataverse MCP Server(미리 보기)

작업 ID:
InvokeMCP

Dataverse에 대한 원격 MCP 서버 액세스 제공

Dataverse MCP 서버(사용되지 않음)

작업 ID:
mcp_DataverseMCPServer

Dataverse MCP 서버. 이 서버를 사용하여 Dataverse에서 정보를 가져올 뿐만 아니라 Dataverse 및 기타 다양한 테이블 형식 원본에서 정보를 얻을 수 있습니다. 이 서버에서 액세스할 수 있는 모든 원본을 확인하려면 list_knowledge_sources 도구를 사용합니다. 이 서버에서 액세스할 수 있는 원본 및 테이블을 사용하여 list_knowledge_sources.

매개 변수

Name 키 필수 형식 Description
jsonrpc
 jsonrpc string
아이디
 id string
method
 method string
params
 params object
결과
 result object
오류
 error object
세션 ID
 sessionId string

반환

Body
MCPQueryResponse

Dynamics 365 Contact Center MCP(미리 보기)

작업 ID:
mcp_ContactCenterMCPServer

Dynamics 365 Contact Center MCP with tools(미리 보기)

매개 변수

Name 키 필수 형식 Description
jsonrpc
 jsonrpc string
아이디
 id string
method
 method string
params
 params object
결과
 result object
오류
 error object
세션 ID
 sessionId string

반환

Body
MCPQueryResponse

Dynamics 365 Conversation Orchestrator MCP(미리 보기)

작업 ID:
mcp_ConversationOrchestratorMCPServer

도구를 사용하는 Dynamics 365 Conversation Orchestrator MCP(미리 보기)

매개 변수

Name 키 필수 형식 Description
jsonrpc
 jsonrpc string
아이디
 id string
method
 method string
params
 params object
결과
 result object
오류
 error object
세션 ID
 sessionId string

반환

Body
MCPQueryResponse

Dynamics 365 ERP MCP

작업 ID:
mcp_ERPMCPServer

도구를 사용하는 Dynamics 365 ERP MCP

매개 변수

Name 키 필수 형식 Description
jsonrpc
 jsonrpc string
아이디
 id string
method
 method string
params
 params object
결과
 result object
오류
 error object
세션 ID
 sessionId string

반환

Body
MCPQueryResponse

ID 기준으로 행 가져오기

작업 ID:
GetItem

이 작업을 사용하면 Microsoft Dataverse 테이블에서 ID와 일치하는 행을 가져올 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.

매개 변수

Name 키 필수 형식 Description
전체 메타데이터 반환
 x-ms-odata-metadata-full boolean

고객이 응답에서 전체 odata 메타데이터를 반환하도록 옵트인하는 헤더 매개 변수입니다.
테이블 이름
 entityName True string

테이블 선택
행 ID
 recordId True string

행의 GUID(Globally Unique Identifier)를 입력합니다
열 선택
 $select string

쉼표로 구분된 열 고유 이름 목록을 입력하여 나열되는 열을 제한합니다
쿼리 확장
 $expand string

OData 스타일 확장 쿼리를 입력하여 관련 행을 나열합니다
파티션 ID
 partitionId string

NoSQL 테이블에 대한 데이터를 검색하는 동안 partitionId를 지정하는 옵션

반환

응답
object

바인딩 작업 수행

작업 ID:
PerformBoundAction

이 작업을 사용하면 선택한 테이블과 관련된 작업을 수행할 수 있습니다. Microsoft Dataverse 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.

매개 변수

Name 키 필수 형식 Description
테이블 이름
 entityName True string

테이블 선택
작업 이름
 actionName True string

작업 선택
행 ID
 recordId True string

행의 GUID(Globally Unique Identifier)를 입력합니다
object

반환

응답
object

바인딩되지 않은 작업 수행

작업 ID:
PerformUnboundAction

이 작업을 사용하면 어떤 테이블과도 연관되지 않은 환경에서 사용 가능한 작업을 수행할 수 있습니다. Microsoft Dataverse 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.

매개 변수

Name 키 필수 형식 Description
작업 이름
 actionName True string

작업 선택
object

반환

응답
object

백그라운드 작업 수행(프리뷰)

작업 ID:
PerformBackgroundOperation

이 작업을 사용하면 함수로 분류되지 않은 사용자 지정 API를 사용하여 백그라운드에서 Microsoft Dataverse 작업을 수행할 수 있습니다. 드롭다운 메뉴에 나열된 API 목록은 이 작업과 호환되는 API만 나열되어 있습니다.

매개 변수

Name 키 필수 형식 Description
동적 항목
 item True dynamic

동적 항목
카탈로그
 catalog True string

테이블 및 작업을 필터링하는 옵션을 선택합니다.
카테고리
 category True string

테이블 및 작업을 필터링하는 옵션을 선택합니다.
작업 이름
 actionName True string

작업을 선택합니다.

반환

백그라운드 작업 상태 코드와 데이터 상태 응답 개체입니다.

Body
WebhookNotificationContentForPerformBackgroundOperation

변경 집합 요청 실행

작업 ID:
ExecuteChangeset

이 작업을 사용하면 여러 Microsoft Dataverse 커넥터 작업을 단일 트랜잭션으로 수행할 수 있습니다. 작업 중 하나가 실패하면 성공한 모든 작업이 롤백됩니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.

새 행 추가

작업 ID:
CreateRecord

이 작업을 사용하면 선택한 Microsoft Dataverse 테이블에 새 행을 추가할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.

매개 변수

Name 키 필수 형식 Description
전체 메타데이터 반환
 x-ms-odata-metadata-full boolean

고객이 응답에서 전체 odata 메타데이터를 반환하도록 옵트인하는 헤더 매개 변수입니다.
테이블 이름
 entityName True string

테이블 선택
object

반환

응답
object

선택한 환경에 새 행 추가

작업 ID:
CreateRecordWithOrganization

Power Platform 환경에서 테이블에 새 행을 만듭니다.

매개 변수

Name 키 필수 형식 Description
전체 메타데이터 반환
 x-ms-odata-metadata-full boolean

고객이 응답에서 전체 odata 메타데이터를 반환하도록 옵트인하는 헤더 매개 변수입니다.
Environment
 organization True string

환경 선택
테이블 이름
 entityName True string

테이블 선택
행 항목
 item True dynamic

만들 행

반환

이 작업의 출력은 동적입니다.

선택한 환경에 파일 또는 이미지 업로드

작업 ID:
UpdateEntityFileImageFieldContentWithOrganization

Power Platform 환경에서 행으로 파일이나 이미지 콘텐츠를 업데이트합니다.

매개 변수

Name 키 필수 형식 Description
Environment
 organization True string

환경 선택
테이블 이름
 entityName True string

테이블 선택
행 ID
 recordId True string

행의 GUID(Globally Unique Identifier)를 입력합니다
열 이름
 fileImageFieldName True string

열 선택
콘텐츠
 item True binary

파일 또는 이미지 콘텐츠 추가
콘텐츠 이름
 x-ms-file-name True string

파일 또는 이미지의 이름 입력

선택한 환경에서 ID로 행 가져오기

작업 ID:
GetItemWithOrganization

Power Platform 환경에 있는 테이블에서 행을 가져옵니다.

매개 변수

Name 키 필수 형식 Description
전체 메타데이터 반환
 x-ms-odata-metadata-full boolean

고객이 응답에서 전체 odata 메타데이터를 반환하도록 옵트인하는 헤더 매개 변수입니다.
Environment
 organization True string

환경 선택
민감도 레이블 추출
 MSCRM.IncludeMipSensitivityLabel boolean

민감도 레이블 ID를 가져올지 선택합니다.
테이블 이름
 entityName True string

테이블 선택
행 ID
 recordId True string

행의 GUID(Globally Unique Identifier)를 입력합니다
열 선택
 $select string

쉼표로 구분된 열 고유 이름 목록을 입력하여 나열되는 열을 제한합니다
쿼리 확장
 $expand string

OData 스타일 확장 쿼리를 입력하여 관련 행을 나열합니다
파티션 ID
 partitionId string

NoSQL 테이블에 대한 데이터를 검색하는 동안 partitionId를 지정하는 옵션

반환

이 작업의 출력은 동적입니다.

선택한 환경에서 관계 없는 행

작업 ID:
DisassociateEntitiesWithOrganization

Power Platform 환경에서 개별 행 간의 연결을 제거합니다.

매개 변수

Name 키 필수 형식 Description
Environment
 organization True string

환경 선택
테이블 이름
 entityName True string

테이블 선택
행 ID
 recordId True string

행의 GUID(Globally Unique Identifier)를 입력합니다
관계
 associationEntityRelationship True string

관계 유형 선택
다음과 관련 없음
 $id True string

이전 단계의 OData ID를 사용하거나 전체 URL을 입력하여 행 URL을 입력합니다(예: https://org0.crm.dynamics.com/api/data/v9.0/faxes(3ce6c728-3c8a-4b55-a4ee-a251b253c3ee)

선택한 환경에서 제한 해제된 작업 수행

작업 ID:
PerformUnboundActionWithOrganization

사용자 지정 작업을 포함하여 Dataverse 환경에서 글로벌 Power Platform 작업을 실행합니다.

매개 변수

Name 키 필수 형식 Description
Environment
 organization True string

환경 선택
작업 이름
 actionName True string

작업 선택
작업 매개 변수
 item dynamic

작업 매개 변수

반환

이 작업의 출력은 동적입니다.

선택한 환경에서 제한된 작업 수행

작업 ID:
PerformBoundActionWithOrganization

사용자 지정 작업을 포함하여 Dataverse 환경의 테이블에 바인딩된 Power Platform 작업을 실행합니다.

매개 변수

Name 키 필수 형식 Description
Environment
 organization True string

환경 선택
테이블 이름
 entityName True string

테이블 선택
작업 이름
 actionName True string

작업 선택
행 ID
 recordId True string

행의 GUID(Globally Unique Identifier)를 입력합니다
작업 매개 변수
 item dynamic

작업 매개 변수

반환

이 작업의 출력은 동적입니다.

선택한 환경에서 파일 또는 이미지 다운로드

작업 ID:
GetEntityFileImageFieldContentWithOrganization

Power Platform 환경의 행에서 파일이나 이미지 데이터를 검색합니다.

매개 변수

Name 키 필수 형식 Description
Environment
 organization True string

환경 선택
테이블 이름
 entityName True string

테이블 선택
행 ID
 recordId True string

행의 GUID(Globally Unique Identifier)를 입력합니다
열 이름
 fileImageFieldName True string

열 선택
이미지 크기
 size string

사용된 경우 전체 이미지에 'full'을 입력합니다(기본값 = 썸네일)

반환

원본 이미지 파일의 파일 콘텐츠

파일 또는 이미지 콘텐츠
binary

선택한 환경에서 행 나열

작업 ID:
ListRecordsWithOrganization

Power Platform 환경에 있는 테이블의 행을 나열합니다.

매개 변수

Name 키 필수 형식 Description
전체 메타데이터 반환
 x-ms-odata-metadata-full boolean

고객이 응답에서 전체 odata 메타데이터를 반환하도록 옵트인하는 헤더 매개 변수입니다.
Environment
 organization True string

환경 선택
민감도 레이블 추출
 MSCRM.IncludeMipSensitivityLabel boolean

민감도 레이블 ID를 가져올지 선택합니다.
테이블 이름
 entityName True string

테이블 선택
열 선택
 $select string

쉼표로 구분된 열 고유 이름 목록을 입력하여 나열되는 열을 제한합니다
행 필터
 $filter string

나열된 행을 제한하는 OData 스타일 필터 식을 입력합니다
정렬 기준:
 $orderby string

OData orderBy 스타일에서 정렬할 열(보기 제외)
쿼리 확장
 $expand string

OData 스타일 확장 쿼리를 입력하여 관련 행을 나열합니다
XML 쿼리 가져오기
 fetchXml string

고급 사용자 지정을 위해 XML 가져오기 쿼리를 입력합니다
행 수
 $top integer

나열할 행을 입력하세요. 기본값은 2000입니다. 더 많은 행을 표시하려면 설정에서 페이징을 활성화하세요.
토큰 건너뛰기
 $skiptoken string

이전 실행에서 얻은 건너뛰기 토큰을 입력하여 다음 페이지의 행을 나열합니다
파티션 ID
 partitionId string

NoSQL 테이블에 대한 데이터를 검색하는 동안 partitionId를 지정하는 옵션

반환

이 작업의 출력은 동적입니다.

선택한 환경에서 행 삭제

작업 ID:
DeleteRecordWithOrganization

Power Platform 환경에서 테이블의 행을 삭제합니다.

매개 변수

Name 키 필수 형식 Description
Environment
 organization True string

환경 선택
테이블 이름
 entityName True string

테이블 선택
행 ID
 recordId True string

행의 GUID(Globally Unique Identifier)를 입력합니다
파티션 ID
 partitionId string

NoSQL 테이블에 대한 행을 삭제하는 동안 partitionId를 지정하는 옵션

선택한 환경의 관계 행

작업 ID:
AssociateEntitiesWithOrganization

동일한 Power Platform 환경에서 일대다 또는 다대다 관계가 있는 테이블의 개별 행을 연결합니다.

매개 변수

Name 키 필수 형식 Description
Environment
 organization True string

환경 선택
테이블 이름
 entityName True string

테이블 선택
행 ID
 recordId True string

행의 GUID(Globally Unique Identifier)를 입력합니다
관계
 associationEntityRelationship True string

관계 유형 선택
다음과 관련
 @odata.id True string

이전 단계의 OData ID를 사용하거나 전체 URL을 입력하여 행 URL을 입력합니다(예: https://org0.crm.dynamics.com/api/data/v9.0/faxes(3ce6c728-3c8a-4b55-a4ee-a251b253c3ee)

선택한 환경의 행 Upsert

작업 ID:
UpdateRecordWithOrganization

Power Platform 환경에서 테이블의 행을 업데이트하거나 추가(업셋)합니다.

매개 변수

Name 키 필수 형식 Description
전체 메타데이터 반환
 x-ms-odata-metadata-full boolean

고객이 응답에서 전체 odata 메타데이터를 반환하도록 옵트인하는 헤더 매개 변수입니다.
Environment
 organization True string

환경 선택
테이블 이름
 entityName True string

테이블 선택
행 ID
 recordId True string

행의 GUID(Globally Unique Identifier)를 입력합니다
행 항목
 item True dynamic

업데이트할 행

반환

이 작업의 출력은 동적입니다.

선택한 환경의 행 업데이트

작업 ID:
UpdateOnlyRecordWithOrganization

Power Platform 환경의 테이블에 행을 업데이트합니다.

매개 변수

Name 키 필수 형식 Description
전체 메타데이터 반환
 x-ms-odata-metadata-full boolean

고객이 응답에서 전체 odata 메타데이터를 반환하도록 옵트인하는 헤더 매개 변수입니다.
Environment
 organization True string

환경 선택
테이블 이름
 entityName True string

테이블 선택
행 ID
 recordId True string

행의 GUID(Globally Unique Identifier)를 입력합니다
행 항목
 item True dynamic

업데이트할 행

반환

이 작업의 출력은 동적입니다.

파일 또는 이미지 다운로드

작업 ID:
GetEntityFileImageFieldContent

이 작업을 사용하면 Microsoft Dataverse 테이블에서 파일이나 이미지 콘텐츠를 다운로드할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.

매개 변수

Name 키 필수 형식 Description
테이블 이름
 entityName True string

테이블 선택
행 ID
 recordId True string

행의 GUID(Globally Unique Identifier)를 입력합니다
열 이름
 fileImageFieldName True string

열 선택
이미지 크기
 size string

사용된 경우 전체 이미지에 'full'을 입력합니다(기본값 = 썸네일)

반환

원본 이미지 파일의 파일 콘텐츠

파일 또는 이미지 콘텐츠
binary

파일 또는 이미지 업로드

작업 ID:
UpdateEntityFileImageFieldContent

이 작업을 사용하면 호환되는 열 유형이 있는 Microsoft Dataverse 테이블에 파일이나 이미지 콘텐츠를 업로드할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.

매개 변수

Name 키 필수 형식 Description
테이블 이름
 entityName True string

테이블 선택
행 ID
 recordId True string

행의 GUID(Globally Unique Identifier)를 입력합니다
열 이름
 fileImageFieldName True string

열 선택
콘텐츠
 item True binary

파일 또는 이미지 콘텐츠 추가
콘텐츠 이름
 x-ms-file-name True string

파일 또는 이미지의 이름 입력

행 Upsert

작업 ID:
UpdateRecord

이 작업을 사용하면 Microsoft Dataverse 테이블에서 선택한 행을 수정하거나, 행이 없으면 새 행을 추가할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.

매개 변수

Name 키 필수 형식 Description
전체 메타데이터 반환
 x-ms-odata-metadata-full boolean

고객이 응답에서 전체 odata 메타데이터를 반환하도록 옵트인하는 헤더 매개 변수입니다.
테이블 이름
 entityName True string

테이블 선택
행 ID
 recordId True string

행의 GUID(Globally Unique Identifier)를 입력합니다
object

반환

응답
object

행 검색(미리 보기)

작업 ID:
GetRelevantRows

이 작업을 수행하면 관련성 검색을 사용하여 환경을 검색할 수 있으며 검색어와 가장 일치하는 행이 반환됩니다. Microsoft Dataverse 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.

매개 변수

Name 키 필수 형식 Description
검색 용어
 search True string

검색어를 입력하세요. 예: 콘토소. 부울 연산자, 와일드카드, 퍼지 검색, 근접 검색 등과 같은 검색 수정자는 전체 검색 유형이 필요합니다.
검색 유형
 searchtype string

간단한 검색 구문을 사용할지 전체 검색 구문을 사용할지 입력합니다(기본값은 간단한 것입니다)
검색 모드
 searchmode string

검색어 중 일부 또는 전부가 일치해야 하는지 여부를 입력합니다(기본값은 any입니다)
행 수
 top integer

나열할 검색 결과의 수를 입력하세요 (기본값 = 50)
행 필터
 filter string

검색 범위를 좁히려면 Odata 스타일 필터 표현식을 입력하세요.
테이블 필터
 entities array of string

검색할 테이블의 쉼표로 구분된 목록을 입력하세요(기본값은 모든 테이블입니다)
정렬 기준
 orderby array of string

열 고유 이름의 쉼표로 구분된 목록을 입력하세요. 뒤에 asc 또는 desc가 붙습니다.
패싯 쿼리
 facets array of string

검색 범위를 좁히려면 쉼표로 구분된 패싯 쿼리 목록을 입력하세요.
행 건너뛰기
 skip integer

건너뛸 검색 결과의 수를 입력하세요.
행 개수 반환
 returntotalrecordcount boolean

옵션 선택

반환

검색 결과입니다.

Body
SearchOutput

행 나열

작업 ID:
ListRecords

이 작업을 사용하면 선택한 옵션과 일치하는 Microsoft Dataverse 테이블의 행을 나열할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.

매개 변수

Name 키 필수 형식 Description
전체 메타데이터 반환
 x-ms-odata-metadata-full boolean

고객이 응답에서 전체 odata 메타데이터를 반환하도록 옵트인하는 헤더 매개 변수입니다.
테이블 이름
 entityName True string

테이블 선택
열 선택
 $select string

쉼표로 구분된 열 고유 이름 목록을 입력하여 나열되는 열을 제한합니다
행 필터
 $filter string

나열된 행을 제한하는 OData 스타일 필터 식을 입력합니다
정렬 기준:
 $orderby string

OData orderBy 스타일에서 정렬할 열(보기 제외)
쿼리 확장
 $expand string

OData 스타일 확장 쿼리를 입력하여 관련 행을 나열합니다
XML 쿼리 가져오기
 fetchXml string

고급 사용자 지정을 위해 XML 가져오기 쿼리를 입력합니다
행 수
 $top integer

나열할 행 수를 입력합니다(기본값 = 5000)
토큰 건너뛰기
 $skiptoken string

이전 실행에서 얻은 건너뛰기 토큰을 입력하여 다음 페이지의 행을 나열합니다
파티션 ID
 partitionId string

NoSQL 테이블에 대한 데이터를 검색하는 동안 partitionId를 지정하는 옵션

반환

테이블 목록

Body
EntityItemList

행 삭제

작업 ID:
DeleteRecord

이 작업을 사용하면 Microsoft Dataverse 테이블에서 행을 삭제할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.

매개 변수

Name 키 필수 형식 Description
테이블 이름
 entityName True string

테이블 선택
행 ID
 recordId True string

행의 GUID(Globally Unique Identifier)를 입력합니다
파티션 ID
 partitionId string

NoSQL 테이블에 대한 행을 삭제하는 동안 partitionId를 지정하는 옵션

행 업데이트

작업 ID:
UpdateOnlyRecord

이 작업을 수행하면 Microsoft Dataverse 테이블에서 선택한 행을 수정할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.

매개 변수

Name 키 필수 형식 Description
전체 메타데이터 반환
 x-ms-odata-metadata-full boolean

고객이 응답에서 전체 odata 메타데이터를 반환하도록 옵트인하는 헤더 매개 변수입니다.
테이블 이름
 entityName True string

테이블 선택
행 ID
 recordId True string

행의 GUID(Globally Unique Identifier)를 입력합니다
object

반환

응답
object

행 연결

작업 ID:
AssociateEntities

이 작업을 사용하면 두 테이블이 일대다 또는 다대다 관계인 경우 한 Microsoft Dataverse 테이블의 행을 다른 테이블과 연결할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.

매개 변수

Name 키 필수 형식 Description
테이블 이름
 entityName True string

테이블 선택
행 ID
 recordId True string

행의 GUID(Globally Unique Identifier)를 입력합니다
관계
 associationEntityRelationship True string

관계 유형 선택
다음과 관련
 @odata.id True string

이전 단계의 OData ID를 사용하거나 전체 URL을 입력하여 행 URL을 입력합니다(예: https://org0.crm.dynamics.com/api/data/v9.0/faxes(3ce6c728-3c8a-4b55-a4ee-a251b253c3ee)

행 연결 취소

작업 ID:
DisassociateEntities

이 작업을 사용하면 두 테이블이 일대다 또는 다대다 관계인 경우 한 Microsoft Dataverse 테이블의 행과 다른 테이블의 행 간의 링크를 제거할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.

매개 변수

Name 키 필수 형식 Description
테이블 이름
 entityName True string

테이블 선택
행 ID
 recordId True string

행의 GUID(Globally Unique Identifier)를 입력합니다
관계
 associationEntityRelationship True string

관계 유형 선택
다음과 관련 없음
 $id True string

이전 단계의 OData ID를 사용하거나 전체 URL을 입력하여 행 URL을 입력합니다(예: https://org0.crm.dynamics.com/api/data/v9.0/faxes(3ce6c728-3c8a-4b55-a4ee-a251b253c3ee)

트리거

작업 수행 시

Microsoft Dataverse 작업이 완료되면 트리거됩니다.
행이 선택되는 경우

명령 모음의 Flow 메뉴에서 행을 선택할 때 흐름을 트리거합니다. ( Power Automate에만 사용 가능합니다.)
행이 추가되거나 수정되거나 삭제될 때

이 트리거를 사용하면 Microsoft Dataverse 테이블에 행이 추가, 수정 또는 삭제될 때 선택한 옵션과 일치하도록 흐름을 시작할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.
흐름 단계가 비즈니스 프로세스 흐름에서 실행되는 경우

이 트리거를 사용하면 비즈니스 프로세스 흐름 단계에서 흐름 실행 버튼을 클릭할 때 흐름을 시작할 수 있습니다. ( Power Automate에만 사용 가능합니다.)

작업 수행 시

작업 ID:
BusinessEventsTrigger

Microsoft Dataverse 작업이 완료되면 트리거됩니다.

매개 변수

Name 키 필수 형식 Description
카탈로그
 catalog True string

테이블 및 작업을 필터링하는 옵션을 선택합니다.
카테고리
 category True string

테이블 및 작업을 필터링하는 옵션을 선택합니다.
테이블 이름
 entityname True string

작업을 필터링할 테이블을 선택하세요.
작업 이름
 sdkmessagename True string

작업을 선택합니다.

반환

작업 및 테이블 항목입니다.

Body
WebhookNotificationContentForWhenAnActionIsPerformed

행이 선택되는 경우

작업 ID:
OnRecordSelected

명령 모음의 Flow 메뉴에서 행을 선택할 때 흐름을 트리거합니다. ( Power Automate에만 사용 가능합니다.)

매개 변수

Name 키 필수 형식 Description
operationId
 operationId True string
host
 host object
매개 변수
 parameters True object
스키마
 schema True object
헤더스키마
 headersSchema object

반환

Name 경로 형식 Description
행
 body.rows array of object
항목
 body.rows object
사용자 ID
 headers.x-ms-user-id-encoded guid

AAD에서 흐름을 트리거한 사용자의 고유 식별자입니다.
사용자 이메일
 headers.x-ms-user-email-encoded byte

해당 흐름을 트리거한 사용자의 이메일 주소입니다
사용자 이름
 headers.x-ms-user-name-encoded byte

흐름을 트리거한 사용자의 표시 이름입니다.
타임스탬프
 headers.x-ms-user-timestamp string

흐름이 트리거된 시간입니다.

행이 추가되거나 수정되거나 삭제될 때

작업 ID:
SubscribeWebhookTrigger

이 트리거를 사용하면 Microsoft Dataverse 테이블에 행이 추가, 수정 또는 삭제될 때 선택한 옵션과 일치하도록 흐름을 시작할 수 있습니다. 이 커넥터는 이전에 Common Data Service (현재 환경)으로 알려져 있었습니다.

매개 변수

Name 키 필수 형식 Description
유형 변경
 message True integer

흐름이 트리거될 때 선택
테이블 이름
 entityname True string

테이블 선택
Scope
 scope True integer

흐름을 트리거할 수 있는 행을 제한하려면 범위를 선택합니다
열 선택
 filteringattributes string

열의 고유한 이름을 쉼표로 구분하여 입력하세요. 그 중 하나라도 수정되면 흐름이 트리거됩니다.
행 필터
 filterexpression string

흐름을 트리거할 수 있는 행을 제한하는 Odata 식입니다(예: statecode eq 0)
다음 기간까지 지연
 postponeuntil string

트리거 평가를 지연하는 시간을 입력합니다(예: 2020-01-01T10:10:00Z)
다음으로 실행
 runas integer

호출자 연결이 사용되는 단계에 대해 실행 중인 사용자를 선택하세요

반환

테이블 항목입니다.

Body
WebhookNotificationContent

흐름 단계가 비즈니스 프로세스 흐름에서 실행되는 경우

작업 ID:
OnFlowStepRun

이 트리거를 사용하면 비즈니스 프로세스 흐름 단계에서 흐름 실행 버튼을 클릭할 때 흐름을 시작할 수 있습니다. ( Power Automate에만 사용 가능합니다.)

매개 변수

Name 키 필수 형식 Description
operationId
 operationId string
host
 host object
스키마
 schema True object

반환

Name 경로 형식 Description
흐름 워크플로 로그 ID
 entity.FlowsWorkflowLogId string

흐름 워크플로 로그 ID입니다.
BPF 인스턴스 ID
 entity.BPFInstanceId string

비즈니스 프로세스 흐름 인스턴스 ID입니다.
BPF 인스턴스 테이블 이름
 entity.BPFInstanceEntityName string

비즈니스 프로세스 흐름 인스턴스 테이블 이름입니다.
BPF 정의 ID
 entity.BPFDefinitionId string

비즈니스 프로세스 흐름 정의 ID입니다.
BPF 정의 테이블 이름
 entity.BPFDefinitionEntityName string

비즈니스 프로세스 흐름 정의 테이블 이름입니다.
단계 ID
 entity.StepId string

비즈니스 프로세스 흐름 단계 ID입니다.
BPF 정의 이름
 entity.BPFDefinitionName string

비즈니스 프로세스 흐름 정의 이름입니다.
BPF 인스턴스 이름
 entity.BPFInstanceName string

비즈니스 프로세스 흐름 인스턴스 이름입니다.
BPF Flow 스테이지 지역화된 이름
 entity.BPFFlowStageLocalizedName string

비즈니스 프로세스 흐름 스테이지 지역화된 이름입니다.
BPF Flow 스테이지 테이블 이름
 entity.BPFFlowStageEntityName string

비즈니스 프로세스 흐름 스테이지 테이블 이름입니다.
BPF Flow 스테이지 테이블 컬렉션 이름
 entity.BPFFlowStageEntityCollectionName string

비즈니스 프로세스 흐름 스테이지 테이블 컬렉션 이름입니다.
BPF 흐름 스테이지 테이블 행 ID
 entity.BPFFlowStageEntityRecordId string

비즈니스 프로세스 흐름 스테이지 테이블 행 ID입니다.
BPF 활성 스테이지 ID
 entity.BPFActiveStageId string

비즈니스 프로세스 흐름 활성 스테이지 ID입니다.
BPF 활성 스테이지 테이블 이름
 entity.BPFActiveStageEntityName string

비즈니스 프로세스 흐름 활성 스테이지 테이블 이름입니다.
BPF 활성 스테이지 지역화된 이름
 entity.BPFActiveStageLocalizedName string

비즈니스 프로세스 흐름 활성 스테이지 지역화된 이름입니다.

정의

엔티티 항목 목록

테이블 목록

Name 경로 형식 Description
value
 value array of EntityItem

항목 목록
다음 링크
 @odata.nextLink string

다음 페이지 데이터를 가져올 URL입니다.

엔티티항목

테이블 항목

Name 경로 형식 Description
동적 속성
 dynamicProperties object

Object

웹후크알림내용

테이블 항목입니다.

Name 경로 형식 Description
스키마
 schema Object

검색출력

검색 결과입니다.

Name 경로 형식 Description
행 목록
 value array of object

행 목록
행 검색 점수
 value.@search.score number

행의 점수 검색
행 테이블 이름
 value.@search.entityname string

행을 포함하는 테이블
행 개체 ID
 value.@search.objectid string

행의 Objectid
헹 개체 유형 코드
 value.@search.objecttypecode integer

행의 Objecttypecode
총 행 수
 totalrecordcount integer

결과의 총 개수(-1 returntotalrecordcount가 false로 설정된 경우)

WebhookNotificationContentForWhenAnActionIsPerformed

작업 및 테이블 항목입니다.

Name 경로 형식 Description
스키마
 schema Object

WebhookNotificationContentForPerformBackgroundOperation

백그라운드 작업 상태 코드와 데이터 상태 응답 개체입니다.

Name 경로 형식 Description
스키마
 schema Object

MCPQueryResponse

Name 경로 형식 Description
jsonrpc
 jsonrpc string
아이디
 id string
method
 method string
params
 params object
결과
 result object
오류
 error object

개체

이것은 '객체' 유형입니다.

이진

이것은 기본 데이터 유형인 '바이너리'입니다.