Configurazioni di servizio

Le configurazioni dei servizi forniscono un modo centralizzato per configurare API e servizi esterni da consumare da Business Central.

Introduzione

Le configurazioni dei servizi consentono di specificare i parametri e la configurazione dei servizi esterni attraverso un’unica interfaccia comune. EOS Administration Library fornisce il supporto per una serie di servizi, ma è possibile implementare facilmente le proprie configurazioni di servizio con il minimo sforzo e sfruttando questa interfaccia di configurazione comune.

Per ogni configurazione di servizio esiste solitamente una Codeunit per l’accesso a tale servizio. Per i dettagli si può fare riferimento alla documentazione di quel servizio specifico.

I servizi che EOS Administration Library supporta immediatamente sono:

  • Azure FileStorage fornisce l’accesso agli storage account di Azure FileShare. Per ulteriori informazioni, consultare il capitolo FileSystem.
  • EOS Function API fornisce l’accesso a tutte le funzionalità offerte da EOS Function API.
  • ApplicationInsights Query consente di inviare e analizzare le query ad Azure Application Insights.
  • Azure BlobStorage consente di accedere agli storage account BLOB di Azure. Per saperne di più, consultate il capitolo FileSystem.
  • L’In-Memory Storage è uno storage integrato il cui caso d’uso principale è il test e lo sviluppo. Per saperne di più, consultate il capitolo FileSystem.

Setup

È possibile accedere alle configurazioni dei servizi dalla pagina Lista configurazioni servizio (EAL). Questa pagina elenca tutti i servizi attualmente configurati. Da qui è possibile gestire i servizi esistenti o crearne di nuovi.

La configurazione di un servizio è composta da due parti. Nella parte superior si trova un elenco di campi:

  • Codice: Specifica il codice che si desidera assegnare alla configurazione di questo servizio.
  • Tipo: Specifica il tipo di servizio che si sta configurando.
  • Descrizione: Consente di fornire una descrizione di facile utilizzo per la configurazione del servizio.
  • Endpoint Uri: Permette di specificare l’URL a cui punta il servizio. Questo può essere necessario o meno, a seconda dell’implementazione del servizio. Alcuni servizi lo richiedono, altri no.
  • Request Timeout (sec): Permette di specificare un timeout per le chiamate HTTP effettuate a questo servizio. Se non viene specificato, verrà utilizzato il timeout predefinito del client HTTP. Questo può essere considerato o meno, a seconda dell’implementazione del servizio. Alcuni servizi lo considerano, altri no.
  • Logging: consente di configurare come (e se) le richieste e le risposte vengono registrate per questo servizio. Questo dovrebbe essere usato solo per il debug. Per saperne di più, consultare il capitolo Debugging.

Di seguito, c’è una sottopagina di parametri specifici del servizio, diversi a seconda del servizio che si sta configurando. Per i dettagli, consultare la documentazione di ciascun servizio.

Ogni parametro di questa sottopagina può essere un parametro normale o un segreto. Questo viene deciso dall’implementazione del servizio. L’unica differenza tra i due è che un valore segreto non può più essere estratto, una volta salvato.

Debugging

La maggior parte dei servizi configurati attraverso una configurazione di servizio può essere sottoposta a debug. Ciò si ottiene loggando le richieste e le relative risposte. Questo, tuttavia, dipende dall’implementazione del servizio.

Per attivare questo log di debug, è necessario specificare un valore diverso da None nel campo Logging. Ciò consente di loggare ogni richiesta (e la relativa risposta) o solo quelle fallite.

Una volta attivato il log, tutte le ulteriori richieste effettuate utilizzando questa configurazione del servizio saranno loggate. È possibile accedere al registro dalla scheda Configurazione del servizio, dall’azione Request Log. Questa pagina consente di vedere tutte le richieste effettuate dall’attivazione del log e permette anche di scaricare i dati delle richieste e delle risposte (come JSON).


EOS Labs -