使用 Assets Essentials 大量匯入資產 bulk-import-essentials

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
資產要點

建立對象：

使用者
主機

AEM Assets Essentials 中的大量匯入能讓管理員將大量資產從資料來源匯入到 AEM Assets。管理員不再需要將個別資產或資料夾上傳到 AEM Assets。

NOTE

Assets Essentials 大量匯入工具使用的後端與 Assets as a Cloud Service 大量匯入工具使用的相同。但是，Assets Essentials 提供了更多可供匯入的資料來源和更簡化的使用者體驗。

您可以從以下資料來源匯入資產：

AWS
Google 雲端
Dropbox
OneDrive
Azure

先決條件 prerequisites

資料來源

先決條件

Azure

Azure 儲存體帳戶
Azure Blob 容器
根據驗證模式的 Azure 存取金鑰或 SAS 權杖

AWS

AWS 區域
AWS 儲存貯體
AWS 存取金鑰
AWS 存取密碼

Google 雲端

GCP 貯體
GCP 服務帳戶電子郵件
GCP 服務帳戶私密金鑰

Dropbox

Dropbox 用戶端 ID
Dropbox 用戶端密碼

OneDrive

OneDrive 租用戶 ID
OneDrive 用戶端 ID
OneDrive 用戶端密碼

除了這些根據資料來源的先決條件之外，您也必須了解資料來源中可用的來源資料夾名稱，其中包含需要匯入到 AEM Assets 的所有資產。

設定 Dropbox 開發人員應用程式 dropbox-developer-application

在將 Dropbox 帳戶中的資產匯入到 AEM Assets 之前，請先建立並設定 Dropbox 開發人員應用程式。

執行以下步驟：

登入您的 Dropbox 帳戶並按一下「建立應用程式」。
如果您使用 Enterprise Dropbox 帳戶，則需要具有內容管理員角色的存取權。
在「選擇 API」區段中，選取唯一可用的選項按鈕。
在「選擇您需要的存取類型」區段中，選取以下其中一個選項：
- 如果您需要存取在 Dropbox 帳戶中應用程式內建立的單一資料夾，請選取「應用程式資料夾」。
- 如果您需要存取 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 帳戶，然後按一下「新註冊」。
指定應用程式的名稱，從「支援的帳戶類型」中選取「僅此組織目錄中的帳戶 (僅限 Adobe - 單一租用戶)」。
執行下列步驟以新增重新導向 URI：
1. 在「選取平台」下拉式選單中，選取「Web」。
2. 將 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 應用程式時選取「完整 Dropbox」，並且包含資產的資料夾位於 `https://www.dropbox.com/home/bulkimport-assets`，則在「來源資料夾」欄位中指定 `bulkimport-assets`。如果您在建立 Dropbox 應用程式時選取「應用程式資料夾」，並且包含資產的資料夾位於 `https://www.dropbox.com/home/Apps/BulkImportAppFolderScope/bulkimport-assets`，則在「來源資料夾」欄位中指定 `bulkimport-assets`，其中 `BulkImportAppFolderScope` 是指應用程式的名稱。在這種情況下，`Apps` 會自動加在 `home` 後面。

(選用) 選取「匯入後刪除來源檔案」選項，在檔案匯入到 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 會尋找現有資料夾以避免重複匯入資產和資料夾，並確認在發生匯入的父資料夾中已套用清理規則。如果已在父資料夾中套用清理規則，則相同的規則也將套用於匯入來源。對於新匯入，將套用以下清理規則來管理資產和資料夾的檔名。

如需大量匯入期間禁止的名稱、處理資產名稱和處理資料夾名稱的詳細資訊，請參閱大量匯入期間處理檔名。