Tópicos

Consulte os tópicos abaixo para obter maiores informações sobre a operação do sistema:

• Download do produto, visite a página de downloads
• O projeto .kps
• Gerando o documento modelo
• Importando a lista de dados variáveis
• Vinculando os dados variáveis ao documento
• Imprimindo
• Passo a passo para a utilização do Kankei PS

Projeto KPS

    Um projeto .kps é composto por duas partes básicas:

    Template de Importação: Configurações que informam ao KPS como os dados variáveis deverão ser importados. Entre essas configurações temos o tipo do arquivo (.TXT, .DBF, .MDB, etc.), informações sobre a estrutura do arquivo (se necessário), ordenação e comandos de importação que permitem a manipulação dos dados, como formatação, validação, etc.

    Layout de Impressão: Informam ao KPS a posição na página onde os dados variáveis serão impressos.

    No momento da impressão, o KPS irá imprimir uma cópia do documento modelo para cada registro de dados variáveis que tiver sido importado, adicionando ao documento os dados referentes a cada registro.

Gerando o documento modelo

    O documento modelo é, na verdade, uma imagem, uma "foto" do documento que será impresso (sem os dados variáveis). Essa imagem pode ser gerada através do software Corel Draw. A Kankei desenvolveu um plugin (.gms) que facilita a exportação de um documento .cdr para os formatos de arquivo suportados pelo KPS, inclusive, permitindo o posicionamento dos campos variáveis dentro do documento de forma simples e visual. Para maiores informações a respeito, consulte o nosso fórum.

    O modelo, basicamente, é composto por dois tipos de arquivo de imagem: arquivos .pdf (para geração de documentos PDF) e arquivos .bmp (para impressão).

Importando a lista de dados variáveis

    A primeira coisa a se fazer em um projeto kps é a importação dos dados variáveis. Essa importação é configurada através de uma Template de Importação, uma estrutura hierárquica bastante flexível que permite a importação de grande parte dos arquivos de dados existentes.

    A propriedade mais importante a ser definida é a Classe de Importação, que vai definir qual o formato do arquivo de dados a ser importado. Esta propriedade pode ser configurada para arquivos .MDB, .XLS, .TXT, .DBF, entre diversos outros.

    Alguns tipos de arquivo precisam de configurações adicionais, como o arquivo texto (.TXT), por exemplo, onde a estrutura do arquivo precisa ser configurada antes da importação.

    O Template de Importação suporta também a definição de comandos de importação que permitem a validação e/ou formatação dos dados importados. Expandindo o nó Eventos da árvore do template,  você irá oter uma lista como a seguinte:

    Ao iniciar importação
    Ao iniciar leitura do arquivo
    Antes de ler registro
    Antes dos cálculos bancários
    Após cálculos bancários
    Após ler registro
    Ao término do arquivo
    Antes de agrupar
    Após agrupar
    Ao término da importação

    A cada um destes eventos, é possível inserir um ou mais comandos de importação para serem executados no momento especificado pelo evento. Existem quatro tipos de comandos de importação:

    Set: Permite criar um novo campo ou redefinir o valor de um campo já existente.
    Assert: Permite validar os dados importados, de maneira que a importação seja cancelada caso a condição informada não seja satisfeita.
    Script: Permite a definição de um script na linguagem JavaScript. O KPS disponibiliza diversas funções e alguns objetos que podem ser manipulados de forma bastante flexível, mas a utilização do script requer algum conhecimento em linguagem de programação.
    GlobalSet: Permite a definição ou redefinição de uma variável global. Variáveis globais não farão parte do conjunto de dados importados, elas existem apenas para trabalhar em conjunto com comandos Set ou Script para determinadas operações, como por exemplo a criação de um campo que vá sendo incrementado a cada registro durante a importação.

    Dica: o melhor momento para formatar os dados com comandos Set ou Script é no evento Após Ler Registro.

    Para maiores informações, consulte o nosso fórum.

Vinculando os dados variáveis ao modelo

    Depois que os dados variáveis tiverem sido importados, eles devem ser vinculados ao modelo para que o KPS possa utilizá-los corretamente. Para isso, utilizamos a estrutura conhecida como Layout de Impressão.

    O layout de impressão possui quatro tipos de objeto:

    Documento: representa o documento de uma forma geral. Cada layout possui um único objeto do tipo documento. Entre as propriedades que podem ser configuradas a partir do documento estão os Sets (informam como os registros serão distribuídos pelas páginas) e Duplex (impressão frente e verso).

    Página: representa uma página do documento. Um documento pode ter uma ou mais páginas. Todas as páginas do documento serão impressas para cada registro de dados variáveis, a menos que determinadas condições sejam definidas. Assim, se o documento possui 2 páginas e foram importados 10 registros de dados variáveis, a impressão final terá 20 páginas.

    Layer: representa uma seção da página. Cada página precisa ter pelo menos um layer. Normalmente, é no layer que definimos o nome do arquivo de imagem que será impresso para a página.

    Shape: representa um campo de dados variáveis a ser impresso na página. Um layer pode conter diversos shapes. A propriedade Nome do shape define o nome do campo de dados que será impresso. As demais propriedade permitem configurar a posição do shape na página, bem como sua aparência (cor, fonte, negrito, etc.).

    Se o modelo de documento que você estiver usando tiver sido gerado pelo plugin (.gms) do Corel Draw, você poderá importar o arquivo .xml que o plugin exporta juntamente com as imagens. Dessa forma, não será necessário configurar manualmente as páginas, layers e shapes.

Imprimindo

    Uma vez importados os dados e definido o layout de impressão, você já estará pronto para imprimir o seu documento. Utilize a opção "Visualizar" para obter a visualização de impressão, onde você poderá visualizar página por página o documento final. Usando a opção "Imprimir", você poderá imprimir todas as páginas, ou apenas um intervalo específico.

    Ao invés de imprimir o documento, você poderá optar por gerar um arquivo .PDF do mesmo. Esta opção é interessante caso você precise, por exemplo, enviar o documento por email ou disponibilizá-lo em um site na Internet.