[AEM Assets]{class="badge positive" title="适用于AEM 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)存储桶
- GCP服务帐户电子邮件
- GCP服务帐户私钥
- Dropbox客户端ID（应用程序密钥）
- Dropbox客户端密钥（应用程序密钥）
- OneDrive租户ID
- OneDrive客户端ID
- 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数据。
-
创建客户端密钥后，复制 值 字段。 请勿复制密码ID字段，因为AEM Assets中的批量导入配置使用密码 值 进行身份验证，而不是使用密码ID进行身份验证。 在AEM Assets中配置批量导入时需要此值，它只显示一次 — 在离开页面之前立即复制并存储它。
添加 API 权限
配置 API权限 将授予注册应用程序代表登录用户与Microsoft Graph通信所需的特定访问权限。 此处定义的应用程序编程接口(API)权限确切地决定了应用程序有权请求哪些数据和操作。 完成以下步骤为应用程序添加所需的API权限：
- 在左窗格中单击API权限，然后单击添加权限。
- 单击 Microsoft Graph > 委派的权限。 随后 选择权限 部分显示可用的权限。 委派权限允许应用程序代表登录用户执行操作，而不是作为独立服务。
- 从
OpenId permissions中选择offline_access权限，并从Files中选择Files.ReadWrite.All权限。offline_access权限允许应用程序获取刷新令牌，以便它可以在不重复提示用户登录的情况下保持访问权限，而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表示应用程序的名称。 这种情况下，自动在home之后添加Apps。
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批量导入仅支持delegated （基于用户）OAuth (Open Authorization)。 不支持 仅应用程序 和 服务主体 身份验证。 由于委派的OAuth需要交互式用户登录才能代表登录用户授予访问权限，因此它不适用于完全自动化的后台处理。 对于无人参与的导入，请改用Azure Blob Storage或Amazon S3 (Simple Storage Service)，因为这些基于存储的源不依赖于交互式用户身份验证，因此运行时没有人员来授权每个会话。
另请参阅