静的ファイルのアップロードと配信

[アーティクル]
08/01/2024

この記事では、静的ファイルを Microsoft Dynamics 365 Commerce サイトビルダーにアップロードする方法と、そのファイルを要求するために使用できるカスタム URL およびファイル名の作成方法について説明します。

サードパーティの一部のコネクタでは、電子商取引サイトからファイルをホストし、提供する必要があります。これらのコネクタは、特定のコールバック URL パスとファイル名への要求によってファイルが返されることを予期しています。したがって、この記事では、Dynamics 365 Commerce 電子商取引サイト上にユーザー定義可能な 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 の割り当て で、ステップ 2 ボックスをオンにし、メディアライブラリから新しいドキュメントを選択します。
適用を選択します。

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

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

URL で指定されているアセットタイプを更新するには、次の手順を実行します。

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

URL パスの変更

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

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

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