Publicarea unui serviciu Web

Serviciile Web sunt o modalitate ușoară de a face funcționalitatea aplicației la dispoziția diferitelor tipuri de sisteme externe și utilizatori. În mod implicit, Business Central expune un număr de obiecte ca servicii web pentru o mai bună integrare cu alte servicii Microsoft. Puteți adăuga alte servicii web, după solicită compania dvs.

Configurați un serviciu web în Business Central, apoi publicați serviciul Web astfel încât să fie disponibil utilizatorilor autentificați. Toți utilizatorii autorizați pot accesa metadate pentru servicii web, dar numai utilizatorii care au permisiuni suficiente pot accesa date reale.

Crearea și publicarea unui serviciu Web

Următorii pași explică modul de creare și publicare a unui serviciu web.

Pentru a crea și a publica un serviciu web

  1. Alegeți Lightbulb that opens the Tell Me feature pictograma, introduceți Servicii Web, apoi alegeți linkul corelat.

  2. În pagina Servicii Web, selectați Nou. Treceți cu mouse-ul peste un câmp pentru a citi o scurtă descriere.

    Notă

    Codeunit și Page sunt tipuri valide pentru serviciile web SOAP. Pagina și Interogarea sunt tipuri valide pentru serviciile web OData. Începând cu versiunea 16.3, Codeunit este, de asemenea, un tip valid pentru serviciile web OData v4, dar apoi nu este afișat niciun URL în interfața cu utilizatorul. De asemenea, dacă baza de date conține mai multe companii, aveți posibilitatea să alegeți un ID de obiect specific uneia dintre companii.
    În cele din urmă, numele serviciului este vizibil pentru consumatorii serviciului web și este baza pentru identificarea și distingerea serviciilor web, așa că ar trebui să faceți numele semnificativ.

  3. Bifați caseta de selectare din coloana Publicat.

Când publicați serviciul Web, câmpurile URL OData și SOAP afișează noile URL-uri. Cu toate acestea, pentru codeunit-uri care sunt expuse ca acțiuni nelegate OData v4, câmpurile URL nu sunt afișate.

Puteți testa serviciul web imediat alegând linkurile din câmpurile URL OData și URL SOAP. Opțional, copiați valoarea câmpului și salvați-l pentru o utilizare ulterioară. Pentru a testa codeunits care sunt expuse ca acțiuni nelegate OData v4, urmați instrucțiunile din secțiunea Verificare disponibilitate serviciu Web din conținutul dezvoltatorului.

Notă

Dacă obiectele pe care le expuneți ca servicii web nu trebuie să fie accesibile online din Business Central, trebuie să marcați metodele expuse în cod ca [Scope('OnPrem')] . Pentru mai multe informații, consultați Atribut domeniu.

După ce publicați un serviciu web, acesta este disponibil părților externe. Aveți posibilitatea să verificați disponibilitatea acelui serviciu Web utilizând un browser sau să alegeți linkul din câmpurile URL OData și URL SOAP din pagina Servicii Web. Următoarea procedură ilustrează modul în care puteți verifica disponibilitatea serviciului Web pentru o utilizare ulterioară.

Pentru a verifica disponibilitatea unui serviciu web

  1. În browser, introduceți URL-ul relevant. Următorul tabel ilustrează tipurile de URL-uri pe care le puteți introduce pentru diferite tipuri de servicii Web.

    Exemplu de sintaxă de text
    Săpun 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
    Numele companiei este sensibil la litere mari și mici.

  2. Examinați informațiile afișate în browser. Verificați dacă aveți posibilitatea să vedeți numele serviciului Web pe care l-ați creat.

Când accesați un serviciu Web și doriți să scrieți date înapoi în Business Central, trebuie să specificați numele companiei. Aveți posibilitatea să specificați compania ca parte a URI-ului, așa se arată în exemple; alternativ, specificați compania ca parte a parametrilor interogării. De exemplu, următoarele URI indică spre același serviciu web OData și sunt ambele URI valide.

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

A se vedea, de asemenea,

Administrare
Servicii Web centrale de afaceri pentru dezvoltatori
Limitele solicitărilor OData

Notă

Ne puteți spune despre preferințele dumneavoastră lingvistice de documentare? Fă un scurt sondaj.

Sondajul va dura aproximativ șapte minute. Nu sunt colectate date cu caracter personal(declarație de confidențialitate).