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.

Per un elenco dei servizi supportati, vedere sotto.

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).

Servizi supportati

I seguenti servizi sono supportati dalla EOS Administration Library.

Azure FileStorage

Questo servizio fornisce l’accesso allo storage Azure FileShare per la lettura e la scrittura di file. Sono disponibili i seguenti parametri di configurazione:

  • AccessKey: Le credenziali di accesso da utilizzare.
  • AccountName: Il nome dello storage account Azure.
  • FileShareName: Il nome del fileshare all’interno dello storage account Azure.

EOS FunctionAPI

Fornisce l’accesso a un’istanza di un’installazione di EOS Function API. Sono disponibili i seguenti parametri di configurazione:

  • X-EOS-Api-Key: La chiave API da utilizzare quando si effettuano le richieste.

ApplicationInsights Query

Consente di eseguire query KustoQL contro un account Application Insights. Sono disponibili i seguenti parametri di configurazione:

  • ApiKey: La chiave API creata nell’account Application Insights da utilizzare.
  • ApplicationId: L’ID dell’applicazione dell’account da utilizzare. È possibile trovarlo nella configurazione dell’account Application Insights.

Azure BlobStorage

Questo servizio fornisce l’accesso allo storage Azure BLOB per la lettura e la scrittura di file. Questa configurazione utilizzerà il modulo di archiviazione della base application. Sono disponibili i seguenti parametri di configurazione:

  • SharedKey: La chiave di accesso da utilizzare.
  • StorageAccount: Il nome dello storage account Azure.
  • ContainerName: Il nome del contenitore BLOB all’interno dello storage account Azure.

In-Memory Storage

Si tratta di un finto archivio da usare con l’interfaccia IFileSystem. È utile per i test e lo sviluppo quando non si ha a disposizione un file system reale. I file sono memorizzati in memoria solo per la propria sessione e non sono visibili a nessun altro. Inoltre, i file vengono persi quando si chiude la sessione. Sono disponibili i seguenti parametri di configurazione:

  • NomeStorage: È possibile avere più archivi in memoria contemporaneamente. Ciascuno di essi è identificato da questo nome. È possibile scegliere qualsiasi nome.

Application Insights

Sostituisce l’obsoleto ApplicationInsights Querey. Questa nuova implementazione consente di eseguire query KustoQL, proprio come faceva il suo predecessore. Inoltre, consente anche di inviare i log a un endpoint di ingestione di Application Insights. A tale scopo, è necessario specificare la stringa di connessione di Application Insights, dove si desidera inviare i log, nel campo Endpoint Uri.

Sono disponibili i seguenti parametri di configurazione:

  • ApiKey: è richiesto solo per l’esecuzione delle query. Le credenziali della chiave API create nell’account di Application Insights da utilizzare.
  • ApplicationId: è richiesto solo per l’esecuzione delle query. L’ID dell’applicazione dell’account da utilizzare. Si trova nella configurazione dell’account Application Insights.

EOS Labs -