Integração da criação da interface de usuário de correspondência com o portal personalizado

Visão geral

Este artigo detalha como você pode integrar a solução Criar correspondência com seu ambiente.

Invocação baseada em URL

Uma maneira de chamar o aplicativo Criar correspondência a partir de um portal personalizado é preparar o URL com os seguintes parâmetros de solicitação:

  • o identificador do modelo de letra (usando o parâmetro cmLetterId).

  • o URL para os dados XML obtidos da fonte de dados desejada (usando o parâmetro cmDataUrl).

Por exemplo, o portal personalizado prepararia o URL como
https://'[server]:[port]'/[contextPath]/aem/forms/createcorrespondence.html?random=[timestamp]&cmLetterId=[letter identifier]&cmDataUrl=[data URL], que pode ser o href de um link no portal.

Observação

Chamar dessa forma não é seguro, pois os parâmetros necessários são passados como uma solicitação GET, expondo o mesmo (claramente visível) no URL.

Observação

Antes de chamar o aplicativo Criar correspondência, salve e carregue os dados para chamar a interface de usuário Criar correspondência no dataURL fornecido. Isso pode ser feito pelo próprio portal personalizado ou por outro processo back-end.

Invocação em linha baseada em dados

Outra maneira (e mais segura) de chamar o aplicativo Criar correspondência pode ser simplesmente acessar o URL em https://'[server]:[port]'/[contextPath]/aem/forms/createcorrespondence.html, enviando os parâmetros e dados para chamar o aplicativo Criar correspondência como uma solicitação POST (ocultando-os do usuário final). Isso também significa que agora você pode passar os dados XML para o aplicativo Criar correspondência em linha (como parte da mesma solicitação, usando o parâmetro cmData), que não era possível/ideal na abordagem anterior.

Parâmetros para especificar a carta

Nome Tipo Descrição
cmLetterInstanceId Sequência de caracteres O identificador da instância da carta.
cmLetterId Sequência de caracteres O nome do modelo Carta.

A ordem dos parâmetros na tabela especifica a preferência dos parâmetros usados para carregar a carta.

Parâmetros para especificar a fonte de dados XML

Nome Tipo Descrição
cmDataUrl
URL Dados XML de um arquivo de origem usando protocolos básicos como cq, ftp, http ou arquivo.
cmLetterInstanceId Sequência de caracteres Usando dados xml disponíveis em Instância de carta.
cmUseTestData Booleano Para reutilizar os dados de teste anexados no dicionário de dados.

A ordem dos parâmetros na tabela especifica a preferência dos parâmetros usados para carregar os dados XML.

Outros parâmetros

Nome Tipo Descrição
cmPreview
Booleano Verdadeiro para abrir a letra no modo de pré-visualização
Aleatório Carimbo de data e hora Para resolver problemas de cache do navegador.

Se você estiver usando o protocolo http ou cq para cmDataURL, o URL de http/cq deve estar acessível anonimamente.

Nesta página