O artigo contém recomendações, materiais de referência e recursos para desenvolvedores de Assets como um Cloud Service. Inclui novo módulo de carregamento de ativos, referência de API e informações sobre o suporte fornecido em workflows de pós-processamento.
Assets como um Cloud Service fornece várias APIs para interagir programaticamente com ativos digitais. Cada API suporta casos de uso específicos, conforme mencionado na tabela abaixo. A Assets interface do usuário, Experience Manager aplicativo desktop e Adobe Asset Link suportam todas ou algumas das operações.
Algumas APIs continuam existindo, mas não são ativamente suportadas (denotadas com um x) e não devem ser usadas.
Nível de suporte | Descrição |
---|---|
Satélite | Compatível |
× | Não suportado. Não utilizar. |
- | Não disponível |
Caso de uso | aem-upload | APIs AEM / Sling / JCRJava | serviço asset compute | Assets API HTTP | Servlets Sling GET / POST | GraphQL (Pré-visualização) |
---|---|---|---|---|---|---|
Binário original | ||||||
Criar original | Satélite | × | - | × | × | - |
Ler original | - | × | Satélite | Satélite | Satélite | - |
Atualizar original | Satélite | × | Satélite | × | × | - |
Excluir original | - | Satélite | - | Satélite | Satélite | - |
Copiar original | - | Satélite | - | Satélite | Satélite | - |
Mover original | - | Satélite | - | Satélite | Satélite | - |
Metadados | ||||||
Criar metadados | - | Satélite | Satélite | Satélite | Satélite | - |
Ler metadados | - | Satélite | - | Satélite | Satélite | - |
Atualizar metadados | - | Satélite | Satélite | Satélite | Satélite | - |
Excluir metadados | - | Satélite | Satélite | Satélite | Satélite | - |
Copiar metadados | - | Satélite | - | Satélite | Satélite | - |
Mover metadados | - | Satélite | - | Satélite | Satélite | - |
Fragmentos de conteúdo (CF) | ||||||
Criar CF | - | Satélite | - | Satélite | - | - |
Ler CF | - | Satélite | - | Satélite | - | Satélite |
Atualizar CF | - | Satélite | - | Satélite | - | - |
Excluir CF | - | Satélite | - | Satélite | - | - |
Copiar CF | - | Satélite | - | Satélite | - | - |
Mover CF | - | Satélite | - | Satélite | - | - |
Versões | ||||||
Criar versão | Satélite | Satélite | - | - | - | - |
Ler versão | - | Satélite | - | - | - | - |
Excluir versão | - | Satélite | - | - | - | - |
Pastas | ||||||
Criar pasta | Satélite | Satélite | - | Satélite | - | - |
Ler pasta | - | Satélite | - | Satélite | - | - |
Excluir pasta | Satélite | Satélite | - | Satélite | - | - |
Copiar pasta | Satélite | Satélite | - | Satélite | - | - |
Mover pasta | Satélite | Satélite | - | Satélite | - | - |
Experience Manager como um Cloud Service fornece um novo método para carregar ativos no repositório. Os usuários podem carregar diretamente os ativos no armazenamento da nuvem usando a API HTTP. As etapas para carregar um arquivo binário são:
A abordagem oferece uma manipulação escalável e mais eficiente dos uploads de ativos. As diferenças em comparação com Experience Manager 6.5 são:
Consulte o código do cliente para implementar essa abordagem na biblioteca de código aberto aem-upload.
Envie uma solicitação POST HTTP para a pasta desejada. Os ativos são criados ou atualizados nesta pasta. Inclua o seletor .initiateUpload.json
para indicar que a solicitação é iniciar o upload de um arquivo binário. Por exemplo, o caminho para a pasta onde o ativo deve ser criado é /assets/folder
. A solicitação POST é POST https://[aem_server]:[port]/content/dam/assets/folder.initiateUpload.json
.
O tipo de conteúdo do corpo da solicitação deve ser application/x-www-form-urlencoded
dados do formulário, contendo os seguintes campos:
(string) fileName
: Obrigatório. O nome do ativo como ele aparece em Experience Manager.(number) fileSize
: Obrigatório. O tamanho do arquivo, em bytes, do ativo que está sendo carregado.Uma única solicitação pode ser usada para iniciar uploads para vários binários, desde que cada binário contenha os campos obrigatórios. Se bem-sucedida, a solicitação responde com um código de status 201
e um corpo contendo dados JSON no seguinte formato:
{
"completeURI": "(string)",
"folderPath": (string)",
"files": [
{
"fileName": "(string)",
"mimeType": "(string)",
"uploadToken": "(string)",
"uploadURIs": [
"(string)"
]
}
]
}
completeURI
(string): Chame esse URI quando o binário terminar de carregar. O URI pode ser um URI absoluto ou relativo, e os clientes devem ser capazes de lidar com ele. Ou seja, o valor pode ser "https://author.acme.com/content/dam.completeUpload.json"
ou "/content/dam.completeUpload.json"
Consulte carregamento completo.folderPath
(string): Caminho completo para a pasta na qual o binário é carregado.(files)
(matriz): Uma lista de elementos cujo comprimento e ordem correspondem ao comprimento e à ordem da lista de informações binárias fornecidas na solicitação de início.fileName
(string): O nome do binário correspondente, conforme fornecido na solicitação de início. Esse valor deve ser incluído na solicitação completa.mimeType
(string): O tipo mime do binário correspondente, conforme fornecido na solicitação de início. Esse valor deve ser incluído na solicitação completa.uploadToken
(string): Um token de carregamento para o binário correspondente. Esse valor deve ser incluído na solicitação completa.uploadURIs
(matriz): Uma lista de strings cujos valores são URIs completos para os quais o conteúdo do binário deve ser carregado (consulte Carregar binário).minPartSize
(número): O comprimento mínimo, em bytes, dos dados que podem ser fornecidos a qualquer um dos uploadURIs, se houver mais de um URI.maxPartSize
(número): O comprimento máximo, em bytes, dos dados que podem ser fornecidos a qualquer um dos uploadURIs, se houver mais de um URI.A saída de iniciar um upload inclui um ou mais valores de URI de upload. Se mais de um URI for fornecido, o cliente dividirá o binário em partes e fará uma solicitação POST de cada parte para cada URI, em ordem. Use todos os URIs. Certifique-se de que o tamanho de cada peça esteja dentro dos tamanhos mínimo e máximo especificados na resposta de início. Os nós de borda CDN ajudam a acelerar o carregamento solicitado de binários.
Um método potencial para fazer isso é calcular o tamanho da peça com base no número de URIs de upload fornecidos pela API. Por exemplo, suponha que o tamanho total do binário seja de 20.000 bytes e que o número de URIs de upload seja de 2. Em seguida, siga estas etapas:
Se o upload for bem-sucedido, o servidor responderá a cada solicitação com um código de status 201
.
Depois que todas as partes de um arquivo binário forem carregadas, envie uma solicitação POST HTTP para o URI completo fornecido pelos dados de início. O tipo de conteúdo do corpo da solicitação deve ser application/x-www-form-urlencoded
dados do formulário, contendo os seguintes campos.
Fields | Tipo | Obrigatório ou não | Descrição |
---|---|---|---|
fileName |
Sequência de caracteres | Obrigatório | O nome do ativo, conforme fornecido pelos dados de início. |
mimeType |
Sequência de caracteres | Obrigatório | O tipo de conteúdo HTTP do binário, conforme fornecido pelos dados de iniciação. |
uploadToken |
Sequência de caracteres | Obrigatório | Faça upload do token para o binário, conforme fornecido pelos dados de início. |
createVersion |
Booleano | Opcional | Se True e um ativo com o nome especificado existir, Experience Manager criará uma nova versão do ativo. |
versionLabel |
Sequência de caracteres | Opcional | Se uma nova versão for criada, o rótulo associado à nova versão de um ativo. |
versionComment |
Sequência de caracteres | Opcional | Se uma nova versão for criada, os comentários associados à versão. |
replace |
Booleano | Opcional | Se True e um ativo com o nome especificado existir, Experience Manager excluirá o ativo e, em seguida, recrie-o. |
!![NOTE]
Se o ativo existir ecreateVersion
nemreplace
for especificado, Experience Manager atualizará a versão atual do ativo com o novo binário.
Como o processo de inicialização, os dados de solicitação completos podem conter informações para mais de um arquivo.
O processo de carregamento de um binário não é feito até que o URL completo seja chamado para o arquivo. Um ativo é processado após a conclusão do processo de upload. O processamento não start mesmo se o arquivo binário do ativo for carregado completamente, mas o processo de upload não estiver concluído.
Se bem-sucedido, o servidor responde com um código de status 200
.
Para saber mais sobre os algoritmos de upload ou para criar seus próprios scripts e ferramentas de upload, o Adobe oferece bibliotecas e ferramentas de código aberto:
O novo método de carregamento só é suportado para Adobe Experience Manager como um Cloud Service. As APIs de Adobe Experience Manager 6.5 estão obsoletas. Os métodos relacionados ao upload ou atualização de ativos ou execuções (qualquer upload binário) estão obsoletos nas seguintes APIs:
AssetManager
API Java, como AssetManager.createAsset(..)
Em Experience Manager, o processamento de ativos é baseado na configuração Processando Perfis que usa os microserviços de ativos. O processamento não requer extensões de desenvolvedor.
Para a configuração do fluxo de trabalho de pós-processamento, use os workflows padrão com extensões com etapas personalizadas.
Os clientes que atualizam de versões anteriores do Experience Manager podem usar os microserviços de ativos para processar ativos. Os microserviços de ativos nativos na nuvem são muito mais simples de configurar e usar. Algumas etapas do fluxo de trabalho usadas no fluxo de trabalho DAM Update Asset na versão anterior não são suportadas.
Experience Manager como Cloud Service suporte para as seguintes etapas do fluxo de trabalho:
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
Os seguintes modelos de fluxo de trabalho técnico são substituídos por microserviços de ativos ou o suporte não está disponível:
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