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 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||
Para o envio de arquivos encondados em BASE64, do aplicativo para o seu backend, deve-se utilizar o formato JSON. Por exemplo:
|
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):
Para envio e download de arquivos utilizando a interface formData do Mingle Gateway
O Mingle permite também o envio de arquivos para o backend no padrão FormDataEssa interface utiliza o mesmo formato que um form html utilizaria se o tipo de codificação estivesse configurado como "multipart/form-data".
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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
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 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
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> |