Nesta documentação não será exibido qualquer dado sensivel sobre a aplicação. Qualquer acesso deverá ser solicitado para a equipe  Squad Mobile.

Propósito 

O AppLinker é uma ferramenta desenvolvida com o objetivo de permitir a criação de Alias para bases locais PROTHEUS. 

Está é uma ferramenta para benfeitoria das equipes de suporte ou desenvolvimento. Esta solução NÃO é para gerar Alias para ambientes de produção. 

Alguns dos nossos aplicativos precisam realizar integração com o intermediador (gateway), também conhecido como Mingle, para conexão com os servers. 

Isso se faz necessário para que a URL do servidor não fique exposta ou disponível para todos. Trazendo assim estabilidade e segurança para o ambiente. 

Os aplicativos móveis a seguir necessitam de Alias: 

  • Legal Process
  • Legal Task
  • Meu Posto de Trabalho
  • Meu Protheus
  • Minha Prestação de Contas
  • Meus Ativos Fixos 
  • Meus Contratos
  • Minha Gestão de Postos 

Clone dos Projetos 

O AppLinker possui dois repositórios.

Um contém o projeto Frontend e o outro o Backend. 

É necessário solicitar uma licença para ter acesso ao Azure.

Caso o usuário no Azure seja um StackHolder ou nem tenha login, o mesmo deve preencher o formulário de solicitação pelo link: 
https://fluig.totvs.com/portal/p/10097/pageworkflowview?processID=solicitacaoLicencasAzureDevops

Segue os links para os repositórios:

https://totvstfs.visualstudio.com/ServicesMobile/_git/AppLinker%20-%20Client

https://totvstfs.visualstudio.com/ServicesMobile/_git/AppLinker%20-%20Server

Configurar Máquina

Para subir o client e o server do Applinker em uma máquina para fins de desenvolvimento, é necessário instalar algumas dependencias.

Segue uma lista de tecnologias que devem estar presentes. 

Para subir o client: 

Para subir o server:

Você pode instalar também um Banco de Dados para realizar testes locais. 

Instale o banco de dados Postgree.

Altere as configurações para apontar para a base de dados local. 

As tabelas do banco NÃO são criadas de forma automática.

Será necessário realizar uma cópia da base de dados de produção e importar ela para a local. 

Conexão em Produção  

Para acessar a página de administração do banco de dados acesse o PGADMIN.

Acesse usando o usuário administrador do banco. 

Para encontrar a tabela vá em Servers → Applinker → Databases → Applinker → Schemas → Public → Tables → tb_users 


Permissões de Usuários

Após aberta a tabela você poderá clicar com o botão direito do mouse, clicar sobre Query Tool,  e em seguida será aberta uma tela para que possa ser criado querys SQL na tabela.  


Caso o serviço de verificação de e-mails esteja instável ou fora do ar, será necessário alterar a permissão por uma query.

O campo "enable" é que diz se o usuário têm ou não permissão para entrar no Applinker. 

Para alterar a permissão do usuário execute: 

UPDATE tb_users SET enable = true WHERE email = 'email_do_usuario@totvs.com.br';

Serviço de E-mails

O Applinker possui um mecanismo para criação de novos usuários e recuperação de senha.

O processo para criação de novos usuários se resume em: 

  1. Usuário cadastra suas informações pelo cadastro do AppLinker.
  2. O Applinker envia um e-mail de confirmação para criação do usuário. 
  3. O usuário recebe o e-mail e confirma o cadastro.

O processo para recuperação de senha: 

  1. Usuário informa o e-mail para recuperação de senha pelo AppLinker. 
  2. O AppLinker envia um e-mail com o link para recuperação de senha. 
  3. Usuário informa a nova senha e envia as alterações.

O server do AppLinker é responsável por todo esse provisionamento do serviço de e-mails. 

As informações do cadastro do serviço de e-mails com autenticação de dois fatores está no Google Cloud. 

Por motivos de segurança não será posto nenhum gif do processo para acessar as informações presentes no Google Cloud.

Para acessar as informações selecione o time "Google Play Android Developer". 

Na seção "IDs do Cliente OAuth 2.0" clique sobre "App Linker Emails".

Neste painel você terá acesso as informações presentes no server do AppLinker, no arquivo smtp.js.


Perguntas frequentes (FAQs)


https://applinker.engpro.totvs.com.br/login

https://mingle.totvs.com.br/landpage/

https://tdn.totvs.com/x/Wm9KE

https://tdn.totvs.com/x/fEn6Hg

https://tdn.totvs.com/x/RXXjIg

https://acm.engpro.totvs.com.br/index.html

<!-- esconder o menu --> <style> div.theme-default .ia-splitter #main { margin-left: 0px; } .ia-fixed-sidebar, .ia-splitter-left { display: none; } #main { padding-left: 10px; padding-right: 10px; overflow-x: hidden; } .aui-header-primary .aui-nav, .aui-page-panel { margin-left: 0px !important; } .aui-header-primary .aui-nav { margin-left: 0px !important; } </style>
<style>

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:link, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:visited, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:focus, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:hover, .aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a:active {
color: white;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after {
background: white; !important}
deck.tab.inactive.background = #e7e7e7
deck.tab.active.background = #252626