静的ファイルのアップロードと提供

注

Dynamics 365 Commerce の小売インタレストグループは、Yammer から Viva Engage に移行しました。新しい Viva Engage コミュニティにアクセスできない場合は、このフォーム (https://aka.ms/JoinD365commerceVivaEngageCommunity) に入力して追加し、最新のディスカッションに参加してください。

この記事では、Microsoft Dynamics 365 Commerce サイトビルダーで静的ファイルをアップロードして提供する方法について説明します。

一部のパートナーコネクタでは、eコマースサイトからファイルをホストして提供する必要があります。これらのコネクタでは、特定のコールバック URL パスとファイル名への要求でファイルが返されることを想定しています。したがって、この記事では、Dynamics 365 Commerce の eコマースサイト上にユーザー定義可能な URL とファイル名を持つ静的ファイルをアップロードして提供する方法について説明します。

静的ファイルを返すサイト URL の作成

Commerce サイトビルダーで静的ファイルを返すサイト URL を作成するには、次の手順に従います。

サイトのメディアライブラリに移動し、指定した URL で配信されるべきリクエストファイルをアップロードします。既にファイルをアップロードしている場合は、この手順をスキップできます。
サイトの URL に移動します。
新規 > 新しい URL を選択します。
新しい URL ダイアログボックスで、メディアライブラリアセット を選択します。
URL パス フィールドに URL パスを入力します。パスにファイル名を含めます。
次へを選択します。メディアライブラリが開き、アップロードした ドキュメント の種類のすべてのメディアアセットが表示されます。
ステップ 5 で定義した URL に対する要求を処理するためにサーブされるファイルを選択します。
保存を選択します。

この時点で、作成した URL はドラフト状態になっています。 URL は、URL を発行するまでファイルを返しません。 URL を発行する前に、適切なデータを返すかどうかを検証できます。

URL の検証と発行

URL を発行する前に検証するには、次の手順に従います。

サイトの URL に移動し、プレビューする URL を選択します。
右側のプロパティウィンドウで、編集ボタンの下にある適切な URL リンクを選択します。新しいブラウザーウィンドウが開き、404 エラーが表示されます。
URL に ?preview=inprogress クエリ文字列を追加し (例: https://yoursite.com/callback.html?preview=inprogress)、ページを再読み込みします。メディアライブラリにアップロードしたファイルが応答に含まれている必要があります。

URL を検証したら、それを発行できます。

サイトの URL に移動し、URL を選択します。
コマンドバーで発行を選択します。

URL がポイントするファイルの更新

URL を発行した後は、別のファイルを指すよう URL を更新できます。または、次のセクションで説明するように、別の種類のリソースを指すように URL を更新することもできます。たとえば、URL を内部ページまたはリダイレクトにポイントすることができます。

URL が指すファイルを更新するには、次の手順に従います。

サイトの URL に移動し、更新する URL を選択します。
右側のプロパティウィンドウで、編集を選択します。
URL の割り当て で、ステップ 2 ボックスをオンにし、メディアライブラリから新しいドキュメントを選択します。
適用を選択します。

URL がポイントするアセットタイプの更新

URL を更新して、内部ページまたはリダイレクトなどの別のタイプのアセット (リソース) をポイントするようにすることもできます。

URL が指す資産の種類を更新するには、次の手順に従います。

サイトの URL に移動し、更新する URL を選択します。
右側のプロパティウィンドウで、編集を選択します。
URL の割り当て の ステップ 1 で、別のアセットタイプを選択します。
ステップ 2 ボックスをオンにし、新しいアセットを選択します。
適用を選択します。

URL パスの変更

URL を作成した後、そのパスを変更することはできません。ファイルまたはその他の種類のリソースを提供する URL パスを変更する必要がある場合は、新しい URL を作成し、既存のファイルまたは他のリソースにマップしてから、古い URL を発行解除して削除する必要があります。

URL パスを変更するには、次の手順に従います。

新しい URL を作成して既存のファイルまたは別のリソースにマップするには、この記事の前の静的ファイルを返すサイト URL を作成するセクションの手順に従ってください。
新しい URL を選択し、コマンドバーの発行を選択します。新しい URL が発行されます。
古い URL の発行を解除するには、URL を選択し、コマンドバーの 発行取り消し を選択します。古い URL を必要に応じて削除できるようになりました。