Considerações sobre problemas conhecidos e práticas recomendadas best-practices-known-issues-and-limitations

Antes de começar a usar as APIs de comunicação, analise as seguintes considerações, problemas conhecidos e perguntas frequentes:

Considerações considerations-for-communications-apis

Dados de formulário form-data

As APIs de comunicação aceitam um design de formulário que normalmente é criado em dados de formulário Designer e XML como entrada. Para preencher um documento com dados, um elemento XML deve existir nos dados de formulário XML para cada campo de formulário que você deseja preencher. O nome do elemento XML deve corresponder ao nome do campo. Um elemento XML será ignorado se não corresponder a um campo de formulário ou se o nome do elemento XML não corresponder ao nome do campo. Não é necessário corresponder à ordem em que os elementos XML são exibidos. O fator importante é que os elementos XML são especificados com valores correspondentes.

Considere o exemplo de formulário de aplicativo de empréstimo a seguir:

Para mesclar dados neste design de formulário, crie uma fonte de dados XML que corresponda ao formulário. O XML a seguir representa uma fonte de dados XML que corresponde ao exemplo de formulário de aplicativo de hipoteca.

<?xml version="1.0" encoding="UTF-8" ?>
- <xfa:datasets xmlns:xfa="http://www.xfa.org/schema/xfa-data/1.0/">
- <xfa:data>
- <data>
    - <Layer>
        <closeDate>1/26/2007</closeDate>
        <lastName>Johnson</lastName>
        <firstName>Jerry</firstName>
        <mailingAddress>JJohnson@NoMailServer.com</mailingAddress>
        <city>New York</city>
        <zipCode>00501</zipCode>
        <state>NY</state>
        <dateBirth>26/08/1973</dateBirth>
        <middleInitials>D</middleInitials>
        <socialSecurityNumber>(555) 555-5555</socialSecurityNumber>
        <phoneNumber>5555550000</phoneNumber>
    </Layer>
    - <Mortgage>
        <mortgageAmount>295000.00</mortgageAmount>
        <monthlyMortgagePayment>1724.54</monthlyMortgagePayment>
        <purchasePrice>300000</purchasePrice>
        <downPayment>5000</downPayment>
        <term>25</term>
        <interestRate>5.00</interestRate>
    </Mortgage>
</data>
</xfa:data>
</xfa:datasets>

Tipos de documento suportados supported-document-types

Para obter acesso total aos recursos de renderização das APIs de comunicações, é recomendável usar um arquivo XDP como entrada. Às vezes, um arquivo PDF pode ser usado. No entanto, o uso de um arquivo PDF como entrada tem as limitações:

Um documento PDF que não contém um fluxo XFA não pode ser renderizado como PostScript, PCL ou ZPL. As APIs de comunicação podem renderizar documentos PDF com fluxos XFA (ou seja, formulários criados no Designer) em formatos laser e de rótulo. Se o documento PDF for assinado, certificado ou contiver direitos de uso (aplicados pelo serviço AEM Forms Reader Extensions), ele não poderá ser renderizado nesses formatos de impressão.

Áreas imprimíveis printable-areas

A margem não imprimível padrão de 0,25 pol. não é exata para impressoras de etiquetas e varia de impressora para impressora e de tamanho de etiqueta para tamanho de etiqueta. No entanto, é recomendável manter ou reduzir a margem de 0,25 pol. No entanto, é recomendável não aumentar a margem não imprimível. Caso contrário, as informações na área imprimível não serão impressas corretamente.

Use sempre o arquivo XDC correto para a impressora. Por exemplo, evite escolher um arquivo XDC para uma impressora de 300 dpi e enviar o documento para uma impressora de 200 dpi.

Scripts somente para formulários XFA (XDP/PDF) scripts

Um design de formulário usado com as APIs de comunicações pode conter scripts executados no servidor. Certifique-se de que um design de formulário não contenha scripts que sejam executados no cliente. Para obter informações sobre como criar scripts de design de formulário, consulte a Ajuda do Designer.

Mapeamento de fontes font-mapping

Para criar um formulário que use fontes residentes na impressora, escolha no Designer um nome de fonte que corresponda às fontes disponíveis na impressora. Uma lista de fontes compatíveis com PCL ou PostScript está localizada nos perfis de dispositivo correspondentes (arquivos XDC). Como alternativa, o mapeamento de fontes pode ser criado para mapear fontes não residentes na impressora para fontes residentes na impressora de um nome de fonte diferente. Por exemplo, em uma situação PostScript, as referências à fonte Arial® podem ser mapeadas para a fonte Helvetica® residente na impressora.

Se uma fonte estiver instalada em um computador cliente, ela estará disponível na lista suspensa no Designer. Se a fonte não estiver instalada, será necessário especificar o nome da fonte manualmente. A opção "Substituir permanentemente fontes indisponíveis" no Designer pode estar desativada. Caso contrário, quando o arquivo XDP for salvo no Designer, o nome da fonte de substituição será gravado no arquivo XDP. Isso significa que a fonte residente na impressora não é usada.

Existem dois tipos de fontes OpenType®. Um tipo é uma fonte TrueType OpenType® suportada por PCL. O outro é o CFF OpenType®. A saída de PDF e PostScript suporta fontes Type-1, TrueType e OpenType® incorporadas. A saída PCL suporta fontes TrueType incorporadas.

As fontes Type-1 e OpenType® não estão incorporadas na saída PCL. O conteúdo formatado com as fontes Type-1 e OpenType® é rasterizado e gerado como uma imagem bitmap que pode ser grande e de geração mais lenta.

As fontes baixadas ou incorporadas são substituídas automaticamente ao gerar saída PostScript, PCL ou PDF. Isso significa que somente o subconjunto dos glifos de fonte necessários para renderizar corretamente o documento gerado é incluído na saída gerada.

Trabalhar com arquivos de perfil de dispositivo (arquivo XDC) working-with-xdc-files

Um perfil de dispositivo (arquivo XDC) é um arquivo de descrição da impressora no formato XML. Esse arquivo permite que as APIs de comunicações emitam documentos como formatos de impressora a laser ou de etiqueta. As APIs de comunicação usam os arquivos XDC, incluindo o seguinte:

Você pode usar os arquivos XDC fornecidos para gerar documentos de impressão ou modificá-los de acordo com sua necessidade.

Esses arquivos são arquivos XDC de referência que oferecem suporte a recursos de impressoras específicas, como fontes residentes, bandejas de papel e grampeador. O objetivo dessa referência é ajudá-lo a entender como configurar suas próprias impressoras usando perfis de dispositivo. A referência também é um ponto de partida para impressoras semelhantes na mesma linha de produtos.

Trabalhar com o arquivo de configuração XCI working-with-xci-files

As APIs de comunicações usam um arquivo de configuração XCI para executar tarefas, como controlar se a saída é um painel único ou paginada. Embora esse arquivo contenha configurações que podem ser definidas, não é típico modificar esse valor.

Você pode passar um arquivo XCI modificado ao usar uma API de comunicações. Ao fazer isso, crie uma cópia do arquivo padrão, altere apenas os valores que exigem modificação para atender aos requisitos comerciais e use o arquivo XCI modificado.

As APIs de comunicações começam com o arquivo XCI padrão (ou o arquivo modificado). Em seguida, ele aplica valores especificados usando as APIs de comunicações. Esses valores substituem as configurações XCI.

A tabela a seguir especifica as opções de XCI.

Problemas conhecidos

Práticas recomendadas

Perguntas frequentes faq

Posso usar uma pasta monitorada ou outros mecanismos de armazenamento para armazenar entrada e saída?

No momento, você pode usar o Armazenamento do Microsoft Azure para salvar dados de entrada e documentos gerados. O armazenamento do Microsoft Azure fornece várias opções para automatizar operações de movimentação de dados.

Uma conta de Armazenamento do Microsoft Azure está incluída na licença do Cloud Service Experience Manager Forms?

A conta de Armazenamento do Microsoft Azure é independente da licença Cloud Service do Experience Manager Forms.

As APIs de comunicação armazenam dados nos servidores Experience Manager Forms Cloud Service?

Os dados de entrada e saída são salvos somente no Armazenamento do Microsoft Azure.

As APIs de comunicação estão disponíveis apenas para o Experience Manager Forms Cloud Service? É possível obter funcionalidade semelhante em um ambiente local?

Você pode usar o serviço AEM Forms Output para combinar um modelo (XFA ou PDF) com os dados do cliente para gerar documentos nos formatos PDF, PS, PCL e ZPL.

Em comparação com o ambiente local, o Cloud Service oferece benefícios adicionais de dimensionamento automático e economia.

É possível executar várias operações em lote simultaneamente?
Sim, você pode executar várias operações em lote simultaneamente. Sempre use pastas de origem e destino diferentes para cada operação para evitar conflitos.