Manual Do EDI7Web Cliente - Itau
Manual Do EDI7Web Cliente - Itau
Manual Do EDI7Web Cliente - Itau
Banco Itaú
Manual do Edi7WebCli
Índice
1
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
1. DOWNLOAD DO INSTALADOR
Acesse o Site do Edi7Itau: https://edi7.itau.com.br/. Após se logar no sistema, acesse o item “Download”
do menu lateral.
Selecione o arquivo de acordo com a plataforma destino: Linux ou Windows.
2
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
2. INSTALAÇÃO DO EDI7WEBCLI
2.1. INSTALAÇÃO DO EDIWEBCLI - WINDOWS
Respondendo “Sim” o browser será aberto na página de download do Java. Siga as instruções da página
para instalar o JRE.
3
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
Nessa tela é possível escolher entre, continuar a instalação mesmo sem o reconhecimento do Java instalado,
respondendo “Sim”, ou parar a instalação, respondendo “Não”. Lembrando que o Edi7WebCli deve ter o
JAVA instalado para ser executado.
Caso tenha respondido “Sim” para a tela anterior, ou o Java foi encontrado no sistema e as duas telas
anteriores não apareceram, a janela acima será apresentada. Caso deseje alterar o diretório destino, clique
no botão “Procurar”. Após confirmar o diretório de instalação, clique no botão “Avançar”.
4
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
5
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
Ao término da instalação. se desejar executar a aplicação que configura o EdiWebCli (configurador), marcar
a opção “Executar Edi7WebCli”.
6
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
Escolha um diretório onde será instalado o programa, por exemplo, “/home/itau/edi7/”. Copie o arquivo
baixado do site https://edi7.itau.com.br/ (versão de instalação para Linux) para este diretório. Use o
comando:
tar –zxvf Edi7WebCliSetup.tar.gz
EDI7Web
|__ bin
| |____ EDI7WebCli.jar
| |____ edi7-bat.ico
| |____ edi7.ico
| |____ setup.sh
|__ cfg
| |____ setup.sh
|__ log
Este é o comando para executar o programa de transferência automaticamente, sem janelas ou interação
com o usuário.
No diretório “cfg” será criado o arquivo webcli-config.xml com a configuração de conexão. Veja o item 4.3
para detalhamento deste arquivo. No diretório “log” serão gravados os arquivos de logs.
7
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
3. CONFIGURAÇÃO DO EDI7WEBCLI
O processo de configuração do Edi7WebCli é facilitado pelo uso do Configurador. Ele é um programa Java
que pode ser executado nas plataformas Windows e Linux (com interface gráfica).
No caso de uma plataforma Linux sem a interface gráfica (ou no Windows, caso não se queira utilizar o
Configurador), o processo é manual e detalhado no item 3.3.
8
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
9
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
• Upload: onde se informam os dados para upload (transmissão para o banco) dos arquivos de
Remessa.
• Download: onde se indica os dados para download (recepção dos arquivos do banco) dos arquivos
de Retorno.
Identificação
Para identificação de acesso será necessário informar os campos Cliente, Produto, Senha e Tipo.
Cliente: código do cliente no Sistema Edi7 do banco, com sete caracteres alfa-numéricos.
Produto: código do produto a que se referem os arquivos trafegados, com três caracteres alfa-numéricos.
Senha: senha de acesso. Este campo é “case-sensitive” e deve ser preenchido com atenção.
Obs.: Se algum destes três campos for novo, ou seja, se nunca houve conexão com o banco
usando estes dados, deve ser acessado o site https://edi7.itau.com.br para a troca da senha inicial
e a concordância com o Termo de Aceite.
Endereço do Servidor Proxy: Caso seja necessário a utilização de um servidor proxy, esse campo deve ser
preenchido com o endereço do servidor proxy.
Porta: Porta do servidor proxy, para quando o endereço é preenchido.
Usuário do Proxy: Quando existe configurado o servidor proxy e o mesmo necessita de usuário e senha
para conexão, deve-se informar nesse campo o usuário.
Senha do Proxy: : Quando existe configurado o servidor proxy e o mesmo necessita de usuário e senha
para conexão, deve-se informar nesse campo a senha.
10
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
Tipo de Arquivo: se o campo anterior for marcado como Arquivo Especial, este item será habilitado e
permitirá que se escolha entre o tipo Texto (arquivo no padrão ASCII) ou Binário para arquivos
compactados, criptografados, planilhas Excel, documentos Word, etc.
Modo de Trabalho: pode-se escolher se o Edi7WebCli deve apenas transmitir os arquivos para o banco
(Transmissão), apenas receber arquivos (Recepção) ou o modo Ambos, onde ocorre tanto a transmissão
quanto a recepção dos arquivos.
Upload
Para a transmissão informar os campos abaixo:
Lista de Transmissão: lista dos arquivos que serão transmitidos. Use os botões Adicionar, Editar e Remover
para inserir arquivos na lista, editar um caminho ou nome de arquivo da lista, ou para retirar um arquivo da
lista.
Diretório de Enviados: clique no botão Definir para alterar o nome do diretório para onde serão movidos os
arquivos já transmitidos. Os arquivos movidos têm o nome alterado para conter um sufixo com a data e hora
da transmissão.
Download
Clique no botão Definir para informar o diretório onde serão gravados os arquivos recebidos do banco
(retorno).
Use os botões Salvar e Cancelar para gravar as configurações feitas ou descartá-las, respectivamente. Ao
salvar uma configuração, os seguintes itens serão criados:
• No diretório “bin” será criado um arquivo batch de nome “EMPRESA-001-P.bat” que contém o comando
para iniciar o processo de transferência de arquivos. Bastará executá-lo.
• No diretório “cfg” será criado o arquivo “webcli.xml” com as configurações editadas na janela de
configuração do cliente.
• Os diretórios dos arquivos de remessa e retorno de acordo com a configuração feita. Na configuração default
do programa, a estrutura será:
11
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
\EMPRESA-001-T\
| \enviar\
| \enviados\
| \recepcao\
Ao clicar no botão “Editar”, a janela de configuração será mostrada, como na inclusão, porém com os
campos de Cliente e Produto desabilitados.
12
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
13
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
O Edi7WebCli possui no diretório bin o script “setup.sh” para configurar uma conta pelo console, voltados
para qualquer distruição Linux, ou sistemas padrão POSIX com bash na versão atual.
Edi7WebCli/bin> ./setup.sh
Iniciando a configuracao do Edi7WebCli
*** Entre com os dados conforme solicitado ***
Cliente: EMPRESA
Produto: 001
Tipo (Teste/Producao): [t/P] t
Senha: *****
Configurar servidor proxy? [s/N] s
Endereco do servidor proxy:
10.10.10.10 Porta do servidor proxy:
8080
Usuario do servidor proxy: user
Senha do usuario do servidor proxy:
***** Operacao
(Normal/reTransmissao): [N/t]
Arquivo especial: [s/N]
Diretorio e filtro de arquivos para upload (remessa): [/home/edi7/Edi7WebCli/EMPRESA-001-
T/enviar/*]
Diretorio de arquivos para download (retorno): [/home/edi7/Edi7WebCli/EMPRESA-001-
T/recepcao]
Diretorio de arquivos enviados: [/home/edi7/Edi7WebCli/EMPRESA-001-T/enviados]
14
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
Para executar o programa de transferência Edi7WebCli, pode ser usado um script de execução ou executar
o comando diretamente num terminal:
Este é um exemplo de comando para executar o programa de transferência automaticamente, sem janelas
ou interação com o usuário.
Em caso de sistema Linux, o nome do arquivo é setup.ref e deve ser renomeado ou copiado para webcli.xml;
15
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
A configuração da operação do EDI7WebCli é feita através do arquivo webcli.xml que está localizado
no diretório “cfg”. Este arquivo deve ter o seguinte formato, conforme o exemplo (Linux):
16
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
<LISTA>
<OBJETO>
<ARQUIVO>/home/edi7/itau/EMPRESA-001-P/enviar/*.REM</ARQUIVO>
</OBJETO>
<OBJETO>
<ARQUIVO>/home/edi7/itau/EMPRESA-001-P/enviar/*.txt</ARQUIVO>
</OBJETO>
</LISTA>
</LISTA_UPLOAD>
</PARAMETROS>
</value>
</entry>
</CLIENTES>
</MODAUTO>
Para plataformas Windows o arquivo muda apenas na configuração dos nomes dos diretórios, usando “\” ao
invés de “/” e iniciando pela unidade (por exemplo, “C:\”). Outra diferença é que no Windows os nomes de
diretórios e arquivos não são “case-sensitive”, ou seja, não importa se o nome está em maiúsculas ou
minúsculas. O Linux é “case-sensitive”.
Onde:
Os itens seguem a padronização XML e portanto as tags devem ser fechadas corretamente.
17
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
18
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
Os itens marcados com “(fixo)” não devem ser alterados ou excluídos. Apenas os valores dos demais itens
podem ser alterados.
19
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
4. USO DO EDI7WEBCLI
4.1. ANTES DE USAR O EDI7WEBCLI
Assim que o cliente é cadastrado na Central do EDI7 e antes do primeiro acesso pelo Edi7WebCli, deve ser
feita uma validação através de uma conexão Web.
Acesse o site https://edi7.itau.com.br/ para executar dois passos importantes, sem os quais o Edi7WebCli
não funcionará.
Ao acessar o site, será solicitada a troca da senha inicial. Digite uma nova senha e confirme. Se a senha for
aceita, faça um acesso pelo site com a nova senha.
Nesta segunda tentativa, será apresentada uma tela para aceitação das condições de uso do serviço. Ao
aceitar, pode ser que seja apresentada a mensagem de erro “Equipamento inválido.”. Isto é normal pois o
sistema diferencia o acesso pelo site daquele que é feito pelo Edi7WebCli, e pode ser que o cliente tenha
acesso apenas pelo Edi7WebCli e não pelo site.
20
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
O programa Edi7WebCli deve ser chamado através da seguinte linha de comando (Linux):
$ cd /home/edi7/EDI7WebCli/bin
$ java –cp Edi7WebCli.jar webclicfg.Edi7WebCli.Main –cEMPRESA –p001 –tP
Ou (Windows):
C:>cd \Edi7\EDI7WebCli\bin
C:\Edi7\EDI7WebCli\bin>java –cp Edi7WebCli.jar webclicfg.Edi7WebCli.Main –cEMPRESA –p001 –tP
Onde a primeira chave (-cp) é um parâmetro do próprio Java e as demais são passadas para o Edi7WebCli.
-cp : indica o caminho onde está instalado o Edi7WebCli.jar. Caso EDI7WebCli/bin esteja no
$CLASSPATH do usuário, este parâmetro torna-se desnecessário.
-c : código do Cliente.
-p : código do Produto.
-t : tipo do Cliente (P-rodução ou T-este).
Obs. O Java é “case-sensitive” (mesmo no Windows) e portanto a diferenciação entre as letras maiúsculas
e minúsculas deve ser observada.
21
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
4.3. LOG
Para cada Cliente/Produto usado, o Edi7WebCli criará um arquivo de log diferente no sub-diretório “log”.
O nome do arquivo tem o formato: “EMPRESA-PPP-T.log”, onde:
• EMPRESA = código do cliente EDI7.
• PPP = código do produto.
• T = tipo, T – Teste ou P – Produção.
Este log é diário, ou seja, para cada dia é gerado um arquivo com este nome. Os arquivos anteriores são
salvos com o seguinte nome: “EMPRESA-PPP-T.log.aaaa-mm-dd”.
Entre colchetes aparece a data e hora da ocorrência, com precisão de milissegundos, e o IP do processo. Em
seguida a categoria da mensagem, que pode ser
22
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
No menu, selecione “Action” e em seguida “Create Task” para acessar a janela abaixo:
23
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
Dê um nome para a tarefa e escolha o usuário e grupo, além de indicar se a tarefa deve ser executada mesmo
que os usuário não esteja logado.
Clique na aba “Triggers” para configurar quando a tarefa deve ser executada. Na janela abaixo, clique no
botão “New...”.
24
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
Na janela seguinte, escolha a frequência e repetição da tarefa. Para obter maiores informações ou ajuda,
tecle “F1”.
25
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
26
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
Clique no botão “Browse...” para selecionar o script batch gerado pelo Configurador (EMPRESA-001-
P.bat). No campo “Start in”, digite o caminho onde está instalado o programa Edi7WebCli.jar. Por exemplo:
27
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
Clique no botão “OK” para salvar e na janela seguinte, clique em “OK” novamente.
28
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
6. MENSAGENS DE ERRO
A seguir são mostradas algumas mensagens de erro geradas pelo programa Edi7WebCli no arquivo de log,
suas possíveis causas e soluções.
Recomenda-se que este log seja monitorado para a verificação e correção de eventuais erros.
Para acessar o suporte técnico do Banco, enviar email para [email protected].
29
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
30
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
Solução: acessar o sistema Edi7 pelo browser (IE) para trocar a senha de acesso.
31
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
Solução: a transmissão de arquivos ao banco está bloqueada nesta data. Entre em contato com o suporte
técnico do Banco.
Modo inválido. Use Modo Especial para arquivos criptografados.
Solução: o arquivo enviado está criptografado ou compactado. É necessário indicar o modo “Arquivo
Especial” no configurador do Edi7WebCli.
Modo inválido. Sem permissão para transferir Arquivos Especiais.
Solução: o cliente não tem permissão para transmitir Arquivos Especiais (compactados ou
criptografados). Entre em contato com o suporte técnico do Banco.
32
Manual do EDI7WebCli v1051.docx
EDI7 – Sistema de Transferência de Arquivos
33
Manual do EDI7WebCli v1051.docx
TODOS OS DIREITOS RESERVADOS E PROTEGIDOS PELA LEI 9610 DE 19/02/1998
Nenhuma parte desta publicação pode ser reproduzida, transcrita, arquivada em sistema recuperável eletrônico, traduzido
para qualquer idioma ou linguagem de computador, ou ser transmitido em qualquer outra forma sem prévio consentimento.
Este manual é propriedade da SEVENCOMm, a qual se reserva o direito de introduzir inovações no produto descrito, assim
como de revisar esta publicação em qualquer tempo e sem notificar qualquer pessoa sobre a revisão ou alteração.
COMENTÁRIOS DO USUÁRIO
A SEVENCOMm agradece qualquer forma de comentário do usuário relativo ao manual ou mesmo ao produto, sob forma
de críticas, correções ou sugestões. Tais comentários representam uma parte importante no seu processo de revisão.
SEVENCOMm
www.7comm.com.br
[email protected]