Publisere en webtjeneste

Webtjenester er en lett måte å gjøre programfunksjonalitet tilgjengelig for forskjellige eksterne systemer og brukere. Som standard viser Business Central flere objekter som webtjenester for bedre integrasjon med andre Microsoft-tjenester. Du kan legge til andre webtjenester etter behov.

Sett opp en nettjeneste i Business Central, og publiser deretter webtjenesten slik at den er tilgjengelig for godkjente brukere. Alle autoriserte brukere har tilgang til metadata for webtjenester, men bare brukere som har tilstrekkelige tillatelser, har tilgang til faktiske data.

Opprette og publisere en webtjeneste

De følgende trinnene forklarer hvordan du oppretter og publiserer en webtjeneste.

Slik oppretter og publiserer du en webtjeneste

1. Velg ikonet, angi Web Tjenester, og velg deretter det relaterte opprette en kobling.

2. På siden Webtjenester velger du Ny. Hold musepekeren over et felt for å lese en kort beskrivelse.

   Merk

   Codeunit og Page er gyldige typer for SOAP-webtjenester. Page og Query er gyldige typer for OData-nettjenester. Fra og med versjon 16.3 er Codeunit også en gyldig type for OData v4-webtjenester, men ingen URL-adresse vises i brukergrensesnittet. Hvis databasen inneholder flere selskaper, kan du også velge en objekt-ID som er spesifikk for ett av selskapene.
   Tjenestenavnet er synlig for brukere av webtjenesten, og brukes som grunnlag for å identifisere og skjelne webtjenester, så du bør velge et meningsfullt navn.

3. Merk avmerkingsboksen i kolonnen Publisert.

Når du publiserer webtjenesten, viser feltene OData-URL-adresse og SOAP-URL-adresse de nye URL-adressene. For codeunits som vises som OData v4-ubundne handlinger, vises imidlertid ikke URL-feltene.

Du kan teste webtjenesten umiddelbart ved å velge koblingene i feltene OData URL-adresse og SOAP-URL-adresse. Kopier eventuelt feltets verdi, og lagre den for senere bruk. Hvis du vil teste codeunits som vises som OData v4-ubundne handlinger, følger du instruksjonene i delen Verifisere tilgjengelighet for webtjeneste i innholdet for utviklere.

Merk

Hvis objektene du eksponerer som nettjenester, ikke må være tilgjengelige fra Business Central online, må du merke av for metodene som vises i koden, som [Scope('OnPrem')]. Se Scope-attributtet hvis du vil ha mer informasjon.

Når du publiserer en webtjeneste, er den tilgjengelig for eksterne parter. Du kan kontrollere tilgjengeligheten til denne webtjenesten ved hjelp av en leser, eller velge koblingen i feltene OData URL-adresse og SOAP-URL-adresse på siden Webtjenester. Følgende fremgangsmåte viser hvordan du kan kontrollere webtjenestens tilgjengelighet for senere bruk.

Slik kontrollerer du tilgjengeligheten til en webtjeneste

1. Angi den aktuelle URL-adressen i nettleseren. Tabellen nedenfor viser hvilke typer URL-adresser som du kan angi for ulike webtjenestetyper.

   Type	Syntaks	Eksempel
   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 Selskapsnavnet skiller mellom store og små bokstaver.

2. Se gjennom informasjone som vises i webleseren. Kontroller at du kan se navnet på webtjenesten som du har opprettet.

Når du åpner en webtjeneste, og du vil skrive data tilbake til Business Central, må du angi firmanavnet. Du kan angi selskapet som en del av URI-en som vist i eksemplene, eller angi selskapet som en del av spørringsparameterne. Følgende URIer peker for eksempel til den samme OData web-tjenesten, og de er begge gyldige URIer.

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

Se også

Administrasjon
Business Central-webtjenester for utviklere
Grenser for OData-forespørsel

Finn gratis e-læringsmoduler for Business Central Her