Histórico da Página

Product_title

Title	Getting started
Image	<>

Este guia explica como configurar seu ambiente para desenvolvimento usando a biblioteca @totvs/Mingle.

A biblioteca Mingle realiza a integração transparente com o servidor do Mingle que esta na nuvem, assim o desenvolvedor não precisa se preocupar com o servidor do Mingle.

O guia Getting Started inclui informações sobre:

Pré-requisitos
Cadastro na plataforma Mingle
Instalação do pacote Mingle Client
Configuração da ferramenta para cada ambiente
Criação de um aplicativo inicial e a execução local desse aplicativo para verificar sua configuração.

Seguindo o passo a passo apresentado nos próximos tópicos o desenvolvedor terá um software integrado com a biblioteca Mingle e estará pronto para desenvolver uma aplicação de alta performance.

Expandir

title	1- Pré-requisitos

Para começar a utilizar o a biblioteca @totvs/mingle em sua aplicação é necessário possuir:

NPM/Node.js
Typescript: 3.2.2 ou superior
Gerenciador de pacotes npm
Biblioteca @totvs/mingle
Envio das informações no formato de encoding suportado pelo Mingle de acordo com a nossa documentação oficial
Entrar em contato com a equipe framework protheus ou o devteam do Mingle para solicitar um Alias no ambiente de desenvolvimento.

Aviso

Para aplicações desenvolvidas com o framework IONIC:

Você deve executar a instalação dos plugins MIngle-ionic: Mingle Ionic Geolocation e Mingle Ionic Device.

Consulte a documentação Pacote @totvs/mingle na plataforma Ionic para maiores detalhes.

Informações

Este guia utiliza o framework Angular para os seus exemplos.

A biblioteca @totvs/mingle é compatível com os frameworks que são baseados no javascript.

Expandir

title	2- Criando um projeto do zero

A biblioteca Mingle foi criada para facilitar a comunicação entre os aplicativos e o servidor Mingle.

Com ela nós teremos a facilidade de realizar login com poucas linhas de código, recursos para geração de métricas, interceptadores de requests entre outros diversos métodos públicos que facilitarão o trabalho do programador.

Instalação do pacote Mingle

Para começar a utilizar o Mingle o primeiro passo é fazer a instalação usando o npm:

$ npm install --save @totvs/mingle

Acompanhe as próximas páginas deste guia para iniciar o desenvolvimento utilizando o pacote instalado.

Expandir

title	3- Configurações iniciais

Neste passo vamos realizar a configuração da classe MingleService que deverá ser instanciada no início da sua aplicação para que possamos tirar proveito de todas as funcionalidades da biblioteca Mingle em seu aplicativo.

Consideramos este passo o mais importante, aqui é onde iremos configurar uma única instância da classe MingleService e ela funcionará por toda a sua aplicação.

Utilizando o comando $ "ng generate service appinitservice" do Angular CLI, criamos um serviço AppInitService e nele realizamos a seguinte implementação:

Bloco de código

language	js
firstline	1
title	appInitService
linenumbers	true

import { Injectable } from '@angular/core';
import { MingleService } from '@totvs/mingle';
@Injectable()
export class AppInitService {
  
 constructor(private mingleService: MingleService) { }
  
 mingleConfiguration(): Promise<any> {
   return new Promise((resolve, reject) => {      
     console.log("Mingle Service Configuration called");
     const server = mingleService.servers.development;
     const appId = 'your_app_id';
     const web = true;
 
     this.mingleService.init(server, appId, web)
      .then( init => {
       resolve('Mingle Service Init');
     }).catch(error => {
       console.log("error" , error);
       
       reject(error);
     }); 
    console.log("Mingle Service configuration completed"); 
   });
 }}

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 6

Nova versão 7

Chave

Instalação do pacote Mingle