Jaa

Verkkopalvelun julkaiseminen

  • Artikkeli

Verkkopalvelut ovat kevyt tapa tuoda sovelluksen toiminnallisuus erilaisten ulkoisten järjestelmien ja käyttäjien saataville. Oletusarvoisesti Business Central näyttää useita objekteja verkkopalveluina, että ne voidaan paremmin integroida muihin Microsoft-palveluihin. Voit lisätä muita verkkopalveluita yrityksesi tarpeiden mukaan.

Määritä verkkopalvelu Business Centralissa ja julkaise verkkopalvelu siten, että se on todennettujen käyttäjien käytettävissä. Kaikki valtuutetut käyttäjät voivat käyttää verkkopalveluiden metatietoja, mutta vain käyttäjät, joilla on riittävät oikeudet, voivat käyttää varsinaisia tietoja.

Verkkopalvelun luominen ja julkaiseminen

Seuraavassa kerrotaan, kuinka voit luoda ja julkaista verkkopalvelun.

Verkkopalvelun luominen ja julkaiseminen

  1. Lamppu, joka avaa Kerro-ominaisuuden.Valitse kuvake, kirjoita Web-palvelut ja valitse linkit.

  2. Valitse Verkkopalvelut-sivulla Uusi. Lue lyhyt kuvaus siirtämällä kohdistin kentän päälle.

    Huomautus

    Koodiyksikkö ja Sivu ovat kelvollisia tyyppejä SOAP-verkkopalveluille. Page ja Query ovat OData-verkkopalvelut voimassa olevia tyyppejä. Versiosta 16.3 lähtien Codeunit on myös kelvollinen tyyppi OData v4 -verkkopalveluille, mutta käyttöliittymässä ei näy URL-osoitetta. Jos tietokanta lisäksi sisältää useita yrityksiä, voit valita yhdelle yritykselle kuuluvan objektitunnuksen.
    Palvelunimi näkyy verkkopalvelun käyttäjille, ja sen perusteella tunnistetaan ja erotellaan verkkopalvelut, joten nimen on oltava merkityksellinen.

  3. Valitse valintaruutu Julkaistu-sarakkeessa.

Kun julkaiset verkkopalvelun, uudet URL-osoitteet näkyvät OData URL- ja SOAP URL -kentissä. Koodayksiköille, jotka ovat alttiina sitoutumattomina OData v4 -toimintoina, URL-kenttiä ei kuitenkaan näytetä.

Voit testata verkkopalvelua heti valitsemalla linkit ODatan URL-osoite - ja SOAP:n URL-osoite -kentissä. Vaihtoehtoisesti kopioi kentän arvo ja tallenna se myöhempää käyttöä varten. Voit testata sitoutumattomia OData v4 -toimintoja sisältäviä codeuniteja noudattamalla kehittäjän sisällön verkkopalvelun käytettävyyden varmistaminen -osan ohjeita.

Huomautus

Jos verkkopalveluina näyttämäsi objektit eivät ole käytettävissä Business Central Onlinesta, sinun täytyy merkitä koodissa näkyvät menetelmät muodossa [Scope('OnPrem')]. Lisätietoja on kohdassa Alueen määrite.

Verkkopalveluna julkaistu palvelu on ulkoisten osapuolien käytettävissä. Voit tarkistaa kyseisen verkkopalvelun saatavuuden selaimen avulla tai valitsemalla linkin ODatan URL-osoite - ja SOAP:n URL-osoite -kentissä Verkkopalvelut-sivulla. Seuraavassa on kuvattu, miten voit tarkistaa verkkopalvelun käytettävyyden myöhempää käyttöä varten.

Verkkopalvelun saatavuuden tarkistaminen

  1. Kirjoita selaimeen asianmukainen URL-osoite. Seuraavassa taulukossa on kuvattu URL-osoitteiden tyypit, jotka voi antaa erilaisille verkkopalvelutyypeille.

    Tyyppi Syntaksi Esimerkki
    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
    Yrityksen nimi -kentässä huomioidaan kirjainkoko.

  2. Tarkista tiedot, jotka näkyvät selaimessa. Varmista, että näet luomasi verkkopalvelun nimen.

Kun siirryt verkkopalveluun ja haluat kirjoittaa tiedot takaisin Business Centraliin, yrityksen nimi on määritettävä. Voit määrittää yrityksen esimerkkien tavoin osana URI:a tai vaihtoehtoisesti osana kyselyparametrejä. Esimerkiksi seuraavat URI:t osoittavat samaan OData-verkkopalveluun ja molemmat ovat kelvollisia URI-osoitteita.

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

Katso myös

Hallinto
Business Central Web -palvelut kehittäjille
OData-pyyntörajat

Business Centralin ilmaiset e-learning-moduulit löydät täältä