Amostra de carta de cobrança

A Amostra de carta de cobrança demonstra o comportamento de um formulário PDF dinâmico.

A amostra tem três níveis disponíveis de cobrança. As informações adequadas para cada nível devem ser impressas junto com uma lista dos documentos não pagos.

A amostra inclui estes arquivos:

Arquivo

Descrição

Dunning Notice.xdp

O arquivo de formulário do Designer localizado na pasta Formulários.

Dunning Notice Level1.xml

Dunning Notice Level2.xml

Dunning Notice Level3.xml

Arquivos de dados XML, localizados na pasta Dados. O arquivo de dados para a Carta de cobrança de nível3 contém notas fiscais suficientes para continuação em uma segunda página.

Dunning Notice.tif

Arquivo de imagem, localizado na pasta Imagens.

Dunning Notice Level1.pdf

Dunning Notice Level2.pdf

Dunning Notice Level3.pdf

Formulários renderizados com dados unidos, localizados na pasta Saídas.

Para executar a Amostra de carta de cobrança

  1. Abra o arquivo Dunning Notice.xdp localizado em \PT\Samples\Forms\Dunning Notice\Forms no Designer.

  2. Selecione Arquivo > Propriedades do formulário para especificar as opções de visualização.

  3. Clique na guia Visualizar e execute as seguintes tarefas:

    • Na lista Tipo de visualização, selecione Formulário impresso.

    • Na caixa Arquivo de dados, navegue até a pasta Dados e selecione uma das amostras de arquivos de dados (por exemplo, Dunning Notice Level1.xml).

    • Clique em OK.

  4. Para visualizar o formulário, clique na guia Visualizar PDF.

As amostras de arquivos PDF de saída na pasta Saídas mostram o formulário renderizado unido a cada um dos três conjuntos de dados. Use esses arquivos para comparar os resultados do formulário visualizado.

Sobre o Formulário de carta de cobrança

O formulário demonstra vários recursos.

Estrutura da hierarquia de formulários
O Formulário carta de cobrança tem como base a estrutura dos dados para aproveitar o processo implícito de vínculo de dados.

Página mestre
São necessárias duas páginas mestres. A primeira exibe o logotipo da empresa, o título do formulário e o texto estático. Essa página é a primeira a ser impressa e aparece em uma página impressa com número ímpar. A segunda página mestra é usada para todas as páginas subsequentes. O mesmo texto estático é exibido também como a numeração de página.

Numeração de página
Os números de página são valores calculados, obtidos por meio da inserção de propriedades de tempo de execução em um objeto Texto.

Conteúdo continuado
Quando os dados são unidos ao formulário, os subformulários são colocados um abaixo do outro definindo a opção de Conteúdo pai (dunningNotice) como Fluxo. A opção Conteúdo está localizada na guia Subformulário da paleta Objeto. A lista Direção do fluxo, também localizada na guia Subformulário da paleta Objeto, está definida como Parte superior para a inferior. As margens do subformulário, especificadas na paleta Layout, adicione o espaçamento adicional exigido entre os dois subformulários.

Os subformulários header, level1, level2, level3 e closing também apresentam um conteúdo continuado. As margens do campo adicionam o espaçamento extra necessário entre dois objetos.

Ocorrência de subformulários
O formulário inclui diversos subformulários que trabalham em conjunto para acomodar corretamente os dados. Os próprios subformulários são uma combinação de subformulários repetitivos e exclusivos. Os valores de contagem mínima de todos os subformulários, com exceção dos subformulários detail header e closing, estão definidos como 0 para especificar que apenas o subformulário solicitado será impresso. O valor máximo de cada subformulário exclusivo está definido como 1. Os subformulários repetitivos não apresentam um valor máximo de ocorrência, pois o número varia para cada conjunto de dados. O valor de contagem mínima do subformulário closing está definido como 1 porque nenhum dado está disponível para instanciar o subformulário.

Cabeçalho de detalhes
O cabeçalho de detalhes exibe os cabeçalhos de colunas e deve ser impresso antes da primeira linha de detalhes. As informações desse cabeçalho de detalhes deverão ser repetidas na parte superior da página quando as linhas de detalhes não couberem mais na página atual e forem continuadas em uma nova página. Definir o valor de contagem mínima do subformulário detailHeader como 1 garante que o cabeçalho sempre seja impresso pelo menos uma vez.

Sobrefluxo anterior
O subformulário detailHeader está associado ao subformulário document como seu sobrefluxo anterior. Esse recurso faz com que o subformulário de sobrefluxo anterior do subformulário document seja impresso sempre que esse subformulário document continuar em uma nova página. Como não há campos no subformulário detailHeader, a opção Vínculo de dados, localizada na guia Vínculo da paleta Objeto, está definida como Sem vínculo de dados.

Campos globais
O valor da moeda é fornecido uma vez no arquivo de dados. Ao definir o vínculo padrão do campo de moeda como Global e usar esse campo em diversos locais, o valor será replicado em cada ocorrência do campo.

Campo de imagem
Como o logotipo da empresa pode variar, o arquivo de logotipo está incorporado ao arquivo de dados. Um objeto de Campo de imagem é usado para exibir a imagem.

Número máximo de caracteres para cada campo
O valor máximo de caracteres para cada campo é indicado conforme as especificações de dados. A opção Máximo de caracteres está localizada na guia Campo da paleta Objeto.

Campos ampliáveis e posição de ancoragem
Para acomodar os valores de dados de comprimento variável, a opção Expandir para ajustar, localizada na paleta Layout, foi selecionada para os campos billToAddress, Salutation e Closing. A posição de ancoragem desses campos está definida para permitir que o campo se expanda na direção correta.

Variáveis
O fechamento de todos os parágrafos é igual. Para facilitar a manutenção, seu valor foi definido como uma variável, e um script é usado para fazer referência a esse valor e para exibi-lo. Como o valor do campo é calculado, a opção Vínculo de dados está definida como Sem vínculo de dados.

Scripts
Os valores de endereço devem ser exibidos como um bloco. Um script JavaScript é usado para concatenar os valores de dados. Como o valor do campo billToAddress é calculado, a opção Vínculo de dados está definida como Sem vínculo de dados.

Campo de várias linhas
A propriedade Permitir linhas múltiplas do campo billToAddress, localizada na guia Campo da paleta Objeto, está selecionada para que o valor calculado possa ser impresso em várias linhas.

Campos continuados
O subformulário level3 contém texto e campos. O uso de campos flutuantes resulta em um fluxo natural de informações. Um padrão de exibição pode ser especificado diretamente no campo e exibido no parágrafo. Use a opção Padrões na guia Campo da paleta Objeto para especificar um padrão de exibição. O campo flutuante é um campo oculto inserido no objeto Texto. A referência ao campo flutuante é representada pelo nome do campo entre chaves; por exemplo, {fieldName}.

Padrões de imagem
Alguns valores são mais fáceis de ler com a aplicação de um padrão de exibição. Por exemplo, o valor do prazo do subformulário level3 é formatado com uma data de comprimento médio para o valor de padrão de dados na guia Vínculo da paleta Objeto.