Integrar o OpenText DAM com o SAP Commerce Cloud é fazer com que os ativos aprovados no DAM passem a existir no catálogo de produtos como itens de media, ligados ao produto e à versão de catálogo certos. O OpenText Media Management (OTMM) guarda o ficheiro final e os metadados; o SAP Commerce Cloud gere a forma como esse ficheiro é referenciado, sincronizado e mostrado na loja.
Para uma empresa com vários catálogos e países, o risco é a loja mostrar uma imagem que já não é a aprovada, ou nenhuma. Na Avafa tratamos estes projetos na nossa área de integração de DAM com ecommerce, e este guia explica as decisões que mais pesam antes de começar.
O artigo descreve o modelo de media do SAP Commerce Cloud, propõe uma tabela de correspondência com os conceitos do OTMM, explica a ligação técnica, os riscos e uma lista de verificação. As indicações sobre a plataforma seguem a documentação de formação da SAP.
Como gere o SAP Commerce Cloud os ficheiros de media?
No SAP Commerce Cloud, o ficheiro não vive no catálogo de produtos: cada ficheiro é representado por um item de media que guarda o URL do ficheiro físico. Segundo a SAP, os ficheiros podem estar guardados localmente ou em destinos remotos, como Amazon S3, Windows Azure Blob ou MongoDB GridFS.
Os itens de media são sensíveis ao catálogo. Cada um tem um identificador único e fica associado a uma versão de catálogo, e tem de ser sincronizado para aparecer na loja. A SAP esclarece que a sincronização copia o item de media entre versões de catálogo, mas não o ficheiro, cuja localização se mantém.
Esta separação tem uma vantagem para quem usa um DAM: o ficheiro pode continuar num repositório único, e o SAP Commerce Cloud apenas referencia o endereço. Também exige disciplina, porque o endereço tem de continuar válido enquanto o item existir.
O que são formatos e contentores de media?
Um formato de media (MediaFormat) indica a utilização prevista de uma imagem, e um contentor de media (MediaContainer) agrupa os itens que mostram o mesmo conteúdo em formatos diferentes. Cada item de media tem um só formato associado. A SAP dá como exemplos formatos de resolução aproximada, como 96×96, 300×300, 500×500 ou 1200×1200, e esclarece que o formato indica o uso pretendido, não um tamanho obrigatório.
Na loja, o contentor apresenta um só item, escolhido conforme o espaço disponível e o formato atribuído. É por isso que o mapeamento com o DAM tem de decidir, para cada ativo, em que contentor entra e com que formato.
Como se correspondem os conceitos do OTMM e do SAP Commerce Cloud?
A tabela seguinte é o ponto de partida que usamos nos workshops de mapeamento. Cada projeto ajusta-a ao seu modelo de dados e aos formatos que a loja realmente utiliza.
| No OpenText DAM | No SAP Commerce Cloud | Decisão a tomar |
|---|---|---|
| Ficheiro aprovado | Item de media | Qual o estado que o liberta |
| Rendição ou derivado | Formato de media | Que tamanhos a loja usa |
| Conjunto de derivados | Contentor de media | Um por imagem lógica |
| Associação ao produto | Ligação do produto à media | Chave: SKU ou código |
| Mercado ou marca | Versão de catálogo | Que catálogo recebe cada ativo |
A linha mais delicada é a última. Se os mercados têm catálogos diferentes, cada ativo precisa de uma regra clara sobre onde entra, e a sincronização entre versões de catálogo passa a fazer parte do processo, não de um passo esquecido no fim.
Convém também decidir quem aprova a sincronização. Num DAM, o estado de um ativo muda em minutos; no catálogo, a sincronização costuma ser planeada, e a equipa deve saber quanto tempo medeia entre as duas coisas para não prometer à área comercial uma imagem que ainda não está na loja.
Como se faz a ligação técnica?
A ligação usa a API REST do OTMM para ler ficheiros e metadados, e um mecanismo de carga do SAP Commerce Cloud para criar ou atualizar os itens de media. Entre os dois, uma camada intermédia aplica as regras de mapeamento e regista o resultado. O mecanismo de carga concreto depende da versão e da arquitetura do projeto, e confirma-se com a equipa SAP responsável.
- Definir o OTMM como fonte dos ficheiros aprovados e o SAP Commerce Cloud como fonte dos produtos.
- Extrair do OTMM o ficheiro, o estado e os metadados de cada ativo.
- Decidir o destino do ficheiro físico: o próprio DAM, um armazenamento remoto ou o armazenamento do SAP.
- Criar ou atualizar o item de media, com o formato e o contentor corretos.
- Ligar o contentor ao produto na versão de catálogo de destino.
- Executar a sincronização de catálogo e confirmar o resultado na loja.
Em cada passo guardamos o identificador do ativo no OTMM e o identificador do item de media. Sem esse par, qualquer correção posterior obriga a procurar à mão.
Que riscos tem esta integração e como se evitam?
- Esquecer a sincronização. Um item de media criado na versão de trabalho não aparece na loja até ser sincronizado; o processo tem de incluir esse passo.
- Endereços que deixam de funcionar. Como o item guarda o URL do ficheiro, mover ficheiros no DAM parte as imagens; os endereços devem ser estáveis.
- Formatos mal atribuídos. Se o formato não corresponde ao uso, a loja escolhe a imagem errada para o espaço disponível.
- Contentores incompletos. Um contentor sem todos os formatos usados na loja obriga a loja a escolher um item que não é o ideal.
- Catálogos por mercado. Ativos para vários catálogos sem regra de destino criam diferenças entre países.
Lista de verificação antes de arrancar o projeto
- Está definido o estado do OTMM que liberta um ativo para a loja?
- Os formatos de media usados pela loja estão listados?
- Há uma regra para o contentor de cada imagem lógica?
- Cada ativo tem o código de produto necessário para a ligação?
- Está decidido onde fica o ficheiro físico?
- Os endereços dos ficheiros são estáveis?
- A sincronização de catálogo faz parte do processo e tem responsável?
- Existe um ambiente de teste com pelo menos dois mercados?
Como trabalhamos na Avafa
Começamos por um inventário: que ativos existem no OTMM, como se identificam e que produtos do SAP Commerce Cloud ficam sem media. Com isso fechamos o mapeamento da tabela acima, testamos num ambiente separado e só depois ligamos a produção. O âmbito completo está na página de integração de DAM com ecommerce, e os projetos que combinam catálogos e ERP na nossa agência especializada em integrações de catálogos.
Guias relacionados do mesmo cluster
- Integrar o SAP S/4HANA com o SAP Commerce Cloud
- Integrar o SAP Business One com o SAP Commerce Cloud
- Integrar o Microsoft Dynamics 365 com o SAP Commerce Cloud
- Integrar o Brandfolder com o SAP Commerce Cloud
Perguntas frequentes
Os ficheiros ficam guardados no SAP Commerce Cloud?
Não necessariamente. Segundo a SAP, o item de media guarda o URL do ficheiro físico, que pode estar guardado localmente ou num destino remoto como Amazon S3 ou Windows Azure Blob.
Porque é que a imagem não aparece na loja depois de a criar?
Muitas vezes porque o item de media ainda não foi sincronizado. Os itens são sensíveis ao catálogo e só aparecem na loja depois da sincronização entre versões de catálogo.
Preciso de um formato de media para cada tamanho?
Precisa de um formato para cada utilização da loja. O formato indica o uso pretendido, como miniatura ou imagem de produto, e não obriga a um tamanho exato.
O OpenText DAM tem conector nativo para o SAP Commerce Cloud?
Na documentação consultada não encontrámos um conector nativo. A ligação faz-se por desenvolvimento ou por uma camada de integração, e convém confirmá-lo com o fornecedor antes de orçamentar.
Quanto tempo demora um projeto destes?
Depende do número de catálogos, de formatos e de mercados. Por isso começamos sempre por um inventário do OTMM e do catálogo, antes de indicar prazos.