Breve Visão Geral

Este artigo aborda as atualizações de primeiro plano e segundo plano do menu da área de trabalho; atualização automática, publicação de conteúdo, detecção de atualização e atualização do aplicativo da Web.

Tarefas que envolvem rede são a funcionalidade principal do menu da área de trabalho. O menu da área de trabalho usa a rede com senso de cuidado e prioriza a estabilidade em detrimento da experiência do usuário para evitar sobrecarregar pontos focais, como servidores proxy.

Conteúdo do WalkMe

O menu da área de trabalho exibe o conteúdo criado no CMS do WalkMe pelos construtores de conteúdo da organização.

Esse conteúdo é enviado e distribuído por meio de um arquivo JSON estático implantado no CDN do WalkMe (cdn.walkme.com). O método de entrega do menu da área de trabalho é semelhante aos produtos WalkMe Web.

No entanto, como aplicativo de desktop, ele não tem observações relacionadas ao carregamento, como o evento web "carregar".

Portanto, as verificações de publicação de conteúdo estão vinculadas ao uso do usuário; o menu da área de trabalho verificará atualizações de conteúdo como resultado de três ações realizadas pelo usuário:

1. Inicialização/Atualização do menu da área de trabalho - quando o processo é iniciado, o mecanismo do menu da área de trabalho baixa novamente o arquivo de conteúdo (também conhecido como arquivo JSON) e o exibe ao usuário.
2. Estado de primeiro plano alterado - conhecido como mudança de estado "em foco"; cada vez que o usuário final "sai" do menu da área de trabalho para outro aplicativo, que não está em um intervalo de tempo de 30 segundos desde a última visita, o mecanismo verificará se houve uma atualização ("verificar se houve uma atualização" não necessariamente prossegue com um download).

Fluxo de carregamento de atualização de conteúdo

Nem todo "check up" terminava com uma atualização real. O novo download do arquivo de conteúdo ocorrerá somente quando um novo conteúdo ou configuração for publicado pelos criadores de conteúdo.

A figura abaixo descreve como o menu da área de trabalho obtém as atualizações e decide se precisa baixar novamente o arquivo de conteúdo.

1. O menu da área de trabalho baixa o arquivo settings.txt (1,3 KB) após os eventos acima.
2. O menu da área de trabalho analisa o arquivo e compara a 'Publicação' com a cópia local do arquivo.
3. Se houver uma atualização posterior à cópia atual, o menu da área de trabalho irá para a próxima etapa.
4. Com base no estado de primeiro plano, o menu da área de trabalho escolherá a estratégia de download;
   1. Solicitar um botão de "atualização de conteúdo" para o usuário
   2. Baixar automaticamente o arquivo de conteúdo em segundo plano
5. O menu da área de trabalho baixa o arquivo de conteúdo (o tamanho geralmente é de algumas centenas de kilobytes, mas pode ser de alguns megabytes para arquivos sem manutenção).
6. Depois que o arquivo de conteúdo for baixado, o menu da área de trabalho reconstruirá o armazenamento de dados local e o conteúdo estará disponível para o usuário.

Segmentação de conteúdo

O conteúdo do WalkMe pode ser segmentado por departamento, atributos e ações do usuário. Cada condição é uma string com hash que, no caso de informações relacionadas ao usuário, é avaliada com um servidor remoto.

A avaliação é o mais consolidada possível e enviada em solicitações em lote para https://papi.walkme.com/conditions/evaluatedConditions

Aplicativo Web Desktop Menu

A interface do menu da área de trabalho é uma solução baseada na web, baseada no framework React. O aplicativo consiste em arquivos estáticos (HTML, CSS, JS) que são fornecidos pelo menu da área de trabalho CDN - workstation.walkme.com.

O tamanho do aplicativo é de 1,3 MB e tudo é fornecido compactado como gzip.

O menu da área de trabalho carrega o aplicativo da Web a cada inicialização e atualização manual pelo usuário final.

A localização do aplicativo da Web é determinada pelo arquivo settings.txt que foi baixado anteriormente no processo de inicialização.

WalkMe Analytics

O menu da área de trabalho coleta vários eventos para fornecer relatórios de uso no Insights e no Painel de Menu.

Cada evento é uma solicitação HTTPS, com alguns kilobytes de tamanho, e é enviado para ec.walkme.com.

Atualização automática do aplicativo binário do menu da área de trabalho

A partir da versão >1.00 do menu desktop baseado no Electron, um mecanismo de atualização automática está sendo instalado para atualizar os binários, também conhecido como Desktop Menu Container.

O contêiner do menu da área de trabalho é um wrapper baseado no Electron que executa tarefas de baixo nível, como compatibilidade de certificação de proxy e rede, registro de notificações push, gerenciamento de janelas e etc.

O Contêiner mantém o ciclo de vida do aplicativo da Web e gerencia o mecanismo de atualização de conteúdo do WalkMe.

O menu da área de trabalho usa Squirrel como um facilitador de atualização automática, seguindo a recomendação padrão do setor pela Electron.

1. O menu da área de trabalho sempre inicia com a versão binária mais recente disponível (consulte a seção Manutenção de Versões e Resolução de Falhas de Download abaixo)
2. Em cada inicialização, o menu da área de trabalho envia uma solicitação HTTPS para verificar se há uma versão mais atualizada do que a atual.
   • Quando o menu da área de trabalho é iniciado ou atualizado, ele verificará se há novas versões instantaneamente. Se não houver novas versões na inicialização, ele será verificado novamente quando o usuário acessar o menu da área de trabalho nas próximas 12 horas. Isso significa que uma verificação é feita uma vez a cada 12 horas se o usuário abrir a janela do aplicativo. Caso contrário, ele só será atualizado quando o aplicativo for reiniciado ou atualizado.
3. O menu da área de trabalho começará a baixar os binários e os armazenará na pasta de instalação do menu da área de trabalho.
4. Quando o download for concluído com sucesso, o menu da área de trabalho implementará uma das estratégias abaixo:
   • O menu da área de trabalho está em primeiro plano/segundo plano - o usuário será notificado sobre a atualização e será solicitado que relance o menu da área de trabalho - "Clique para atualizar"
   • O menu da área de trabalho está desativado - a próxima inicialização usará o binário mais recente.

Manutenção de versões e resolução de falhas de download

O mecanismo de atualização automática mantém duas versões binárias ao mesmo tempo para superar falhas de download.

Antes de mudar para a versão mais recente, o mecanismo de atualização automática manterá duas versões concluídas; a versão atual + anterior e a nova versão incompleta.

Após a conclusão do download, a versão de atualização automática apagará a versão anterior e manterá duas versões; atual + próxima.

Observe que a v2.1.2 foi removida do sistema de arquivos quando a v.2.3.0 foi atualizada.

Atualizações automáticas de software e privilégios administrativos do macOS

Quando uma nova atualização estiver disponível, ela será implantada automaticamente e estará pronta para atualizar o software.

Para usuários Mac sem privilégios administrativos, uma notificação pode aparecer. Essa notificação é gerada pelo sistema operacional e está além do nosso controle. No entanto, na maioria dos casos, você tem privilégios administrativos.

Ações relacionadas ao usuário

O menu da área de trabalho convida os usuários a usá-lo conectando aplicativos de terceiros, como SharePoint, Confluence, Jira e muitos outros.

Qualquer conexão está usando a rede, seja o aplicativo auto-hospedado ou um SaaS.

A conexão de aplicativos de terceiros inicia os fluxos de autenticação OAuth2.0, SMAL ou OAuth1.1 que estão usando a rede.

Depois que a conexão for estabelecida, o menu da área de trabalho solicitará ao servidor que forneça à interface conteúdo proveniente do aplicativo de terceiros. Cada aplicativo de terceiros gera pelo menos uma solicitação HTTPS sempre que o usuário traz o menu da área de trabalho para o primeiro plano.

Atividade de pesquisa corporativa

Além das atualizações automáticas acima, os usuários podem iniciar pesquisas em aplicativos de terceiros. Cada pesquisa aciona uma solicitação HTTPS que coleta os resultados dos servidores remotos.