注記
コミュニティの関心グループが Yammer から Microsoft Viva Engage に移行されました。 Viva Engageコミュニティに参加し、最新のディスカッションに参加するには、 Finance and Operations Viva Engage Community へのアクセス権フォームに入力し、参加するコミュニティを選択します。
この記事では、Microsoft Dynamics 365 Commerce サイト ビルダーでマニフェストを使用してデジタル資産を一括インポートおよびエクスポートする方法について説明します。 また、マニフェストスキーマについても説明します。
コマース サイト ビルダ メディア ライブラリで、ファイル名に基づく資産のインポートとエクスポートの操作を実行できます。 マニフェストに基づく操作を実行するには、インポート時にマニフェストファイルを必要とし、エクスポート時にマニフェストファイルを生成する必要があります。 このファイルは、操作に含まれるすべての資産を一覧表示するタブ区切り .tsv テキスト ファイルです。 エクスポート操作において、マニフェストにはすべての資産情報が含まれており、読み取り専用メタデータとして資産の作成時や公開時の詳細が指定されています。 インポート操作の場合、マニフェストには各資産の資産情報のサブセットのみを含める必要があります。 残りのフィールドはオプションです。
マニフェスト ドキュメントをインポートすると、システムはそれらを行ごとに処理します。 何らかの理由で行の処理が失敗した場合、結果のマニフェストにはエラーの説明が含まれます。 サイトビルダーのジョブ詳細ビュー (サイト設定 > ジョブ) からそのマニフェストをダウンロードできます。 マニフェスト内の複数のエントリの 1 つが失敗しても、マニフェストの残りのエントリが処理されることはありません。 エラーによってマニフェストの何かを修正する必要がある場合（例えば、ソースURLが正しくない場合）、最初の実行から得られたマニフェストを使用して、それに基づいてエラーが発生したアセットを修正し、再処理することができます。
次のシナリオでは、マニフェスト駆動型の資産のインポート操作とエクスポート操作を使用します。
- オンボーディング中に、製品メディアやその他のデジタル資産をシステムにアップロードします。
- 資産メタデータを一括で変更します (たとえば、多数の資産に特定のキーワードを追加します)。
- メタデータに対して検索操作と置換操作を実行します (ブランド変更など)。
- アクションを一括で実行する (資産の発行や削除など)。
製品メディアの一括インポートおよびエクスポート
マニフェストでは、製品メディアの割り当てをインポートおよびエクスポートすることもできます。 製品メディア割り当てのスキーマは、プレーンアセット管理マニフェスト スキーマの拡張バージョンです。 製品メディアの割り当ての詳細については、「製品 とカテゴリへのメディアの割り当て」を参照してください。
注記
オムニチャネル (チャネル) - ニュートラル (ロケール) の一括インポートとエクスポートの製品メディア割り当て機能を使用するには、サイト ビルダーのアプリケーション ID を使用して Commerce 本社を構成する必要があります。
サイトビルダーのアプリケーション ID を使用して Commerce headquarters を構成するには、以下の手順に従ってください:
手動で新しいユーザーを追加するに記載の手順に従って、本部に新しいユーザー アカウントを作成します。 一括 CMS サービスでは、新しいユーザー アカウントを使用して本社の製品データにアクセスします。 アカウントには、何でも指定できます (「一括操作ユーザー」 など)。
「 手動でユーザーをロールに割り当てる 」の手順に従って、品質管理マネージャーの役割を新しいユーザー アカウントに割り当てます。
注記
バルク CMS サービスには、本社製品データにアクセスするための読み取り専用特権のみが必要です。
本社で "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 | 資産がエクスポートされる、またはインポートされるeコマースチャネルの名前です。 |
| MediaLocale | 資産のロケールです。 |
| メディアタイプ | 資産のタイプです。 許可されるフィールドの値は、画像、ビデオ、または ファイル です。 |
| MediaVersion | 資産タイプのバージョン番号です。
MediaVersionMismatchAction フィールドと組み合わせると、メディア資産がエクスポートとインポートの間に変更された場合のインポートの動作を制御できます。 |
| メディアカテゴリー | Commerce のメディア カテゴリです。 許可されるフィールドの値は、なし (既定)、製品、カテゴリ、顧客、作業者、カタログ、サイズ 、色、または スタイル です。 |
| MediaSourceProvider | 資産のインポートを行う外部システムです。
MediaSourceId フィールドと組み合わせて、このフィールドは、アセットがすでにシステムに存在しているかどうか、また更新する必要があるかどうかを判断するために使用されます。
MediaSourceProvider と MediaSourceId フィールドに値が入力されていない場合、 InternalMediaId、MediaChannel、MediaLocale が代わりに使用されます。 |
| MediaSourceId | 外部システムの識別子です。 |
| MediaReferenceUrl | 外部プロバイダー (MediaImportPath の代替) の URL です。 |
| メディアソース存在時アクション | メディア資産が既にシステムに存在する場合のインポート動作。 許可されるフィールドの値は、UseExisting、Overwrite、TakeLatest、または KeepBoth を使用します。 |
| MediaAction | マニフェストのインポート時に資産に適用する必要があるアクション。 許可されるフィールド値は 、PublishNow、 Draft、 Unpublish、、または UnpublishAndDelete です。 |
| MediaCheckedOutAction | システムの既存のメディアが編集用にチェックアウトされている場合のインポート動作。 許可されるフィールドの値は、UseExisting、または Overwrite です。 |
| MediaVersionMismatchAction | マニフェストのエクスポートとインポートの間で、システム内の既存のメディアが更新された場合 (バージョンが異なる) 場合のインポート動作。 許可されるフィールドの値は、UseExisting、または Overwrite です。 |
| MediaImportPath | HTTP ソース URL またはファイル名です。 ローカル ファイルのアップロードを使用するか、パブリックにアクセス可能な外部 Web の場所からメディア 資産バイナリをフェッチするシステムを使用して、この場所からメディア資産をインポートします。 この値には、アップロードされたフォルダーのルートから始まる相対パスを含める必要があります。 たとえば、ファイルが c:/uploadfiles/images/image1.png にあり、フォルダ images がアップロードされている場合、正しい MediaImportPath は /images/image1.png です。 |
| ImageAltText | 画像資産の Alt テキストです。 |
| メディア検索タグ | 資産を説明するキーワード (コンマ区切り) です。 |
| MediaCaption | ビデオ資産のキャプション。 |
| メディア表示名 | 資産の表示名です。 値はサイト内で一意である必要があります。 |
| メディアの説明 | ビデオ資産の説明。 |
| ビデオキャプションインポートパス | ビデオ資産のキャプションのパブリックにアクセスできる HTTPソース URL。 |
| ビデオサムネイルインポートパス | ビデオ資産のサムネイルのパブリックにアクセスできる HTTPソース URL。 何も指定しない場合、ソース URL は自動的に生成されます。 |
| VideoTranscriptImportPath | ビデオ資産のトランスクリプトのパブリックにアクセスできる HTTPソース URL。 |
| VideoAudioTrackImportPath (ビデオオーディオトラックインポートパス) | ビデオ資産の追加音声トラックのパブリックにアクセスできる HTTPソース URL。 |
| VideoDescriptiveAudioTrackImportPath | ビデオ資産の説明的音声トラックのパブリックにアクセスできる HTTPソース URL。 |
| VideoPlaytime | ビデオ資産の再生時間 (秒)。 |
| MediaCreatedOn | 資産が作成された日時です。 |
| MediaLastModifiedOn | アセットが最後に修正された日時。 |
| MediaPublished | 資産が公開されているかどうかを示す true/false の値です。 |
| MediaPublishedOn | 資産が公開された日時です。 |
| メディア公開URL | 公開された資産の URL です。 |
| メディアプレビューURL | 資産のプレビューURL (サインインが必要)。 |
| ImageQuality | イメージ資産の品質評価。 |
| ImageWidth | 画像資産の幅。 |
| 画像高さ | 画像資産の高さ。 |
| MediaChecksum | イメージアセットのハッシュ（チェックサム）バイナリ。 |
| メディアタイトル | ビデオ資産のタイトルです。 |
| ビデオ字幕 | ビデオ資産の字幕の URL です。 |
| VideoMinimumAge | ビデオ資産の最小年数です。 |
| DocumentForceDownload | 表示するのではなくファイル資産をダウンロードするかどうかを指定する値。 |
| 結果 | 現在の行のインポート操作の結果。 |
| ResultTime | 現在の行が処理された時刻。 |
| ErrorCode | エラー コードです。 |
| 結果説明 | 結果の詳細な説明 (エラーの説明など)。 |
MediaSourceProviderフィールドとMediaSourceId フィールドを使用して、メディア 資産の外部ソースと ID (外部 CMS など) を示します。
MediaSourceProvider値とMediaSourceId値を指定した場合、システムはそれらを使用して、同じ資産が以前にインポートされたかどうかを判断し、更新する必要があります。
MediaSourceProvider値とMediaSourceId値を指定しない場合、システムはInternalMediaId、MediaChannel、およびMediaLocale値を使用して、システムに既に存在するメディア資産にインポートされているメディア資産と一致させます。
前に説明したほとんどのフィールドはマニフェストでは省略可能であり、ヘッダーを含め、完全に除外することができます。
強制インポートの必須フィールド (新しい資産の場合)
- MediaLocale
- メディアタイプ
- MediaImportPath
- ImageAltText (画像資産の場合)
- メディア表示名
- MediaTitle (ビデオ資産の場合)
強制インポートの必須フィールド (既存の資産の場合)
- InternalMediaId
- MediaChannel
- MediaLocale
- メディアタイプ
- ImageAltText (画像資産の場合)
- メディア表示名
- MediaTitle (ビデオ資産の場合)
データがヘッダーと一致している限り、インポート マニフェスト内の列は任意の順序で配置できます。 エクスポート マニフェストには、常に資産に使用できるすべてのフィールドが含まれます。 使用可能なフィールドは資産タイプによって異なります。
製品メディアの割り当てには、同じマニフェスト スキーマを使用できます。 製品メディア割り当てのマニフェストには、基本資産マニフェストの必須フィールドも含める必要があります。 製品メディアの割り当てについては、製品とカテゴリへのメディアの割り当て を参照してください。
製品メディアの割り当てのスキーマ拡張機能
次の表に、製品メディアの割り当てに対するスキーマ拡張を示します。
| 列名 | 説明 |
|---|---|
| エンティティタイプ (EntityType) | 現在の行の製品割り当てターゲット。 サポートされている値は、Product|Master、Product|Variant、Product|DimensionMatrix、Product|Master|Swatch です。 |
| エンティティキー |
EntityKeyValue フィールドの割り当てのキーを指定する値。 サポートされている値は、EntityId、EntityId|DimensionMatrix、および EntityId|SwatchType|SwatchId です。 |
| エンティティキー値 |
EntityKeyで指定されたキーの値。
DimensionMatrix では、次元はパイプで区切られ、キーと値はコロンで区切られます。 |
| EntityLocale | 製品の割り当てのロケール (ロケールに依存しない場合は "en-us"、"de-de、"system_neutral" など)。 |
| カタログ番号 | 割り当てに関連付けられているカタログ番号。 |
| EntityChannel | 割り当てに関連付けられているチャネル操作ユニット番号 (OUN)。 プレフィックスに "OUN" を付ける必要があります (例: OUN007、OUN116)。 |
| エンティティ割り当ての現在の公開状態 | 割り当の公開状態。 |
| エンティティアサインメントアクション | マニフェスト インポート時に製品メディア割り当てに適用されるべきアクション。 許可されるフィールド値は 、PublishNow、 Draft、 Unpublish、、または UnpublishAndDelete です。 |
| EntityCheckedOutAction | 商品メディア割り当てが編集のためにチェックアウトされている場合のインポート動作。 許可されるフィールドの値は、UseExisting、または Overwrite です。 |
| エンティティバージョン不一致アクション | マニフェストのエクスポートとインポートの間に、システム内の既存の製品メディア割り当てが更新された (バージョンが異なる) 場合のインポート動作です。 許可されるフィールドの値は、UseExisting、または Overwrite です。 |
| MediaGroup | 資産のメディア グループを選択してください 許可されるフィールドの値は、Primary、または Additional です。 |
| MediaPurpose | 資産の目的 (フリーテキスト) です。 |
| メディア表示順序 | 表示順序です。 |
| SwatchGroup | スウォッチグループ (例えば、サイズ や スタイル など)。 |
| SwatchDimension | スウォッチのサイズ（例えば、M、XL、XXL など）。 |
| SwatchValue | 見本の値 (画像資産の色または識別子の 16 進コード)。 |
| エンティティ作成日時 | 割り当てが作成された日時。 |
| エンティティ最終更新日時 | 割り当てが最後に修正された日時。 |
| エンティティバージョン | 割り当てのバージョン番号。 |
| EntityPublishedOn | 割り当てが公開された日時。 |
見本に関する詳細については、製品固有の見本 を参照してください。 メディア グループの詳細情報については、シンプルな製品にメディアを割り当てる を参照してください。
資産マニフェストのインポート
アセットマニフェストは、eコマースサイトまたはオムニチャネルのサイトビルダーメディアライブラリにインポートできます。 製品メディアの割り当てを含むマニフェストは、オムニチャネルの [製品メディア ] ビューからインポートする必要があります。
資産マニフェストの一括インポート
サイト ビルダー メディア ライブラリから、e コマース サイトのマニフェスト ベースの資産インポート操作を開始します。
サイト ビルダーに資産マニフェストを一括インポートするには、次の手順に従います。
サイト ビルダーで、マニフェストをインポートするサイトに移動します。
メディア ライブラリ に移動します。
一括インポート を選択します。 ファイルの一括インポート ダイアログ ボックスが表示されます。
インポートの詳細 で、ジョブの名前 (必須) と説明 (オプション) を入力し、次へ を選択します。
インポートするマニフェスト ファイルの選択 で、コンピュータの参照 を選択して、ローカル コンピュータ上のマニフェスト ファイルを選択するか、マニフェスト ファイルを ファイルをここにドロップする ボックスにドラッグします。
マニフェストがローカルコンピュータからアセットバイナリを参照している場合は、デバイスからローカルファイルを使用してインポートする チェックボックスを選択します。
次へを選択します。
前にデバイスのチェック ボックスで ローカル ファイルを使用してインポート を選択した場合は、メディア ディレクトリの選択 で 参照 を選択し、ローカル コンピューターのメディア ディレクトリを選択します。 メディアアセットをインポートしない場合は、手順 11 に進んでください。
アップロードするメディア ディレクトリを選択すると、ブラウザによっては確認メッセージ ボックスが表示されることがあります。 メッセージを確認し、アップロード、OK、または はい (ブラウザに応じて) を選択します。 メディア ディレクトリの選択 ダイアログ ボックスが更新され、アップロード用に選択したフォルダが表示されます。
注記
アップロードされたコンテンツ内のすべてのフォルダー名とファイル名は、小文字のみを使用する必要があります。 インポート プロセスでは、アップロード前に大文字を小文字に変換します。
次へを選択します。
確認と完了 ダイアログ ボックスで、ジョブの設定を確認し、インポートの開始 を選択します。
製品メディアアサイン資産マニフェストの一括インポート
オムニチャネルのメディア ライブラリからマニフェスト ベースの製品メディア割り当て資産のインポート操作を開始します。 オムニチャネルの製品メディア ビューから、製品 メディア の割り当てを含むマニフェストをインポートします。
製品メディア割り当て資産マニフェストを一括インポートするには、次の手順に従います。
- サイト ビルダーで、ご利用の環境のオムニチャネルにアクセスします。
- 製品メディア を選択します。
- 一括インポート を選択します。
- インポートの詳細 で、ジョブの名前 (必須) と説明 (オプション) を入力し、次へ を選択します。
- インポートするマニフェスト ファイルの選択 で、コンピュータの参照 を選択して、ローカル マシン上の製品メディア割り当て資産マニフェスト ファイルを選択するか、マニフェスト ファイルを ファイルをここにドロップする ボックスにドラッグします。
- マニフェストがローカルコンピュータからアセットバイナリを参照している場合は、デバイスからローカルファイルを使用してインポートする チェックボックスを選択します。
- 次へを選択します。
- 前にデバイスのチェック ボックスで ローカル ファイルを使用してインポート を選択した場合は、メディア ディレクトリの選択 で 参照 を選択し、ローカル コンピューターのメディア ディレクトリを選択します。 メディアアセットをインポートしない場合は、手順 11 に進んでください。
- アップロードするメディア ディレクトリを選択すると、ブラウザによっては確認メッセージ ボックスが表示されることがあります。 メッセージを確認し、アップロード、OK、または はい (ブラウザに応じて) を選択します。 メディア ディレクトリの選択 ダイアログ ボックスが更新され、アップロード用に選択したフォルダが表示されます。
- 次へを選択します。
- 確認と完了 ダイアログ ボックスで、ジョブの設定を確認し、インポートの開始 を選択します。
資産マニフェストのエクスポート
アセットマニフェストは、eコマースサイトまたはオムニチャネルのサイトビルダーのメディアライブラリからエクスポートできます。 オムニチャネルの製品 メディア ビューから 、製品メディアの割り当てを含むマニフェストをエクスポートする必要があります。
資産マニフェストの一括エクスポート
資産マニフェストを一括エクスポートするには、次の手順に従います。
- サイト ビルダーで、マニフェストをエクスポートしたいサイトまたはオムニチャネルに移動します。
- メディア ライブラリ に移動します。
- エクスポートする資産を選択し、一括エクスポート を選択します。 または、すべてのメディア資産をエクスポートするには、ライブラリ全体をエクスポート を選択します。
- エクスポート ジョブの名前と説明を入力し、選択したメディアを確認して、エクスポート を選択します。 サイト設定 > ジョブ でジョブ ステータスを 監視するか、ジョブ通知で ジョブに移動 を選択します。
- エクスポート ジョブが完了したら、ジョブ> 過去のジョブ に移動します。
- 完了したエクスポート ジョブを選択します。
- 右ウィンドウで マニフェストをダウンロード を選択し、ローカル コンピューターにマニフェストをダウンロードします。
製品メディア割り当てマニフェストの一括エクスポート
製品メディア割り当てマニフェストを一括エクスポートするには、次の手順に従います。
- サイト ビルダーで、ご利用の環境のオムニチャネルにアクセスします。
- 製品メディア を選択します。
- 一括エクスポート を選択します。
- すべての製品に対するメディア割り当てのエクスポート または 特定の製品のメディア割り当てをエクスポート を選択し、次へ を選択します。
- 特定の製品に対するメディア割り当てのエクスポート を選択した場合は、すべての製品 で、メディア割り当てのエクスポート基の製品を選択し、次へ を選択します。 すべての製品に対して メディアの割り当てをエクスポート を選択した場合は、手順 6 に進みます。
- 現在選択されているロケールだけでなく、すべてのロケールをエクスポートしたい場合は、すべてのロケールをエクスポート チェックボックスを選択します。
- 製品メディアをエクスポート を選択します。 サイト設定 > ジョブ でジョブ ステータスを 監視するか、ジョブ通知で ジョブに移動 を選択します。
- エクスポート ジョブが完了したら、ジョブ> 過去のジョブ に移動します。
- 完了したエクスポート ジョブを選択します。
- 右ウィンドウで マニフェストをダウンロード を選択し、ローカル コンピューターにマニフェストをダウンロードします。