Adobe Experience Manager Assets 开发人员用例、 API和参考资料

本文包含针对Assets作为Cloud Service的开发人员的建议、参考材料和资源。 它包括新的资产上传模块、API引用，以及有关后处理工作流中提供支持的信息。

Experience Manager Assets API和操作

Assets as a提供 Cloud Service 了多个API以编程方式与数字资产交互。每个API都支持特定的用例，如下表所述。 Assets用户界面、Experience Manager桌面应用程序和Adobe Asset Link支持所有或部分操作。

资产上传

在Experience Manager中，作为Cloud Service，您可以使用HTTP API直接将资产上传到云存储。 下面是上载二进制文件的步骤。 在外部应用程序中而不是在Experience Manager JVM中执行这些步骤。

1. 提交HTTP请求。它会通知Experience Manager部署您上传新二进制文件的意图。
2. PUT由启动请 求提供的一个或多个URI的二进制内容。
3. 提交HTTP请 求，以通知服务器二进制文件的内容已成功上传。

该方法可以对资产上传进行可伸缩、更高性能的处理。 与Experience Manager 6.5相比的区别如下：

• 二进制文件不会通过Experience Manager，现在，它只是将上传过程与为部署配置的二进制云存储进行协调。
• 二进制云存储可与内容交付网络(CDN)或边缘网络配合使用。 CDN会选择更接近客户端的上传端点。 当数据传输到附近端点的距离较短时，上传性能和用户体验会得到改善，尤其是对于地理上分散的团队而言。

启动上传

将HTTPPOST请求提交到所需的文件夹。 资产会在此文件夹中创建或更新。 包括选择器.initiateUpload.json以指示请求启动二进制文件的上传。 例如，应创建资产的文件夹路径为/assets/folder。 POST请求为POST https://[aem_server]:[port]/content/dam/assets/folder.initiateUpload.json。

请求正文的内容类型应为application/x-www-form-urlencoded表单数据，其中包含以下字段：

• (string) fileName: 必填. 资产在Experience Manager中显示的名称。
• (number) fileSize: 必填. 上传资产的文件大小（以字节为单位）。

只要每个二进制文件包含必填字段，就可以使用单个请求启动多个二进制文件的上传。 如果成功，请求将以下格式响应201状态代码和包含JSON数据的正文：

{
    "completeURI": "(string)",
    "folderPath": (string)",
    "files": [
        {
            "fileName": "(string)",
            "mimeType": "(string)",
            "uploadToken": "(string)",
            "uploadURIs": [
                "(string)"
            ]
        }
    ]
}

• completeURI （字符串）：在二进制文件完成上传时调用此URI。URI可以是绝对URI或相对URI，客户端应该能够处理这两个URI。 即，该值可以是"https://[aem_server]:[port]/content/dam.completeUpload.json"或"/content/dam.completeUpload.json"。请参阅完成上载。
• folderPath （字符串）：上传二进制文件的文件夹的完整路径。
• (files) （数组）：元素列表，其长度和顺序与启动请求中提供的二进制信息列表的长度和顺序相匹配。
• fileName （字符串）：相应二进制文件的名称，在启动请求中提供。此值应包含在完整请求中。
• mimeType （字符串）：相应二进制文件的mime类型，在启动请求中提供。此值应包含在完整请求中。
• uploadToken （字符串）：对应二进制文件的上传令牌。此值应包含在完整请求中。
• uploadURIs （数组）：其值是应将二进制内容上传到的完整URI的字符串列表(请参阅 上传二进制)。
• minPartSize （数字）：如果有多个URI，则可能提供给其中任一URI的数据的最 uploadURIs小长度（以字节为单位）。
• maxPartSize （数字）：如果有多个URI，则可能提供给其中任何一个的数据的最大长度(以字 uploadURIs节为单位)。

上载二进制文件

启动上传的输出包括一个或多个上传URI值。 如果提供了多个URI，则客户端会将二进制文件拆分为多个部分，并按顺序对每个URI发出每个部分的PUT请求。 使用所有URI。 确保每个部件的大小在启动响应中指定的最小和最大大小范围内。 CDN边缘节点有助于加快请求的二进制文件上传。

实现此目的的一种潜在方法是，根据API提供的上传URI数量计算部件大小。 例如，假设二进制文件的总大小为20,000字节，并且上传URI的数量为2。 然后，执行以下步骤：

• 通过将总大小除以URI数来计算部件大小：20,000 / 2 = 10,000。
• POST字节范围0-9,999（二进制）到上传URI列表中的第一个URI。
• POST字节范围10,000 - 19,999（二进制到上传URI列表中的第二个URI）。

如果上传成功，服务器将使用201状态代码响应每个请求。

完成上传

上传二进制文件的所有部分后，将HTTPPOST请求提交到初始数据提供的完整URI。 请求正文的内容类型应为application/x-www-form-urlencoded表单数据，其中包含以下字段。

与启动过程一样，完整的请求数据可能包含多个文件的信息。

只有在为文件调用完整URL后，才会完成上传二进制文件的过程。 上传过程完成后，会处理资产。 即使资产的二进制文件已完全上传，但上传过程未完成，处理也不会开始。 如果上传成功，服务器将回复200状态代码。

开源上载库

要了解有关上传算法的更多信息或构建您自己的上传脚本和工具，Adobe提供了开源库和工具：

• 开源aem上传库。
• 开源命令行工具。

已弃用的资产上传API

仅Adobe Experience Manager作为Cloud Service支持新的上载方法。 Adobe Experience Manager 6.5中的API已弃用。 以下API中弃用了与上传或更新资产或演绎版（任何二进制上传）相关的方法：

• Experience Manager资产HTTP API
• AssetManager Java API，例如 AssetManager.createAsset(..)

资产处理和后处理工作流

在Experience Manager中，资产处理基于使用资产微服务的​处理配置文件​配置。 处理不需要开发人员扩展。

对于后处理工作流配置，请使用带有自定义步骤的扩展的标准工作流。

在后处理工作流中支持工作流步骤

如果您从以前的Experience Manager版本进行升级，则可以使用资产微服务来处理资产。 云原生资产微服务的配置和使用更简单。 不支持在以前版本的DAM更新资产工作流中使用的一些工作流步骤。 有关支持类的更多信息，请参阅Java API引用或Javaocs。

以下技术工作流模型已被资产微服务取代，或者无法获得支持：

• com.day.cq.dam.cameraraw.process.CameraRawHandlingProcess
• com.day.cq.dam.core.process.CommandLineProcess
• com.day.cq.dam.pdfrasterizer.process.PdfRasterizerHandlingProcess
• com.day.cq.dam.core.process.AddPropertyWorkflowProcess
• com.day.cq.dam.core.process.CreateSubAssetsProcess
• com.day.cq.dam.core.process.DownloadAssetProcess
• com.day.cq.dam.word.process.ExtractImagesProcess
• com.day.cq.dam.word.process.ExtractPlainProcess
• com.day.cq.dam.ids.impl.process.IDSJobProcess
• com.day.cq.dam.indd.process.INDDMediaExtractProcess
• com.day.cq.dam.indd.process.INDDPageExtractProcess
• com.day.cq.dam.core.impl.lightbox.LightboxUpdateAssetProcess
• com.day.cq.dam.pim.impl.sourcing.upload.process.ProductAssetsUploadProcess
• com.day.cq.dam.core.process.SendDownloadAssetEmailProcess
• com.day.cq.dam.similaritysearch.internal.workflow.smarttags.StartTrainingProcess
• com.day.cq.dam.similaritysearch.internal.workflow.smarttags.TransferTrainingDataProcess
• com.day.cq.dam.switchengine.process.SwitchEngineHandlingProcess
• com.day.cq.dam.core.process.GateKeeperProcess
• com.day.cq.dam.s7dam.common.process.DMEncodeVideoWorkflowCompletedProcess
• com.day.cq.dam.core.process.DeleteImagePreviewProcess
• com.day.cq.dam.video.FFMpegTranscodeProcess
• com.day.cq.dam.core.process.ThumbnailProcess
• com.day.cq.dam.video.FFMpegThumbnailProcess
• com.day.cq.dam.core.process.CreateWebEnabledImageProcess
• com.day.cq.dam.core.process.CreatePdfPreviewProcess
• com.day.cq.dam.s7dam.common.process.VideoUserUploadedThumbnailProcess
• com.day.cq.dam.s7dam.common.process.VideoThumbnailDownloadProcess
• com.day.cq.dam.s7dam.common.process.VideoProxyServiceProcess
• com.day.cq.dam.scene7.impl.process.Scene7UploadProcess
• com.day.cq.dam.s7dam.common.process.S7VideoThumbnailProcess
• com.day.cq.dam.core.process.MetadataProcessorProcess
• com.day.cq.dam.core.process.AssetOffloadingProcess
• com.adobe.cq.dam.dm.process.workflow.DMImageProcess