...

Deck of Cards

effectDuration	0.5
id	cabecalho
effectType	slide

Card

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

Deck of Cards

effectDuration	0.5
id	vertentes

Card

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

Column

width	80%

Propósito

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

Aviso
Está é uma ferramenta para benefício das equipes de suporte ou desenvolvimento. Esta solução NÃO é para geração deAlias 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

Card

effectDuration	0.5
id	funcionalidades-interfaces
label	Funcionalidades e Interfaces
title	Funcionalidades e Interfaces

Deck of Cards

effectDuration	0.5
id	aplicacao

Card

effectDuration	0.5
id	acesso
label	Acesso
title	Acesso

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

Card

effectDuration	0.5
id	novo-usuario
label	Novo Usuário
title	Novo Usuário

Solicitando Nova Credencial

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

Painel

Card

effectDuration	0.5
id	recuperar-senha
label	Recuperar Senha
title	Recuperar Senha

Resgatar Palavra Chave

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

Painel

Card

effectDuration	0.5
id	conexao-server
label	Conexão com o Server
title	Conexão com o Server

Conectar Protheus

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

Painel

Card

effectDuration	0.5
id	escolher-aplicativo
label	Escolher aplicativo
title	Escolher aplicativo

Conectando App no Rest

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

Painel

Card

effectDuration	0.5
id	alias-gerado
label	Alias Gerado
title	alias-gerado

Recebendo o Alias

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

Painel

Card

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

Deck of Cards

startHidden	false
effectDuration	0.5
id	desenvolvimento-producao

Card

id	projeto
label	Projeto
title	Projeto

Deck of Cards

effectDuration	0.5
id	documentos-tecnicos

Card

id	caso-uso
label	Caso de Uso
title	Caso de Uso

Card

id	fluxo-usuario
label	Fluxo do Usuário
title	Fluxo do Usuário

Image Added

Card

effectDuration	0.5
id	modelo-conceitual-logico
label	Modelo Conceitual e Lógico
title	Modelo 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

title	Modelo Conceitual

Painel

title	Modelo Lógico

Card

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

Deck of Cards

effectDuration	0.5
id	ambiente-producao

Card

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

Deck of Cards

effectDuration	0.5
id	database

Card

effectDuration	0.5
id	criando-ambiente-sql
label	Criando o Ambiente SQL
title	Criando o Ambiente SQL

Persistência de Dados

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

Bloco de código

language	sql
theme	Confluence
firstline	1
title	Criando 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()
)

Card

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

Painel

title	Acessando as tabelas

Card

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.

Painel

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

Card

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:

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

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	provisionamento-aplicação
label	Provisionamento da Aplicação
title	Provisionamento da Aplicação

Deck of Cards

effectDuration	0.5
id	Acessos

Card

effectDuration	0.5
id	painel-acesso
label	Painel de Acesso
title	Painel 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:

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

Painel

Card

effectDuration	0.5
id	deploy-restart-aplicacoes
label	Deploy e Restart das Aplicações
title	Deploy 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

Card

effectDuration	0.5
id	desenvolvimento
label	Desenvolvimento
title	Desenvolvimento

Deck of Cards

startHidden	false
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

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

Instale o banco de dados Postgree.

Card

effectDuration	0.5
id	aponte-local
label	Aponte para Local
title	Aponte para Local

Deck of Cards

effectDuration	0.5
id	arquivos

Card

effectDuration	0.5
id	frontend
label	Frontend
title	Frontend

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/environments

Card

effectDuration	0.5
id	backend
label	Backend
title	Backend

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.

Card

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

Card

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

Column

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/

Expandir

title	Documentação dos Aplicativos Móveis

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

Expandir

title	Configurar REST

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

Expandir

title	Aplicativos na Web

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

Expandir

title	Criar Alias pelo Assistente de Configuração Mobile

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

...

Árvore de páginas

Versões comparadas

Versão antiga 141

Nova versão 142

Chave

Propósito

Primeiro Login

Solicitando Nova Credencial

Resgatar Palavra Chave

Conectar Protheus

Conectando App no Rest

Recebendo o Alias

Diagramas

Persistência de Dados

Conexão em Produção

Permissões de Usuários

Serviço de E-mails

Gestão com Rancher

Administrando Containers

Clone dos Projetos

Configurar Máquina

Alterando arquivos

Perguntas frequentes (FAQs)

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 141

Nova versão 142

Chave

Propósito

Primeiro Login

Solicitando Nova Credencial

Resgatar Palavra Chave

Conectar Protheus

Conectando App no Rest

Recebendo o Alias

Diagramas

Persistência de Dados

Conexão em Produção

Permissões de Usuários

Serviço de E-mails

Gestão com Rancher

Administrando Containers

Clone dos Projetos

Configurar Máquina

Alterando arquivos

Perguntas frequentes (FAQs)