Del via

Udgive en webtjeneste

  • Artikel

Webtjenester er en nem måde at gøre programfunktionalitet tilgængelig for forskellige eksterne systemer og brugere. Som standard viser Business Central en række objekter som webtjenester, hvilket giver en bedre integration med andre Microsoft-tjenester. Du kan tilføje andre webtjenester, efterhånden som virksomheden kræver det.

Opret en webtjeneste i Business Central, og udgiv derefter webtjenesten, så den er tilgængelig for godkendte brugere. Alle godkendte brugere kan få adgang til metadata til webtjenester, men kun brugere med tilstrækkelige -tilladelser kan få adgang til de faktiske data.

Oprettelse og publicering af en webtjeneste

Følgende trin forklarer, hvordan du opretter og publicerer en webtjeneste.

Sådan oprettes og publiceres en webtjeneste

  1. Lyspæreikon, der åbner funktionen Fortæl mig.Vælg ikonet, angiv Webtjenester, og vælg derefter det relaterede sammenkæde.

  2. På siden Webtjeneste skal du vælge Ny. Placer markøren over et felt for at se en kort beskrivelse.

    Note

    Kodeenhed og Page er gyldige typer for SOAP-webtjenester. Side og forespørgsel er gyldige typer for OData-webtjenester. Fra og med version 16.3 Codeunit, som også er en gyldig type til OData v4-webtjenester, men derefter vises der ikke nogen URL-adresse i brugergrænsefladen. Hvis databasen indeholder flere firmaer, kan du også vælge et objekt-id, der er specifikt for ét af firmaerne.
    Endelig er servicenavnet synligt for brugerne af webtjenesten og bruges som grundlag til at identificere og skelne mellem webtjenester, så du bør gøre navnet meningsfyldt.

  3. Marker afkrydsningsfeltet i kolonnen Udgivet.

Når du udgiver webtjenesten, viser felterne OData URL og SOAP-URL nye URL-adresser. For de kodeenheder, der eksponeres som Odata v4-ubundne handlinger, vises URL-felterne imidlertid ikke.

Du kan teste webtjenesten straks ved at vælge linksene i felterne URL-adresse til OData og URL-adresse til SOAP. Du kan vælge at kopiere værdien af feltet og gemme det til senere brug. Hvis du vil teste codeunits, som er eksponerede som OData v4-ubundne handlinger, skal du følge instruktionerne i afsnittet Kontroller webtjenestetilgængelighed i udviklerindholdet.

Note

Hvis du ikke kan få adgang til de objekter, du fremviser som webtjenester, i Business Central online, skal du markere de metoder, der vises i koden, som [Scope('OnPrem')]. Du kan finde flere oplysninger i Områdeattribut.

Når du udgiver en webtjeneste, er den tilgængelig for eksterne parter. Du kan kontrollere tilgængeligheden af denne webtjeneste ved hjælp af en browser, eller du kan vælge linket på siden URL-adresse til OData og URL-adresse til SOAP på siden Webtjenester. Følgende procedure illustrerer, hvordan du kan kontrollere tilgængeligheden af webtjenesten til senere brug.

Sådan kontrolleres tilgængeligheden af en webtjeneste

  1. Indtast den relevante URL-adresse i din browser Følgende tabel viser de typer URL'er, som du kan angive for forskellige typer webtjenester.

    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
    V4-adresse til OData 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
    Der skelnes mellem små og store bogstaver i firmanavnet.

  2. Gennemse de oplysninger, der vises i browseren. Kontroller, at du kan se navnet på den webtjeneste, du har oprettet.

Når du får adgang til en webtjeneste, og du vil skrive data tilbage til Business Central, skal du angive firmanavnet. Du kan angive virksomheden som en del af URI'en som vist i følgende eksempler, eller du kan angive virksomhedens som en del af forespørgselsparametrene. F.eks. peger følgende URI'er på den samme OData-webtjeneste, og begge er gyldige 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 også

Administration
Business Central-webtjenester til udviklere
Grænser for OData-anmodninger

Find gratis e-læringsmoduler til Business Central her