使用 Assets Essentials 批量导入资源 bulk-import-essentials

Last update: Sat Jul 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
Assets Essentials

创建对象：

用户
领导

通过 AEM Assets Essentials 中的批量导入，管理员可将大量资源从数据源导入到 AEM Assets。管理员不再需要将单独的资源或文件夹上传到 AEM Assets。

NOTE

Assets Essentials 批量导入器与 Assets as a Cloud Service 批量导入器使用相同的后端。但是，Assets Essentials 提供更多可从其导入的数据源和更简化的用户体验。

您可以从以下数据源导入资源：

AWS
Google Cloud
Dropbox
OneDrive
Azure

前提条件 prerequisites

数据源

前提条件

Azure

Azure 存储帐户
Azure Blob 容器
基于身份验证模式的 Azure 访问密钥或 SAS 令牌

AWS

AWS 区域
AWS 分段
AWS 访问密钥
AWS 访问机密

Google Cloud

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` 表示应用程序的名称。这种情况下，自动在 `home` 之后添加 `Apps`。

（可选）选择 导入后删除源文件 选项，以在文件导入到 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 查找现有文件夹以避免重复导入资源和文件夹，还验证在发生导入的父文件夹中应用的净化规则。如果在父文件夹中应用了净化规则，则将相同的规则应用于导入源。对于新导入，应用以下净化规则以管理资源的文件名和文件夹名称。

有关在批量导入期间不允许使用的名称、处理资源名称和处理文件夹名称的详细信息，请参阅批量导入期间处理文件名。