Dynamics 365 상거래 - 평점 및 리뷰
Dynamics 365 상거래 등급 및 리뷰 API를 활용하여 새 리뷰 가져오기, 기존 리뷰 내보내기 등!
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | Dynamics 365 Commerce-Ratings 및 리뷰 |
| URL | https://dynamics.microsoft.com/en-us/support/ |
| 전자 메일 | d365ratingreviewconn@microsoft.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://dynamics.microsoft.com/en-us/commerce/overview/ |
| 개인 정보 보호 정책 | https://privacy.microsoft.com/privacystatement |
| 카테고리 | 상업; 비즈니스 관리 |
Dynamics 365 상거래 - 등급 및 리뷰 커넥터는 Dynamics 365 등급 및 검토 서비스 API와 상호 작용하는 일련의 작업을 제공합니다. 이러한 작업은 검토 데이터를 가져오고 내보내는 데 도움이 될 수 있습니다. 두 가지 작업을 사용할 수 있습니다. 모든 검토 내보내기 및 검토 제출
필수 조건
계속하려면 다음이 필요합니다.
- Microsoft Dynamics 365 상거래 구독
- 사용 등급 및 검토 솔루션 세부 정보
Microsoft Dynamics 365를 시작하는 방법에 대한 자세한 내용은 여기에서 Dynamics 365 상거래 파트너에게 문의하세요.
자격 증명을 가져오는 방법
첫 번째 단계는 커넥터를 Microsoft Entra ID에 애플리케이션으로 등록하는 것입니다. 이를 통해 커넥터는 Microsoft Entra ID에 대해 자신을 식별하고 최종 사용자를 대신하여 등급 및 검토 데이터에 액세스할 수 있는 권한을 요청할 수 있습니다. 여기에 대해 자세히 알아보고 아래 단계를 따르세요.
1. Microsoft Entra ID 애플리케이션 만들기:
이 Microsoft Entra ID 애플리케이션은 등급 및 리뷰에 대한 커넥터 연결을 식별하는 데 사용됩니다. 이 작업은 Azure Portal을 사용하여 Microsoft Entra ID에 앱을 등록하고 인증을 사용하도록 설정하는 단계를 수행하여 수행할 수 있습니다 .
등록하는 동안 서비스 주체를 사용하여 커넥터와 인증된 연결을 설정하는 데 사용되므로 다음 정보를 캡처합니다.
- 클라이언트 애플리케이션 ID
- 클라이언트 암호(한 번만 표시되므로 이를 적어 두는 것이 좋습니다).
- 클라이언트 디렉터리(테넌트) ID입니다.
Microsoft Entra ID 애플리케이션을 만들면 이제 최종 사용자로부터 권한을 가져오는 데 사용할 수 있습니다. Dynamics 365 상거래 - 등급 및 리뷰 커넥터를 사용하여 서비스 주체를 통해 인증된 연결을 설정하려면 저장한 필드를 사용합니다.
다음 단계는 등급 및 검토 조정 도구 설정 페이지에서 이 앱을 등록하는 것입니다.
2. 등급 및 검토 조정 도구에 Microsoft Entra ID 애플리케이션 등록
등급 및 리뷰 서비스가 커넥터에서 들어오는 작업을 인증하려면 클라이언트가 등급 및 검토 조정 도구 설정 페이지에 Microsoft Entra ID 앱을 등록해야 합니다. 이전 단계의 클라이언트 애플리케이션 ID 및 클라이언트 디렉터리 ID를 사용하여 S2S(Service to Service) 애플리케이션 항목을 추가합니다. 조정 도구에서 등급 및 리뷰 설정을 관리하는 방법에 대한 자세한 내용은 여기를 참조 하세요.
커넥터 시작
Dynamics 365 상거래 - 등급 및 리뷰 커넥터를 시작하려면 기존 흐름을 추가하거나 샘플 템플릿 흐름을 검색하여 리뷰 가져오기 및 내보내기를 시작합니다.
참고: Dynamics 365 상거래 - 등급 및 리뷰 커넥터는 모든 Power Automate 지역에서 사용할 수 있지만 등급 및 리뷰는 테넌트에 대해 지원되는 지역에서만 호출을 처리합니다. 조직의 규정 준수 요구 사항을 검토하고 규정 준수 요구 사항에 맞는 지역에서 Power Automate 환경을 만들어야 합니다.
자주 묻는 질문(FAQ)
검토 텍스트 본문 및 검토 제목의 최대 길이는 무엇인가요?
검토 제목의 최대 길이는 55자입니다. 검토 텍스트 본문의 최대 길이는 1,000자입니다.
검토 제출 작업에서 encodedUser 매개 변수의 구조는 무엇인가요?
encodedUser는 사용자 정보를 전달하기 위해 추가 보안을 추가합니다. 사용자 ID 스키마를 base64로 인코딩합니다. 흐름에서 개체를 작성하려면 아래 스키마 구조를 참조한 다음, 기본 제공 toBase64() 함수를 사용하여 SubmitReview 작업에 전달하기 전에 인코딩합니다.
{ "p" : { "t" : "Unix epoch in seconds (should be within an hour of current time)", "email" : "Reviewer User Email Here", "name" : "Reviewer User Name Here", "id" : "Reviewer User Id Here" } }자세한 내용은 가져오기 검토 템플릿 흐름에서 이 예제를 확인하세요.
나는 더 많은 지원이 필요합니다. 누구에게 연락할 수 있나요?
일반 지원 또는 전자 메일d365ratingreviewconn@microsoft.com은 Dynamics 365 Commerce 지원에 문의하세요.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 모든 리뷰 내보내기 |
모든 리뷰를 다운로드 가능한 SAS URL로 내보냅니다. |
| 사용자 검토 제출 |
RnR 테넌트에 사용자 검토를 제출합니다. |
모든 리뷰 내보내기
모든 리뷰를 다운로드 가능한 SAS URL로 내보냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
RnR 테넌트 ID
|
tenantId | True | string |
RnR 테넌트 ID를 지정합니다. |
반환
사용자 검토 제출
RnR 테넌트에 사용자 검토를 제출합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
제품 ID
|
productId | True | string |
검토 중인 제품의 ID를 지정합니다. |
|
RnR 테넌트 ID
|
tenantId | True | string |
RnR 테넌트 ID를 지정합니다. |
|
채널 ID
|
channelId | string |
이 검토에 대한 채널의 ID를 지정합니다. |
|
|
시장
|
market | string |
이 검토와 연결된 시장을 지정합니다. |
|
|
로케일
|
locale | True | string |
이 검토와 연결된 로캘을 지정합니다. |
|
encodedUser
|
encodedUser | True | string |
이 검토와 연결된 base64로 인코딩된 사용자 정보 문자열을 지정합니다. 사용자 이름, 전자 메일 및 ID를 포함하는 JSON 블록 형식에 대한 설명서를 참조하세요. |
|
Rating
|
Rating | True | string |
검토의 등급을 정수로 지정합니다. |
|
제목
|
Title | True | string |
검토 제목을 지정합니다. |
|
ReviewText
|
ReviewText | True | string |
검토의 텍스트 본문을 지정합니다. |
|
Sku
|
Sku | string |
검토된 제품의 SKU 번호를 지정합니다. |
|
|
ProductName
|
ProductName | True | string |
검토된 제품의 이름 지정 |
|
LegalEntity
|
LegalEntity | string |
법인을 지정합니다. |
|
|
확장 속성들
|
ExtendedProperties | object |
추가 검토 속성을 키-값 쌍으로 지정합니다. JSON 형식에 대한 설명서를 참조하세요. |
|
|
submittedDateTime
|
submittedDateTime | string |
검토의 제출된 날짜/시간을 UTC 형식으로 지정합니다(기본값은 현재 UTC 시간). |
반환
제출된 검토의 검토 ID입니다.
- response
- SubmitReviewResponse
정의
SubmitReviewResponse
ExportSuccessfulResponse
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Blob SAS Url
|
blobSasUrl | string |
Blob Storage에서 생성된 SAS URL입니다. |
|
만료 날짜
|
expires | string |
SAS URL이 만료되는 날짜입니다. |
|
만든 날짜
|
created | string |
SAS URL을 만든 날짜입니다. |