Integração da interface Criar correspondência com o portal personalizado integrating-create-correspondence-ui-with-your-custom-portal

CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

Visão geral overview

Este artigo detalha como é possível integrar a Solução de criação de correspondência ao seu ambiente.

Invocação baseada em URL url-based-invocation

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

  • o identificador para o modelo de letra (usando o parâmetro cmLetterId) ou o nome do modelo Carta (usando o parâmetro cmLetterName)

  • 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.
Se o portal tiver o nome do modelo Carta em mãos, o URL poderá ser
https://[server]:[port]/content/cm/createcorrespondence.html?cmLetterName=[letter name]&cmDataUrl=[data URL].

NOTE
Chamar dessa forma não é seguro, pois os parâmetros necessários são passados como uma solicitação do GET, expondo o mesmo (claramente visível) no URL.
NOTE
Antes de chamar o aplicativo Criar correspondência , salve e faça upload dos dados para chamar a interface do 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 embutida baseada em dados inline-data-based-invocation

Outra maneira (e mais segura) de chamar o aplicativo Criar correspondência pode ser simplesmente pressionar o URL em https://[server]:[port]/[contextPath]/aem/forms/createcorrespondence.html, ao enviar os parâmetros e dados para chamar o aplicativo Create Correspondence como uma solicitação do POST (ocultando-os do usuário final). Isso também significa que agora é possível transmitir os dados XML para o aplicativo Create Correspondence 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 especificação de carta parameters-for-specifying-letter

Nome
Tipo
Descrição
cmLetterInstanceId
String
O identificador da instância da carta.
cmLetterName
String

O identificador do modelo de carta.

Se houver várias letras CM com o mesmo nome em um servidor, o uso do parâmetro cmLetterName no URL acionará um erro "Existem várias letras com o nome". Nesse caso, use o parâmetro cmLetterId no URL em vez de cmLetterName.

cmLetterId
String
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 parameters-for-specifying-the-xml-data-source

Nome
Tipo
Descrição
cmDataUrl
URL
Dados XML de um arquivo de origem usando protocolos básicos como cq, ftp, http ou arquivo.
cmLetterInstanceId
String
Uso de 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 other-parameters

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

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

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da