Passaggi principali

  1. Verificare che sia attivo un servizio con autenticazione NavUserPassword e che le API siano abilitate.
  2. Installare le app.
  3. Completare il setup di DocFinance all’interno di BC.
  4. Creare l’utente BC per l’integrazione con DocFinance e generare la relativa chiave di accesso ai servizi web (Web Service Access Key).
  5. Configurare la connessione in DocFinance verso il servizio con autenticazione NavUserPassword.

Ma devo pubblicare dei web service?

No, l’app per comunicare con DocFinance utilizza delle page di tipo API, di conseguenza sono automaticamente esposte da BC, non è necessario creare il web service.

Installazione OnPrem

Credential Type: NavUserPassword

Enable API Services: true

Max Page Size: a scelta (default: 20'000)

Port: a scelta (default: 7048)



Environment NameNome dell’environment
API publisher/group/versionStringa che serve per comporre l’URL da chiamare (in caso di cambiamento in futuro, si può ottenere comodamente l’URL nuovo)
Company IDID della company su BC, lo si ottiene anche tramite lookup sulla lista delle company

Configurare Oauth2 per i servizi OnPrem

È supportato l’uso di OData2.0 con servizi OnPrem.

Segui la guida Microsoft per preparare l’ambiente Business Central a lavorare con Entra ID visitando il seguente link:

Configura l’autenticazione di Microsoft Entra con OpenID Connect

Setup della connessione verso BC in DocFinance


Configurazione OnPrem

CampoDescrizione
Protocollohttp o https, dipende se è abilitato l’SSL sul servizio BC. Se il flag è a true, bisogna inserire https
HostL’ip del server su cui è installato BC
PortaSpecificata all’interno del setup del servizio BC
AutenticazioneBasic (OAuth2 opzionale, per i setting Nome utente, Password, KeySecret, TenantID, ClientID seguire la configurazione SaaS)
TimeoutTempo di attesa massima in secondi per cui DocFinance attenderà una risposta da BC
Nome utenteUtente BC che useremo per la connessione tra DocFinance e BC
PasswordWebService access key dell’utente BC che useremo per la connessione tra DocFinance e BC
EnvironmentNameNome del servizio BC a cui verrà effettuata la connessione
API Publisher/Group/VersionDisponibile sul setup DocFinance nel gruppo connessione
CompanyIDDisponibile sul setup DocFinance nel gruppo connessione
TenantIDNon disponibile
ClientIDNon disponibile
Percorso di backup degli scambiCartella su cui vengono salvate le chiamate effettuate da DocFinance a BC ed il loro contenuto, utile per il debug in caso di problemi

EOS Labs -