...

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

title	Tenha de Login - AppLinker

Card

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

Solicitando Nova Credencial

Para criar um novo usuário clique em "Novo Registro" em seguida informe os dados necessários de "E-mail" e "Senha".

Aviso
Para o cadastro é necessário que o usuário seja um TOTVER. Outras organizações não são permitidas.

Painel

title	Cadastro - AppLinker

Card

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

Resgatar Palavra Chave

Para recuperar as credenciais de acesso, informe o seu "E-mail", confirme no seu e-mail a troca de senha e altere sua senha.

Painel

title	Recuperação de Senha - AppLinker

Card

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

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

Painel

title	Rest Protheus - AppLinker

Dica

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

Painel

Card

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

Aplicativo

Após clicar em conectar, se a conexão for bem sucedida você será redirecionado a seguinte página. Nesta pagina será necessário escolher o APP que serão realizados os testes.
De acordo com o APP selecionado, exibirá campos personalizados, como por exemplo, empresa e filial, que são campos obrigatórios.

Painel

title	Aplicativo - AppLinker

Nota
Para o aplicativo "Meu Protheus NÃO É COMPATÍVEL" com a funcionalidade de notificações. Para tal, deve ser criado um ALIAS através do Mingle, ou pelo Assistente de Configuração Mobile.

Card

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

Start

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.

Painel

title	Alias - AppLinker

Painel

title	Aplicativo

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

Funcionalidades do Usuário

A seguir você irá visualizar os requisitos de usuário.

Painel

title	Caso de Uso

Card

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

Diagrama de Uso

A seguir você irá visualizar um passo a passo de como funciona a aplicação e todas as entidades presentes.

Painel

title	Diagrama de Uso

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 o Banco de Dados Postgree para testes locais.

As branchs para iniciar o desenvolvimento de qualquer feature devem ser feitas a partir da "develop" (tanto client como server).

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.

Note a seguir que o client faz todas as suas requisições usando um provider HttpService.

Neste HttpService usamos uma constante que possui a URL para onde estamos apontar, se localhost ou produção.

Painel

title	HttpService

Altere o valor do objeto de:

Bloco de código

language	js
theme	Midnight
title	Valor para Produção

export const environment = {
production: true,
api: 'https://applinkerserver.applinker.engpro.totvs.com.br'
};

para:

Bloco de código

language	js
theme	Midnight
title	Valor para Produção

export const environment = {
production: false,
api: 'http://localhost:3000'
};

em:

AppLinkerClient/app/src/environments/environment.ts

Painel

title	Environment

Painel

title	Environment

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

Deck of Cards

effectDuration	0.5
id	bd

Card

effectDuration	0.5
id	crie-server
label	Crie um Server
title	Crie um Server

Criando o DataBase

Para criar um Banco de Dados clique com o botão direito em "Databases" e depois em "Create".

De o nome de "applinker" e clique em "Save".

Painel

title	Criação do Server

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 155

Nova versão 156

Chave

Propósito

Primeiro Login

Solicitando Nova Credencial

Resgatar Palavra Chave

Rest Protheus

Aplicativo

Start

Funcionalidades do Usuário

Diagrama de Uso

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

Criando o DataBase

Perguntas frequentes (FAQs)

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 155

Nova versão 156

Chave

Propósito

Primeiro Login

Solicitando Nova Credencial

Resgatar Palavra Chave

Rest Protheus

Aplicativo

Start

Funcionalidades do Usuário

Diagrama de Uso

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

Criando o DataBase

Perguntas frequentes (FAQs)