Condividi tramite

Pubblicare un servizio Web

  • Articolo

I servizi Web sono un modo semplice ed efficace per rendere le funzionalità di applicazioni disponibili a diversi tipi di sistemi e utenti esterni. Per impostazione predefinita, Business Central espone una serie di oggetti come servizi Web per una migliore integrazione con altri servizi Microsoft. È possibile aggiungere altri servizi Web in base alle esigenze dell'azienda.

Configurare un servizio Web in Business Central e quindi pubblicare il servizio Web in modo che sia disponibile per gli utenti autenticati. Tutti gli utenti autorizzati possono accedere ai metadati per i servizi Web, ma solo gli utenti che dispongono di permessi sufficienti possono accedere ai dati effettivi.

Creazione e pubblicazione di un servizio Web

I seguenti passaggi illustrano come creare e pubblicare un servizio Web.

Per creare e pubblicare un servizio Web

  1. Scegli l'icona Icona lampadina che apre la funzione Dimmi., immetti Servizi Web, quindi scegli il collegamento correlato.

  2. Nella pagina Servizi Web selezionare Nuovo. Passare sul campo con il mouse per visualizzare una breve descrizione.

    Nota

    Codeunit e Pagina sono tipi validi per servizi Web SOAP. Pagina e Query sono tipi validi per i servizi Web OData. A partire dalla versione 16.3, Codeunit è anche un tipo valido per i servizi Web OData v4, ma non viene visualizzato alcun URL nell'interfaccia utente. Inoltre, se il database contiene più società, è possibile scegliere un ID oggetto specifico di una delle società.
    Il nome del servizio è visibile agli utenti del servizio Web e poiché è la base per l'identificazione e la distinzione dei servizi Web, è importante che sia un nome significativo.

  3. Selezionare la casella di controllo nella colonna Pubblicato.

Quando si pubblica il servizio Web, i campi URL OData e URL SOAP mostrano i nuovi URL. Tuttavia, per le codeunit esposte come azioni non associate OData v4, i campi URL non vengono visualizzati.

È possibile verificare il servizio web immediatamente selezionando i collegamenti nei campi URL SOAP e URL OData. In alternativa, copiare il valore del campo e salvarlo per un successivo utilizzo. Per testare le codeunit esposte come azioni non associate OData v4, seguire le istruzioni nella sezione Verifica della disponibilità del servizio Web nel contenuto per gli sviluppatori.

Nota

Se gli oggetti esposti come servizi Web non devono essere accessibili da Business Central Online online, è necessario contrassegnare i metodi esposti nel codice come [Scope('OnPrem')]. Per ulteriori informazioni, vedere Attributo dell'ambito.

Dopo la pubblicazione di un servizio Web, questo è immediatamente disponibile per le parti esterne. È possibile verificare la disponibilità del servizio Web utilizzando un browser oppure scegliere il collegamento nei campi URL SOAP e URL OData nella pagina Servizi Web. La procedura seguente illustra come verificare la disponibilità del servizio Web per un uso successivo.

Per verificare la disponibilità di un servizio Web

  1. Nel browser immettere l'URL pertinente. Nella seguente tabella sono illustrati i tipi di URL che è possibile immettere per tipi di servizi Web diversi.

    Tipo Sintassi Esempio
    SOAP https://api.businesscentral.dynamics.com/*version*/*tenant*/Production/WS/*CompanyName*/*entity*/ https://api.businesscentral.dynamics.com/v2.0/7acc9d3d-d354-4616-8bbd-c4fc9f2b15b3/Production/WS/CRONUS%20USA%2C%20Inc./Page/InvoiceDocument
    OData V4 https://api.businesscentral.dynamics.com/*version*/*tenant*/Production/ODataV4/Company('*CompanyName*')/*entity* https://api.businesscentral.dynamics.com/v2.0/7acc9d3d-d354-4616-8bbd-c4fc9f2b15b3/Production/ODataV4/Company('CRONUS%20USA%2C%20Inc.')/InvoiceDocument
    Per la ragione sociale viene osservata la distinzione tra maiuscole e minuscole.

  2. Esaminare le informazioni visualizzate nel browser. Verificare che sia possibile visualizzare il nome del servizio Web creato.

Quando si accede a un servizio Web e si desidera scrivere i dati di nuovo in Business Central, è necessario specificare il nome della società. È possibile specificare la società come parte di URI come illustrato negli esempi oppure specificare la società come parte dei parametri di query. Ad esempio, gli URI successivi scelgono lo stesso servizio Web OData e sono entrambi URI validi.

https://api.businesscentral.dynamics.com/v1.0/OData/Company('CRONUS International Ltd.')/Customer  

https://api.businesscentral.dynamics.com/v1.0/OData/Customer?company='CRONUS International Ltd.'

Vedere anche

Amministrazione
Servizi Web di Business Central per sviluppatori
Limiti richieste OData

I moduli di e-learning gratuiti per Business Central sono disponibili qui