SAP OData
엔터티 만들기, 읽기, 업데이트 및 삭제와 같은 다양한 작업을 수행하고 서비스에서 함수를 호출하기 위해 SAP ODATA 서비스를 호출하는 데 사용할 수 있는 OData 커넥터입니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 모든 Power Automate 지역 |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 모든 Power Apps 지역 |
| Power Automate (파워 오토메이트) | Premium | 모든 Power Automate 지역 |
| 연락처 | |
|---|---|
| 이름 | Microsoft |
| URL |
Microsoft LogicApps 지원 Microsoft Power Automate 지원 Microsoft Power Apps 지원 |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://www.odata.org/ |
| 개인 정보 보호 정책 | https://privacy.microsoft.com/privacystatement |
알려진 문제 및 제한 사항
- 커넥터는 OData 프로토콜의 전체 구현이 아니며 모든 시나리오를 지원하지 않을 수 있습니다.
- Power Apps 테이블 형식 기능에 대한 "읽기" 지원만 지원됩니다.
- $metadata 응답이 큰 OData 서비스의 경우 성능 문제를 방지하기 위해 "모든 유형의 OData 요청 만들기" 작업 및 "bypassMetadata" 매개 변수를 사용합니다.
Virtual Network 지원(공개 미리 보기)
Virtual Network에 연결된 Power Platform 환경에서 커넥터를 사용하는 경우 다음과 같은 제한 사항이 적용됩니다.
- 온-프레미스 데이터 게이트웨이는 지원되지 않습니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 익명 | OData 서비스에 익명 액세스를 사용합니다. | 모든 지역 | 공유할 수 없음 |
| Basic | 사용자 이름 및 암호를 사용하여 OData 서비스에 액세스합니다. | 모든 지역 | 공유할 수 없음 |
| Microsoft Entra ID 통합(APIM 포함) | Microsoft Entra ID를 사용하여 SAP 인스턴스에 액세스합니다. | 모든 지역 | 공유할 수 없음 |
| SuccessFactors를 사용하는 Microsoft Entra ID(미리 보기) | SuccessFactors에 대한 인증에 Microsoft Entra ID를 사용합니다. | 모든 지역 | 공유할 수 없음 |
| 기본값 [사용되지 않음] | 이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다. | 모든 지역 | 공유할 수 없음 |
익명
인증 ID: 익명
적용 가능: 모든 지역
OData 서비스에 익명 액세스를 사용합니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| OData 기본 URI | 문자열 | 진실 | |
| Gateway | gatewaySetting | 온-프레미스 게이트웨이(자세한 내용은 참조 https://docs.microsoft.com/data-integration/gateway ) | |
| API 키 이름 | 문자열 | ||
| API 키 값 | 시큐어스트링 (보안 문자열) | ||
| SAP 클라이언트 이름 | 문자열 | ||
| SAP 클라이언트 값 | 시큐어스트링 (보안 문자열) |
기초
인증 ID: 기본
적용 가능: 모든 지역
사용자 이름 및 암호를 사용하여 OData 서비스에 액세스합니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| OData 기본 URI | 문자열 | 진실 | |
| 사용자 이름 | 시큐어스트링 (보안 문자열) | 진실 | |
| 암호 | 시큐어스트링 (보안 문자열) | 진실 | |
| Gateway | gatewaySetting | 온-프레미스 게이트웨이(자세한 내용은 참조 https://docs.microsoft.com/data-integration/gateway ) | |
| API 키 이름 | 문자열 | ||
| API 키 값 | 시큐어스트링 (보안 문자열) | ||
| SAP 클라이언트 이름 | 문자열 | ||
| SAP 클라이언트 값 | 시큐어스트링 (보안 문자열) |
Microsoft Entra ID 통합(APIM 포함)
인증 ID: oauth
적용 가능: 모든 지역
Microsoft Entra ID를 사용하여 SAP 인스턴스에 액세스합니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| Microsoft Entra ID 리소스 URI(애플리케이션 ID URI) | 문자열 | Microsoft Entra ID에서 대상 리소스를 식별하는 데 사용되는 식별자입니다. | 진실 |
| OData 기본 URI | 문자열 | 진실 | |
| Gateway | gatewaySetting | 온-프레미스 게이트웨이(자세한 내용은 참조 https://docs.microsoft.com/data-integration/gateway ) | |
| API 키 이름 | 문자열 | ||
| API 키 값 | 시큐어스트링 (보안 문자열) | ||
| SAP 클라이언트 이름 | 문자열 | ||
| SAP 클라이언트 값 | 시큐어스트링 (보안 문자열) |
SuccessFactors를 사용하는 Microsoft Entra ID(미리 보기)
인증 ID: oauthsuccessfactors
적용 가능: 모든 지역
SuccessFactors에 대한 인증에 Microsoft Entra ID를 사용합니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 성공 요소 토큰 URL | 문자열 | SuccessFactors OAuth 토큰 엔드포인트 URL(형식: https://<api-server>/oauth/token). |
진실 |
| 서비스 공급자 클라이언트 ID | 문자열 | SuccessFactors OAuth2 클라이언트 ID입니다. | 진실 |
| 회사 ID | 문자열 | CompanyId | 진실 |
| Microsoft Entra 리소스 URL(애플리케이션 ID URI) | 문자열 | Microsoft Entra ID에서 대상 리소스를 식별하는 데 사용되는 식별자입니다. | 진실 |
| OData 기본 URI | 문자열 | 진실 |
기본값 [사용되지 않음]
적용 가능: 모든 지역
이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| OData 기본 URI | 문자열 | 진실 | |
| 인증 유형 | 문자열 | OData 서비스에 연결할 인증 유형입니다. | 진실 |
| 사용자 이름 | 시큐어스트링 (보안 문자열) | OData 서비스에 연결하는 데 사용할 사용자 이름입니다. | 진실 |
| 암호 | 시큐어스트링 (보안 문자열) | OData 서비스에 연결하는 데 사용할 암호입니다. | 진실 |
| Gateway | gatewaySetting | 온-프레미스 게이트웨이(자세한 내용은 참조 https://docs.microsoft.com/data-integration/gateway ) |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 2500 | 60초 |
동작
| OData 엔터티 만들기 |
OData 엔터티를 만듭니다. |
| OData 엔터티 삭제 |
OData 엔터티를 삭제합니다. |
| OData 엔터티 업데이트 |
OData 엔터티를 업데이트합니다. |
| OData 엔터티 읽기 |
OData 엔터티를 읽습니다. |
| OData 엔터티 쿼리 |
OData 엔터티 데이터를 쿼리합니다. |
| 모든 유형의 OData 요청 만들기 |
모든 유형의 OData 요청을 만듭니다. |
| 모든 유형의 대량 OData 요청 만들기(미리 보기) |
모든 유형의 대량 OData 요청을 만듭니다. |
OData 엔터티 만들기
OData 엔터티를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
OData 엔터티 이름
|
entity | True | string |
OData 엔터티 이름을 지정하세요. |
|
OData 엔터티 입력
|
entryInput | True | dynamic |
OData 엔터티 입력을 지정하세요. |
|
상대 경로
|
relativePath | string |
연결에서 OData URI와 결합하여 상호 작용할 전체 URI를 만듭니다. |
반환
OData 엔터티 삭제
OData 엔터티를 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
OData 엔터티 이름
|
entity | True | string |
OData 엔터티 이름을 지정하세요. |
|
OData 엔터티 입력
|
entryInput | True | dynamic |
OData 엔터티 입력을 지정하세요. |
|
상대 경로
|
relativePath | string |
연결에서 OData URI와 결합하여 상호 작용할 전체 URI를 만듭니다. |
반환
- response
- object
OData 엔터티 업데이트
OData 엔터티를 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
OData 엔터티 이름
|
entity | True | string |
OData 엔터티 이름을 지정하세요. |
|
OData 엔터티 입력
|
entryInput | True | dynamic |
OData 엔터티 입력을 지정하세요. |
|
상대 경로
|
relativePath | string |
연결에서 OData URI와 결합하여 상호 작용할 전체 URI를 만듭니다. |
반환
OData 엔터티 읽기
OData 엔터티를 읽습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
OData 엔터티 이름
|
entity | True | string |
OData 엔터티 이름을 지정하세요. |
|
OData 엔터티 입력
|
entryInput | True | dynamic |
OData 엔터티 입력을 지정하세요. |
|
상대 경로
|
relativePath | string |
연결에서 OData URI와 결합하여 상호 작용할 전체 URI를 만듭니다. |
|
|
$top
|
top | number |
선택적 $top 쿼리 옵션입니다. |
|
|
$skip
|
skip | number |
선택적 $skip 쿼리 옵션입니다. |
|
|
$select
|
select | string |
선택적 $select 쿼리 옵션입니다. |
|
|
$필터
|
filter | string |
선택적 $filter 쿼리 옵션입니다. |
|
|
$expand
|
expand | string |
선택적 $expand 쿼리 옵션입니다. |
|
|
$orderby
|
orderby | string |
선택적 $orderby 쿼리 옵션입니다. |
|
|
$search
|
search | string |
선택적 $search 쿼리 옵션입니다. |
|
|
$inlinecount
|
inlinecount | string |
선택적 $inlinecount 쿼리 옵션입니다. |
반환
OData 엔터티 쿼리
OData 엔터티 데이터를 쿼리합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
OData 엔터티 이름
|
entity | True | string |
OData 엔터티 이름을 지정하세요. |
|
상대 경로
|
relativePath | string |
연결에서 OData URI와 결합하여 상호 작용할 전체 URI를 만듭니다. |
|
|
$top
|
top | number |
선택적 $top 쿼리 옵션입니다. |
|
|
$skip
|
skip | number |
선택적 $skip 쿼리 옵션입니다. |
|
|
$select
|
select | string |
선택적 $select 쿼리 옵션입니다. |
|
|
$필터
|
filter | string |
선택적 $filter 쿼리 옵션입니다. |
|
|
$expand
|
expand | string |
선택적 $expand 쿼리 옵션입니다. |
|
|
$orderby
|
orderby | string |
선택적 $orderby 쿼리 옵션입니다. |
|
|
$search
|
search | string |
선택적 $search 쿼리 옵션입니다. |
|
|
$inlinecount
|
inlinecount | string |
선택적 $inlinecount 쿼리 옵션입니다. |
반환
모든 유형의 OData 요청 만들기
모든 유형의 OData 요청을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상대 경로
|
relativePath | True | string |
연결에서 OData URI와 결합하여 상호 작용할 전체 URI를 만듭니다. |
|
httpMethod
|
httpMethod | True | string | |
|
쿼리 문자열
|
queryString | object | ||
|
payload
|
payload | object | ||
|
bypassMetadata
|
bypassMetadata | boolean |
CSRF 토큰을 페치하는 경우를 제외하고 성능에 대한 $metadata 호출을 무시합니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
상태 코드
|
statusCode | integer | |
|
구조화 된
|
response.structured | object | |
|
구조화 되지 않은
|
response.unstructured | string |
모든 유형의 대량 OData 요청 만들기(미리 보기)
모든 유형의 대량 OData 요청을 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
상대 경로
|
relativePath | True | string |
연결에서 OData URI와 결합하여 상호 작용할 전체 URI를 만듭니다. |
|
httpMethod
|
httpMethod | True | string | |
|
쿼리 문자열
|
queryString | object | ||
|
payload
|
payload | object | ||
|
bypassMetadata
|
bypassMetadata | boolean |
CSRF 토큰을 페치하는 경우를 제외하고 성능에 대한 $metadata 호출을 무시합니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
상태 코드
|
statusCode | integer | |
|
구조화 된
|
response.structured | object | |
|
구조화 되지 않은
|
response.unstructured | string |
정의
객체
'object' 형식입니다.