Assets Essentials を使用したアセットの一括読み込み bulk-import-essentials
AEM Assets Essentials の一括読み込みを使用すると、管理者はデータソースから AEM Assets に大量のアセットを読み込むことができます。管理者は、個々のアセットやフォルダーを AEM Assets にアップロードする必要がなくなりました。
次のデータソースからアセットを読み込むことができます。
- AWS
- Google Cloud
- Dropbox
- OneDrive
- Azure
前提条件 prerequisites
- Azure ストレージアカウント
- Azure ブロブコンテナ
- 認証モードに基づく Azure アクセスキーまたは SAS トークン
- AWS 地域
- AWS バケット
- AWS アクセスキー
- AWS アクセスシークレット
- GCP バケット
- GCP サービスアカウントメール
- GCP サービスアカウントの秘密キー
- Dropbox クライアント ID
- Dropbox クライアント秘密鍵
- OneDrive テナント ID
- OneDrive クライアント ID
- OneDrive クライアントシークレット
データソースに基づくこれらの前提条件に加えて、AEM Assets に読み込む必要があるすべてのアセットが含まれるデータソースで使用可能なソースフォルダー名を認識しておく必要があります。
Dropbox 開発者アプリケーションの設定 dropbox-developer-application
Dropbox アカウントからAEM Assets にアセットを読み込む前に、Dropbox 開発者アプリケーションを作成して設定します。
以下の手順を実行します。
-
Dropbox アカウントにログインし、「アプリを作成」をクリックします。
Enterprise Dropbox アカウントを使用している場合は、コンテンツ管理者の役割へのアクセス権が必要です。 -
「API を選択」セクションで、使用可能なラジオボタンのみを選択します。
-
「必要なアクセスのタイプを選択」セクションで、次のいずれかのオプションを選択します。
-
Dropbox アカウントで、アプリケーション内で作成された 1 つのフォルダーにアクセスする必要がある場合は、「アプリフォルダー」を選択します。
-
Dropbox アカウント内のすべてのファイルおよびフォルダーにアクセスする必要がある場合は、「完全な Dropbox」を選択します。
-
-
アプリケーションの名前を指定し、「アプリを作成」をクリックします。
-
アプリケーションの「設定」タブで、https://experience.adobe.com を「リダイレクト URI」セクションに追加します。
-
「アプリキー」および「アプリシークレット」フィールドの値をコピーします。これらの値は、AEM Assets で一括読み込みツールを設定する際に必要になります。
-
「権限」タブで、「個々のスコープ」セクションに次の権限を追加します。
-
account_info.read
-
files.metadata.read
-
files.content.read
-
files.content.write
-
-
「送信」をクリックして、変更を保存します。
OneDrive 開発者アプリケーションの設定 onedrive-developer-application
OneDrive アカウントから AEM Assets にアセットを読み込む前に、OneDrive 開発者アプリケーションを作成して設定します。
アプリケーションの作成
-
OneDrive アカウントにログインして「新規登録」をクリックします。
-
アプリケーションの名前を指定し、「サポートされるアカウントのタイプ」で「この組織ディレクトリのアカウントのみ(アドビのみ - シングルテナント)」を選択します。
-
次の手順を実行して、リダイレクト URI を追加します。
-
プラットフォームを選択 ドロップダウンメニューで、「Web」を選択します。
-
https://experience.adobe.com を「リダイレクト URI」セクションに追加します。
-
-
「登録」をクリックします。アプリケーションが正常に作成されます。
-
「アプリケーション(クライアント)ID」および「ディレクトリ(テナント)ID」フィールドの値をコピーします。これらの値は、AEM Assets で一括読み込みツールを設定する際に必要になります。
-
「クライアント資格情報」オプションに対応する「証明書または秘密鍵を追加」をクリックします。
-
「新しいクライアント秘密鍵」をクリックし、クライアント秘密鍵の説明と有効期限を指定して、「追加」をクリックします。
-
クライアントシークレットを作成したら、「値」フィールドをコピーします(「シークレット ID」フィールドはコピーしないでください)。これは、AEM Assets で一括読み込みを設定する際に必要になります。
API 権限の追加
次の手順を実行して、アプリケーションの API 権限を追加します。
- 左側のウィンドウで「API 権限」、「権限を追加」の順にクリックします。
- Microsoft Graph/委任された権限 をクリックします。「権限を選択」セクションに、使用可能な権限が表示されます。
- 「
OpenId permissions
のoffline_access
権限」および「Files
のFiles.ReadWrite.All
権限」を選択します。 - 「権限を追加」をクリックして変更を保存します。
一括読み込み設定の作成 create-bulk-import-configuration
Experience Manager Assets に一括読み込み設定を作成するには、次の手順を実行します。
-
左側のパネルで「一括読み込み」をクリックし、「読み込みを作成」をクリックします。
-
データソースを選択します。使用可能なオプションには、Azure、AWS、Google Cloud、Dropbox、OneDrive が含まれます。
-
「名前」フィールドで一括読み込み設定の名前を指定します。
-
前提条件で説明しているように、データソース固有の資格情報を指定します。
-
「ソースフォルダー」フィールドでデータソースのアセットを含むルートフォルダーの名前を指定します。
note note NOTE データソースとして Dropbox を使用している場合は、次のルールに基づいてソースフォルダーのパスを指定します。 - Dropbox のアプリケーションと、
https://www.dropbox.com/home/bulkimport-assets
にあるアセットを含むフォルダーの作成中に、「完全な Dropbox」を選択した場合は、「ソースフォルダー」フィールドでbulkimport-assets
を指定します。 - Dropbox のアプリケーションと、
https://www.dropbox.com/home/Apps/BulkImportAppFolderScope/bulkimport-assets
にあるアセットを含むフォルダーの作成中に、「アプリのフォルダー」を選択した場合は、「ソースフォルダー」フィールドでbulkimport-assets
を指定します。ここでBulkImportAppFolderScope
は、アプリケーションの名前を指します。ここでは、Apps
がhome
の後に自動的に追加されます。
- Dropbox のアプリケーションと、
-
(オプション)ファイルが Experience Manager Assets に読み込まれた後、ソースデータストアから元のファイルを削除するには、「読み込み後にソースファイルを削除」オプションを選択します。
-
「読み込みモード」を選択します。「スキップ」、「置換」または「バージョンを作成」を選択します。スキップモードがデフォルトです。このモードでは、アセットが既に存在する場合は、取得をスキップします。
-
(オプション)「メタデータファイル」フィールドに、CSV 形式で読み込むメタデータファイルを指定します。メタデータソースファイルは、ソースフォルダー内に指定する必要があります。「次へ」をクリックして、場所とフィルター に移動します。
-
「 アセットのターゲットフォルダー」フィールドを使用して、アセットの読み込み先となる DAM 内の場所を定義するパスを指定します。例:
/content/dam/imported_assets
-
(オプション)「フィルターを選択」セクションで、アセットの最小ファイルサイズを MB 単位で指定して、「最小サイズでフィルター」フィールドの取り込みプロセスにアセットを含めます。
-
(オプション)アセットの最大ファイルサイズを MB 単位で指定して、「最大サイズでフィルター」フィールドの取り込みプロセスにアセットを含めます。
-
(オプション)「MIME タイプを含める」フィールドを使用して、取り込みプロセスに含める MIME タイプを選択します。このフィールド内で複数の MIME タイプを選択できます。値を定義しない場合、すべての MIME タイプが取り込みプロセスに含まれます。
-
(オプション)「MIME タイプを除外」フィールドを使用して、取り込みプロセスで除外する MIME タイプを選択します。このフィールド内で複数の MIME タイプを選択できます。値を定義しない場合、すべての MIME タイプが取り込みプロセスに含まれます。
-
「次へ」をクリックします。環境設定に応じて、次のいずれかのオプションを選択します。
- 読み込みを保存:後で実行できるように現在の設定を保存します。
- 保存して読み込みを実行:設定を保存し、一括読み込みを実行します。
- 読み込みを保存してスケジュール:設定を保存し、後で一括読み込みを実行するようにスケジュールします。一括読み込みの頻度を選択し、読み込みの日時を設定できます。一括読み込みは、選択した頻度で、設定した日時に実行されます。
-
「保存」をクリックして、選択したオプションを実行します。
一括読み込み時のファイル名の処理 filename-handling-bulkimport-assets-view
アセットやフォルダーを一括で読み込む場合、Experience Manager Assets は、インポートソースに存在する情報の構造全体を読み込みます。Experience Manager は、アセット名とフォルダー名に含まれる特殊文字に対する組み込みルールに従うので、これらのファイル名のサニタイズが必要になります。フォルダー名とアセット名の両方について、ユーザーが定義したタイトルは変更されず、jcr:title
に保存されます。
一括読み込み時に、Experience Manager は、既存のフォルダーを探してアセットやフォルダーの再読み込みを避けると共に、読み込みが行われる親フォルダーに適用されるサニタイズルールを検証します。親フォルダーにサニタイズルールが適用される場合、インポートソースにも同じルールが適用されます。新規読み込みの場合、アセットやフォルダーのファイル名を管理するために、次のサニタイズルールが適用されます。
一括読み込み時の使用できない名前、アセット名の処理、フォルダー名の処理について詳しくは、一括読み込み時のファイル名の処理を参照してください。
既存の一括読み込み設定を表示 view-import-configuration
既存の一括読み込みを表示するには、左側のパネルで「一括読み込み」オプションを選択します。一括読み込みページが表示され、実行された読み込み のリストが表示されます。
また、ドロップダウンオプションから 保存された読み込み および スケジュールされた読み込み を表示することもできます。
一括読み込み設定を編集 edit-import-configuration
設定の詳細を編集するには、設定名に対応する をクリックし、「編集」をクリックします。編集操作の実行中は、設定のタイトルとデータソースの読み込みを編集することはできません。「実行された読み込み」タブ、「スケジュールされた読み込み」タブまたは「保存された読み込み」タブを使用して、設定を編集できます。
1 回限りの読み込みまたは繰り返しの読み込みのスケジュール設定 schedule-imports
1 回限りの一括読み込みまたは繰り返しの一括読み込みをスケジュール設定するには、次の手順に従います。
-
「実行された読み込み」タブまたは「保存された読み込み」タブで使用可能な設定名に対応する をクリックし、「スケジュール」をクリックします。また、「スケジュールされた読み込み」タブに移動し、「スケジュール」をクリックして、既存のスケジュールされた読み込みを再スケジュールすることもできます。
-
1 回限りの取得を設定するか、1 時間ごと、1 日ごと、または 1 週間ごとのスケジュールを設定します。「送信」をクリックします。
読み込みのヘルスチェックを実行 import-health-check
データソースへの接続を検証するには、設定名に対応する 、チェック の順にクリックします。接続に成功すると、Experience Manager Assets に次のメッセージが表示されます。
読み込みを実行する前にドライランを実行 dry-run-bulk-import
設定名に対応する をクリックし、「ドライラン」をクリックして、一括読み込みジョブのテスト実行を呼び出します。Experience Manager Assets には、一括読み込みジョブに関する次の詳細が表示されます。
一括読み込みを実行 run-bulk-import
設定の作成中に読み込みを保存した場合は、「保存された読み込み」タブに移動して、その設定に対応する アイコンをクリックし、「実行」をクリックします。
同様に、既に実行された読み込みを実行する必要がある場合は、「実行された読み込み」タブに移動して、設定名に対応する をクリックし、「実行」をクリックします。
進行中の読み込みの停止またはスケジュール schedule-stop-ongoing-report
読み込み中に一括読み込みホームページに表示される一括読み込みステータスダイアログを使用して、進行中の一括読み込みをスケジュールまたは停止できます。
また、「アセットを表示」をクリックして、ターゲットフォルダーに読み込まれたアセットを表示することもできます。
一括読み込み設定を削除 delete-bulk-import-configuration
「実行された読み込み」タブ、「スケジュールされた読み込み」タブまたは「保存された読み込み」タブに存在し、設定名に対応する をクリックし、「削除」をクリックして一括読み込み設定を削除します。
一括読み込みの実行後のアセットへの移動 view-assets-after-bulk-import
一括読み込みジョブの実行後にアセットが読み込まれる Assets のターゲット場所を表示するには、設定名に対応する をクリックして、「アセットを表示」をクリックします。