[AEM Assets]{class="badge positive" title="適用於AEM Assets)。"}
使用 Assets 檢視大量匯入資產 bulk-import-assets-view
在 Adobe Experience Manager (AEM) Assets 檢視中的 大量匯入 可讓管理員以單一、簡化的作業，直接從外部資料來源將大量資產匯入AEM Assets。 此功能可免除一次上傳一個個別資產或資料夾的需求，因此對於大規模資產移轉、數位資產合併，以及從現有雲端儲存庫上線內容而言，此功能特別有用。
透過將AEM Assets直接連線至支援的資料來源，管理員能夠有效地移轉影像、影片、檔案和其他數位資產的整個資料庫，減少手動工作量，並在填入AEM Assets環境時加快實現價值的時間。
大量匯入的支援資料來源 supported-data-sources
管理員可從以下資料來源匯入資產，這些資料來源涵蓋企業環境中常用的主要雲端儲存空間與檔案共用平台：
- Azure — Microsoft的雲端儲存平台，用於可擴充的資產儲存。
- AWS (Amazon Web Services) — 廣泛使用的雲端儲存和基礎建設提供者。
- Google雲端 — Google的雲端儲存空間與運算平台。
- Dropbox — 熱門的檔案託管和共用服務。
- OneDrive — Microsoft的雲端型檔案儲存和共用服務。
如此廣泛的支援來源意味著，管理員可以將儲存在多個平台上的資產整合至單一AEM Assets存放庫，進而簡化控管並確保數位資產受到集中管理。
先決條件 prerequisites
將內容匯入Adobe Experience Manager (AEM) Assets之前，請確定您所選的雲端資料來源有必要的認證和設定值可用。 每個資料來源都需要一組特定的驗證和連線引數，如下所述。
- Azure儲存體帳戶
- Azure Blob容器
- Azure存取金鑰或共用存取簽章(SAS)權杖 （所需的認證取決於選取的驗證模式）
- AWS地區
- AWS Bucket
- AWS存取金鑰
- AWS存取密碼
- Google Cloud Platform (GCP) Bucket
- GCP服務帳戶電子郵件
- GCP服務帳戶私密金鑰
- Dropbox使用者端ID （應用程式金鑰）
- Dropbox使用者端密碼（應用程式密碼）
- OneDrive租使用者ID
- OneDrive使用者端識別碼
- OneDrive使用者端密碼
這些認證會驗證Adobe Experience Manager (AEM) Assets與外部儲存提供者之間的連線，因此在開始匯入之前，請從雲端提供者的主控台收集這些憑證。
除了上面列出的來源特定先決條件之外，您還必須識別資料來源中的來源資料夾名稱。 此資料夾包含您打算匯入AEM Assets的所有資產。 瞭解準確的來源資料夾名稱至關重要，因為AEM會在匯入程式期間使用它來尋找和擷取正確的資產集。
設定 Dropbox 開發人員應用程式 dropbox-developer-application
在將資產從您的Dropbox帳戶匯入至Adobe Experience Manager (AEM) Assets之前，請先建立和設定Dropbox開發人員應用程式。 此應用程式會產生認證並授予AEM Assets所需的許可權範圍，以便使用Dropbox進行驗證並安全地傳輸檔案。
完成下列步驟以建立並授權Dropbox開發人員應用程式：
-
登入您的 Dropbox 帳戶並按一下「建立應用程式」。
如果您使用Enterprise Dropbox帳戶，您必須具有內容管理員角色的存取權，因為Enterprise帳戶上的應用程式建立僅限於該管理員角色。 -
在 選擇API 區段（應用程式設計介面）中，選取唯一可用的選項按鈕。
-
在 選擇您需要的存取型別 區段中，根據您計畫匯入的資產範圍選取下列其中一個選項：
-
選取「應用程式資料夾」，以授與存取許可權給在Dropbox帳戶中為您的應用程式建立的單一專用資料夾。 這會將應用程式限製為僅限該資料夾。
-
選取 完整Dropbox 以授與存取許可權給您的Dropbox帳戶中的所有檔案和資料夾。
-
-
指定應用程式的名稱，然後按一下「建立應用程式」。
-
在應用程式的「設定」索引標籤中，將 https://experience.adobe.com 新增至「重新導向 URI」區段。 此重新導向URI （統一資源識別碼）可確保Dropbox在登入後傳回授權回應給Adobe Experience Cloud，完成兩個服務之間的安全連線。
-
複製「應用程式金鑰」和「應用程式密碼」欄位的值。 應用程式金鑰是您應用程式的公開識別碼，應用程式機密是用來驗證其身分的機密認證。 在AEM Assets中設定大量匯入工具時，需要兩個值，以便安全地儲存。
-
在「權限」索引標籤，將以下權限新增到「個別範圍」區段。 每個範圍都授權批次匯入工具執行的特定動作：
-
account_info.read — 允許讀取Dropbox帳戶的基本資訊。
-
files.metadata.read — 允許讀取檔案和資料夾中繼資料，例如名稱和路徑。
-
files.content.read — 允許讀取檔案的實際內容，允許匯入資產。
-
files.content.write — 允許將內容寫入帳戶內的檔案和資料夾。
-
-
按一下「提交」以儲存變更。 應用程式現在已設定完畢，且準備好連線至AEM Assets中的大量匯入工具。
設定 OneDrive 開發人員應用程式 onedrive-developer-application
將資產從Microsoft OneDrive帳戶匯入Adobe Experience Manager (AEM) Assets需要已註冊的OneDrive開發人員應用程式。 您必須先建立並設定此開發人員應用程式，才能進行任何匯入，因為應用程式會建立已驗證的連線，允許AEM存取儲存在OneDrive中的檔案。
OneDrive開發人員應用程式可作為AEM Assets與您的OneDrive帳戶之間受信任的中介程式。 註冊應用程式會為AEM提供所需的認證，可透過Microsoft的身分平台進行驗證，以及代表您安全地擷取資產。
開發人員應用程式是先決條件的關鍵原因：
- 驗證：已註冊的應用程式會提供AEM用來登入Microsoft身分平台的認證，這樣AEM就可以代表您行事，而不會公開您的個人登入。
- 已授權的API存取權：應用程式會授予AEM透過OneDrive API讀取及匯入檔案的許可權，以確保只有已核准的作業才會發生。
- 安全資產轉移：透過已設定的應用程式路由連線，OneDrive和AEM Assets之間的資產轉移仍可控制及追蹤。
請先完成OneDrive開發人員應用程式的建立和設定。 設定應用程式後，AEM Assets可以連線至OneDrive並開始匯入您的資產。
建立OneDrive大量匯入的應用程式
在您的OneDrive (Azure)入口網站中註冊應用程式，會建立信任的身分識別與認證，以驗證您的OneDrive儲存裝置與Adobe Experience Manager (AEM) Assets之間的連線。 完成下列步驟來建立應用程式，並收集大量匯入組態所需的認證：
-
登入您的 OneDrive 帳戶，然後按一下「新註冊」。
-
指定應用程式的名稱，從「支援的帳戶類型」中選取「僅此組織目錄中的帳戶 (僅限 Adobe - 單一租用戶)」。
-
執行以下步驟以新增重新導向統一資源識別碼(URI)：
-
在「選取平台」下拉式選單中，選取「Web」。
-
將 https://experience.adobe.com 新增至「重新導向 URI」區段。 此URI會定義登入後傳回驗證回應的位置。
-
-
按一下「註冊」。 應用程式建立成功。
-
複製「應用程式 (用戶端) ID」和「目錄 (租用戶) ID」欄位的值。 在Adobe Experience Manager (AEM) Assets中設定大量匯入工具時需要這些值，因為在驗證期間，這些值會唯一識別您註冊的應用程式及其目錄。
-
按一下與「用戶端憑證」選項相對應的「新增憑證或密碼」。
-
按一下「新用戶端密碼」，提供用戶端密碼描述和有效期限，然後點選「新增」。 使用者端密碼的功用是授權應用程式存取OneDrive資料的密碼。
-
建立使用者端密碼之後，複製 值 欄位。 請勿複製「密碼識別碼」欄位，因為AEM Assets中的大量匯入組態會使用密碼 Value 驗證，而非使用密碼識別碼。 在AEM Assets中設定大量匯入時需要此值，而且它只會顯示一次 — 在離開頁面之前立即複製並儲存它。
新增 API 權限
設定 API許可權 可授予已註冊應用程式代表登入使用者與Microsoft Graph通訊所需的特定存取許可權。 此處定義的應用程式設計介面(API)許可權會確切決定應用程式有權要求的資料和動作。 完成下列步驟，為應用程式新增必要的API許可權：
- 在左窗格中按一下API許可權，然後按一下新增許可權。
- 按一下「Microsoft Graph > 委派的權限」。 「選取權限」區段會顯示可用權限。 委派許可權允許應用程式代表登入的使用者執行動作，而非作為獨立服務。
- 從
OpenId permissions選取offline_access許可權，並從Files選取Files.ReadWrite.All許可權。offline_access許可權可讓應用程式取得重新整理Token，以便維持存取權而不需重複提示使用者登入，而Files.ReadWrite.All則授與登入使用者可以存取的檔案的完整讀寫存取權。 應用程式需要這兩個許可權，才能持續驗證並管理檔案內容。 - 按一下「新增權限」以儲存更新。 儲存功能會完成許可權設定，並針對應用程式註冊這些存取許可權，確保應用程式在授予許可權後能成功驗證及存取指定的檔案。
建立大量匯入設定 create-bulk-import-configuration
執行以下步驟，在Experience Manager Assets中建立大量匯入組態。 此設定會定義資料來源、認證、目標位置以及篩選規則，這些規則控制如何將資產從外部儲存提供者擷取到Experience Manager Assets：
-
在左窗格中按一下大量匯入，然後按一下建立匯入。
-
選取資料來源。 可用的選項包括Azure、AWS、Google Cloud、Dropbox和OneDrive。
-
在「名稱」欄位中為大量匯入設定指定名稱。
-
指定資料來源特定的認證，如先決條件中所述。
-
在「來源資料夾」欄位中提供包含資料來源中資產的根資料夾名稱。
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後面。
note NOTE 如果您使用OneDrive做為資料來源，請根據下列規則指定來源資料夾路徑： - 僅指定根資料夾名稱，不含網域。 如果資料夾的完整URL路徑為
https://my.sharepoint.com/my?id=/personal/user/Documents/Importfolder/，請在 Source資料夾 欄位中指定/Importfolder/。 - 如果資料夾名稱包含多個以空格分隔的字詞，請在「大量匯入」組態中指定包含空格的名稱。
- 來源資料夾必須位於根目錄。 不支援資料夾路徑。
- 如果您在建立 Dropbox 應用程式時選取「完整 Dropbox」，並且包含資產的資料夾位於
-
（選擇性）選取 匯入後刪除來源檔案 選項。 啟用時，此選項會在原始檔案成功匯入Experience Manager Assets後，從來源資料存放區移除原始檔案，這有助於防止重複儲存，並減少來源位置中保留的資料。
-
選取匯入模式，以決定擷取程式如何處理目標位置中已存在的資產。 選擇下列其中一項：
- 略過 — 預設模式。 在「略過」模式中，擷取程式會略過匯入資產（若已存在），並保留現有資產不變。
- 取代 — 以資料來源的傳入資產覆寫現有資產。
- 建立版本 — 將傳入的資產匯入為現有資產的新版本，保留版本記錄中的舊版本。
-
(選用) 在「中繼資料檔案」欄位中指定要匯入的中繼資料檔案 (以 CSV 格式提供)。 中繼資料來源檔案必須位於來源資料夾中。 按一下「下一步」，導覽至「位置和篩選器」。
note NOTE 根據您組織的安全性規則，您可能需要管理員同意才能讓此應用程式連線到大量匯入工具。 如果需要，管理員必須先提供同意，然後才能儲存大量匯入設定。 -
若要在數位資產管理(DAM)存放庫中定義要使用 Assets目標資料夾 欄位匯入資產的位置，請指定路徑。 例如
/content/dam/imported_assets。 -
（選擇性）在 選擇篩選器 區段中，在 依大小下限篩選 欄位中提供以MB為單位的資產檔案大小下限。 系統會排除小於此值的Assets，所以擷取程式中只會包含符合最小大小的檔案。
-
（選用）在 按大小上限篩選 欄位中提供資產的最大檔案大小（以MB為單位）。 大於此值的Assets會從擷取程式中排除。
-
(可選) 使用「包含 MIME 類型」欄位選取要包含在擷取程序中的 MIME 類型。 您可以在此欄位中選取多種 MIME 類型。 如果您未定義值，則所有 MIME 類型都將包含在擷取程序中。
-
（選擇性）使用 排除MIME型別 欄位，從擷取程式選取要排除的MIME型別。 您可以在此欄位中選取多種 MIME 類型。 如果您未定義值，則所有 MIME 類型都將包含在擷取程序中。
-
按一下「下一步」。 根據偏好選取下列其中一個選項：
- 「儲存匯入」：暫時儲存設定，以便稍後執行。
- 儲存並執行匯入以儲存設定並立即執行大量匯入。
- 「儲存並安排匯入」：儲存設定，以便稍後安排大量匯入。 您可以選擇大量匯入的頻率，並設定匯入日期和時間。 大量匯入會在設定的日期和時間以選定的頻率執行，允許重複匯入而不需要手動干預。
-
按一下 儲存 以套用並執行選取的選項，認可您選擇的組態。 選取 儲存 會完成動作、套用您選擇的選項，並完成工作流程步驟。 一旦您按一下[儲存]，系統就會處理選取的選項並保留您的設定，讓變更生效。
大量匯入期間處理檔名 filename-handling-bulkimport-assets-view
當您大量匯入資產或資料夾時，Experience Manager Assets會匯入匯入來源中存在的整個結構。 Experience Manager遵循其內建規則，以處理資產和資料夾名稱中的特殊字元，因此這些檔案名稱需要經過淨化，以確保符合存放庫命名限制，並在整個平台上以可靠的方式呈現。 對於資料夾名稱和資產名稱，使用者定義的 title 保持不變，並儲存在 jcr:title 屬性中。 這表示清理會影響基礎節點名稱，而人類看得懂的顯示標題會保留為原始輸入。
大量匯入期間，Experience Manager會先執行下列檢查，再套用新匯入的清理規則：
- 檢查現有的資料夾 — Experience Manager檢查現有的資料夾，以避免重新匯入已經存在的資產和資料夾。
- 驗證父資料夾清理 — Experience Manager驗證匯入發生所在的父資料夾中套用的清理規則。
因此，當清理規則已套用至父資料夾時，Experience Manager會將相同的規則套用至匯入來源，以確保匯入階層的一致性。 針對新的匯入，接著會套用清理規則以管理資產和資料夾的檔案名稱。
如需大量匯入期間禁止的名稱、處理資產名稱和處理資料夾名稱的詳細資訊，請參閱在管理員視圖中大量匯入期間處理檔名。
檢視現有的大量匯入設定 view-import-configuration
大量匯入頁面提供所有大量匯入設定的集中檢視，可讓管理員監控過去的活動、重複使用儲存的定義，以及管理即將從單一位置自動執行。
若要檢視現有的大量匯入，請遵循下列步驟：
- 在左窗格中選取 大量匯入 選項。
- 大量匯入頁面隨即顯示，預設顯示 已執行的匯入 清單。
- 使用下拉式清單選項在可用的匯入檢視之間切換，包括 儲存的匯入 和排程的匯入。
可用的匯入型別 import-types-available
下拉式清單將大量匯入設定整理為三個不同的類別：
- 已執行的匯入 — 預設檢視，列出已執行的匯入。 此檢視用於檢閱已完成大量匯入操作的歷史記錄和結果。
- 儲存的匯入 — 已定義並儲存以供重複使用的匯入組態。 儲存的匯入可讓相同的設定再次執行，而不需從頭重新建立。
- 已排程的匯入 — 匯入組態設定為在定義的時間自動執行。 此檢視可讓管理員確認哪些匯入已排入佇列等候未來執行。
檢閱這些設定有助於確保完成的匯入如預期完成、可重複使用的定義保持準確，以及排程執行在執行之前已正確設定。
編輯大量匯入設定 edit-import-configuration
透過下列步驟，編輯現有大量匯入的組態詳細資訊：
-
找到您要變更的組態，然後按一下對應組態名稱的
-
按一下 編輯 以編輯模式開啟設定。
-
視需要更新可編輯的欄位，然後儲存變更。
編輯作業期間無法修改組態標題和匯入資料來源。 建立設定後，這兩個欄位將維持固定狀態。 這可確保匯入保持穩定的身分，並且先前對應的來源資料會持續正確對齊，保持執行和已排程執行的完整性。
從下列任一標籤編輯設定： 已執行、已排程或 已儲存匯入 標籤。 每個索引標籤都會顯示相同的編輯控制項，因此管理員可以從任何檢視清單中更新設定，無論匯入是否已執行、已排定要執行或已儲存以供稍後使用。
安排單次或定期匯入的排程 schedule-imports
排程匯入可讓您自動擷取資料，讓資料集保持最新狀態，而不需要手動重新上傳。 若要排定單次或定期大量匯入，請執行以下步驟：
-
按一下「已執行的匯入」或「已儲存的匯入」標籤中可用設定名稱相對應的「
-
設定 一次性 擷取，或排程以小時、每日或 每週 為基礎進行週期性匯入。 選擇符合您來源資料變更頻率的頻率，然後按一下 提交 以確認排程。 一次性擷取會執行一次匯入，而週期性排程則會在選取的間隔自動重新執行匯入，確保您的資料保持最新，不會重複手動操作。
執行匯入健康情況檢查 import-health-check
匯入狀況檢查會在您執行或排程匯入之前，先驗證匯入組態與其資料來源之間的連線。 執行此檢查可確認Adobe Experience Manager (AEM) Assets可以連線至設定的來源、成功驗證及擷取資產，避免認證損毀、端點不正確或無法連線服務所導致的失敗或部分匯入。
若要驗證與資料來源的連線，請完成以下步驟：
-
找到您要測試的設定。
-
按一下與組態名稱相對應的
-
按一下檢查。
AEM Assets接著會測試連線並報告結果：
- 如果連線成功，Experience Manager Assets會顯示確認訊息，指出已建立與資料來源的連線。 成功的結果可確認設定是否有效以及是否準備好用於匯入資產。
- 如果連線失敗，Experience Manager Assets會顯示錯誤，指出無法建立連線。 失敗的結果表示在再次嘗試匯入之前，您應該檢閱設定詳細資訊，例如來源位置、驗證認證和存取許可權。
在每次匯入執行前執行此健康狀態檢查，可降低匯入錯誤的風險，並確保您的來源組態保持有效且可連線。
在執行匯入之前執行試執行 dry-run-bulk-import
練習是一種非破壞性測試執行，會在實際匯入任何資產之前驗證 大量匯入 工作。 強烈建議您先執行練習，因為這樣可讓您預覽及驗證工作組態，而不需將變更提交至存放庫。 這可防止在即時匯入期間發生未預期的衝突、設定錯誤的來源路徑或意外覆寫等常見問題。
若要執行試執行，請按一下組態名稱對應的
Experience Manager Assets接著會顯示它為 大量匯入 工作偵測到的詳細資訊摘要，讓您在繼續之前先確認範圍。 此摘要通常包括：
- 識別為匯入的資產，反映工作將從設定的來源位置擷取的內容。
- 驗證結果，指出來源、認證及目標路徑是否已正確設定。
- 可能發生衝突，例如已在目的地存在且會受匯入影響的資產。
- 工作的整體範圍，讓您預覽即時匯入將處理的內容。
在執行匯入之前，請先檢閱這些試執行結果，以確保工作如預期般運作。 因此，您可以及早修正任何設定問題，減少大量匯入工作實際執行時匯入失敗或部分匯入的風險。
執行大量匯入 run-bulk-import
根據匯入組態是在安裝期間儲存或是已執行至少一次，可以從兩個位置觸發大量匯入。 兩個路徑都使用組態旁邊的
執行已儲存的匯入 run-saved-import
如果您在建立組態時儲存匯入，請從 儲存的匯入 索引標籤執行：
- 導覽至 儲存的匯入 標籤。
- 按一下與儲存的組態相對應的
- 按一下 執行 以執行匯入。
重新執行先前執行的匯入 rerun-executed-import
若要執行已執行的匯入，請使用 已執行的匯入 索引標籤。 這可讓您重新處理或重新整理先前擷取的資料，而不需要重新建立設定：
- 導覽至 已執行的匯入 標籤。
- 按一下與組態名稱相對應的
- 按一下 執行 以再次執行匯入。
停止或排程進行中的匯入 schedule-stop-ongoing-report
您可以直接 排程 或 停止 正在執行的批次匯入，從批次匯入狀態對話方塊，此對話方塊會在匯入進行中時顯示在 批次匯入首頁 上。 此對話方塊可讓您即時控制作業，因此作用中的匯入可以暫停、延後至排程時間，或完全停止而不離開首頁。
管理作用中的匯入 managing-active-import
使用 大量匯入狀態對話方塊 來控制目前的匯入：
- 排程進行中的匯入 — 將匯入延遲，以便在指定的時間執行，而不是立即繼續。 當您想要在非尖峰期間執行大量匯入以降低系統負載時，排程很有用。
- 停止進行中的匯入 — 停止目前正在執行的匯入。 停止匯入會防止在重新啟動匯入之前處理任何其他資產。
由於這些控制項會在匯入本身期間顯示，因此只要狀態對話方塊指出需要動作，您就可以調整或取消作業。
驗證匯入的資產 verify-imported-assets
您也可以按一下檢視Assets，檢視已匯入目標資料夾的資產。 這可讓您確認匯入是否如預期般進行，並直接在目標資料夾中驗證結果，確保在匯入完成之前已傳輸正確的資產。
刪除大量匯入設定 delete-bulk-import-configuration
使用 刪除 動作，直接從介面刪除任何大量匯入組態。 根據其狀態，大量匯入設定可能會出現在三個索引標籤之一：已執行的匯入索引標籤（已執行的設定）、已排程匯入索引標籤（在設定時間排入佇列的設定）或 已儲存的匯入 索引標籤（儲存以供稍後使用的設定）。 刪除動作可從目前列出設定的任何標籤中使用。
若要刪除大量匯入組態：
- 在已執行的匯入、已排程的匯入或 已儲存的匯入 索引標籤中找到組態名稱。
- 按一下與該組態名稱相對應的
- 按一下 刪除 以移除大量匯入組態。
這會將選取的大量匯入組態從清單中永久移除，確保它不再執行、保持排程狀態，或可重複使用。
執行大量匯入後瀏覽至資產 view-assets-after-bulk-import
在 大量匯入工作 完成後，您可以直接導覽至儲存匯入資產的目標位置。 確認此目的地是必要的驗證步驟：可讓您驗證資產是否著陸至預期的資料夾、檢閱資產的中繼資料，並在您開始使用內容之前確認匯入是否成功執行。
若要檢視資產在執行大量匯入工作後匯入的Assets目標位置：
- 找出與已完成大量匯入相關聯的組態名稱。
- 按一下與組態名稱相對應的
- 按一下檢視Assets。
選取 檢視Assets 會開啟Assets目標位置，將您直接導向收到匯入檔案的資料夾。 這可讓您立即存取匯入的資產，以便驗證結果、檢查個別專案並繼續下游工作，例如標籤、檢閱或發佈。
限制和驗證限制 limitations-authentication-constraints
- OneDrive大量匯入僅支援委派的（以使用者為基礎） OAuth (Open Authorization)。 不支援 僅限應用程式 和 服務主體 驗證。 因為委派的OAuth需要互動式使用者登入，才能代表登入的使用者授與存取權，因此不適用於完全自動化的背景處理。 如果是自動匯入，請改用Azure Blob Storage或Amazon S3 （簡單儲存服務），因為這些儲存式來源不依賴互動式使用者驗證，因此執行時沒有人員在場，無法授權每個工作階段。
另請參閱