|
V2.0R1 - JUN/2011
MANUAL INTERAPP V2.0
| O recurso InterApp visa permitir que um programa externo (por exemplo, um aplicativo ERP, ou o aplicativo de controle administrativo da sua empresa) controle o Boleto Pro. Os comandos e parâmetros eventualmente necessários são passados através da linha de comando. Estão disponíveis os seguintes comandos:
|
| · | Importar lote de boletos, a partir de arquivo.
|
| · | Emitir lote de boletos, a partir de arquivo.
|
| · | Emitir lote de boletos cadastrados, mas ainda não-emitidos.
|
| A emissão pode ser tanto impressa, por e-mail ou salvamento em arquivo. Se necessário, o programa pode executar de modo silencioso, de forma totalmente transparente para o usuário que estiver usando a sua aplicação.
|
| Em razão das pastas disponíveis quando o Boleto Pro é instalado num computador com sistema operacional Windows Vista serem ligeiramente diferentes, o uso nesse sistema requer pequenos ajustes nos comandos a serem utilizados. Sempre que o comando a ser usado com o Windows Vista for diferente aparecerá a indicação [Windows Vista], seguida do comando que deverá ser utilizado.
|
| Com o intuito de agilizar o aprendizado do uso do recurso InterApp, dentro da pasta de instalação do Boleto Pro há a pasta \InterApp, dentro da qual há pastas contendo arquivos-exemplo:
|
| · | \InterApp\Exemplo1_Leiaute_padrao: Pasta com arquivos de boletos em leiaute-padrão.Nessa pasta há arquivos-exemplos com leiaute padrão, com os quatro tipos suportados pelo programa: CSV, DBF, MDB e XLS. Você pode tomar como base esses arquivos para desenvolver os seus arquivos com leiaute padrão.
|
| · | \InterApp\Exemplo2_Leiaute_padrao_NNum_Auto: Pasta com arquivos de boletos em leiaute-padrão, mas nos quais o valores do campo Nosso Número dos boletos estão em branco. Em razão disso, quando a importação dos boletos o Boleto Pro gerará automaticamente o valor do campo Nosso Número.
|
| · | \InterApp\Exemplo3_Leiaute_personalizado: Pasta com arquivos de boletos com leiaute personalizado (são informados os valores de apenas alguns campos dos boletos a emitir, não de todos os campos possíveis). Em razão de ter um leiaute personalizado, é necessário informar ao Boleto Pro, através da linha de comando, o arquivo com especificação de importação a ser usada para importar os dados (arquivo .SMI), quando da chamada InterApp.
|
| Com Windows Vista, a pasta InterApp fica dentro da pasta
|
| C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\
|
| No site da Neo Interativa, na seção Desenvolvedores há artigos técnicos com informações adicionais quanto ao uso do recurso InterApp. Como por exemplo, fazer uma planilha do Microsoft Excel emitir boletos chamando o Boleto Pro, ou como fazer a emissão a partir de chamada feita pelo Microsoft Access.
|
| Com o objetivo de facilitar ao máximo a geração da linha de comando para usar o recurso InterApp, a Neo Interativa desenvolveu o programa utilitário Assistente InterApp. Este utilitário é instalado automaticamente quando o Boleto Pro é instalado. O Assistente InterApp permite que de forma interativa vá-se acrescentando novos parâmetros à chamada InterApp e que se observe o comportamento do Boleto Pro com esses novos parâmetros (a cada passo, o Assistente InterApp pode executar o Boleto Pro, para que se teste a chamada InterApp desenvolvida, sem a necessidade de sair do assistente).
|
| IMPORTANTE: Caso o Boleto Pro já se encontre em execução, deve-se finalizá-lo, antes de requisitar a execução deste, através do utilitário Assistente InterApp.
|
| Recomendamos fortemente o uso do programa Assistente InterApp, como forma de agilizar ao máximo o desenvolvimento de chamadas InterApp, e, conseqüentemente, a integração do Boleto Pro, com outras aplicações.
|
| 3.1 Importação de boletos a partir de arquivo com leiaute padrão
|
| Este exemplo utilizará os arquivos-exemplos que se encontram dentro da pasta
|
| C:\Arquivos de Programas\NeoInter\BoletoPro\V2.0\Exemplo1_Leiaute_padrao\
|
| C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\Exemplo1_Leiaute_padrao\
|
| Neste exemplo, requisitaremos que o programa importe o arquivo com boletos BoletosEx1.csv. Como este arquivo de dados possui leiaute padrão, não é necessário especificar qual arquivo de especificação deve ser utilizado.
|
| Para executar a importação dos dados, usaremos a função Executar Programa do Windows.
|
| · | Chame a função Executar..., que está dentro do menu Iniciar
|
| · | Na janela que aparecer, use o botão Procurar..., para encontrar o arquivo executável do programa Boleto Pro. Normalmente, deve ter sido instalado no diretório
|
| C:\Arquivos de Programas\NeoInter\BoletoPro\V2.0\
|
| · | No campo Abrir você deve ter o texto
|
| "C:\Arquivos de Programas\NeoInter\BoletoPro\V2.0\BoletoPro.exe"
|
| · | No campo Abrir, logo após o texto acima, acrescente um espaço em branco e coloque o seguinte texto:
|
| -I "/F0:C:\Arquivos de Programas\NeoInter\BoletoPro\V2.0\InterApp\Exemplo1_Leiaute_padrao\BoletosEx1.csv" /QE
|
| Assim, o texto completo da linha de comando ficará da seguinte forma:
|
| "C:\Arquivos de programas\NeoInter\BoletoPro\V2.0\BoletoPro.exe" -I "/F0:C:\Arquivos de programas\NeoInter\BoletoPro\V2.0\InterApp\Exemplo1_Leiaute_padrao\BoletosEx1.csv" /QE
|
| Com Windows Vista, o texto acima deve ser substituído por
|
| "C:\Arquivos de programas\NeoInter\BoletoPro\V2.0\BoletoPro.exe" -I "/F0:C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\InterApp\Exemplo1_Leiaute_padrao\BoletosEx1.csv" /QE
|
| (necessário aspas, pois há espaços em branco no nome do diretório onde está o programa)
|
| O programa Boleto Pro será chamado e importará os registros de boletos que estão no arquivo BoletosEx1.csv e, após isso, o programa finalizará sua execução. Execute o programa e confira que os boletos foram realmente importados pelo Boleto Pro.
|
| Explicação do comando e parâmetros utilizados na chamada InterApp desenvolvida:
|
| Comando que indica que o Boleto Pro deve importar dados de boletos que estão armazenados em um arquivo.
|
| b) "/F0:C:\Arquivos de programas\NeoInter\BoletoPro\V2.0\InterApp\Exemplo1_Leiaute_padrao\BoletosEx1.csv"
|
| Parâmetro que informa o nome completo do arquivo que contém os dados, em leiaute padrão, dos boletos a serem importados.
|
| Parâmetro que determina que execução do programa seja encerrada, tão logo a importação dos dados dos boletos seja concluída. Como por default (padrão) a execução do programa é em modo silencioso (sem aparecer a tela para o usuário) é desnecessário informar, também, o parâmetro /QM (modo silencioso).
|
| Iniciar | Todos os Programas | Neo Interativa | Boleto Pro V2.0 | Assistente InterApp
|
| · | Clique no botão Próximo, passando ao passo 2.
|
| · | Clique no botão Próximo, passando ao passo 3.
|
| · | No passo 3, escolha a opção Importar boletos.
|
| · | Clique no botão Próximo, passando ao passo 4.
|
| · | Estando no passo 4, clique no botão Arquivo e escolha o arquivo
|
| C:\Arquivos de Programas\NeoInter\BoletoPro\V2.0\InterApp\Exemplo1_Leiaute_padrao\BoletosEx1.csv
|
| C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\InterApp\Exemplo1_Leiaute_padrao\BoletosEx1.csv
|
| · | Escolha a opção Leiaute padrão.
|
| · | Clique no botão Próximo, passando ao passo 6.
|
| · | No passo 6, marque as opções: Modo silencioso e Fechar ao terminar.
|
| · | Clique no botão Próximo, passando ao passo 7 (último passo).
|
| · | Pronto! Na aba Comando, está mostrada a linha de comando completa para a chamada InterApp que fará a importação do arquivo de boletos, a qual terá o seguinte conteúdo:
|
| "C:\Arquivos de programas\NeoInter\BoletoPro\V2.0\BoletoPro.exe" -I "/F0:C:\Arquivos de programas\NeoInter\BoletoPro\V2.0\InterApp\Exemplo1_Leiaute_padrao\BoletosEx1.csv" /QE
|
| Com Windows Vista, o texto acima deve ser substituído por
|
| "C:\Arquivos de programas\NeoInter\BoletoPro\V2.0\BoletoPro.exe" -I "/F0:C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\InterApp\Exemplo1_Leiaute_padrao\BoletosEx1.csv" /QE
|
| · | Clique no botão Copiar e cole essa linha de comando na janela da função Executar Programa do Windows (conforme discutido mais acima) para executar a importação dos dados, ou simplesmente clique no botão Executar, que o programa Boleto Pro será chamado e os dados dos boletos importados.
|
| 3.2 Emissão impressa de boletos a partir de arquivo com leiaute padrão
|
| Este exemplo utilizará os arquivos-exemplos que se encontram dentro da pasta
|
| C:\Arquivos de Programas\NeoInter\BoletoPro\V2.0\Exemplo2_Leiaute_padrao\
|
| C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\InterApp\Exemplo2_Leiaute_padrao\
|
| Neste exemplo, requisitaremos que o programa importe o arquivo com boletos BoletosEx2.xls e que faça a emissão impressa dos boletos logo a seguir. Como este arquivo de dados possui leiaute padrão, não é necessário especificar qual arquivo de especificação deve ser utilizado. Apesar de estar em outro formato (Excel), o conteúdo desse arquivo é similar ao arquivo de dados abordado no item anterior (arquivo BoletosEx1.csv), com a diferença de que o campo Nosso Número dos boletos encontra-se em branco. Isso fará com que o programa Boleto Pro gere automaticamente o valor desse campo, quando a importação dos boletos.
|
| Em razão da maior simplicidade, será apresentado o procedimento utilizando-se o programa Assistente InterApp:
|
| Iniciar | Todos os Programas | Neo Interativa | Boleto Pro V2.0 | Assistente InterApp
|
| · | Clique no botão Próximo, passando ao passo 2.
|
| · | Clique no botão Próximo, passando ao passo 3.
|
| · | No passo 3, escolha a opção Importar e emitir boletos.
|
| · | Clique no botão Próximo, passando ao passo 4.
|
| · | Estando no passo 4, clique no botão Arquivo e escolha o arquivo
|
| C:\Arquivos de Programas\NeoInter\BoletoPro\V2.0\InterApp\Exemplo2_Leiaute_padrao_NNum_Auto\BoletosEx2.xls
|
| C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\InterApp\Exemplo2_Leiaute_padrao_NNum_Auto\BoletosEx2.xls
|
| · | Escolha a opção Leiaute padrão.
|
| · | Clique no botão Próximo, passando ao passo 5.
|
| · | No passo 5, marque a opção: Imprimir.
|
| · | Clique no botão Próximo, passando ao passo 6.
|
| · | No passo 6, marque as opções: Modo silencioso e Fechar ao terminar.
|
| · | Clique no botão Próximo, passando ao passo 7 (último passo).
|
| · | Pronto! Na aba Comando, está mostrada a linha de comando completa para a chamada InterApp que fará a importação do arquivo de boletos, a qual terá o seguinte conteúdo:
|
| "C:\Arquivos de programas\NeoInter\BoletoPro\V2.0\BoletoPro.exe" -M "/F0:C:\Arquivos de programas\NeoInter\BoletoPro\V2.0\InterApp\Exemplo2_Leiaute_padrao_NNum_Auto\BoletosEx2.XLS" /P /QE
|
| Com Windows Vista, o texto acima deve ser substituído por
|
| "C:\Arquivos de programas\NeoInter\BoletoPro\V2.0\BoletoPro.exe" -M "/F0:C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\InterApp\Exemplo2_Leiaute_padrao_NNum_Auto\BoletosEx2.XLS" /P /QE
|
| · | Clique no botão Copiar e cole essa linha de comando na janela da função Executar Programa do Windows (conforme discutido mais acima) para executar a importação dos dados, ou simplesmente clique no botão Executar, que o programa Boleto Pro será chamado e os dados dos boletos importados.
|
| Explicação do comando e parâmetros utilizados na chamada InterApp desenvolvida:
|
| Comando que indica que o Boleto Pro deve importar dados de boletos que estão armazenados em um arquivo e, após tê-los importado, emitir os boletos.
|
| b) "/F0:C:\Arquivos de programas\NeoInter\BoletoPro\V2.0\InterApp\Exemplo1_Leiaute_padrao\BoletosEx1.csv"
|
| Parâmetro que informa o nome completo do arquivo que contém os dados, em leiaute padrão, dos boletos a serem importados e emitidos.
|
| Parâmetro que indica que a emissão dos boletos será feita através de impressão.
|
| Parâmetro que determina que execução do programa seja encerrada, tão logo a importação dos dados e emissão dos boletos seja concluída. Como por default (padrão) a execução do programa é em modo silencioso (sem aparecer a tela para o usuário) é desnecessário informar, também, o parâmetro /QM (modo silencioso).
|
| 3.3 Emissão em arquivo PDF de boletos a partir de arquivo com leiaute personalizado
|
| Este exemplo utilizará os arquivos-exemplos que se encontram dentro da pasta
|
| C:\Arquivos de Programas\NeoInter\BoletoPro\V2.0\InterApp\Exemplo3_Leiaute_personalizado\
|
| C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\InterApp\Exemplo3_Leiaute_personalizado\
|
| Neste exemplo, requisitaremos que o programa importe o arquivo com boletos BoletosEx3.mdb e que faça a emissão em arquivos PDF dos boletos logo a seguir. Como este arquivo de dados não está em leiaute padrão, será necessário informar qual arquivo de especificação deve ser utilizado.
|
| Em razão da maior simplicidade, será apresentado o procedimento utilizando-se o programa Assistente InterApp:
|
| Iniciar | Todos os Programas | Neo Interativa | Boleto Pro V2.0 | Assistente InterApp
|
| · | Clique no botão Próximo, passando ao passo 2.
|
| · | Clique no botão Próximo, passando ao passo 3.
|
| · | No passo 3, escolha a opção Importar e emitir boletos.
|
| · | Clique no botão Próximo, passando ao passo 4.
|
| · | Estando no passo 4, clique no botão Arquivo e escolha o arquivo
|
| C:\Arquivos de Programas\NeoInter\BoletoPro\V2.0\Exemplo3_Leiaute_personalizado\BoletosEx3.MDB
|
| C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\InterApp\Exemplo3_Leiaute_personalizado\BoletosEx3.MDB
|
| · | Escolha a opção Leiaute Personalizado.
|
| · | Clique no botão SMI e escolha o arquivo
|
| C:\Arquivos de Programas\NeoInter\BoletoPro\V2.0\InterApp\Exemplo3_Leiaute_personalizado\BoletosEx3_MDB.smi
|
| C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\InterApp\Exemplo3_Leiaute_personalizado\BoletosEx3_MDB.smi
|
| · | Clique no botão Próximo, passando ao passo 5.
|
| · | No passo 5, marque a opção: Salvar.
|
| · | Clique no botão Opções, o que abrirá a janela Opções de Salvamento.
|
| · | Na janela Opções de Salvamento, clique no botão Pasta, e escolha a pasta abaixo (ou qualquer outra, onde deseje armazenar os arquvos PDF de boletos que serão gerados):
|
| C:\Arquivos de Programas\NeoInter\BoletoPro\V2.0\Anexos
|
| C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\Anexos
|
| · | Em Nome Base, preencha com Teste.
|
| · | Em Formato, escolha PDF.
|
| · | Clique no botão OK. A janela Opções de salvamento será fechada.
|
| · | Clique no botão Próximo, passando ao passo 6.
|
| · | No passo 6, marque as opções: Modo silencioso e Fechar ao terminar.
|
| · | Clique no botão Próximo, passando ao passo 7 (último passo).
|
| · | Pronto! Na aba Comando, está mostrada a linha de comando completa para a chamada InterApp que fará a importação do arquivo de boletos e a emissão em arquivos do tipo PDF, a qual terá o seguinte conteúdo:
|
| "C:\Arquivos de programas\NeoInter\BoletoPro\V2.0\BoletoPro.exe" -M "/F:C:\Arquivos de programas\NeoInter\BoletoPro\V2.0\InterApp\Exemplo3_Leiaute_personalizado\BoletosEx3.MDB" "/D:C:\Arquivos de programas\NeoInter\BoletoPro\V2.0\InterApp\Exemplo3_Leiaute_personalizado\BoletosEx3_MDB.smi" /S /SSEL:"C:\Arquivos de programas\NeoInter\BoletoPro\V2.0\Anexos" /SBN:Teste /FT:0 /QE
|
| Com Windows Vista, o texto acima deve ser substituído por
|
| "C:\Arquivos de programas\NeoInter\BoletoPro\V2.0\BoletoPro.exe" -M "/F:C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\InterApp\Exemplo3_Leiaute_personalizado\BoletosEx3.MDB" "/D:C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\InterApp\Exemplo3_Leiaute_personalizado\BoletosEx3_MDB.smi" /S /SSEL:"C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\Anexos" /SBN:Teste /FT:0 /QE
|
| · | Se você clicar no botão Copiar e tentar colar essa linha de comando na janela da função Executar Programa do Windows (conforme discutido mais acima) para executar a importação dos dados, não terá sucesso, em razão do número de caracteres ultrapassar o número máximo admitido pela função Executar Programa do Windows. Então, para executar essa linha de comando, você deve botão Executar, que o programa Boleto Pro será chamado e os dados dos boletos importados e emitidos (boletos salvos em arquivos PDF).
|
| Explicação do comando e parâmetros utilizados na chamada InterApp desenvolvida:
|
| Comando que indica que o Boleto Pro deve importar dados de boletos que estão armazenados em um arquivo e, após tê-los importado, emitir os boletos.
|
| b) "/F:C:\Arquivos de programas\NeoInter\BoletoPro\V2.0\InterApp\Exemplo3_Leiaute_personalizado\BoletosEx3_MDB.mdb"
|
| Parâmetro que informa o nome completo do arquivo que contém os dados, em leiaute personalizado, dos boletos a serem importados e emitidos.
|
| Parâmetro que indica que a emissão dos boletos será feita através de salvamento em arquivos.
|
| d) /SSEL:"C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\Anexos
|
| Parâmetro que indica a pasta na qual serão armazenados os arquivos referentes aos boletos emitidos.
|
| Parâmetro que indica que o nome base para os arquivos emitidos será Teste.
|
| Parâmetro que indica que os boletos serão emitidos em arquivos do tipo PDF.
|
| Parâmetro que determina que execução do programa seja encerrada, tão logo a importação dos dados e emissão dos boletos seja concluída. Como por default (padrão) a execução do programa é em modo silencioso (sem aparecer a tela para o usuário) é desnecessário informar, também, o parâmetro /QM (modo silencioso).
|
| 4. COMANDOS e PARÂMETROS - Lista de referência
|
| Para controlar o programa você deve passar comandos através da linha de comandos e parâmetros. A seguir, são descritos os comandos disponíveis e eventuais parâmetros.
|
| Importar boletos a partir de arquivo especificado. Arquivo com especificação de importação é necessário apenas se o leiaute do arquivo com os boletos não estiver em Leiaute Padrão.
|
| Emitir boletos, a partir de arquivo especificado. Arquivo com especificação de importação é necessário apenas se o leiaute do arquivo com os boletos não estiver em Leiaute Padrão. Para que a emissão seja possível, é necessário que você especifique ao menos uma modalidade de emissão (e-mail => /E, impressão => /P ou salvamento em arquivo => /S).
|
| Emitir boletos não-emitidos. Este comando emite os boletos que já foram cadastrados, mas que ainda não foram emitidos, quer por e-mail, quer por impressão, quer por salvamento em arquivo. Este comando é bastante útil para usar em conjunto com o comando -I (importar boletos): ao longo do dia você pode cadastrar os boletos no programa usando o comando -I e, ao final do dia, emitir todos os boletos usando o comando -MN. Para que a emissão seja possível, é necessário que você especifique ao menos uma modalidade de emissão (e-mail => /E, impressão => /P ou salvamento em arquivo => /S).
|
| Apagar todos os registros. Este comando apaga todos os registros de boletos da conta que for a corrente. Esse comando é útil se você efetua o acompanhamento dos boletos emitidos através do seu sistema, não necessitando que o programa armazene os dados de todos os boletos que foram emitidos.
|
| Nome da conta a usar para emissão de boletos. Após selecioná-la esta fica sendo a conta ativa no programa. Por padrão, todos os boletos são emitidos para a conta ativa (a conta que foi usada na última vez em que o programa foi chamado). Caso queira importar dados, ou emitir boletos para outra conta, você deve usar este parâmetro para especificar o nome da conta desejada. Por exemplo: /CT:Conta_Filial_SP.
|
| /CT_Num:<AutoCode_da_conta>
|
| Valor do campo AutoCode da conta a usar para emissão de boletos. Após selecioná-la esta fica sendo a conta ativa no programa. Por padrão, todos os boletos são emitidos para a conta ativa (a conta que foi usada na última vez em que o programa foi chamado). Caso queira importar dados, ou emitir boletos para outra conta, você deve usar este parâmetro para especificar o valor do campo AutoCode da conta desejada. Por exemplo: /CT_Num:1.
|
| Nome do arquivo de dados com boletos. É o nome do arquivo que contém os registros de boletos a importar. Se fornecido apenas o nome do arquivo, sem o caminho completo (path), será admitido que o arquivo encontra-se no mesmo diretório que o arquivo executável do programa.
|
| Com Windows Vista, caso seja fornecido apenas o nome do arquivo, sem o caminho completo (path), será admitido que o mesmo encontra-se dentro da pasta padrão para dados do programa
|
| C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\Dados"
|
| Nome do arquivo de dados. É o nome do arquivo que contém os registros de boletos a importar. Se fornecido apenas o nome do arquivo, sem o caminho completo (path), será admitido que o arquivo encontra-se no mesmo diretório que o arquivo executável do programa. Difere do parâmetro acima pelo fato de que o arquivo especificado em <filename> deve ter leiaute padrão (o que define se um arquivo está de acordo com o leiaute padrão são campos que possui e a ordem em que aparecem). Uma maneira bem simples de gerar um arquivo com leiaute padrão é usar a função exportar dados, no Gerenciador de Boletos, e escolher exportar para arquivo com leiaute padrão.
|
| Com Windows Vista, caso seja fornecido apenas o nome do arquivo, sem o caminho completo (path), será admitido que o mesmo encontra-se dentro da pasta padrão para dados do programa
|
| C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\Dados"
|
| Nome de arquivo com especificações para importação. É necessário fornecer este arquivo apenas se o leiaute do arquivo com os boletos não estiver em Leiaute Padrão.
|
| Se fornecido apenas o nome do arquivo com especificações para importação, sem o caminho (path), será admitido que o arquivo encontra-se no diretório \DADOS, onde o programa foi instalado.
|
| Com Windows Vista, caso seja fornecido apenas o nome do arquivo, sem o caminho completo (path), será admitido que o mesmo encontra-se dentro da pasta padrão para dados do programa
|
| C:\Users\Nome_do_Usuario\Documents\NeoInter\BoletoPro\V2.0\Dados"
|
| Usando o Assistente de importação de dados, você pode criar e salvar uma especificação de importação que contenha apenas os campos do seu interesse, e no formato da sua escolha. Para isso, chame o Assistente de importação de dados. Através das telas do assistente, forneça os parâmetros de importação. No último passo, clique no botão Especificações..., para salvar a sua especificação de importação. Uma vez salva, você poderá utilizá-la para controlar a importação de um arquivo com dados de boletos pelo Boleto Pro.
|
| Emitir imprimindo. Este parâmetro deve ser usado em conjunto com o comando -M ou com o comando -MN.
|
| /PSEL:<Nome_da_impressora>
|
| Indica o nome da impressora responsável pela impressão dos boletos a serem emitidos. Caso não saiba o nome da impressora, basta consultar o item "Impressoras" no Painel de Controle, ou verificar o nome para a impressora que aparece na janela de configuração de impressoras de algum programa (Boleto Pro, NotePad, Microsoft Word, etc.). Notar que se a impressora estiver em rede, deve-se informar o nome do micro que a contém, também. Exemplos de valores: "HP LaserJet 1200 Series PCL 6", "\\Servidor01\HP LaserJet 1200 Series PCL 6". Parâmetro opcional. Se não-fornecido, será utilizada a impressora que estiver configurada como padrão.
|
| Emitir enviando boletos por e-mail. Este parâmetro deve ser usado em conjunto com o comando -M ou com o comando -MN.
|
| Emitir salvando boletos em arquivo. Este parâmetro deve ser usado em conjunto com o comando -M ou com o comando -MN.
|
| Os nomes dos arquivos gerados obedecerão ao seguinte formato:
|
| NNNN...N - são os dígitos do campo Nosso Número do boleto
|
| ext - Extensão do arquivo. Varia conforme o tipo de arquivo.
|
| Exemplos de nomes de arquivos gerados: B101.pdf, B10.bmp, etc.
|
| Por padrão, os arquivos gerados são armazenados dentro do diretório \Anexos, o qual está dentro do diretório no qual foi instalado o programa. Para instalação-padrão do programa, o diretório para salvamento dos boletos deve ser algo como:
|
| C:\Arquivos de Programas\NeoInter\BoletoPro\V2.0\Anexos
|
| Com Windows Vista, a pasta para salvamento dos boletos deve ser algo como
|
| C:\Users\Nome_do_Usuario\AppData\Local\NeoInter\BoletoPro\V2.0\Anexos"
|
| Para especificar outro diretório para salvamento dos boletos utilize o parâmetro /SSEL, e para acrescentar um texto adicional ao nome do arquivo, o parâmertro /SBN, os quais são explicados nos itens a seguir.
|
| /SSEL:<Diretório_para_Salvar>
|
| Indica diretório (pasta) dentro do qual boletos gerados utilizando-se o parâmetro /S serão armazenados. Este parâmetro deve ser usado em conjunto com os comandos -M ou -MN, e com o parâmetro /S.
|
| Indica o nome base para os arquivos gerados durante o salvamento de boletos. Se este parâmetro for usado, ao nome do arquivo obtido conforme convenção explicada no parâmetro /S, será acrescentado um caractere underscore ("_") seguido do texto fornecido através deste parâmetro. Exemplos de nomes obtidos usando-se também esse parâmetro: B101_Matriz.pdf, B10_Filial01.bmp, etc.
|
| Se o nome base do arquivo fornecido tiver uma extensão válida (*.PDF, *.JPEG, *.GIF, *.BMP, *.EMF, *.WMF, *.HTML), o arquivo gerado será do mesmo tipo (possuirá a mesma extensão), sendo o tipo eventualmente fornecido através do parâmetro /FT ignorado. A extensão padrão, para casos de erro é a extensão *.PDF. Essa é a extensão dos arquivos gerados em casos onde a extensão fornecida é inválida, ou ausente.
|
| Tipo de arquivo para envio ou salvamento do boleto ( 0 / 1 / 2 / 3 / 4 / 5 / 6 => PDF / JPEG / GIF / BMP / EMF / WMF / HTML).
|
| Observação: como no formato HTML é gerado link para boleto on-line é necessário contratar o serviço Boleto On-line. Também é importante mencionar que por gerar link para um boleto on-line, dificilmente um cliente terá dificuldades em abrir esse tipo de boleto, sendo entre todas as opções disponíveis, esta a que resulta no menor tamanho de arquivo de boleto.
|
| A extensão padrão, para casos de erro é a extensão *.PDF. Essa é a extensão dos arquivos gerados em casos onde a extensão fornecida é inválida, ou ausente.
|
| Operação em modo silencioso. O programa é executado em modo minimizado, de forma transparente para o seu usuário. Após ter executado a função InterApp passada através dos parâmetros, o programa será finalizado. Equivale a ter passado também o parâmetro /QE. Este é um parâmetro DEFAULT (a menos que /SHOW tenha sido especificado, o programa admitirá que este parâmetro foi fornecido na linha de comando).
|
| Sai do programa após terminar a execução do parâmetro que você pediu para ser executado.
|
| Operação em modo não-silencioso. O programa é executado em modo maximizado, sendo mostrada a tela principal do programa. Além de possuir processamento mais lento este modo de operação não é transparente para o seu usuário. Pode ser útil na fase de Debug da integração do sistema. Quando o sistema já estiver em operação recomenda-se não utilizar este parâmetro.
|
| Enviar junto ao e-mail instruções de auxílio sobre como imprimir o boleto enviado em anexo
|
| Enviar junto ao e-mail dados dos principais campos do boleto enviado em anexo
|
| Faz com que em modo de execução não-silencioso sejam mostradas janelas com botão de cancelamento, o qual permitirá que a operação de emissão (e-mail, impressão ou salvamento) seja cancelada.
|
| Emissão dos boletos é feita sem manter cadastrados boletos que foram gerados na chamada InterApp em questão. Útil se o Boleto Pro for usado apenas como programa emissor, pois você não precisará em apagar registros após ter feito a emissão dos boletos.
|
| /PWD:<senha_arquivo_de_ banco_de_dados>
|
| Senha de acesso ao arquivo de Banco de Dados do programa (arquivo com extensão *.prodbcnabdb), caso este tenha uma senha de acesso. Parâmetro opcional. Se o arquivo de dados for protegido por senha e o programa não estiver em modo silencioso e a senha não tiver sido informada através do parâmetro "/PWD", o programa mostrará uma janela para leitura da senha de acesso. Se estiver em modo silencioso, não será mostrada a janela para leitura de senha, mas acrescentará indicação de erro no arquivo LOG_ERROS.TXT.
|
| Se ocorrer algum erro durante o processamento dos comandos será criado arquivo de nome LOG_ERROS.TXT, no qual estarão todos os erros ocorridos durante a execução dos comandos fornecidos. Assim, para a sua aplicação saber se ocorreu algum erro durante a execução dos comandos basta verificar se existe arquivo com o nome LOG_ERROS.TXT, no diretório onde está armazenado o arquivo executável do programa. E, para saber quais erros ocorreram, deve mostrar o conteúdo desse arquivo.
|
| Se não ocorrer nenhum erro durante o processamento dos comandos será criado arquivo de nome LOG_OK.TXT. Nesse caso, o arquivo LOG_ERROS.TXT não será gerado. Assim, para a sua aplicação saber se todos os comandos foram executados corretamente basta verificar se existe arquivo com o nome LOG_OK.TXT, no diretório onde está armazenado o arquivo executável do programa (arquivo BoletoPro.exe).
|
| Com Windows Vista, os arquivos LOG_ERROS.TXT e LOG_OK.TXT são criados dentro da pasta
|
| C:\Users\Nome_do_Usuario\AppData\Local\NeoInter\BoletoPro\V2.0"
|
| 6. PROGRAMA EM PROCESSAMENTO
|
| Quando o programa começa a executar algum comando recebido via InterApp, é criado o arquivo LOG_PROCESSING.TXT, no diretório onde está o arquivo executável deste. Dentro desse arquivo, é armazenada a data e a hora do instante em que ocorreu o início do processamento do comando. Tão logo a execução da função InterApp seja concluída, esse arquivo será apagado. Monitorando a existência desse arquivo, você terá à disposição um mecanismo de intertravamento, que permitirá que se evite que mais de um processo no seu aplicativo chame o Boleto Pro ao mesmo tempo (o que não é permitido).
|
| Com Windows Vista, o arquivo LOG_PROCESSING.TXT é criado dentro da pasta
|
| C:\Users\Nome_do_Usuario\AppData\Local\NeoInter\BoletoPro\V2.0"
|
| Como forma de minimizar as modificações que você deve fazer, quando de atualização de versão do programa, recomenda-se que
|
| 1. | O Boleto Pro seja instalado em diretório padrão, que independa da versão do programa (ao instalar o programa, você pode definir em que diretório o programa deve ser instalado). Por exemplo, instalar o programa no local: C:\BoletoPro\
|
| 2. | Colocar arquivo com os dados a serem importados no diretório C:\BoletoPro\Dados\.
|
| 3. | Caso seja necessário utilizar alguma especificação de importação, colocá-la, também, no diretório C:\BoletoPro\Dados\
|
| 8. NOVIDADES NO INTERAPP 2.0
|
| A seguir são listadas as principais diferenças entre o InterApp 2.0 e a versão da geração anterior do recurso, a 1.3:
|
| 1. | Parâmetros /S, /SSEL e /SBN, para emissão de boletos diretamente em arquivo (emissão por salvamento).
|
| 2. | Completamente silencioso: a menos que o parâmetro /SHOW seja utilizado, a execução do Boleto Pro será totalmente silenciosa. Ao contrário do que ocorria em versões anteriores, nenhuma janela de progresso, ou botão do programa na barra de status do Windows, serão mostrados.
|
| 3. | Se parâmetro /QM for usado (ou se nem este nem o parâmetro /SHOW forem utilizados), necessariamente, o programa será finalizado após ter executado a função InterApp pedida. Equivale a ter-se feita chamada utilizando-se simultaneamente os parâmetros /QM e /QE.
|
| 4. | Parâmetro /NL, o qual permite que se faça emissão dos boletos, mas os boletos emitidos não são mantidos armazenados na base de dados. Útil se o Boleto Pro for usado apenas como programa emissor.
|
| 5. | Parâmetro /SCD, que controla se janelas para cancelamento de operação (importação ou emissão) devem ser mostradas, quando programa está operando em modo não-silencioso.
|
| 6. | Como o registro de boleto do Boleto Pro permite cadastro de título de e-mail, mensagem e endereço de e-mail do cliente para cada boleto emitido, você possui maior flexibilidade para a emissão de boletos, podendo definir para cada cliente qual a mensagem e título que deve acompanhar, cada boleto enviado.
|
| 7. | Novas opções para o formato do arquivo dos boletos gerados. Agora é possível emitir boletos (envio por e-mail ou salvamento em arquivo) utilizando-se os seguintes formatos: PDF, JPEG, GIF, BMP, EMF, WMF e HTML (link para boleto on-line, sendo necessário contratar o serviço Boleto On-line. Por gerar link para um boleto on-line, dificilmente um cliente terá dificuldades em abrir o boleto, além disso, entre todas as opções disponíveis, é a que resulta no menor tamanho de arquivo de boleto).
|
| 8. | Arquivo LOG_PROCESSING.TXT é criado no início da execução de uma função InterApp e apagado ao final. Monitorando-se a existência desse arquivo, tem-se à disposição um mecanismo de intertravamento, o qual permite que se evite que mais de um processo no seu aplicativo chame o Boleto Pro ao mesmo tempo (o que não é permitido).
|
| 9. | Maior performance na emissão de boletos.
|
|
