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

...

effectDuration	0.5
id	cabecalho
effectType	slide

...

default	true
effectDuration	0.5
id	applinker
label	AppLinker
title	Applinker
effectType	slide

...

effectDuration	0.5
id	vertentes

...

id	introducao
label	Introdução
title	Introdução

...

width	80%

Propósito

O AppLinker é uma ferramenta

...

Aviso
Está é uma ferramenta para benefício das equipes de suporte ou desenvolvimento. Esta solução NÃO é para gerar Alias para ambientes externos, apenas para fins internos.

Determinados aplicativos necessitam 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

...

effectDuration	0.5
id	producao
label	Produção
title	Produção

...

effectDuration	0.5
id	documentacao-tecnica
label	Documentação Técnica
title	Documentação Técnica

...

id	documentacao-tecnica

...

effectDuration	0.5
id	configuracao-instrucoes-tecnicas
label	Configuração e Instruções Técnicas
title	Configuração e Instruções Técnicas

...

effectDuration	0.5
id	configuracao-tecnica

Card

effectDuration	0.5
id	instalacao
label	Instalação
title	Instalação

Clone dos Projetos

O AppLinker possui dois repositórios.

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

Aviso

É 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:

Expandir

title	Frontend

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

Expandir

title	Backend

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

Card

effectDuration	0.5
id	ambiente-desenvolvimento
label	Ambiente de Desenvolvimento
title	Ambiente de Desenvolvimento

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:

Node

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

Instale o banco de dados Postgree.

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

Aviso

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.

Aviso
Todas as requisições são feitas para ambiente de produção. Altere os arquivos que apontam para o ambiente de produção para que eles sejam direcionadas para localhost. AppLinkerClient/app/src/environmentsImage Removed

...

effectDuration	0.5
id	banco-dados
label	Banco de Dados
title	Banco de Dados

...

effectDuration	0.5
id	database

...

effectDuration	0.5
id	acesso
label	Acesso
title	Acesso

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

...

title	Acessando as tabelas

Image Removed

...

effectDuration	0.5
id	usuarios
label	Usuários
title	Usuários

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.

...

Image Removed

Aviso
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';

...

effectDuration	0.5
id	administracao-usuarios
label	Administração de Usuários
title	Administração de Usuários

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:

que permite a integração entre os Aplicativos móveis da linha Backoffice e o Protheus local do usuário, e também permite a visualização de LOGS para fins de suporte.

Observação: O AppLinker deve ser utilizado somente para fins de demonstrações e suporte.

Para utilizar, acesse https://applinker.engpro.totvs.com.br/

Para efetuar o login é necessário ter um usuário cadastrado e aprovado.

Caso não possua um usuário basta cadastrar clicando no botão NOVO REGISTRO

Image Added

Nota

title	IMPORTANTE

O modelo de autenticação foi alterado a partir do dia 06/11/2020, sendo necessário fazer um novo cadastro para utilização do APPLINKER.

Preencher os campos solicitados e clicar no botão CADASTRAR

Image Added

O cadastro será realizado e ficará PENDENTE aprovação, o processo de aprovação pode levar até 24 horas, em caso de dúvidas entrar em contato com e-mail [email protected]

Image Added

Após receber o e-mail do cadastro aprovado o seu usuário está pronto para uso.

Image Added

Para a geração de um ALIAS temporário seguir os passos abaixo:

1 - REST PROTHEUS

Preencher as informações de configuração do REST de seu Protheus local.

Porta - Porta que o REST está configurado.

URL - path onde o REST irá subir

Image Added

Os campos acima devem ser preenchidos de acordo com o seu appserver.ini,

exemplo:

Image Added

Para mais informações sobre o como configurar o REST.
acesse: https://tdn.totvs.com/x/fEn6Hg

2 - APP Linker

Após clicar em conectar, se a conexão for bem sucedida você será redirecionado a seguinte pagina.

Nesta pagina será necessário escolher o APP que serão realizado os testes.
De acordo com o APP selecionado, exibirá campos personalizados, como por exemplo, empresa e filial, que são campos
obrigatórios.

Image Added

Nota

title	IMPORTANTE

Por meio desta ferramenta (APPLINKER) o uso do aplicativo Meu Protheus NÃO É COMPATÍVEL com a funcionalidade de NOTIFICAÇÕES. Para tal, deve ser criado um ALIAS através do Mingle (https://tdn.totvs.com/x/b_ITEQ).

Na escolha do APP MINHA PRESTAÇÃO DE CONTAS, exibirá os campos disponíveis para serem preenchidos, no caso,
empresa e filial.

Image Added

Possuindo tudo configurado, aperte o botão "Conectar".

3- START

Será apresentando a seguinte tela, onde exibirá o ALIAS, que será: APP + seu email.

Nota

title	IMPORTANTE

Ao fechar o navegador é encerrado a conexão, sendo necessário estar com o navegador aberto enquanto estiver utilizando o ALIAS no aplicativo.

Image Added

Após as etapas, na tela do aplicativo, você utiliza o usuário e a senha do Protheus configurado no REST
e o ALIAS gerado no applinker.

Image Added

Demais documentações

Documentação

...

O processo para recuperação de senha:

Usuário informa o e-mail para recuperação de senha pelo AppLinker.
O AppLinker envia um e-mail com o link para recuperação de senha.
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.

Aviso
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.

Card

id	disponibilizacao-provisionamento-aplicação
label	Disponibilização e Provisionamento da Aplicação
title	Disponibilização e Provisionamento da Aplicação

Rancher

...

effectDuration	0.5
id	funcionalidades-interfaces
label	Funcionalidades de interfaces
title	Funcionalidades de interfaces

...

default	true
effectDuration	0.5
id	suporte
label	Suporte
title	Suporte
effectType	slide

...

Perguntas frequentes (FAQs)

Expandir

title	Acesso a ferramenta

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

Expandir

title	Solicitação do Alias pelo portal do Mingle

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

...

Aplicativos Móveis

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

...

title	Configurar REST

Documentação de aplicativos WEB (Somente para TOTVERS)

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

...

Expandir

title	Aplicativos na Web

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

...

title	Criar Alias pelo Assistente de Configuração Mobile

RXXjIg

Solicitar Alias

TOTVS Mingle https://

...

mingle.totvs.com.br/

...

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>

HTML

<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}

...

landpage/

Image Added

...

Árvore de páginas

Versões comparadas

Versão antiga 89

Nova versão Atual

Chave

Propósito

Clone dos Projetos

Configurar Máquina

Conexão em Produção

Permissões de Usuários

Serviço de E-mails

Demais documentações

Rancher

Perguntas frequentes (FAQs)

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 89

Nova versão Atual

Chave

Propósito

Clone dos Projetos

Configurar Máquina

Conexão em Produção

Permissões de Usuários

Serviço de E-mails

Demais documentações

Rancher

Perguntas frequentes (FAQs)