Upload
buidien
View
260
Download
2
Embed Size (px)
Citation preview
Manual do Usuário
2
Sumário
Login
Versão Desktop
Versão do aplicativo
Caixas Postais do usuário
Log da aplicação
Ajuda
Exibir Configurações
Limpar Log
Atualizar
Barra de progresso
Sincronizar
Atualização do aplicativo
Configurações
Autenticação
Proxy
Sincronização de arquivos
Sincronização automática (agendador de tarefas)
Listagem de possíveis erros que o aplicativo possa exibir
Versão Web
Componentes da tela:
Atualizar
Recepcionar Arquivos
Download Individual
Progresso do download (Individual)
Progresso do download (Completo)
Adicionar Arquivos
Botão Remover
Caixa Postal de Destino
Progresso do Upload (Individual)
Progresso do Upload (Completo)
Cancelar Upload
Remover Todos
Transmitir Arquivos
Manual do Usuário
3
Login
Ao acessar o FastWeb no navegador (https://fastweb.finnet.com.br) o usuário será
direcionado para a página de login abaixo, onde deverá inserir seus dados de acesso.
O usuário (cliente) deverá informar seu usuário e senha e clicar no botão "Entrar" para
acessar o sistema. Caso o usuário e senha sejam informados incorretamente será exibida
uma mensagem ao usuário, conforme imagem abaixo.
Fazendo o login corretamente o usuário será redirecionado para a tela principal (vide
imagem abaixo), e poderá decidir por qual versão do FastWeb ele deseja realizar o
envio/recepção dos arquivos: "Versão Web" ou "Versão Desktop".
Manual do Usuário
4
Versão Desktop
Quando o usuário clicar no botão "Versão Desktop" caso ele esteja usando o navegador
Google Chrome, será feito o download do arquivo " fastweb.jnlp" e ele poderá executar o
arquivo manualmente para iniciar a aplicação, caso ele esteja usando outro navegador que
suporte a execução de aplicações Java, a aplicação será iniciada automaticamente.
No primeiro acesso pode ser solicitada a permissão para execução do aplicativo
(semelhante a tela abaixo), basta marcar a caixa de seleção "Não mostrar novamente para
aplicativos do editor e local acima" e clicar no botão "Executar".
Manual do Usuário
5
No primeiro acesso aparecera a tela para digitar o Usuário e Senha de acesso, o mesmo
utilizado no acesso ao Portal.
Obs: O usuário precisa ter a máquina virtual do Java previamente instalada. Caso contrário
o sistema operacional pode questioná-lo sobre qual aplicação utilizar para executar o
aplicativo. Nesse caso é necessário acessar o site da Oracle, fazer o download e a
instalação. (segue link https://www.java.com/pt_BR/download/)
Após esse momento o usuário pode utilizar o próprio arquivo "fastweb.jnlp" que foi baixado
para acessar o aplicativo Desktop, sem a necessidade de abrir o site.
Após o primeiro acesso no aplicativo desktop, será criado um arquivo com o nome
"config.cfg" na pasta "home" “C:\Users\nomedousuario\.fastweb\config.cfg” do usuário para
armazenar as configurações do aplicativo.
Manual do Usuário
6
Após a inicialização do aplicativo, será exibida a tela principal do aplicativo (imagem
abaixo).
As indicações em vermelho indicam os componentes da tela que serão detalhados abaixo.
1. Versão do aplicativo
Detalhes sobre a versão do aplicativo, texto apenas informativo. Sempre que necessário
contatar o suporte é importante informar o valor descrito nesse campo para facilitar o
atendimento.
2. Caixas Postais do usuário
Essa caixa a esquerda do aplicativo lista em formato de árvore, as caixas postais do
usuário, abaixo os blocos de "Remessa" e "Retorno" com suas respectivas pastas e
expressões regulares, conforme configuração no FileTransfer (instalação).
3. Log da aplicação
A caixa a direita exibe o log de execução das sincronizações, sempre que é feita uma
sincronização o passo a passo da transferência dos arquivos é exibido para que o usuário
possa acompanhar.
Manual do Usuário
7
4. Ajuda
Esse botão pode ser utilizado pelo usuário para acessar a tela de "Ajuda", que apresenta as
perguntas mais frequentes e logo abaixo os telefones e o e-mail do departamento de
suporte da Finnet, conforme imagem abaixo.
5. Exibir Configurações
Esse botão permite ao usuário acessar a tela de configurações e fazer modificações do
usuário e senha utilizados para fazer login, e das configurações de proxy. Mais detalhes no
capítulo Configurações.
6. Limpar Log
Esse botão faz a limpeza do campo logo abaixo dele. Pode ser utilizado após várias
sincronizações para facilitar a leitura do log e acompanhar o progresso da transferência dos
arquivos.
Manual do Usuário
8
7. Atualizar
Botão utilizado para recarregar as informações de caixas postais, configurações de pastas e
expressões regulares do usuário. Deve ser utilizado sempre que forem realizadas
modificações no FileTransfer.
8. Barra de progresso
Barra que exibe o progresso de envio ou recepção de cada arquivo. É utilizada para
visualizar de forma simplificada o envio das partes do arquivo, sem precisar ler o log.
9. Sincronizar
Esse botão dispara a sincronização dos arquivos, tanto envio quanto recepção. Antes de
dispará-lo, é importante verificar se todos os arquivos já estão em suas devidas pastas para
evitar que algum deixe de ser enviado. Mais detalhes no capítulo Sincronização de
Arquivos.
Atualização do aplicativo
Sempre que o aplicativo é executado, ele faz uma consulta aos servidores da Finnet e caso
exista uma nova versão do aplicativo, ela é baixada e executada logo em seguida. Caso
seja necessário forçar uma atualização é possível efetuar a limpeza do cache das
aplicações Java no painel de controle do Java.
No Windows, ele pode ser encontrado no "Painel de controle" do sistema operacional >
"Programas" > "Java". Após aberto, basta clicar no botão "Definições", na tela que será
exibida, clicar no botão "Excluir Arquivos", selecionar a caixa "Aplicativos e Applets
Instalados" e clicar no botão "OK". Feito isso, os arquivos antigos da aplicação serão
removidos e baixados novamente.
Manual do Usuário
9
Configurações
A tela de configuração do aplicativo é composta por dois grupos de campos, "Autenticação"
e "Proxy", descritos abaixo:
Autenticação
Os campos de usuário e senha armazenam a configuração atual do usuário e podem ser
modificados conforme a necessidade. Essa informação é utilizada para comunicação com
os servidores da Finnet, portanto, evite modificações desnecessárias. Modificar a
autenticação do aplicativo só tem efeito após clicar no botão "Salvar", que faz o registro das
informações no arquivo chamado ".fastweb" na pasta "home" do usuário.
Se as informações forem modificadas e o usuário clicar no botão "Cancelar" as
modificações não serão aplicadas.
O usuário pode utilizar o botão "Validar" para verificar se as informações inseridas estão
corretas, antes de salvar.
As configurações do usuário são salvas no arquivo ".fastweb", na pasta "home" do usuário
com criptografia para evitar que pessoas desautorizadas tenham acesso às informações de
configuração do aplicativo.
Caso seja modificado o usuário ou a senha no servidor, ao tentar abrir o aplicativo
novamente será exibida a tela abaixo para que o usuário possa inserir os novos dados.
Manual do Usuário
10
Proxy
O usuário pode selecionar qual tipo de proxy vai utilizar ou se não será utilizado nenhum
proxy, selecionando um dos campos, conforme imagem abaixo.
Caso ele selecione a primeira opção, nenhuma informação de proxy será adicionada
durante a comunicação com os servidores da Finnet. Se ele marcar a opção "Usar
configurações do sistema", serão utilizadas as mesmas configurações de proxy do sistema
operacional. E por último, caso ele selecione a opção "Configuração manual", ele poderá
informar nos campos abaixo: Endereço, Porta, Usuário e Senha; os dados desejados para a
comunicação.
Sincronização de arquivos
Ao clicar no botão "Sincronizar", o aplicativo inicia o processo de sincronização dos
arquivos. O primeiro passo da sincronização é o envio dos arquivos disponíveis nas pastas
listadas na configuração, com as devidas expressões regulares.
Nesse momento é criada uma pasta chamada "PENDENTE", para onde o aplicativo
transfere os arquivos no momento da transmissão, faz a compressão caso essa opção
tenha sido configurada na primeira instalação do cliente, em seguida avalia o tamanho do
arquivo como tamanho máximo configurado para a transferência e só então inicia a
transferência para o servidor. Todos esses passos podem ser acompanhados na tela de log
(a direita).
Ao final da transferência, caso a mesma tenha ocorrido com sucesso, o aplicativo exclui o
arquivo da pasta PENDENTE e move o arquivo original para uma pasta com a data do dia,
localizada no mesmo nível do arquivo e dentro de uma outra pasta chamada BACKUP
(conforme imagem abaixo).
Manual do Usuário
11
Estando concluído o processo de envio dos arquivos, o aplicativo inicia a recepção dos
arquivos disponíveis no servidor. O aplicativo inicia o processo de recepção buscando a
listagem de todos os arquivos disponíveis na pasta de saída da caixa postal do usuário e,
que estiverem de acordo com a expressão regular configurada. Feito isso, dentro da pasta
de ENTRADA configurada na máquina do usuário é criada uma pasta RESTART, onde é
armazenado o arquivo enquanto o download é realizado. Após o download do arquivo
completo ele é então movido para a pasta de destino e removido da pasta RESTART.
Sincronização automática (agendador de tarefas)
A sincronização automática pode ser agendada para executar em segundo plano. Abaixo
está o comando a ser executado para que a sincronização seja executada. Ele pode ser
configurado no agendador de tarefas do Windows ou do crontab no Linux ou equivalente em
outros sistemas operacionais.
javaws -Xnosplash -open segundoPlano
https://fastweb.finnet.com.br/out/download-jnlp
É importante ressaltar que esse comando não faz a atualização automática do aplicativo, portanto, sempre que houver atualização do aplicativo será necessária a intervenção do usuário, executando o comando abaixo.
javaws -uninstall https://fastweb.finnet.com.br/out/download-jnlp
Listagem de possíveis erros que o aplicativo possa exibir
Cód. Erro Mensagem
10 Caixa postal %s - Ocorreu um erro na listagem dos arquivos
11 Arquivo %s - Ocorreu um erro ao criar o backup do arquivo no servidor
12 Arquivo %s - Ocorreu um erro no download da parte %s
13 Arquivo %s - Ocorreu um erro ao atualizar a listagem no servidor
14 Arquivo %s - Ocorreu um erro ao tentar remover o arquivo do servidor
15 Arquivo %s - Ocorreu um erro ao tentar salvar a configuração
16 Arquivo %s - Não foi possível baixar a parte %s do arquivo, download interrompido
17 Arquivo %s - Erro ao tentar remover a configuração
21 A pasta %s está configurada para duas ou mais caixas postais.
22 A pasta %s não tem permissão de escrita
23 Arquivo %s - Já baixado
Manual do Usuário
12
24 Arquivo %s - Corrompido no download
25 Arquivo %s - Erro ao descompactar
26 Arquivo %s - Erro ao mover para a pasta de ENTRADA, Hash incorreto
27 Arquivo %s - Erro ao mover para a pasta de ENTRADA
28 Arquivo %s - Erro ao escrever na pasta RESTART
29 Arquivo %s - Erro ao criar arquivo temporário
30 Arquivo %s - Erro ao criar arquivo .CONF
31 Arquivo %s - Erro ao criar pasta RESTART
32 Arquivo %s - Erro ao realizar a validação
33 Arquivo %s - Erro ao excluir
52 Configurações de usuário/caixas postais não encontradas
53 Ocorreu um erro ao preencher a configuração
54 Ocorreu um erro ao tentar realizar o login
61 Diretório %s - O diretório não tem permissão de leitura
62 Diretório %s - Erro ao tentar ler os arquivos
63 Diretório %s - Não foi possível criar o diretório
64 Arquivo %s - Ocorreu um erro ao tentar copiar o arquivo para a pasta PENDENTE
65 Arquivo %s - Erro durante a compactação
67 Arquivo %s - Erro ao tentar calcular as partes
68 Arquivo %s - Erro ao tentar calcular o tamanho
68 Arquivo %s - Erro ao tentar calcular o hash
69 Arquivo %s - Ocorreu um erro ao enviar o hash do arquivo
70 Arquivo %s - Ocorreu um erro ao enviar o arquivo .CONF para o servidor
71 Arquivo %s - Erro ao tentar ler a parte %s
72 Arquivo %s - Ocorreu um erro ao criar a pasta de backup
73 Arquivo %s - Erro ao tentar excluir
74 Arquivo %s - Ocorreu um erro ao tentar mover para a pasta de backup
76 Arquivo %s - Arquivo já existe no servidor
77 Arquivo %s - Não foi possível enviar a parte %s e o envio deste arquivo foi interrompido
78 Arquivo %s - Ocorreu um erro ao tentar criar o arquivo .CONF
79 A pasta %s não existe e é necessária para a sincronização
80 A pasta %s não existe e é necessária para a sincronização
81 Arquivo %s - Erro ao tentar baixar parte
82 Arquivo %s - Ocorreu um erro ao atualizar a listagem no servidor
83 Arquivo %s - Ocorreu um erro ao tentar remover o arquivo do servidor
84 Caixa postal %s - Ocorreu um erro na listagem dos arquivos
85 Arquivo %s - Ocorreu um erro ao criar o backup do arquivo no servidor
86 Arquivo %s - Arquivo já existe no servidor
87 Arquivo %s - Ocorreu um erro ao remover o arquivo CONF
88 Arquivo %s - Ocorreu um erro ao enviar o arquivo .CONF para o servidor
89 Arquivo %s - Ocorreu um erro ao enviar o hash do arquivo
Manual do Usuário
13
90 Arquivo %s - Ocorreu um erro ao renomear o arquivo .TEMP
91 Arquivo %s - Ocorreu um erro ao remover o arquivo CONF
92 Arquivo %s - Ocorreu um erro durante o envio (Web)
93 Arquivo %s - Ocorreu um erro ao tentar carregar o arquivo de configuração
94 Ocorreu um problema ao tentar carregar as configurações
95 Regex '%s' - Ocorreu um erro ao tentar compilar a expressão regular
Manual do Usuário
14
Versão Web
Ao clicar no botão "Versão Web" o usuário será redirecionado para a página principal da
aplicação web, conforme imagem abaixo. Essa versão é executada apenas no navegador,
por esse motivo ela não necessita de instalação de módulos adicionais por parte do usuário,
porém ela é mais simples e não possui algumas funcionalidades, como o acesso as pastas
da máquina do usuário. Diferentemente do aplicativo desktop, o envio e recepção na versão
web é realizado de maneira separada, pois ambos dependem da interação do usuário
conforme descrito abaixo.
Componentes da tela:
1. Atualizar
Botão utilizado para recarregar a lista de arquivos disponíveis no servidor para recepção e,
para carregar as configurações de caixa postal do usuário.
2. Recepcionar Arquivos
Botão que inicia o processo de recepção dos arquivos do servidor para a máquina do
usuário. O download é feito individualmente, arquivo por arquivo, e salvo na pasta de
download padrão do usuário, e a partir de lá ele pode movê-lo para onde desejar.
3. Download Individual
Esse botão permite que o usuário faça o processo de recepção do arquivo para apenas um
ou outro arquivo que ele tenha interesse em recepcionar.
Manual do Usuário
15
4. Progresso do download (Individual)
Barra de progresso que exibe o progresso do download de cada arquivo, permitindo que o
usuário verifique em que passo está o processo de recepção.
5. Progresso do download (Completo)
Barra de progresso que indica o progresso total do processo de recepção de arquivos.
6. Adicionar Arquivos
Botão utilizado para selecionar arquivos da máquina do usuário e colocá-los na fila para
envio. O usuário pode selecionar vários arquivos de uma só vez e adicionar a lista. No
entanto, quando ele clicar no botão "Transmitir Arquivos" o aplicativo fará a validação das
expressões regulares referentes a caixa postal de destino e pode informar ao usuário que
determinados arquivos não serão enviados por não estarem de acordo com as expressões
regulares.
7. Botão Remover
Esse botão pode ser utilizado pelo usuário para remover arquivos que ele adicionou a fila,
mas que ele não deseja mais enviar ao servidor.
8. Caixa Postal de Destino
Antes de clicar no botão "Transmitir Arquivos" o usuário deve conferir e/ou selecionar a
caixa postal para o qual ele deseja enviar os arquivos da fila.
9. Progresso do Upload (Individual)
Barra de progresso que indica ao usuário qual o progresso do envio de cada arquivo para o
servidor.
10. Progresso do Upload (Completo)
Barra de progresso que exibe para o usuário qual é o progresso total do envio dos arquivos
para o servidor. Permitindo que ele acompanhe o progresso como um todo.
11. Cancelar Upload
Botão utilizado para cancelar o processo de upload de arquivos e interromper a
transmissão. Esse botão só é habilitado após a transmissão ter sido iniciada.
12. Remover Todos
O usuário pode utilizar esse botão para realizar a remoção de todos os arquivos que ele
tenha adicionado a fila.
13. Transmitir Arquivos
O usuário deve clicar nesse botão após adicionar os arquivos que ele deseja enviar para o
servidor na fila (exibida acima do botão). Ao clicar no botão o aplicativo inicia o envio dos
arquivos, 1 a 1, para a caixa postal definida na caixa de seleção e vai exibindo o progresso
nas respectivas barras. Diferentemente do aplicativo desktop, os arquivos da máquina do