[AEM Assets]{class="badge positive" title="适用于AEM Assets)。"}
Assets支持的文件格式 supported-file-formats
Adobe Experience Manager as a Cloud Service为任何二进制文件提供基本的内容管理功能,与其格式无关 — 包括存储、在线元数据管理、版本控制以及文件的上载和下载。 Adobe Experience Manager Assets支持多种文件格式,而且每种产品功能都提供不同格式的特定级别支持。
此外,Experience Manager Assets还提供 扩展支持 以生成预览和演绎版,并提取 全文索引 的元数据和文本。 此扩展支持通过资源微服务提供,该服务支持在云中对资源进行可扩展的自动化处理,以便预览、演绎版和元数据提取在大型资源库中一致运行。
使用资产微服务的资产转换功能亮点包括:
以下图例描述了每种格式的支持级别。
某些功能可能与其他格式配合使用,但这些格式不受正式支持。 因此,输出可能不一致,并且功能可能无法按预期工作。
由于不支持的格式可能会产生不可靠的结果,因此请仅使用支持的格式以确保一致且可预测的行为。
Adobe格式 adobe-formats
Adobe Experience Manager (AEM) Assets处理一系列本机Adobe文件格式,生成预览并提取嵌入信息,以使资源在数字资产管理系统中保持可搜索性和可用性。 下表确定了每个Adobe格式支持的处理功能。
定义的支持的功能:
- 缩略图生成 — 创建资源的可视预览(演绎版)以供浏览和搜索结果。
- 全文提取 — 对文件中的可读文本内容进行索引,以便通过关键词搜索找到资源。
- 元数据提取 — 从文件中读取嵌入的元数据(如作者、标题和描述性字段)。
- 宽度/高度 — 检测和记录资源的像素或页面尺寸。
在所有列出的Adobe格式中,除了缩略图生成、元数据提取和宽度/高度检测之外,PDF是唯一支持全文提取的格式。 表中的每种格式都支持元数据提取,而光栅和设计格式支持生成缩略图和宽度/高度检测,容器或模板格式则不支持。
支持缩略图生成和宽度/高度检测的格式: AI、DN、SBSAR、INDD、PDF、PSB、PSD和XD。 相反,COLLAGE、IDEAS、INDT和PROTO仅支持元数据提取。
Adobe格式首字母缩略词说明:
- AI — Adobe Illustrator矢量图稿。
- 拼贴 — Adobe拼贴文件。
- DN — 扩展名为DN的Adobe文件。
- SBSAR — Adobe Substance材料存档。
- IDEAS — Adobe Ideas草图文件。
- INDD — Adobe InDesign文档。
- INDT — Adobe InDesign模板。
- PDF — 可移植文档格式。
- PROTO — Adobe原型文件。
- PSB — Adobe Photoshop大文档(大)。
- PSD — Adobe Photoshop文档。
- XD — Adobe XD体验设计文件。
*对于Adobe InDesign文件(INDD),演绎版的大小由INDD文件中嵌入的预览图像决定。 要嵌入更大的呈现版本,请在InDesign中配置预览首选项,位于首选项>文件处理>始终保存预览图像及文档,预览大小。 选择较大的预览大小可确保AEM Assets可以为InDesign文档生成更高分辨率的缩略图。
图像格式 image-formats
支持处理以下图像文件格式,其功能跨越缩略图生成、元数据提取、宽度/高度检测和裁剪。 支持的格式包括BMP (位图)、GIF (图形交换格式)、JPEG (联合照相专家组)、PNG (可移植网络图形)、TIFF (标记图像文件格式)和 WebP 等常见光栅格式以及矢量和专用格式,包括EPS (封装PostScript)、SVG (可缩放矢量格式图形)、SGI™、RGB和RGBA。
定义的支持的功能
- 缩略图生成 — 创建源图像的较小预览表示形式,可用于列表、画廊和快速视觉识别。
- 元数据提取 — 读取嵌入的信息,如颜色配置文件、编码详细信息以及存储在文件中的其他属性。
- 宽度/高度 — 检测图像的像素尺寸,实现精确的布局和缩放。
- 裁切 — 将图像裁切到指定的区域,删除不需要的区域,同时保留保留保留的内容。
按格式显示的功能支持
关键支持说明
- 所有列出的格式都支持生成缩略图,使预览创建在受支持的集合中普遍可用。
- 支持所有四种功能(缩略图生成、元数据提取、宽度/高度检测和裁切)的格式为GIF、JPEG、PNG、RGB、RGBA、SGI™和WebP。
- BMP和 SVG 支持除元数据提取之外的每种功能,这反映出这些格式携带的嵌入属性数据有限。
- EPS不支持宽度/高度检测或裁切,与其作为基于PostScript的格式而不是固定维度的光栅图像的角色一致。
- TIFF支持缩略图生成、元数据提取和宽度/高度检测,但 不支持 裁切。
正如在图像处理中广泛承认的那样,光栅格式(如JPEG、PNG和WebP)存储了具有已定义维度的基于像素的数据,因此它们始终支持宽度/高度检测和裁剪。 面向矢量的格式,如 SVG 和EPS,通过可缩放的指令而不是固定的像素网格描述图像,这说明了对于上表反映的某些依赖于维度和元数据的操作的支持比较有限。
三维格式 support-3d-formats
支持九种3D文件格式:DN、gLB、gLTF、OBJ、STL、FBX、3DS、USDz和SBSAR。 每种格式都支持存储、版本控制和工作流,而发布、缩略图预览、3D预览和Dynamic Media交付会因格式而异,如下面的支持矩阵中所示。
另请参阅在 Dynamic Media中使用3D资产。
支持的3D格式定义
支持的格式对应于广泛使用的3D文件类型:
- gLB和gLTF — GL Transmission Format (glTF),一种高效传输和加载3D场景和模型的开放标准。 gLB是格式的二进制打包。
- OBJ — Wavefront OBJ,一种表示3D网格的常用几何定义格式。
- STL — 立体光刻(STL),广泛用于3D打印和快速原型。
- FBX — Filmbox (FBX),一种用于3D内容、动画和场景的交换格式。
- 3DS — 3D Studio (3DS),旧网格和场景格式。
- USDz — Universal Scene Description Zip (USDz),一种面向AR的3D资源容器格式。
- SBSAR — Substance Archive (SBSAR),一种参数材料和纹理格式。
- DN — 支持3D资源的存储和工作流格式。
功能列说明
支持矩阵中的每一列都指示给定的功能是否可用于该格式:
- 存储 — 可以将格式作为3D资产进行存储和管理。
- 版本控制 — 可以跟踪和保留资产的多个版本。
- 工作流 — 可以通过自动工作流处理资源。
- 正在发布 — 可以发布资产以进行交付。 由于下游投放需要发布,因此没有发布支持的格式仅限于内部使用。
- 访问控制 — 可以应用权限来管理谁可以查看或管理该资源。
- 缩略图预览 — 生成静态缩略图图像以便快速进行视觉识别。
- 3D预览 — 交互式3D预览可用于检查模型。
- Dynamic Media投放 — 可以通过Dynamic Media投放资产。 支持完整Dynamic Media投放的格式为gLB、OBJ、STL和USDz。
3D格式支持矩阵
Camera Raw格式 camera-raw-formats
下面列出的所有 27相机原始文件格式 都支持相同的三个核心操作: 缩略图生成、元数据提取和宽度/高度检测。 表中的所有格式在所有三项功能上都受到完全支持,这使得覆盖范围在主要的相机原始数据标准中是统一和全面的。
每种格式支持的操作
在处理Camera Raw文件时,每个支持的功能都有不同的用途:
- 缩略图生成生成嵌入原始文件或从原始文件派生的预览图像,无需解码完整的传感器数据即可实现快速视觉浏览。
- 元数据提取读取嵌入的EXIF和特定于制造商的信息,如相机设置、曝光值和原始文件中存储的捕获详细信息。
- 宽度/高度检测确定图像的像素尺寸,这对于布局、编目和下游处理至关重要。
列出原始格式的制造商来源
Camera Raw格式在很大程度上是绑定到特定相机制造商的专有标准,因此该列表涵盖了如此多的不同文件扩展名。 作为一般背景,一些受支持的扩展适用于知名相机制造商:
- CR2和CR3(Canon Raw版本2和3)以及 CRW 与Canon相机相关联。
- NEF (Nikon电子格式)和 NRW 是Nikon原始格式。
- ARW、SRF和 SRW 对应于Sony和Samsung原始映像。
- ORF是Olympus原始格式,RAF与Fujifilm、Panasonic和Leica的 RW2 和 RWL 相关联。
- PEF和DCR/KDC与Pentax和Kodak映像相关联。
- DNG (Digital Negative)是一种开放的、非专有的原始存档格式,旨在实现广泛的跨制造商兼容性。
- 其他格式,如3FR、FFF、IIQ、MEF、MFW、MOS、MRW、ERF、GPR和 X3F 源自中格式、操作摄像头和专用传感器系统。
由于列出的所有格式都提供了相同的缩略图生成、元数据提取和维度检测支持,因此无论原始文件是由哪个相机制造商生成的,用户都可以依赖一致的行为。 这种广泛、统一的覆盖范围确保来自各种相机系统的文件可以预览、编目和处理,而不受格式特定限制。
文档格式 document-formats
资产管理功能支持19文档格式,涵盖文字处理、电子表格、演示、发布和标记文件类型。 下面的矩阵指定哪些功能适用于每种格式。
功能定义
兼容性矩阵中的每一列对应于一个不同的资源管理功能:
- 缩略图生成 — 生成文档的可视预览图像,在浏览大型资源库时可加快识别速度。
- 全文提取 — 对文档的文本内容编制索引,以便可以搜索文档,从而提高整个存储库的可发现性。
- 宽度/高度 — 捕获文档的维度元数据,该元数据支持布局感知处理和渲染。
- 元数据管理 — 读取并存储嵌入的文档属性,从而允许按属性组织、筛选和管理资产。
- 已连接 Assets — 使资产可在已连接的实例中使用,将重复使用扩展到单个环境之外。
- 完整文档预览 — 呈现完整文档以供应用程序内查看,而无需使用本机应用程序。
格式缩写
作为参考,矩阵中的格式代码对应于以下常见文档类型:
- DOC / DOCX — Microsoft Word文档(旧版和Open XML格式)
- EPUB — 电子出版物电子书格式
- HTML — HyperText标记语言文档
- ODF / ODM / ODP / ODS / ODT / OFG — OpenDocument格式系列(公式、母版、演示文稿、电子表格、文本和图形变量)
- PDF — 可移植文档格式
- PPT / PPTX — Microsoft PowerPoint演示文稿(旧版和Open XML格式)
- PS — PostScript
- RTF — 富文本格式
- TXT — 纯文本
- XLS / XLSX — Microsoft Excel电子表格(旧版和Open XML格式)
- XML — 可扩展标记语言文档
基于 Open XML的格式(DOCX、PPTX、XLSX) 和 PDF 提供了最广泛的功能范围,支持缩略图生成、全文提取、维度元数据、元数据管理、连接的Assets和完整文档预览。 这种全面的支持使其成为依赖预览、搜索和跨实例重用的资源工作流最通用的选择。
视频格式 video-formats
下表列出了每个受支持的视频 文件格式 以及可用于每个格式的处理功能。 支持因格式而异:对于缩略图、元数据和投放,可以完全处理某些格式,而其他格式则仅限于这些操作的子集。
图例 — 每列的含义:
- 文件格式 — 以其公共扩展名标识的视频容器或编解码器类型(例如,MP4、MOV、AVI和 WebM 是最广泛使用的Web兼容视频容器之一)。
- 缩略图生成 — 格式支持自动创建静止预览图像。
- 元数据提取 — 此格式允许从文件中读取技术元数据(如持续时间、编解码器和帧详细信息)。
- 宽度/高度 — 可以自动检测格式的像素尺寸。
- 预览 — 可以直接预览格式。
- 输出 — 支持将该格式作为播放/分发的投放/输出格式。
复选标记(✓)表示该格式支持该功能;短划线(-)表示不支持该功能。
支持输出的格式:仅 MP4 和 WebM 标记为支持的 输出 格式。 这反映了他们作为现代Web和流播放的标准投放容器的角色,从而确保跨浏览器和设备的广泛兼容性。 列出的其他大多数格式都支持用于摄取和处理的缩略图生成、预览和维度检测,但并非最终输出容器。
请注意,对 元数据提取 和 缩略图生成 的支持并非在所有格式中均统一,例如,容器格式(如 3G2 和3GP)支持元数据提取,但不支持缩略图生成或预览,因为其预期用途和内部结构限制了可以执行的操作。 AVI、F4V、FLV、M4V、MOV、MP4、MPEG、MPG和 WMV 等格式提供了最全面的摄取格式处理功能。
音频格式 audio-formats
Assetsas a Cloud Service支持六种音频格式的可扩展元数据平台(XMP)元数据提取:AIF、ASF、M4A、MP3、WAV和WMA。 XMP元数据提取可读取存储在音频文件中的嵌入式描述信息(如标题、艺人、版权和其他标记字段),并在资产管理系统中提供该信息。 这使您能够根据上传的音频资产的内置元数据而不是单独的文件名来搜索、筛选和组织这些音频资产。
支持的音频格式包括:
- AIF (音频交换文件格式):一种通常用于高质量音频存储的未压缩音频格式。
- ASF(高级系统格式):为流媒体设计的容器格式。
- M4A (MPEG-4音频):广泛用于音乐和有声读物的压缩音频格式。
- MP3 (MPEG-1音频层III):最广泛采用的压缩音频格式之一,用于通用音频分发。
- WAV(波形音频文件格式):一种适用于高保真和专业音频工作的未压缩音频格式。
- WMA (Windows Media音频):在Windows Media生态系统中开发的压缩音频格式。
由于XMP元数据是自动针对每种格式提取的,因此摄取的音频资产会将它们的描述性标记带入平台,从而提高可发现性并简化大规模数字资产管理。
音频和视频转录支持的输入格式 audio-video-transcription-formats
音频和视频转录支持以下容器和文件格式。 每个条目都列出了格式名称、相关的适用编解码器,以及标识输入文件类型的接受文件扩展名(显示在括号中)。
- FLV (带有 H.264 和 AAC 编解码器) (.flv)
- MXF (.mxf)
- MPEG2-PS,MPEG2-TS,3GP (.ts,.ps,.3gp,.3gpp,.mpg)
- Windows Media Video (WMV)/ASF (.wmv,.asf)
- AVI(未压缩8位/10位)(.avi)
- MP4 (.mp4,.m4a,.m4v)
- ®数字视频录制(DVR-MS) (.dvr-ms)
- Matroska/WebM (.mkv)
- WAVE/WAV (.wav)
- QuickTime (.mov)
提示和限制 limitations-and-tips
元数据提取的文件大小限制
要牢记的关键限制包括:
-
元数据提取的文件大小限制约为15 GB。 在上传接近或超过此阈值的大型资产时,元数据提取操作可能会失败。 发生这种情况的原因是,提取过程必须在可用的处理限制内扫描和分析整个文件,而且非常大的资源会增加成功完成提取所需的处理时间和资源。
-
元数据提取对于轻松保持在大小限制内的资源最可靠。 因此,将单个文件保留在 约15 GB 以下有助于确保始终如一且无中断地提取元数据。 如果提取大型资源失败,则减小文件大小、将资源拆分为较小的组件或重新上传可以帮助提取操作按预期完成。
Dynamic Media — 支持的转码输入视频格式 video-dynamic-media-transcoding
Dynamic Media转码接受一组定义的输入视频格式,转码成功取决于是否将正确的容器(如MP4、MOV或WMV)与推荐的视频编解码器(如H264/AVC — 高级视频编码)匹配。 下面每个受支持的容器都与已知可可靠转码的编解码器配对,以及不受支持且无法正确处理的编解码器。 为容器选择推荐的编解码器可确保接收并转换源视频,而不会失败。
‡尚不支持 MXF(材料交换格式) 容器用于Dynamic Media中的交互式视频或用于Experience Manager Assets中的批注。 因此,MXF源文件仍可以通过上述标准格式进行转码,但依赖于交互式视频或注释功能的工作流必须使用受支持的替代容器。
Dynamic Media — 支持的文档格式 document-support-dynamic-media
Adobe Experience Manager Dynamic Media支持三种文档输入格式:Adobe Illustrator (AI)、Adobe InDesign (INDD)和可移植文档格式(PDF)。 下表确切确立了每种格式在整个资产工作流中支持的操作 — 从初始上传到动态演绎版投放。
支持的输入和输出格式
可移植文档格式(PDF)是Dynamic Media中最完全支持的文档格式。 PDF支持工作流的每个阶段: 上传、创建图像预设、预览动态演绎版、交付动态演绎版和下载动态演绎版。 相反,Adobe Illustrator (AI)和 Adobe InDesign (INDD) 仅支持上传 — 这些格式可以引入Dynamic Media,但不能用于创建图像预设或预览、交付或下载动态演绎版。
每列表示Dynamic Media管道中的一个不同步骤:
- 上传(输入格式):可以将格式作为源资产引入Dynamic Media。
- 创建图像预设(输出格式):可以将格式处理为图像预设,以便在呈现版本中重用。
- 预览动态演绎版:可以预览动态生成的资源演绎版。
- 交付动态演绎版:动态生成的演绎版可以交付到网站、应用程序或其他终结点。
- 下载动态演绎版:可以下载动态生成的演绎版。
由于AI和INDD是原生设计源文件,因此支持将它们作为源资产上传,而PDF(一种可移植、打印和Web就绪的交付格式)会流经整个演绎版工作流。
安全的PDF处理
对于安全(受密码保护或权限限制)的PDF,仅支持上传。 这意味着可以将安全的PDF引入Dynamic Media,但无法将其用于创建图像预设或预览、交付或下载动态演绎版。 此限制反映了嵌入在安全PDF文件中的访问控制,这些访问控制限制了Dynamic Media可以对其执行的下游处理。
Dynamic Media — 支持的栅格图像格式 image-support-dynamic-media
Adobe Experience Manager Dynamic Media支持一组定义的栅格图像格式,每种格式在上传、通过图像预设转换、预览、交付、下载还是在特定集类型中使用时有所不同。 下表针对这些功能映射了每种支持的格式。 动态演绎版是Dynamic Media在请求时提供服务的图像的按需动态生成版本,这就是为什么传递支持是格式之间的关键区别所在。
支持的格式包括AVIF(AV1图像文件格式)、BMP(位图)、EPS(封装的PostScript)、GIF(图形交换格式)、HEIC(高效图像容器)、JPEG(联合照相专家组)、PICT、PNG(可移植网络图形), PSD (Photoshop文档)、TIFF (标记的图像文件格式)和WEBP。
如何读取功能列
- 上传(输入格式):可以将格式作为源资产引入Dynamic Media。
- 创建图像预设(输出格式):可以通过图像预设生成该格式作为输出。
- 预览动态演绎版:可以在界面中预览动态生成的资源版本。
- 交付动态演绎版:可在请求时向最终用户提供动态生成的版本。
- 下载动态呈现版本:可以下载生成的呈现版本。
- 支持此格式的集类型:特定集类型 — 图像、混合媒体和旋转 — 可用于此格式。
支持完整管道的格式(上传、预设创建、预览、交付和下载)包括EPS、GIF、JPEG、PNG和TIFF。 相比之下,AVIF、HEIC和 WEBP 仅支持交付动态演绎版,而不支持上传、预设创建、预览或下载。 BMP、JPEG、PNG和 TIFF 是图像、混合媒体和 旋转 集类型支持的格式。
关于从PSD文件中提取的合并图像
‡对于 PSD (Photoshop文档) 文件,将从PSD文件中提取合并的图像。 此合并图像由Adobe Photoshop生成并嵌入到PSD文件本身中。 根据文件的保存方式及其设置,合并的图像可能与实际的复合图像匹配,也可能不匹配,因此提取的结果可能与原始分层文档显示的内容不同。
Dynamic Media — 不支持的栅格图像格式 unsupported-raster-image-formats-dm
Dynamic Media不支持光栅图像文件格式的以下子类型。 符合这些条件的文件无法处理,因为其编码、色彩空间或位深度不在支持的范围内:
- IDAT区块大小大于100 MB的PNG (可移植网络图形)文件。 IDAT块存储压缩的图像数据,超过此阈值的块超过处理限制。
- PSB (Large Document Format / Photoshop Big)文件 — 用于大于标准Photoshop大小限制的文档的扩展PSD格式。
- CMYK、RGB、灰度或位图以外色彩空间中的PSD (Photoshop Document)文件。 不支持DuoTone、Lab和Indexed色彩空间。
- 每个通道位深度大于16位的PSD文件。
- 包含浮点数据的TIFF (标记图像文件格式)文件。
- Lab色彩空间中的TIFF文件。
Dynamic Media — 支持的3D文件格式 support-3d-formats-dynamic-media
另请参阅支持的3D格式
Adobe Dynamic Media支持四种主要的3D文件格式用于资产摄取和交付:GLB、OBJ、STL和USDZ。 从基于Web的交互式观看到3D打印和原生移动增强现实体验,每种格式都提供不同的工作流程。
资产文件格式支持和验证 asset-file-format-support-and-validation
Adobe Experience Manager (AEM) Assets处理依赖于两个不同的机制,当文件类型不完全受支持时,每个机制的行为都不同。 确定哪个机制失败是确定观察到的行为是否是预期行为,还是指示需要修复的问题的最快方法。
两种机制是:
- 标准演绎版 — 始终为每个资源请求且不可配置。 由于标准演绎版会在所有引入的资源上自动运行,因此无论资源类型如何,它们都表示AEM适用的基线处理。
- Dynamic Media或自定义处理配置文件 — 可完全配置,并且可以按MIME(多用途Internet邮件扩展)类型或资源选择条件限定范围。 这种可配置性允许这些用户档案以特定文件类型或资源子集为目标,而不是统一应用。
为什么区分很重要
关键的区别在于可配置性。 标准演绎版适用于每个资源且无法调整,而 Dynamic Media或自定义处理配置文件 可配置且可以选择设定范围。 因此,当文件类型未得到完全支持时,这两种机制可能会产生不同的结果。
确定哪个机制失败说明了结果是预期行为还是需要解决的问题。 如果故障源自不可配置的标准演绎版,则该行为反映了AEM对该文件类型的基线处理。 如果它源自于可配置的处理配置文件,则由MIME类型或资产选择标准定义的范围是更有可能调查的因素。
预期的呈现版本失败 expected-rendition-failures
不适用格式的呈现版本失败是预期行为,在AEM中按设计是行为 — 而不是配置错误。 Adobe Experience Manager (AEM)资源微服务始终为每个上传的资源请求一组固定的标准演绎版,无论其MIME(多用途Internet邮件扩展)类型如何。 此固定集包括文本提取和MP4(视频)预览,管道将尝试跨所有资源统一进行这两个操作。
由于统一应用此请求集,因此某些演绎版天生不适用于某些资源类型。 对于PNG(可移植网络图形)图像,无法生成以下演绎版:
cqdam.text.txt— 用于文档和其他文本承载资源的文本提取演绎版。 图像不包含可提取正文文本,因此无法生成此演绎版。cq5dam.preview.mp4— 用于移动图像资源的视频预览演绎版。 静态图像没有要编码的视频流,因此无法生成此演绎版。
由于这些演绎版不适用于资产的实际格式,因此它们将被记录为 dam:failedRenditions 中的条目。 这是正常行为,而不是配置错误。
只要与资产的实际类型 相关的演绎版 成功完成,此类条目的存在就是无害的。 对于图像资源,这意味着:
- 标准图像演绎版按预期生成。
- 已成功完成 Dynamic Media处理 映像。
换言之,不应用于给定资产类型的格式的dam:failedRenditions条目指示管道正确跳过不适用的输出,而不是真正的处理错误。 仅当与资产实际类型相关的 为 的演绎版失败时,才应进行调查。
不受支持或受限制的输入格式 unsupported-or-restricted-input-formats
已知以下格式和方案不支持或限制在Adobe Experience Manager (AEM)中作为Cloud Service进行资源处理,以及观察到行为和建议对每个格式和方案进行修正。
<stop>元素中缺少offset属性/is/image,而/is/content仍呈现它。 这是因为SVG违反了 SVG 1.1 合规性。.pem证书#、/、;、反斜杠符号、管道符号、[、]、%、{、}、?、&)开头或包含的元数据值exifEX、mwg-rs、photomechanic限制每个文件夹的上传类型 restricting-upload-types-per-folder
文件夹特定的上载限制允许您仅接受单个文件夹中的某些文件类型,而保留存储库的其余部分不变。 默认情况下,多用途Internet邮件扩展(MIME)类型限制在整个 数字资产管理(DAM) 系统中应用全局,但这些全局规则可以在 文件夹级别 覆盖,以实施更严格、特定于位置的控件。
要为特定文件夹(例如,/content/dam/projects)配置允许的MIME类型,请执行以下步骤:
- 导航到工具 > Assets > Assets配置。
- 选择目标文件夹路径(如
/content/dam/projects)。 - 仅列出该文件夹应接受的MIME类型。
由于文件夹配置充当显式允许列表,因此该文件夹会自动阻止列表中未列出的任何MIME类型。 因此,该文件夹中会专门拒绝常见格式(如Excel电子表格),而不会影响DAM中其他位置的上传。 这种规定范围的方法可确保每个文件夹都能强制执行其自己的内容标准 — 将项目目录、品牌资产商店或特定于部门的文件夹限制为其预期的文件类型,同时更广泛的存储库会继续根据其全局规则运行。
XMP元数据写回冲突 XMP-metadata-writeback-conflicts
对资源的元数据节点(cqdam.metadata.xml)进行并发更新(例如,从多个自定义工作流或服务同时写入同一资源)时,可能会在可扩展元数据平台(XMP)写回期间产生存储库冲突(InvalidItemStateException、CommitFailedException)。 发生这些冲突的原因是,每个保存操作都期望元数据节点处于一致的、未更改的状态;当两个进程同时修改同一节点时,存储库会检测到基础项目已更改并拒绝过时的写入。 结果,一个或多个竞争操作失败而不是无声地覆盖另一操作。
常见症状和原因
由于频繁重试这些失败的写入,因此此类重复失败会累积到不正常或重试的工作流实例的积压中。 如果不加以管理,此积压的工作会随着时间的推移而不断加重,从而降低整个工作流的吞吐量,并使诊断根源变得更加困难。
建议的分辨率
要防止XMP写回冲突并减少导致的工作流积压,请应用以下措施:
- 序列化并发元数据写入。 审查自定义工作流或服务以并行写入同一资产的元数据节点,并将它们序列化,以便一次只有一个进程写入给定的元数据节点。 以这种方式协调访问会删除触发
InvalidItemStateException和CommitFailedException的争用。 - 启用工作流清除维护。 启用并配置工作流清除维护,以便自动清除已完成和过时的工作流实例,而不是累积。 这样可保持工作流收件箱正常运行,并防止临时写回故障累积到永久性积压中。
故障排除清单 troubleshooting-checklist
- 排除格式不适用的演绎版。 如果演绎版失败仅影响不适用于资产格式的演绎版类型(例如,在图像上请求的视频预览),则将其视为预期行为,而不是错误。 请改为验证该资产的 适合格式化的演绎版 是否成功。
- 更正已排除文件类型的配置文件选择条件。 如果处理配置文件在从未打算由它处理的文件(例如 ZIP存档 或3D包)上失败,请修复配置文件的资源选择条件,而不是尝试强制处理文件类型。 将配置文件限制为支持的格式会从根本上解决该故障,因为文件从一开始就不是有效的输入。
- 怀疑配置之前有单个文件。 如果某个特定文件失败,而类似文件成功,则首先怀疑该文件本身。 在假定Adobe Experience Manager (AEM)配置问题之前,请检查受限或授权的字体(位于 PPTX 或 PDF 文件中)、SVG合规性或不支持的格式或扩展名不匹配(如 AVIF 或JFIF)。
- 调查工作流备份时的复合原因。 如果工作流在不正常状态下备份,请检查 不受支持的格式处理失败 和元数据写回冲突。 由于这两种失效模式可以同时发生,它们相互复合并加速了积压工作,因此解决这两种失效模式是清除积压工作的必要条件。
另请参阅