Guia Prático para importação de Mensagens do Gears para o MAilArchiver
Import Gears O que é o Import Gears? Trata-se de um utilitário acessório que faz parte da solução MailArchiver: sua finalidade é realizar a migração dos dados armazenados em arquivamentos locais no padrão Google Gears para o novo modelo. Sua disponibilidade está no contexto do console de administração do MailArchiver, sendo executado nativamente no ambiente web (em um navegador de internet). Como eu utilizo a ferramenta? É necessário realizar a autenticação junto ao console de administração do MailArchiver, através da URL padrão, conforme o protocolo adequado e em uso no ambiente Expresso do usuário: https://127.0.0.1:4334/admin http://127.0.0.1:4333/admin IMPORTANTE: os parâmetros utilizados acima correspondem aos valores padrões das portas HTTP e HTTPS da solução. Caso estes dados tenham sido modificados, deve-se conferir no arquivo de definições config.ini do MailArchiver os dados correspondentes. Ao acessar o endereço, será solicitado o nome de usuário/senha de acesso ao ambiente Expresso em uso pelo usuário (definido na seção Authentication do arquivo config.ini - valor padrão é o ambiente Expresso SERPRO de produção). O usuário deverá logar utilizando os mesmos dados que usa no Expresso, sendo que este evento de logon somente irá ocorrer após o logon junto ao Expresso. Por esta razão, inicialmente é recomendado antes de efetuar a importação, realizar o login no Expresso.
Uma vez logado, o usuário deverá invocar o recurso disponível na interface gráfica para lançar o assistente de importação, conforme a sequencia a seguir. Usando o assistente, passo a passo 1. Invocar o assistente de importação: no menu superior da interface gráfica, corresponde ao primeiro ícone da esquerda para a direita, identificado como Gears. Na parte inferior, há um elemento gráfico com a descrição Executar Importação Gears. Ao acionar este atalho, uma janela irá surgir dentro do contexto na interface gráfica do usuário, onde todos os dados e informações referentes ao assistente de importação estarão vinculados.
2. Iniciar o processo de importação: clicar no elemento gráfico com a descrição Avançar para inicializar o procedimento. 3. Confirmar os dados de logon junto à estação de trabalho: antes de seguir o procedimento da importação, se faz necessário validar o perfil do usuário que está utilizando o assistente de importação (uma vez que a solução anterior utiliza esta informação para armazenar localmente a sua estrutura de dados). Nesta etapa, o usuário logado na estação de trabalho, deverá confirmar as suas credenciais, informando o nome da conta de usuário e a senha de logon junto a estação de trabalho.
4. Selecionar os arquivamentos identificados na estação de trabalho para importar: nesta primeira etapa, o utilitário irá pesquisar, na estação de trabalho em uso, os arquivamentos locais candidatos que satisfazem os critérios de identificação da solução Google Gears. Aqueles que se desejar migrar deverão ser marcados para dar sequência à próxima etapa. 5. Aguardar a filtragem inicial de mensagens elencadas: das mensagens que estão armazenadas na estrutura do Gears, somente serão importadas aquelas que se encontar/dispor do código fonte da mensagem (original da mensagem, em formato de mensagem de e-mail em texto puro padrão eml ).
6. Efetuar a importação: depois de concluída a pré-carga de mensagens válidas, o processo de importação se efetiva neste momento. 7. Processo concluído: ao final da importação das menagens, o assistente encerra seus trabalhos.
Mensagens de erro e log Na eventualidade de situações particulares, as seguintes mensagens poderão ter repassadas interface gráfica do Import Gears, comunicando inconsistências, ou invalidades computadas: na 1. Inexistência de arquivamento local no padrão Google Gears Caso não hajam arquivamentos válidos para importação, na segunda tela do assistente esta informação será repassada ao usuário, comunicando da impossibilidade de execução do processo. 2. Importação a partir de endereços previamente habilitados pelo Gears, mas não mais vigentes Pode ocorrer a situação de que, para usuários que utilizavam o Gears para acessar distintos ambientes (entenda-se, servidor alocado em domínio diferente), alguns destes tenham sido bloqueados/desativados para o armazenamento local por ação do próprio usuário. Nestes casos, estas origens de dados que não estão ativas, não serão analisados para o procedimento da importação. 3. Mensagem arquivada no Google Gears sem fonte de mensagem existente É de conhecimento da equipe de desenvolvimento e de suporte que, em casos específicos, existe a possibilidade de existirem mensagens locais arquivadas na estrutura Google Gears mas que, por razões infortúnias, acabaram por não persistir o fonte da mensagem armazenado em disco. Isto gera uma inconsistência e falha de funcionamento na leitura das mensagens, pois anexos e quaisquer objetos que componham a mensagem podem não estar presentes na estação de trabalho do usuário. Por esta razão, a ferramenta de importação desconsidera estas mensagens, adicionando-as em um arquivo de log (armazenado na pasta raiz do diretório do usuário) com a identificação no formato user_log_dd.mm.aa.hh.mm.ss.log, onde: DD = dia MM = mês AA = ano hh = hora mm = minutos
ss = segundos Tendo-se como referência, o momento da execução do Import Gears. Em seu conteudo, o log conterá a identificação da pasta (folder name) e o título (subject) da mensagem de e-mail que apresenta esta inconsistência. Isto facilitará a identificação e comprovação do cenário pela equipe de suporte e/ou usuário.