Show Menu
화제×

Assets API 및 개발자 참조 자료

이 문서에는 Cloud Service의 개발자를 위한 참조 자료 및 리소스 Assets 가 포함되어 있습니다. 여기에는 새로운 업로드 방법, API 참조 및 사후 처리 워크플로우에서 제공되는 지원에 대한 정보가 포함됩니다.

자산 업로드

Experience Manager as a Cloud Service provides a new method to upload assets to the repository. 사용자는 HTTP API를 사용하여 자산을 클라우드 스토리지에 직접 업로드할 수 있습니다. 이진 파일을 업로드하는 단계는 다음과 같습니다.
  1. HTTP 요청을 제출합니다 . 새 바이너리를 업로드하려는 의도를 Experience Manage알려주거나 배포합니다.
  2. POST을 사용하면 초기화 요청에서 제공하는 바이너리 컨텐츠를 하나 이상의 URI로할 수 있습니다.
  3. HTTP 요청을 제출하여 바이너리의 내용이 성공적으로 업로드되었음을 서버에 알립니다.
이 접근 방식에서는 자산 업로드를 보다 확장 가능하고 성능적으로 처리할 수 있습니다. 6.5와 비교할 때 Experience Manager 다음과 같습니다.
  • 바이너리는 통과 Experience Manager가 되지 않으며, 이는 배포에 대해 구성된 바이너리 클라우드 스토리지를 사용하여 업로드 프로세스를 조정하는 것입니다.
  • 바이너리 클라우드 스토리지는 CDN(Content Delivery Network) 또는 Edge 네트워크와 연동됩니다. CDN은 클라이언트에 가까운 업로드 끝점을 선택합니다. 특히 지리적으로 분산된 팀의 경우 데이터가 가까운 종단점으로 이동하는 경우 업로드 성능 및 사용자 경험이 향상됩니다.
오픈 소스 aem-upload 라이브러리에서 이 방법을 구현하려면 클라이언트 코드 를 참조하십시오 .

업로드 시작

HTTP POST 요청을 원하는 폴더에 제출합니다. 이 폴더에 자산이 만들어지거나 업데이트됩니다. 요청이 바이너리 파일 .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일 수 있으며 클라이언트는 둘 중 하나를 처리할 수 있어야 합니다. 즉, 이 값은 "https://author.acme.com/content/dam.completeUpload.json" 또는 전체 업로드 "/content/dam.completeUpload.json" 참조하십시오 .
  • folderPath (문자열):바이너리가 업로드된 폴더의 전체 경로입니다.
  • (files) (배열):길이 및 순서가 시작 요청에 제공된 이진 정보 목록의 길이 및 순서와 일치하는 요소 목록입니다.
  • fileName (문자열):시작 요청에 제공된 해당 바이너리의 이름입니다. 이 값은 전체 요청에 포함되어야 합니다.
  • mimeType (문자열):시작 요청에 제공된 해당 바이너리의 MIME 형식입니다. 이 값은 전체 요청에 포함되어야 합니다.
  • uploadToken (문자열):해당 바이너리에 대한 업로드 토큰입니다. 이 값은 전체 요청에 포함되어야 합니다.
  • uploadURIs (배열):값이 바이너리 컨텐츠를 업로드해야 하는 전체 URI인 문자열 목록입니다(바이너리 업로드 참조 ).
  • minPartSize (숫자):둘 이상의 URI가 있는 경우 uploadURI 중 하나에 제공할 수 있는 데이터의 최소 길이(바이트)입니다.
  • maxPartSize (숫자):둘 이상의 URI가 있는 경우 uploadURI 중 하나에 제공할 수 있는 데이터의 최대 길이(바이트)입니다.

이진 업로드

업로드를 시작하는 출력에는 하나 이상의 업로드 URI 값이 포함됩니다. 두 개 이상의 URI가 제공되는 경우 클라이언트는 바이너리를 여러 부분으로 분할하고 각 URI에 대한 POST 요청을 순서대로 수행합니다. 모든 URI 사용 각 부품의 크기가 시작 응답에 지정된 최소 및 최대 크기 내에 있는지 확인합니다. CDN 에지 노드는 요청된 바이너리 업로드 속도를 높여줍니다.
이를 위한 가능한 방법은 API에서 제공하는 업로드 URI 수를 기준으로 부품 크기를 계산하는 것입니다. 예를 들어 바이너리의 총 크기가 20,000바이트이고 업로드 URI 수는 2라고 가정합니다. 그런 다음 다음 다음 단계를 수행합니다.
  • 전체 크기를 URI 수로 나누어 부품 크기를 계산합니다.20,000 / 2 = 10,000.
  • 바이너리의 POST 바이트 범위 0-9,999를 업로드 URI 목록의 첫 번째 URI로 지정합니다.
  • 업로드 URI 목록에서 바이너리의 POST 바이트 범위 10,000 - 19,999를 두 번째 URI로 지정합니다.
업로드가 성공하면 서버가 각 요청에 응답하고 201 상태 코드가 있습니다.

업로드 완료

이진 파일의 모든 부분이 업로드되면 HTTP POST 요청을 시작 데이터로 제공된 전체 URI에 제출합니다. 요청 본체의 컨텐츠 유형은 다음 필드를 포함하는 application/x-www-form-urlencoded 양식 데이터여야 합니다.
필드
유형
필수 또는 아님
설명
fileName
문자열
필수
시작 데이터에 의해 제공된 자산의 이름입니다.
mimeType
문자열
필수
초기화 데이터에 의해 제공된 바이너리의 HTTP 컨텐츠 유형입니다.
uploadToken
문자열
필수
초기화 데이터에 의해 제공된 것처럼 바이너리에 대한 토큰을 업로드합니다.
createVersion
부울
선택 사항입니다
지정된 이름을 가진 자산 True 과 자산이 존재하는 경우, 자산의 새 버전을 Experience Manager 만듭니다.
versionLabel
문자열
선택 사항입니다
새 버전이 만들어진 경우 자산의 새 버전과 연관된 레이블입니다.
versionComment
문자열
선택 사항입니다
새 버전이 만들어지면 버전과 연결된 댓글이 표시됩니다.
replace
부울
선택 사항입니다
지정된 이름의 자산이 있는 경우 자산 True 을 Experience Manager 삭제한 후 자산을 다시 만듭니다.
! 자산이 존재하며 지정되지 않은 경우 createVersion replace 지정하지 않은 경우 자산의 현재 버전을 새로운 바이너리로 Experience Manager 업데이트합니다.
시작 프로세스와 마찬가지로 전체 요청 데이터에는 둘 이상의 파일에 대한 정보가 포함될 수 있습니다.
이진 업로드 프로세스는 파일에 대해 전체 URL을 호출할 때까지 수행되지 않습니다. 업로드 프로세스가 완료된 후 자산이 처리됩니다. 자산의 이진 파일이 완전히 업로드되었지만 업로드 프로세스가 완료되지 않은 경우에도 처리가 시작되지 않습니다.
성공하면 서버가 200 상태 코드로 응답합니다.

오픈 소스 업로드 라이브러리

업로드 알고리즘에 대해 자세히 알아보거나 자신만의 업로드 스크립트 및 도구를 만들기 위해 Adobe은 오픈 소스 라이브러리 및 도구를 제공합니다.

사용되지 않는 에셋 업로드 API

새 업로드 방법은 Cloud Service Adobe Experience Manager 에 대해서만 지원됩니다. 6.5의 API는 Adobe Experience Manager 더 이상 사용되지 않습니다. 자산 또는 표현물(바이너리 업로드)의 업로드 또는 업데이트와 관련된 방법은 다음 API에서 더 이상 사용되지 않습니다.

자산 처리 및 사후 처리 워크플로우

에서 자산 처리 Experience Manager는 자산 마이크로서비스를 사용하는 처리 프로필 구성을 기반으로 합니다. 프로세싱에는 개발자 익스텐션이 필요하지 않습니다.
사후 처리 워크플로우 구성의 경우 사용자 정의 단계와 함께 표준 워크플로우와 함께 사용하십시오.

사후 처리 워크플로우의 워크플로우 단계 지원

이전 버전에서 업그레이드하는 고객은 에셋 마이크로서비스를 사용하여 에셋을 처리할 Experience Manager 수 있습니다. 클라우드 기반의 자산 마이크로 서비스는 구성 및 사용이 훨씬 간단합니다. 이전 버전의 DAM 자산 업데이트 워크플로우에서 사용되는 몇 가지 워크플로우 단계는 지원되지 않습니다.
Experience Manager as Cloud Service은 다음 워크플로우 단계를 지원합니다.
  • com.day.cq.dam.similaritysearch.internal.workflow.process.AutoTagAssetProcess
  • com.day.cq.dam.core.impl.process.CreateAssetLanguageCopyProcess
  • com.day.cq.wcm.workflow.process.CreateVersionProcess
  • com.day.cq.dam.similaritysearch.internal.workflow.smarttags.StartTrainingProcess
  • com.day.cq.dam.similaritysearch.internal.workflow.smarttags.TransferTrainingDataProcess
  • com.day.cq.dam.core.impl.process.TranslateAssetLanguageCopyProcess
  • com.day.cq.dam.core.impl.process.UpdateAssetLanguageCopyProcess
  • com.adobe.cq.workflow.replication.impl.ReplicationWorkflowProcess
  • com.day.cq.dam.core.impl.process.DamUpdateAssetWorkflowCompletedProcess
다음 기술 워크플로우 모델은 자산 마이크로 서비스로 대체되거나 지원되지 않습니다.
  • com.day.cq.dam.core.impl.process.DamMetadataWritebackWorkflowCompletedProcess
  • com.day.cq.dam.core.process.DeleteImagePreviewProcess
  • com.day.cq.dam.s7dam.common.process.DMEncodeVideoWorkflowCompletedProcess
  • com.day.cq.dam.core.process.GateKeeperProcess
  • com.day.cq.dam.core.process.AssetOffloadingProcess
  • com.day.cq.dam.core.process.MetadataProcessorProcess
  • com.day.cq.dam.core.process.XMPWritebackProcess
  • com.adobe.cq.dam.dm.process.workflow.DMImageProcess
  • com.day.cq.dam.s7dam.common.process.S7VideoThumbnailProcess
  • com.day.cq.dam.scene7.impl.process.Scene7UploadProcess
  • com.day.cq.dam.s7dam.common.process.VideoProxyServiceProcess
  • com.day.cq.dam.s7dam.common.process.VideoThumbnailDownloadProcess
  • com.day.cq.dam.s7dam.common.process.VideoUserUploadedThumbnailProcess
  • com.day.cq.dam.core.process.CreatePdfPreviewProcess
  • com.day.cq.dam.core.process.CreateWebEnabledImageProcess
  • com.day.cq.dam.video.FFMpegThumbnailProcess
  • com.day.cq.dam.core.process.ThumbnailProcess
  • 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.video.FFMpegTranscodeProcess
  • 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.ScheduledPublishBPProcess
  • com.day.cq.dam.core.process.ScheduledUnPublishBPProcess
  • com.day.cq.dam.core.process.SendDownloadAssetEmailProcess
  • com.day.cq.dam.core.impl.process.SendTransientWorkflowCompletedEmailProcess