Publicera en webbtjänst

Webbtjänster är ett enklare sätt att göra applikationfunktioner tillgängliga för olika typer av externa system och användare. Som standard exponerar Business Central flera objekt som webbtjänster för bättre integration med andra Microsoft-tjänster. Du kan lägga till andra webbtjänster när ditt företag behöver det.

Skapa en webbtjänst i Business Central och publicera sedan webbtjänsten så att den är tillgänglig för autentiserade användare. Alla behöriga användare kan komma åt metadata för webbtjänster, men endast användare, som har tillräcklig behörighet kan komma åt faktiska data.

Skapa och publicera en webbtjänst

Följande Moment beskriver hur du skapar och publicerar en webbtjänst.

Så här Skapa och publicera en webbtjänst

1. Välj ikonen , ange Webbtjänster och välj sedan relaterad länk.

2. Välj Nytt på sidan Webbtjänster. Placera markören över ett fält om du vill läsa en kort beskrivning.

   Anmärkning

   Kodmodul och Sida är giltiga typer för SOAP-webbtjänster. Sida och Fråga är giltiga typer för OData-webbtjänster. Från och med version 16.3 är också codeunit en giltig typ för OData v4-webbtjänster, men då visas ingen URL i användargränssnittet. Om databasen innehåller flera företag, kan du välja ett objekt-ID som är unikt för ett av företagen.
   Tjänstnamnet visas för konsumenter av din webbtjänsten och utgör basen för att identifiera och för att särskilja webbtjänster, så se till att välja ett meningsfullt namn.

3. Markera kryssrutan i kolumnen Publicerat.

När du publicerar webbtjänsten visar fälten OData-URL och SOAP-URL nya URL:er. För kodmoduler som är exponerade som icke-bundna åtgärder för OData v4 visas dock inte URL-fälten.

Du kan testa webbtjänsten omedelbart, genom att välja länkarna i de fälten OData-URL och SOAP-URL. Om du vill kan du kopiera värdet i fältet och spara det för senare användning. Om du vill testa kodmoduler som visas som obundna åtgärder för OData v4 följer du instruktionerna i avsnittet Verifiera webbtjänsttillgänglighet i utvecklarinnehållet.

Anmärkning

Om de objekt som du visar som webbtjänster inte får vara åtkomliga från Business Central Online, måste du markera de metoder som visas i koden som [Scope('OnPrem')]. Mer information finns i attributet Omfattning.

När du publicerar en webbtjänst, är den tillgänglig för externa parter. Du kan kontrollera tillgängligheten för den webbtjänsten genom att använda en webbläsare, eller välja länken i fälten OData-URL och SOAP-URL på sidan Webbtjänster. Följande tillvägagångssätt visar hur du kan kontrollera tillgängligheten av webbtjänsten för senare användning.

Om du vill kontrollera tillgängligheten av en webbtjänst

1. Ange den relevanta URL.en i din webbläsare. Följande tabell visar vilka olika typer av URL som du kan ange för olika webbtjänsttyper.

   Typ	Syntax	Exempel
   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 Företagsnamnsfältet är skiftlägeskänsligt.

2. Granska informationen som visas i webbläsaren. Kontrollera att du kan visa namnet på webbtjänsten som du har skapat.

När du öppnar en webbtjänst, och du vill skriva data tillbaka till Business Central, måste du ange företagsnamn. Du kan skriva in företaget som en del av den URI som visas i exemplen, eller så kan du skriva in företaget som en del av frågeparametrarna. Till exempel pekar följande URI.er på samma OData-webbtjänst och båda är giltiga URI:er.

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 även

Administration
Business Central-webbtjänster för utvecklare
Gränser för OData-begäranden

Hitta kostnadsfria e-utbildningsmoduler för Business Central-Hit