Manual do Usuário

1

Finnet FastWeb 2.0

Manual do usuário

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

Manual do Usuário

16

usuário permanecem intactos e nenhuma ação é realizada, exceto a leitura e o envio para o

servidor.