Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

A transferência de arquivos através do Gateway do Mingle pode ser realizada utilizando a biblioteca @totvs/mingle ou o acesso direto ao servidor conforme a documentação https://mingle.totvs.com.br/api/docs/#api-Gateway-gateway


Para envio e download de arquivos utilizando payload do Mingle o Mingle Gateway o arquivo deve ser encodado para BASE64 ou FormData e conter no máximo o tamanho de 50 megabytes.

Informações
titleAtenção

Para o envio de arquivos encondados em BASE64, do aplicativo para o seu backend, deve-se utilizar o formato JSON.

Por exemplo: 

Bloco de código
languagejs
firstline1
titleJSON
linenumberstrue
{"file":"9j/4AAQSkZJRgABAQAAAQABAAD/4gIoSUNDX1BST0ZJTEUAAQEAAAIYAAAAAAIQA..."}


Dessa forma é possível enviar arquivos PDF, ZIP, XLS, imagens, etc ...

Para converter o arquivo para BASE64  e enviá-lo como resposta a uma solicitação GET para download, pode-se utilizar o exemplo em NodeJS abaixo:

...

Segue abaixo links das documentações de Encode e Decode do Protheus (ADVPL):

Encode64

Decode64

FormData


FormData 

O Mingle permite também o Para envio de arquivos utilizando a interface formData do Mingle GatewayEssa interface utiliza o mesmo formato que um form html utilizaria se o tipo de codificação estivesse configurado como "multipart/form-data"para o backend no padrão FormData.

Neste exemplo abaixo, recebemos no aplicativo arquivos com qualquer tipo de extensões através do po-upload no htmlHTML e o valor dele (ngModel) é repassado para uma função javascript onde será montado o POST:

Bloco de código
languagexml
firstline1
titleupload_de_arquivos.html
linenumberstrue
<po-upload name="upload" [(ngModel)]="fileUpload"> </po-upload>

<ion-button (click)="sendFilesByMingle(fileUpload)">Direto</ion-button>

E enviamos com o MingleService no método sendFilesByMingle(fileUpload)Exemplo enviando arquivos do aplicativo utilizando o método post da classe gateway da biblioteca @totvs/Mingle:

Bloco de código
languagejs
firstline1
titlesendFilesByMingle.js
linenumberstrue
public sendFilesByMingle (file: any) {
    const formData: FormData = new FormData();

    formData.append('file', file[0].rawFile);

    const options = { body: formData };

    this.mingleService.gateway.post("api/upload", options).subscribe(res => {
      console.log("HTTP RESPONSE OK: ", res)
    }), error => {
      console.log("HTTP RESPONSE ERROR:", error);
    }

  }

Envie o formData através do body usando a classe mingleService.gateway.

...



Exemplo de envio de arquivo direto para o servidor conforme documentação https://mingle.totvs.com.br/api/docs/#api-Gateway-gateway:

Bloco de código
languagejs
firstline1
titlesendFiles.js
linenumberstrue
public sendFiles (file: any) {
   const formData: FormData = new FormData();

   formData.append('file', file[0].rawFile);

   const options = { body: formData };

   this.httpService.post("https://mingle.totvs.com.br/api/api/v1/gateway/:setId/back-end-method", options).subscribe(res => {
     console.log("HTTP RESPONSE OK: ", res)
   }), error => {
     console.log("HTTP RESPONSE ERROR:", error);
   }

}



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