Table of Contents

Integrazione API

L'app fornisce un'API che può essere utilizzata per integrazioni con servizi e sistemi esterni, consentendo l'importazione automatica di giornali e documenti utilizzando i template configurati.

L'API ha i seguenti parametri:

  • Publisher: memento
  • API Group: importTemplate
  • Version: v1.0
  • Entity: importTemplates

L'API può essere chiamata usando la seguente sintassi:

https://api.businesscentral.dynamics.com/v2.0/[ENVIRONMENT]/api/memento/importTemplate/v1.0/companies([COMPANY ID])/importTemplates

Il corpo della richiesta dovrebbe contenere i seguenti campi:

  • importCode: Obbligatorio. Il nome del template di importazione da utilizzare.
  • fileName: Obbligatorio. Il nome del file da importare. Se questo campo non è compilato, la richiesta non verrà elaborata.
  • base64FileContent: Obbligatorio. Il contenuto del file in formato Base64, nel formato previsto dal template selezionato.
  • templateName: Obbligatorio per l'importazione delle registrazioni, per selezionare la definizione registrazione in cui dovrebbero essere importate le righe.
  • batchName: Obbligatorio per l'importazione delle registrazioni, per selezionare il batch in cui dovrebbero essere importate le righe.
  • importParameters: Facoltativo. Se il template di importazione è configurato per accettare parametri di importazione per i campi, questo campo dovrebbe contenere un array di oggetti con le seguenti proprietà: tableId, che è l'ID della tabella a cui si riferisce questo parametro; fieldId, che è l'ID del campo; e fieldValue, che è il valore da applicare al parametro. Un esempio è il seguente: [{"tableId":"81","fieldId":"5","fieldValue":01/01/2024}].

La risposta conterrà un campo result che indica il risultato dell'operazione di importazione e il numero di documenti o righe creati:

Power Automate

L'API può essere utilizzata per un'integrazione tramite Power Automate. Alcuni esempi includono:

  • Importazione da un server FTP/SFTP quando un nuovo file viene caricato.
  • Importazione da un percorso di rete on premise, utilizzando Azure File Shares, quando un nuovo file viene creato.
  • Importazione da un Azure Blob Storage Account quando un nuovo file viene creato.
  • Importazione da un allegato e-mail quando è stata ricevuta una nuova e-mail.

Nel connettore di Business Central, l'azione di Power Automate da selezionare è Create Record (V3), utilizzando i parametri dell'API:

Nei parametri dell'azione, i campi della richiesta dovrebbero essere popolati come descritto in precedenza:

Un esempio per leggere file da un server FTP potrebbe essere il seguente:

Utilizzando i file letti dal FTP come parametri per la richiesta: