Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Revertida da versão 40
Painel
borderColor#BAD0F0
bgColor#BADBFF
borderStylesolid

Diagrama do AppLinkerImage Removed

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 ([email protected]).

...

effectDuration0.5
idcabecalho
effectTypeslide

...

defaulttrue
effectDuration0.5
idapplinker
labelAppLinker
titleApplinker
effectTypeslide

...

effectDuration0.5
idvertentes

...

idintroducao
labelIntrodução
titleIntrodução

...

width80%

Propósito 

O AppLinker é uma ferramenta

...

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 
Card
effectDuration0.5
idfuncionalidades-interfaces
labelFuncionalidades e Interfaces
titleFuncionalidades e Interfaces
Deck of Cards
effectDuration0.5
idaplicacao
Card
effectDuration0.5
idacesso
labelAcesso
titleAcesso

Primeiro Login

Para acessar o AppLinker, é necessário ter um usuário liberado. 

Informe os dados de "Usuário" e "Senha" e clique em "Acessar sistema".

Painel

Image Removed

Card
effectDuration0.5
idnovo-usuario
labelNovo Usuário
titleNovo Usuário

Solicitando Nova Credencial

Para acessar o AppLinker, é necessário ter um usuário liberado. 

Painel

Image Removed

Card
effectDuration0.5
idrecuperar-senha
labelRecuperar Senha
titleRecuperar Senha

Resgatar Palavra Chave

Para acessar o AppLinker, é necessário ter um usuário liberado. 

Painel

Image Removed

Card
effectDuration0.5
idconexao-server
labelConexão com o Server
titleConexão com o Server

Conectar Protheus

Para acessar o AppLinker, é necessário ter um usuário liberado. 

Painel

Image Removed

Card
effectDuration0.5
idescolher-aplicativo
labelEscolher aplicativo
titleEscolher aplicativo

Conectando App no Rest

Para acessar o AppLinker, é necessário ter um usuário liberado. 

Painel

Image Removed

Card
effectDuration0.5
idalias-gerado
labelAlias Gerado
titlealias-gerado

Recebendo o Alias 

Para acessar o AppLinker, é necessário ter um usuário liberado. 

Painel

Image Removed

...

effectDuration0.5
idconfiguracao-instrucoes-tecnicas
labelConfiguração e Instruções Técnicas
titleConfiguração e Instruções Técnicas

...

startHiddenfalse
effectDuration0.5
iddesenvolvimento-producao

...

effectDuration0.5
idprodução
labelProdução
titleProdução

...

effectDuration0.5
idambiente-producao

...

effectDuration0.5
idbanco-dados
labelBanco de Dados
titleBanco de Dados

...

effectDuration0.5
iddatabase
Card
effectDuration0.5
idmodelo-conceitual-logico
labelModelo Conceitual e Lógico
titleModelo Conceitual e Lógico

Diagramas

A modelagem de dados do AppLinker é bem "simples".

É composta apenas por uma tabela de "Usuários", que guarda o "e-mail", "senha", "permissão" e "data do registro". 

Painel
titleModelo Conceitual

Image Removed

Painel
titleModelo Lógico

Image Removed

Card
effectDuration0.5
idcriando-ambiente-sql
labelCriando o Ambiente SQL
titleCriando o Ambiente SQL

Persistência de Dados

Query para a criação da tabela de usuários: 

Bloco de código
languagesql
themeConfluence
firstline1
titleCriando Tabela de Usuários
CREATE TABLE public.tb_users
(
    id integer NOT NULL DEFAULT nextval('tb_users_seq'::regclass),
    email character varying(50) COLLATE pg_catalog."default" NOT NULL,
    password character varying(50) COLLATE pg_catalog."default",
    enable boolean,
    register text COLLATE pg_catalog."default" DEFAULT now()
)

...

effectDuration0.5
idacesso
labelAcesso
titleAcesso

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 

...

titleAcessando as tabelas

Image Removed

...

effectDuration0.5
idusuarios
labelUsuários
titleUsuá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';

...

effectDuration0.5
idadministracao-usuarios
labelAdministração de Usuários
titleAdministraçã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: 

...

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

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.

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
titleIMPORTANTE

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
titleIMPORTANTE

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
titleIMPORTANTE

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

Card
idprovisionamento-aplicação
labelProvisionamento da Aplicação
titleProvisionamento da Aplicação
Deck of Cards
effectDuration0.5
idAcessos
Card
effectDuration0.5
idpainel-acesso
labelPainel de Acesso
titlePainel de Acesso

Gestão com Rancher

Rancher é uma plataforma para gestão de aplicações Docker.

Por meio do Rancher disponibilizamos e gerenciamos as aplicações Backend e Frontend do AppLinker

Para acessar os containers Docker: 

  1. Acesse o painel de administração do Rancher.
  2. Informe as credenciais de acesso. (As credenciais são seu usuário e senha de rede). 
  3. Após logado você será direcionado para página de "Clusters". Acesse o projeto clicando no cluster "engpro-eks" e em seguida "mobile".

Painel

Image Removed

Card
effectDuration0.5
iddeploy-restart-aplicacoes
labelDeploy e Restart das Aplicações
titleDeploy e Restart das Aplicações

Administrando Containers

Em alguns momentos, as aplicações ficam fora do ar ou apresentam instabilidade. 

Neste caso será necessário reiniciar as aplicações. 

Para reiniciar as aplicações selecione applinker-client e o AppLinker-server  e em seguida clique em "Redeploy". 

Painel
Image Removed

...

effectDuration0.5
iddesenvolvimento
labelDesenvolvimento
titleDesenvolvimento

...

startHiddenfalse
effectDuration0.5
idconfiguracao-tecnica
Card
effectDuration0.5
idinstalacao
labelInstalação
titleInstalaçã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
titleFrontend

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

Expandir
titleBackend

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

Card
effectDuration0.5
idambiente-desenvolvimento
labelAmbiente de Desenvolvimento
titleAmbiente 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:

Instale também um Banco de Dados para realizar testes locais. 

Instale o banco de dados Postgree.

...

effectDuration0.5
idaponte-local
labelAponte para Local
titleAponte para Local

...

effectDuration0.5
idarquivos

...

effectDuration0.5
idfrontend
labelFrontend
titleFrontend

Alterando arquivos

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

...

effectDuration0.5
idbackend
labelBackend
titleBackend
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. 

...

effectDuration0.5
idbanco-dados
labelBanco de Dados
titleBanco de Dados

...

defaulttrue
effectDuration0.5
idsuporte
labelSuporte
titleSuporte
effectTypeslide

...

Perguntas frequentes (FAQs)

Expandir
titleAcesso a ferramenta

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

Expandir
titleSolicitação do Alias pelo portal do Mingle

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

...

Aplicativos Móveis

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

Expandir
titleConfigurar REST

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


...

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

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

...

titleCriar Alias pelo Assistente de Configuração Mobile


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

...