Dynamics 365 Commerce - 評価とレビュー

Dynamics 365 Commerce Ratings and Reviews API を使用して、新規レビューのインポート、既存のレビューをエクスポートなどを行うことができます!

このコネクタは、次の製品および地域で利用可能です。

Dynamics 365 Commerce - Ratings and Reviews コネクタは、Dynamics 365 Ratings and Review Service API と対話するための一連のアクションを提供します。 これらのアクションにより、レビュー データのインポートとエクスポートが容易になります。 2 つのアクションがあります: すべてのレビューをエクスポートとレビューの送信。

前提条件

続行するには、次のものが必要です:

• Microsoft Dynamics 365 Commerce のサブスクリプション
• 有効な Ratings and Reviews ソリューションの 詳細

Microsoft Dynamics 365 の使用方法の詳細については、こちら の Dynamics 365 Commerce パートナーにお問い合わせください。

資格情報の入手方法

最初のステップは、Microsoft Entra ID でコネクタをアプリケーションとして登録することです。 これにより、コネクタは Microsoft Entra ID に対して自身を識別し、エンド ユーザーに代わって Ratings and Reviews データにアクセスするためのアクセス許可を要求できます。 詳しくは こちら をご覧いただき、以下の手順に従ってください:

1. Microsoft Entra ID アプリケーションの作成:

この Microsoft Entra ID アプリケーションは、Ratings and Reviews へのコネクタ接続を識別するために使用されます。 これは、Azure Portal を使用し、こちら の手順に従って Microsoft Entra ID にアプリを登録し、認証を有効にすることで行うことができます。

サービス プリンシパルを使用してコネクタとの認証接続を確立するために使用されるため、登録時に次の情報を取得します。

• クライアント アプリケーション ID
• クライアント シークレット (一度しか表示されないので、忘れずにメモしてください)。
• クライアント ディレクトリ (テナント) ID。

Microsoft Entra ID アプリケーションが作成されたことで、エンド ユーザーからアクセス許可を取得するために使用できるようになりました。 保存したフィールドを使用して、Dynamics 365 Commerce - Ratings and Reviews コネクタを使用したサービス プリンシパル経由の認証接続を確立します。

次の手順では、このアプリを Ratings and Reviews のモデレーション ツール設定ページに登録します。

2. Microsoft Entra ID アプリケーションを Ratings and Reviews モデレーション ツールに登録

Ratings and Reviews サービスがコネクタからの操作を認証するためには、クライアントは自身の Microsoft Entra ID アプリを Ratings and Review のモデレーション ツール設定ページに登録する必要があります。 前の手順のクライアント アプリケーション ID とクライアント ディレクトリ ID を使用して、サービス間 (S2S) アプリケーション エントリを追加します。 モデレーション ツールから Ratings and Reviews の設定を管理する方法の詳細については、こちら を参照してください。

コネクタの使用を開始する

Dynamics 365 Commerce - Ratings and Reviews コネクタの使用を開始するには、既存のフローに追加するか、レビューのインポートとエクスポート用のサンプル テンプレート フローを検索することから始めます。

注: Dynamics 365 Commerce - Ratings and Reviews コネクタはすべての Power Automate リージョンで利用可能ですが、Ratings and Reviews はテナントでサポートされているリージョンでのみ通話を処理します。 組織のコンプライアンス要件を確認し、コンプライアンスのニーズに適したリージョンに Power Automate 環境を作成してください。

よくあるご質問

• レビュー テキスト本文とレビュー タイトルの最大長は?

  レビュー タイトルの最大長は 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"
          }
  }
  

  詳細については、インポート レビュー テンプレート フローでこの例を確認してください。

• もっとサポートが必要です。 どこに連絡すればいいですか?

  一般的なサポートについては、Dynamics 365 Commerce サポートまでお問い合わせいただくか、d365ratingreviewconn@microsoft.com までメールでお問い合わせください。

接続を作成する

このコネクタは、次の認証タイプをサポートしています:

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

調整制限

アクション

すべてのレビューをエクスポート

ユーザー レビューの送信

定義

SubmitReviewResponse

ExportSuccessfulResponse