Redigera

Publicera en webbtjänst

  • Artikel

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 den Glödlampa som öppnar funktionen Berätta. anger du Webbtjänster och väljer 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.

    Anteckning

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

Anteckning

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
Begärandegräns för OData

Sök efter gratis e-inlärningsmoduler för Business Central här