マニフェストを使用したデジタル資産の一括インポートとエクスポート
この記事では、Microsoft Dynamics 365 Commerce サイト ビルダーでマニフェストを使用してデジタル資産を一括インポート、エクスポートする方法について説明します。 また、スキーマが変更された場合の説明も示します。
コマース サイト ビルダ メディア ライブラリで、ファイル名に基づく資産のインポートとエクスポートの操作を実行できます。 影響を受け取るオブジェクトに基づく操作を実行するには、インポート中にファイルを作成するか、またはエクスポート中にファイルを生成する必要があります。 このファイルは、操作に含まれるすべての資産を一覧表示するタブ区切り .tsv テキスト ファイルです。 エクスポート操作の場合、負債には、資産の作成時や公開時などの詳細を指定する読み取り専用メタデータなど、すべての資産情報が含まれます。 インポート操作の場合は、各資産の資産情報のサブセットのみを含める必要があります。 残りのフィールドはオプションです。
変更後のドキュメントは、インポートされたドキュメントは行別に処理されます。 何らかの理由で行の処理が失敗した場合、エラーの説明が結果の変更に含まれます。 サイト ビルダのジョブの詳細表示 (サイト設定 > ジョブ) からその画像をダウンロードできます。 マニフェスト内の複数のエントリの 1 つが失敗しても、マニフェストの残りのエントリが処理されることはありません。 エラーを修正する必要がある場合 (ソースURLが正しくないなど)、エラーが発生した資産を最初の実行から修正して再処理できます。
以下は、マニフェスト駆動型資産のインポートおよびエクスポート操作の主な使用例です:
- プログラムの変更中にシステムに製品メディアなどのデジタル資産をアップロードします。
- 資産メタデータを一括して変更します (たとえば、大量の資産に特定のキーワードを追加する)。
- メタデータに対する検索および置換の操作をします (リブランドなど)。
- 一括してアクションを実行します (資産の公開や削除など)。
製品メディアの一括インポートおよびエクスポート
しだいは、製品メディアの割り当てをインポートおよびエクスポートする場合にも使用できます。 製品メディアの割り当てに使用されるスキーマは、無地の資産管理で構成されるスキーマの拡張バージョンです。 製品メディアの割り当てについては、製品とカテゴリへのメディアの割り当て を参照してください。
注記
オムニチャネル (Channel) - Neutral (ロケール) で商品メディアの一括インポート/エクスポート割り当て機能を使用するには、サイトビルダーのアプリケーション ID で Commerce headquarters を構成する必要があります。 このアクションは、将来の更新で不必要になされる一時的な要件です。
サイトビルダーのアプリケーション ID を使用して Commerce headquarters を構成するには、以下の手順に従ってください:
手動で新しいユーザーを追加するに記載の手順に従って、本部に新しいユーザー アカウントを作成します。 新しいユーザーアカウントは、一括 CMS サービスが本部製品データにアクセスするために使用されます。 アカウントには、何でも指定できます (「一括操作ユーザー」 など)。
新しいユーザー アカウントに品質管理マネージャのロールを割り当てるには、ユーザーをロールに手動で割り当てるに記載の手順に従ってください。
注記
一括 CMS サービスは、本社製品データにアクセスするための読み取り専用権限のみを必要とします。
headquarters で「entra」を検索し、検索結果から Microsoft Entra ID アプリケーション を選択します。
アクション ウィンドウで 新規を選択します。
次のサイトビルダーのアプリケーション ID GUID をコピーして、新しいレコードのクライアント ID フィールドに貼り付けます:
3530b95b-aca8-4164-b78e-0c07cbfd0681名前には、わかりやすい名前を入力します (「CMS の一括操作」など)。
ユーザー IDフィールドで新規ユーザー を選択します。
アクション ウィンドウで、保存を選択します。
オブジェクト スキーマ
マニフェスト ドキュメントは、.tsv 拡張子を持つタブ区切りの Unicode テキスト ファイルです。 付け替えの最初の行はヘッダー行で、列名が含まれています。 後続の各行は、1 つの資産および関連付けられたメタデータを表します。 資産を最初に取り込む場合、バイナリファイル (言い換えれば、実際の資産) をマニフェストとともに提供する必要があります。 ローカル アップロードまたはパブリックにアクセスできる HTTP ソースの URL として指定できます。
マニフェスト ベースのインポート操作が完了すると、インポート結果と考えられるエラー情報を含むインポートされたマニフェストは、サイト ビルダーの サイト ジョブ ページ (サイト設定 > ジョブ) の 過去のジョブ タブからダウンロードできます。 次のスキーマの説明では、最後の 4 行は、キャプチャおよび提供されるエラー情報について説明します。
資産のインポートとエクスポートの操作のスキーマ
次の表に、資産のインポートとエクスポートの操作のスキーマを示します。
| 列名 | 説明 |
|---|---|
| InternalMediaId | Commerce コンテンツ管理システム (CMS) の資産の ID です。 新しい資産をインポートする場合、このフィールドは空である必要があります。 |
| MediaChannel | 資産のエクスポートまたはインポート時に実行される電子メール チャンネルの名前です。 |
| MediaLocale | 資産のロケールです。 |
| MediaType | 資産のタイプです。 許可されるフィールドの値は、画像、ビデオ、または ファイル です。 |
| MediaVersion | 資産タイプのバージョン番号です。 MediaVersionMismatchAction フィールドと組み合わせると、メディア資産がエクスポートとインポートの間に変更された場合のインポートの動作を制御できます。 |
| MediaCategory | Commerce のメディア カテゴリです。 許可されるフィールドの値は、なし (既定)、製品、カテゴリ、顧客、作業者、カタログ、サイズ 、色、または スタイル です。 |
| MediaSourceProvider | 資産のインポートを行う外部システムです。 MediaSourceId フィールドと組み合わせて、このフィールドは、アセットがすでにシステムに存在しているかどうか、また更新する必要があるかどうかを判断するために使用されます。 MediaSourceProvider と MediaSourceId フィールドに値が入力されていない場合、 InternalMediaId、MediaChannel、MediaLocale が代わりに使用されます。 |
| MediaSourceId | 外部システムの識別子です。 |
| MediaReferenceUrl | 外部プロバイダー (MediaImportPath の代替) の URL です。 |
| MediaSourceIfExistsAction | メディア資産が既にシステムに存在する場合のインポート動作。 許可されるフィールドの値は、UseExisting、Overwrite、TakeLatest、または KeepBoth を使用します。 |
| MediaAction | 変更前のインポート時に資産に適用する必要があるアクション。 許可されるフィールド値は 、PublishNow、 Draft、 Unpublish、、または UnpublishAndDelete です。 |
| MediaCheckedOutAction | システムの既存のメディアが編集用にチェックアウトされている場合のインポート動作。 許可されるフィールドの値は、UseExisting、または Overwrite です。 |
| MediaVersionMismatchAction | システム内の既存のメディアが更新されている (バージョンが異なる) 場合のインポート動作は、その動作を変更するオブジェクトのエクスポートとインポートの間で動作が異なります。 許可されるフィールドの値は、UseExisting、または Overwrite です。 |
| MediaImportPath | HTTP ソース URL またはファイル名です。 メディア資産は、ローカルのファイル アップロードまたはシステムが一般にアクセス可能な外部のウェブ ロケーションからメディア アセットのバイナリを取得することによって、この場所からインポートされます。 |
| ImageAltText | 画像資産の Alt テキストです。 |
| MediaSearchTags | 資産を説明するキーワード (コンマ区切り) です。 |
| MediaCaption | ビデオ資産のキャプション。 |
| MediaDisplayName | 資産の表示名です。 値はサイト内で一意である必要があります。 |
| MediaDescription | ビデオ資産の説明。 |
| VideoCaptionImportPath | ビデオ資産のキャプションのパブリックにアクセスできる HTTPソース URL。 |
| VideoThumbnailImportPath | ビデオ資産のサムネイルのパブリックにアクセスできる HTTPソース URL。 何も指定しない場合、ソース URL は自動的に生成されます。 |
| VideoTranscriptImportPath | ビデオ資産のトランスクリプトのパブリックにアクセスできる HTTPソース URL。 |
| VideoAudioTrackImportPath | ビデオ資産の追加音声トラックのパブリックにアクセスできる HTTPソース URL。 |
| VideoDescriptiveAudioTrackImportPath | ビデオ資産の説明的音声トラックのパブリックにアクセスできる HTTPソース URL。 |
| VideoPlaytime | ビデオ資産の再生時間 (秒)。 |
| MediaCreatedOn | 資産が作成された日時です。 |
| MediaLastModifiedOn | アセットが最後に修正された日時。 |
| MediaPublished | 資産が公開されているかどうかを示す true/false の値です。 |
| MediaPublishedOn | 資産が公開された日時です。 |
| MediaPublishedURL | 公開された資産の URL です。 |
| MediaPreviewURL | 資産のプレビューURL (サインインが必要)。 |
| ImageQuality | イメージ資産の見積品質。 |
| ImageWidth | 画像資産の幅。 |
| ImageHeight | 画像資産の高さ。 |
| MediaChecksum | 画像資産のバイナリのハッシュ (checksum)。 |
| MediaTitle | ビデオ資産のタイトルです。 |
| VideoSubtitle | ビデオ資産の字幕の URL です。 |
| VideoMinimumAge | ビデオ資産の最小年数です。 |
| DocumentForceDownload | 表示するのではなくファイル資産をダウンロードするかどうかを指定する値。 |
| 結果 | 現在の行のインポート操作の結果。 |
| ResultTime | 現在の行が処理された時刻。 |
| ErrorCode | エラー コードです。 |
| ResultDescription | 結果の詳細な説明 (エラーの説明など)。 |
MediaSourceProvider フィールドと MediaSourceId フィールドを使用して、メディア アセットの外部ソースと ID を示すことができます (外部 CMS など)。 MediaSourceProvider と MediaSourceId の値が提供された場合、同じ資産が以前にインポートされ、更新されるべきかどうかを判断するために使用されます。 MediaSourceProvider と MediaSourceId の値が利用できない場合、InternalMediaId、MediaChannel、MediaLocale の値が、インポートされるメディア資産と、すでにシステムに存在するメディア資産とを一致させるために使用されます。
前に説明したフィールドの大部分は、省略可能であり、ヘッダーも含めて完全に省略できます。
強制インポートの必須フィールド (新しい資産の場合)
- MediaLocale
- MediaType
- MediaImportPath
- ImageAltText (画像資産の場合)
- MediaDisplayName
- MediaTitle (ビデオ資産の場合)
強制インポートの必須フィールド (既存の資産の場合)
- InternalMediaId
- MediaChannel
- MediaLocale
- MediaType
- ImageAltText (画像資産の場合)
- MediaDisplayName
- MediaTitle (ビデオ資産の場合)
インポートファイルの列は、データがヘッダーに揃える限り、任意の順序で並び替えできます。 エクスポート マニフェストには、常に資産に使用できるすべてのフィールドが含まれます。 使用可能なフィールドは資産タイプによって異なります。
製品メディアの割り当てには、同じ異なるスキーマを使用できます。 製品メディア割り当てに対して、基本資産の変更を変更する場合の必須フィールドも含める必要があります。 製品メディアの割り当てについては、製品とカテゴリへのメディアの割り当て を参照してください。
製品メディアの割り当てのスキーマ拡張機能
次の表に、製品メディアの割り当てに対するスキーマ拡張を示します。
| 列名 | 説明 |
|---|---|
| EntityType | 現在の行の製品割り当てターゲット。 サポートされている値は、Product\|Master、Product\|Variant、Product\|DimensionMatrix、Product\|Master\|Swatch です。 |
| EntityKey | EntityKeyValue フィールドの割り当てのキーとして使用されるものを指定する値。 サポートされている値は、EntityId、EntityId\|DimensionMatrix、EntityId\|SwatchType\|SwatchId です。 |
| EntityKeyValue | EntityKey の指定されたキーの値。 DimensionMatrix では、分析コードがパイプで区切され、キーはコロンを使用して値から区切ります。 |
| EntityLocale | 製品の割り当てのロケール (たとえば、「en-us」、「de-de」、「system_neutral」ロケールの場合は 「system_neutral」) です。 |
| CatalogNumber | 割り当てに関連付けられているカタログ番号。 |
| EntityChannel | 割り当てに関連付けられているチャンネルの操作単位番号 (OUN)。 接頭語 「OUN」 (OUN007、OUN116 など) が付く必要があります。 |
| EntityAssignmentCurrentPublishState | 割り当てに関連付けられているカタログ番号。 |
| EntityAssignmentAction | マニフェスト インポート時に製品メディア割り当てに適用されるべきアクション。 許可されるフィールド値は 、PublishNow、 Draft、 Unpublish、、または UnpublishAndDelete です。 |
| EntityCheckedOutAction | 商品メディア割り当てが編集のためにチェックアウトされている場合のインポート動作。 許可されるフィールドの値は、UseExisting、または Overwrite です。 |
| EntityVersionMismatchAction | マニフェストのエクスポートとインポートの間に、システム内の既存の製品メディア割り当てが更新された (バージョンが異なる) 場合のインポート動作です。 許可されるフィールドの値は、UseExisting、または Overwrite です。 |
| MediaGroup | 資産のメディア グループを選択してください 許可されるフィールドの値は、Primary、または Additional です。 |
| MediaPurpose | 資産の目的 (フリーテキスト) です。 |
| MediaDisplayOrder | 表示順序です。 |
| SwatchGroup | 見本グループ (サイズ や スタイル など)。 |
| SwatchDimension | スアコード (M、XL、 XXL など)。 |
| SwatchValue | 見本の値 (画像資産の色または識別子の 16 進コード)。 |
| EntityCreatedOn | 割り当てが作成された日時。 |
| EntityLastModifiedOn | 割り当てが最後に修正された日時。 |
| EntityVersion | 割り当てのバージョン番号。 |
| EntityPublishedOn | 割り当てが公開された日時。 |
見本に関する詳細については、製品固有の見本 を参照してください。 メディア グループの詳細情報については、シンプルな製品にメディアを割り当てる を参照してください。
資産マニフェストのインポート
資産の変更は、e コマース サイトまたはお客様のサイト ビルダ メディア ライブラリにインポートできます。 商品メディアの割り当てを含むマニフェストは、オムニチャネルの 商品メディア ビューからインポートする必要があります。
資産マニフェストの一括インポート
e コマースサイトのマニフェストベースの資産インポート操作は、サイトビルダーのメディア ライブラリから開始されます。
資産をサイト ビルダに一括インポートするには、次の手順に従います。
- サイト ビルダーで、マニフェストをインポートするサイトに移動します。
- メディア ライブラリ に移動します。
- 一括インポート を選択します。 ファイルの一括インポート ダイアログ ボックスが表示されます。
- インポートの詳細 で、ジョブの名前 (必須) と説明 (オプション) を入力し、次へ を選択します。
- インポートするマニフェスト ファイルの選択 で、コンピュータの参照 を選択して、ローカル コンピュータ上のマニフェスト ファイルを選択するか、マニフェスト ファイルを ファイルをここにドロップする ボックスにドラッグします。
- マニフェスト参照の資産をローカル コンピュータから削除する場合は、デバイスからローカル ファイルを使用してインポートする を選択します。
- 次へ を選択します。
- 前にデバイスのチェック ボックスで ローカル ファイルを使用してインポート を選択した場合は、メディア ディレクトリの選択 で 参照 を選択し、ローカル コンピューターのメディア ディレクトリを選択します。 メディア資産をインポートしない場合は、手順 11 に進みます。
- アップロードするメディア ディレクトリを選択すると、ブラウザによっては確認メッセージ ボックスが表示されることがあります。 メッセージを確認し、アップロード、OK、または はい (ブラウザに応じて) を選択します。 メディア ディレクトリの選択 ダイアログ ボックスが更新され、アップロード用に選択したフォルダが表示されます。
- 次へ を選択します。
- 確認と完了 ダイアログ ボックスで、ジョブの設定を確認し、インポートの開始 を選択します。
製品メディア割り当て資産の一括インポート
オブジェクトを変更ベースにした製品メディア割り当て資産のインポート操作は、お客様のクリストからメディア ライブラリから開始されます。 商品メディアの割り当てを含むマニフェストは、オムニチャネルの 商品メディア ビューからインポートする必要があります。
製品メディア割り当て資産の一括インポートをするには、次の手順に従います。
- サイト ビルダーで、ご利用の環境のオムニチャネルにアクセスします。
- 製品メディア を選択します。
- 一括インポート を選択します。
- インポートの詳細 で、ジョブの名前 (必須) と説明 (オプション) を入力し、次へ を選択します。
- インポートするマニフェスト ファイルの選択 で、コンピュータの参照 を選択して、ローカル マシン上の製品メディア割り当て資産マニフェスト ファイルを選択するか、マニフェスト ファイルを ファイルをここにドロップする ボックスにドラッグします。
- マニフェスト参照の資産をローカル コンピュータから削除する場合は、デバイスからローカル ファイルを使用してインポートする を選択します。
- 次へ を選択します。
- 前にデバイスのチェック ボックスで ローカル ファイルを使用してインポート を選択した場合は、メディア ディレクトリの選択 で 参照 を選択し、ローカル コンピューターのメディア ディレクトリを選択します。 メディア資産をインポートしない場合は、手順 11 に進みます。
- アップロードするメディア ディレクトリを選択すると、ブラウザによっては確認メッセージ ボックスが表示されることがあります。 メッセージを確認し、アップロード、OK、または はい (ブラウザに応じて) を選択します。 メディア ディレクトリの選択 ダイアログ ボックスが更新され、アップロード用に選択したフォルダが表示されます。
- 次へ を選択します。
- 確認と完了 ダイアログ ボックスで、ジョブの設定を確認し、インポートの開始 を選択します。
資産マニフェストのエクスポート
資産の変更は、e コマース サイトまたはお客様のサイト ビルダ メディア ライブラリからエクスポートできます。 商品メディアの割り当てを含むマニフェストは、オムニチャネルの 商品メディア ビューからエクスポートする必要があります。
資産マニフェストの一括エクスポート
資産マニフェストを一括エクスポートするには、以下の手順に従います。
- サイト ビルダーで、マニフェストをエクスポートしたいサイトまたはオムニチャネルに移動します。
- メディア ライブラリ に移動します。
- エクスポートする資産を選択し、一括エクスポート を選択します。 または、すべてのメディア資産をエクスポートするには、ライブラリ全体をエクスポート を選択します。
- エクスポート ジョブの名前と説明を入力し、選択したメディアを確認して、エクスポート を選択します。 サイト設定 > ジョブ でジョブ ステータスを 監視するか、ジョブ通知で ジョブに移動 を選択します。
- エクスポート ジョブが完了したら、ジョブ に > 移動します。
- 選択完了したエクスポート ジョブを表示します。
- 右ウィンドウで[ダウンロード選択 し、 をローカル コンピュータにダウンロードします。
製品メディア割り当て資産の一括エクスポート
製品メディア割り当て資産の一括エクスポートをするには、次の手順に従います。
- サイト ビルダーで、ご利用の環境のオムニチャネルにアクセスします。
- 製品メディア を選択します。
- 一括エクスポート を選択します。
- すべての製品に対するメディア割り当てのエクスポート または 特定の製品のメディア割り当てをエクスポート を選択し、次へ を選択します。
- 特定の製品に対するメディア割り当てのエクスポート を選択した場合は、すべての製品 で、メディア割り当てのエクスポート基の製品を選択し、次へ を選択します。 すべての製品に対して メディアの割り当てをエクスポート を選択した場合は、手順 6 に進みます。
- 現在選択されているロケールだけでなく、すべてのロケールをエクスポートしたい場合は、すべてのロケールをエクスポート チェックボックスを選択します。
- 製品メディアをエクスポート を選択します。 サイト設定 > ジョブ でジョブ ステータスを 監視するか、ジョブ通知で ジョブに移動 を選択します。
- エクスポート ジョブが完了したら、ジョブ に > 移動します。
- 選択完了したエクスポート ジョブを表示します。
- 右ウィンドウで[ダウンロード選択 し、 をローカル コンピュータにダウンロードします。