[AEM Assets]{class="badge positive" title="适用于AEM Assets)。"}
将数字资产作为Cloud Service添加到Adobe Experience ManagerAssets add-assets-to-experience-manager
Adobe Experience Manager Assets接受来自多个来源的多种数字资源。 它存储二进制文件和创建的演绎版，可以使用各种工作流和Adobe AI服务进行资产处理，允许跨多个表面通过多个渠道进行分发。
Adobe Experience Manager使用富元数据、智能标记、演绎版和其他数字资产管理(DAM)服务丰富了已上传数字文件的二进制内容。 您可以从本地文件夹或网络驱动器将各种类型的文件（如图像、文档和原始图像文件）上载到Experience Manager Assets。
除了最常用的浏览器上载之外，还存在将资产添加到Experience Manager存储库的其他方法。 这些其他方法包括桌面客户端（如Adobe Asset Link或Experience Manager桌面应用程序）、上传和客户将创建的摄取脚本，以及添加为Experience Manager扩展的自动摄取集成。
虽然您可以上传和管理Experience Manager中的任何二进制文件，但最常用的文件格式支持其他服务，如元数据提取或预览/演绎版生成。 有关详细信息，请参阅支持的文件格式。
您还可以选择对上传的资源执行其他处理。 可以在上传资源的文件夹上配置多个资源处理配置文件，以添加特定的元数据、演绎版或图像处理服务。 请参阅上传时处理资源。
Assets提供以下上载方法。 Adobe建议您在使用上传选项之前了解其用例和适用性。
上传资产 upload-assets
要上传文件（或多个文件），您可以在桌面上选择它们，然后在用户界面（Web浏览器）上将其拖到目标文件夹中。 或者，您可以从用户界面启动上传。
-
在Assets用户界面中，导航到要添加数字资产的位置。
-
要上传资源，请执行以下操作之一：
- 在工具栏上，单击创建 > 文件。 如果需要，可以在呈现的对话框中重命名文件。
- 在支持HTML5的浏览器中，将资源直接拖动到Assets用户界面上。 不显示重命名文件的对话框。
要选择多个文件，请选择
Ctrl或Command键，然后在文件选取器对话框中选择资源。 使用iPad时，一次只能选择一个文件。 -
要取消正在进行的上载，请单击进度条旁边的关闭(
X)。 取消上传操作时，Assets将删除部分上传的资产部分。
如果在上载文件之前取消上载操作，Assets将停止上载当前文件并刷新内容。 但是，不会删除已上载的文件。 -
Assets中的上传进度对话框显示已成功上传的文件数和无法上传的文件数。
此外，Assets用户界面会显示您上传的最新资源或您首先创建的文件夹。
处理现有资源的上传 handling-upload-existing-file
您可以上传与现有资产具有相同路径（相同名称和相同位置）的资产。 但是，会显示一个警告对话框，其中包含下列选项：
-
替换现有资源：如果替换现有资源，则将删除资源的元数据以及您之前对现有资源所做的任何修改（例如，注释和裁切）。
note NOTE 如果资产已锁定或签出，则用于替换资产的选项将不可用。 -
创建其他版本：在存储库中创建现有资源的新版本。 您可以在时间线中查看这两个版本，如有必要，还可以还原到以前的现有版本。
-
保留两者：如果选择保留两个资源，则新资源将重命名。
若要在Assets中保留重复的资产，请单击保留。 要删除您上传的重复资源，请单击删除。
文件名处理和禁止使用的字符 filename-handling
Experience Manager Assets阻止您上传其文件名中包含禁止使用的字符的资产。 如果您尝试上载文件名中包含不允许的字符或更多字符的资产，Assets将显示一条警告消息并停止上载，直到您删除这些字符或使用允许名称上载为止。
为了适合您所在组织的特定文件命名约定，可以使用上传Assets对话框为上传的文件指定长名称。 不支持以下（以空格分隔的）字符：
- 资源名称
* / : [ \\ ] | # % { } ? &或;=的字符无效（分号后跟等号） - 资产文件夹名称的字符无效：
* / : [ \\ ] | # % { } ? \" . ^ ; + & \t
无效的文件名示例：
JPG_JD_small file ~!)$@;(-_=+^',..jpgJPG_JD_small file ~!)$@;=(-_+^',..jpg
批量上传资产 bulk-upload
批量资源引入器可以高效地处理许多资源。 但是，大规模摄取并不仅仅是一种广泛的文件转储或临时迁移。 要使大规模引入成为满足您的业务目的并且高效的有意义项目，请规划迁移并策划资源组织。 所有引入都不同，因此，这里考虑的因素不是概括，而是存储库的细微构成和业务需求。 以下是计划和执行批量摄取的一些总体建议：
- 策划资源：删除DAM中不需要的资源。 考虑删除未使用、过时或重复的资源。 此类内务管理可减少传输的数据和引入的资产，从而加快引入速度。
- 组织资产：考虑按某种逻辑顺序组织内容，例如按文件大小、文件格式、用例或优先级。 通常，大型复杂文件需要更多的处理。 您还可以考虑使用文件大小过滤选项（如下所述）单独摄取大文件。
- 交错摄取：考虑将摄取分组为多个批量摄取项目。 q可让您更快地看到内容，并根据需要更新引入。 例如，您可以在非高峰时间摄取处理密集型资产，或逐渐摄取多个块中的资产。 但是，您可以一次性摄取不需要太多处理的更小、更简单的资产。
要上传更多文件，请使用以下方法之一。 另请参阅用例和方法
- 资源上传API：如有必要，请使用自定义上传脚本或使用API添加其他资源处理（例如，翻译元数据或重命名文件）的工具。
- Experience Manager 桌面应用程序：对于从本地文件系统上传资产的创意专业人员和营销人员非常有用。 使用它可上载本地可用的嵌套文件夹。
- 批量摄取工具：在部署Experience Manager时用于偶尔或最初摄取大量资源。
资产批量导入工具 asset-bulk-ingestor
该工具仅提供给管理员组用于从Azure或S3数据存储中大规模摄取资源。 观看配置和摄取的视频演练。
下图说明了将资产从数据存储摄取到Experience Manager时的各个阶段：
先决条件
此功能需要来自Azure或AWS的外部存储帐户或存储段。
配置批量导入工具 configure-bulk-ingestor-tool
要配置批量导入工具，请执行以下步骤：
-
导航到工具 > Assets > 批量导入。 选择 创建 选项。
-
在 标题 字段中指定批量导入配置的标题。
-
从 导入Source 下拉列表中选择数据源类型。
-
提供值以创建与数据源的连接。 例如，如果选择 Azure Blob Storage 作为数据源，请指定Azure存储帐户、Azure Blob容器和Azure访问密钥的值。
-
从下拉列表中选择所需的身份验证模式。 Azure访问密钥提供对Azure存储帐户的完全访问，而 Azure SAS令牌 允许管理员使用权限和过期策略限制令牌的功能。
-
在 源文件夹 字段中提供包含数据源中资源的根文件夹的名称。
-
（可选）在 按最小大小筛选 字段中提供要包含在摄取进程中的资源的最小文件大小（以MB为单位）。
-
（可选）在 按最大尺寸过滤 字段中，以 MB 为单位提供资源的最大文件大小，以将其包括在摄取过程中。
-
（可选）在 排除MIME类型 字段中指定要从摄取中排除的MIME类型列表（以逗号分隔）。 例如，
image/jpeg, image/.*, video/mp4。 请参阅所有支持的文件格式。 -
在 包含MIME类型 字段中指定要从摄取中包含的MIME类型列表（以逗号分隔）。 请参阅所有支持的文件格式。
-
选择 导入后删除源文件 选项，以在文件导入Experience Manager后从源数据存储中删除原始文件。
-
选择“导入模式”。 选择“跳过”、“代替”，或者创建版本。 跳过模式是默认模式，在该模式下，如果资源已经存在，则摄取器会跳过导入该资源。 查看替换和创建版本选项的含义。
-
要使用 资源目标文件夹 字段在 DAM 中定义要导入资源的位置，请指定路径。 例如：
/content/dam/imported_assets。 -
（可选）在 元数据文件 字段中指定要导入的元数据文件（以 CSV 格式提供）。 在源Blob位置中指定CSV文件，并在配置批量导入工具时引用路径。 当您批量导入和导出资产元数据时，此字段引用的CSV文件格式与CSV文件格式相同。 如果选择 导入后删除源文件 选项，请使用排除、包含MIME类型或 按路径/文件筛选 字段筛选CSV文件。 您可以使用正则表达式在这些字段中筛选CSV文件。
-
单击 保存 以保存配置。
管理批量导入工具配置 manage-bulk-import-configuration
创建批量导入工具配置后，您可以先执行任务以评估配置，然后再将资源批量摄取到Experience Manager实例。 要查看用于管理批量导入工具配置的可用选项，请选择位于工具 > Assets > 批量导入的配置。
编辑配置 edit-configuration
要编辑配置详细信息，请选择配置，然后单击编辑。 执行编辑操作时无法编辑配置的标题和导入数据源。
删除配置 delete-configuration
选择配置并单击 删除 以删除批量导入配置。
验证与数据源的连接 validate-connection
要验证与数据源的连接，请选择配置，然后单击检查。 如果连接成功，Experience Manager会显示以下消息：
为批量导入作业调用测试运行 invoke-test-run-bulk-import
选择配置并单击 试运行 以调用批量导入作业的测试运行。 Experience Manager显示有关批量导入作业的以下详细信息：
批量导入期间处理文件名 filename-handling-bulkimport
当您批量导入资源或文件夹时，Experience Manager Assets 导入在导入源中存在的内容的完整结构。 Experience Manager 遵循针对关资源和文件夹名称中特殊字符的内置规则，因此需要净化这些文件名。 对于文件夹名称和资源名称，用户定义的标题保持不变并存储在 jcr:title 中。
在批量导入期间，Experience Manager会查找现有文件夹以避免重新导入资产和文件夹，并且还会验证在导入执行位置的父文件夹中应用的清理规则。 如果在父文件夹中应用了净化规则，则将相同的规则应用于导入源。 对于新导入，应用以下净化规则以管理资源的文件名和文件夹名称。
批量导入中不允许的名称
文件和文件夹名称中不允许使用以下字符：
- 控制和专用使用字符（0x00到0x1F、\u0081、\uE000）
- 以点(.)结尾的文件或文件夹名称
在导入过程中，会跳过名称符合这些条件的文件或文件夹，并将其标记为失败。
正在批量导入中处理资源名称
对于资源文件名，使用API清理JCR名称和路径： JcrUtil.escapeIllegalJcrChars。
-
未更改Unicode字符
-
将特殊字符替换为其URL转义代码，例如，
new%asset.png已更新为new%25asset.png：code language-none URL escape code " %22 % %25 ' %27 * %2A / %2F : %3A [ %5B \n %0A \r %0D \t %09 ] %5D | %7C
正在处理批量导入中的文件夹名称
对于文件夹文件名，使用API清理JCR名称和路径： DamUtil.getSanitizedFolderName。
-
大写字符转换为小写
-
未更改Unicode字符
-
将特殊字符替换为破折号(“ — ”)，例如，
new folder已更新为new-folder：code language-none " # % & * + . : ; ? [ ] ^ { } | / It is used for split folder in cloud storage and is pre-handled, no conversion here. \ Not allowed in Azure, allowed in AWS. \t space It is the space character.
计划一次性或循环批量导入 schedule-bulk-import
要计划一次性或定期批量导入，请执行以下步骤：
-
创建批量导入配置。
-
选择配置并从工具栏中选择计划。
-
设置一次性摄取或安排每小时、每天或每周的摄取计划。 单击“提交”。
查看Assets目标文件夹 view-assets-target-folder
要查看运行批量导入作业后资源导入的Assets目标位置，请选择配置，然后单击查看Assets。
运行批量导入工具 run-bulk-import-tool
在配置批量导入工具并可选管理批量导入工具配置之后，您可以运行配置作业以开始批量摄取资产。
要启动批量导入流程，请导航到工具 > Assets > 批量导入，选择批量导入配置，然后单击运行。 再次单击 运行 以确认。
成功完成作业后，Experience Manager会将作业的状态更新为 正在处理 和成功。 要在Experience Manager中查看导入的资源，请单击查看Assets。
当作业正在进行时，您还可以选择配置并单击 停止 以停止批量摄取进程。 再次单击 运行 以继续此进程。 您还可以单击 试运行 以了解仍在等待导入的资产的详细信息。
执行后管理作业 manage-jobs-after-execution
Experience Manager允许您查看批量导入作业的历史记录。 作业历史记录包括作业的状态、作业创建者、日志以及其他详细信息，如开始日期和时间、创建日期和时间以及完成日期和时间。
要访问配置的作业历史记录，请选择该配置，然后单击作业历史记录。 选择作业并单击打开。
Experience Manager显示作业历史记录。 在“批量导入作业历史记录”页面上，您还可以单击 删除 以删除该批量导入配置的作业。
使用桌面客户端上传资源 upload-assets-desktop-clients
除了Web浏览器用户界面外，Experience Manager还支持桌面上的其他客户端。 这些客户端同样支持上传操作，无需打开网页浏览器即可完成。
- Adobe Asset Link提供了从Adobe Photoshop、Adobe Illustrator和Adobe InDesign桌面应用程序中的Experience Manager访问资源的权限。 您可以从这些桌面应用程序中直接从Adobe Asset Link用户界面将当前打开的文档上传到Experience Manager。
- Experience Manager 桌面应用程序简化了桌面上资产的处理过程，而不管其文件类型或处理这些资产的本机应用程序如何。 该应用程序适用于从本地文件系统上传包含嵌套文件夹结构的文件，因为浏览器上传仅支持上传扁平的文件列表。
上传时处理资源 process-when-uploaded
要对上传的资源执行其他处理，您可以对上传文件夹应用处理配置文件。 配置文件在Assets中文件夹的 属性 页面中可用。 扩展名不正确或扩展名不正确的数字资产无法按需要处理。 例如，上传此类资产时，可能没有任何反应，或者资产处理配置文件不正确。 用户仍然可以在DAM中存储二进制文件。
可以使用以下选项卡：
此外，如果在您的部署中启用了Dynamic Media，则以下选项卡可用：
- Dynamic Media 图像配置文件允许您对上传的资源应用特定裁剪（智能裁剪和像素裁剪）和锐化配置。
- Dynamic Media 视频配置文件允许您应用特定的视频编码配置文件（分辨率、格式、参数）。
对于已分配处理配置文件的文件夹，配置文件名称会显示在卡片视图的缩略图上。 在列表视图中，配置文件名称显示在 处理配置文件 列中。
使用API上传或摄取资源 upload-using-apis
开发人员参考的资产上传部分提供了上传API和协议的技术详细信息，以及指向开源SDK和示例客户端的链接。
资产上传安全性和最佳实践 asset-upload-security-and-best-practices
使用预签名URL直接二进制上传 direct-binary-upload
Adobe Experience Manager (AEM) as a Cloud Service通过 直接二进制上传 流程上传资源。 您可以请求一个预签名的URL，二进制文件会使用该URL直接上传到存储中，然后通过经过身份验证的API调用最终确定资产。
- 预签名URL大约会短暂存在一小时，但确切的生存时间(TTL)不是已发布或保证的Service level agreement (SLA)。 将持续时间视为可以更改的实施详细信息，而不是硬编码到集成中的值。
- 预签名URL必须立即用作单个上载会话的一部分。 此插件不用于以后存储和重用，也不用于跨多个上载重复使用。
- 仅泄露预签名的URL不足以创建资产。 资产创建或完成需要使用有效凭据和
uploadToken的经过身份验证的API调用。 如果仅获得预签名URL，则在没有有效身份验证和关联的上传令牌的情况下无法完成资产注册。 这限制了泄露URL的实际影响。 - 在您的集成中将预签名URL视为敏感值；避免记录它们，始终使用HTTPS，并且不要在上传会话之外保留它们。
用于程序化上传的身份验证 authentication-for-programmatic-uploads
AEM API访问存在两种身份验证机制，并且对于资源上传操作不可互换。
用于API上载的技术帐户在特定目标子文件夹的/content/dam和rep:write （或jcr:all）上必须具有显式的存储库级别ACL jcr:read，以及正确的凭据类型和管理员控制台产品配置文件或组成员资格。 技术帐户可以被正确许可和分组，如果尚未授予路径级别ACL，则仍会收到 403 Forbidden 错误。 产品配置文件或组分配和存储库ACL是独立的，并且都是必需的。
恶意软件检测和隔离 malware-detection-and-quarantine
启用恶意软件检测后，将扫描上传的文件，并将感染病毒的文件置于 隔离 区域。 对隔离资产的访问由标准AEM权限通过 隔离管理员 组进行控制；如果需要，可以授予其他自定义组访问隔离区域的权限。 隔离可见性不限于单个固定角色。 有关恶意软件检测和隔离的详细信息，请参阅恶意软件检测。
文件类型处理和上传限制 file-type-handling-and-upload-restrictions
- AEM对上传没有默认的文件类型限制。 可以将具有可执行扩展名（例如.exe、.exe.pdf）的文件作为资产演绎版上传。
- 这是一种预期行为，而不是AEM不会呈现或执行上传的活动内容或脚本的漏洞（无论是在浏览器中还是在服务器上）。 因此，在AEM的默认安全模型下，上传可执行文件本身不会产生远程代码执行风险。 如果组织需要满足更严格的合规性要求，则应应用自己的上传验证或允许列表，因为AEM不会在本机强制实施此验证。
- 资产处理支持的文件格式和MIME类型单独记录，不支持的类型不会得到完全处理（例如，它们可能不会生成预期的演绎版）。
上传可靠性最佳实践 upload-reliability-best-practices
- 对于大型或专用资源类型（如视频、PDF、GIF），请遵循推荐的文件大小限制、编码和首选格式，以避免在上传、处理和预览生成期间影响平台性能。
- 与针对业务关键型文件的临时文件夹级批量上传相比，更喜欢受支持的上传API或UI流。 据报告，文件夹级别的拖放上传偶尔会导致文件损坏；如果发生这种情况，请立即捕获确切的错误或行为（屏幕快照、HAR或网络日志），因为根本原因通常是环境或文件特定的，如果没有证据，很难在事后诊断。
上载失败疑难解答核对清单 troubleshooting-checklist-for-upload-failures
- 403禁止在API上载时执行：确认凭据类型。 资产上传API不支持来自Adobe Developer控制台的OAuth S2S。 请改用AEM开发人员控制台中的服务凭据(JWT)。
- 403已禁止，尽管凭据和组成员身份正确：确认技术帐户在特定目标文件夹的
/content/dam和rep:write/jcr:all上明确具有jcr:read。 组或配置文件成员资格不能代替文件夹级别的ACL。 - 上传成功，但资产无法显示或二进制文件似乎已损坏：排除将文件夹级别的批量上传作为摄取方法；通过标准上传API或UI重试，并在重复时捕获日志。
- 安全审查标记不受限制的文件上传：明确说明AEM在默认情况下不执行上传的活动内容服务器端或浏览器中的上传，因此这是一种预期的平台行为而不是缺陷，除非您的组织需要额外的上传时间验证。
- 担心预签名URL泄露：确认该URL在其短的有效期内被使用，并且资产最终确定仍需要单独的、经过身份验证的调用，其有效
uploadToken。 这就是限制泄露URL的爆炸半径的原因。
提示、最佳实践和限制 tips-limitations
-
直接二进制上传是一种上传资产的新方法。 产品功能和客户端（如Experience Manager用户界面、Adobe Asset Link和Experience Manager桌面应用程序）默认支持它。 客户技术团队自定义或扩展的任何自定义代码必须使用新的上传API和协议。
-
Experience Manager Assets现在支持包含大量子资产的文件夹。 一旦文件夹包含1000多个直接子文件夹（资产或子文件夹），Admin UI就会使用异步更新的索引来列出文件夹内容。 因此，新创建的文件夹和资产的可见性可能会有短暂的延迟（通常只需几秒钟），并且在管理员视图中打开此类文件夹时，会显示一个横幅以通知最终用户这种行为，并声明如下：“此目录包含1000多个项目。 上传和新文件夹创建可能会延迟。”
-
当您在名称冲突对话框中选择 替换 时，将为新资源重新生成资源ID。 此ID与上一个资源的ID不同。 如果启用了Assets Insights以通过Adobe Analytics跟踪展示次数或单击次数，则重新生成的资源ID将使在Analytics上为资源捕获的数据无效。
-
某些上传方法不会阻止您上传文件名中包含禁止使用的字符的资产。 字符已替换为
-符号。 -
使用浏览器上传资产仅支持平面文件列表，不支持嵌套文件夹层次结构。 要上传嵌套文件夹中的所有资产，请考虑使用桌面应用程序。
-
批量导入方法会导入数据源中存在的整个文件夹结构。 但是，在Experience Manager中只创建非空文件夹。
另请参阅