Webtjenester er en nem måde at gøre programfunktionalitet tilgængelig for en række eksterne systemer og brugere. I Microsoft Dynamics NAV kan du vise sider, kodeenheder og forespørgsler som webtjenester. Når du publicerer Microsoft Dynamics NAV-objekter som webtjenester, er de straks tilgængelige på netværket.

Du kan konfigurere en webtjeneste i Microsoft Dynamics NAV Windows klient eller Microsoft Dynamics NAV Webklient. Du skal derefter publicere webtjenesten, så den er tilgængelig for serviceanmodninger via netværket. Brugere kan se webtjenester ved at pege på en browser på den computer, der kører Microsoft Dynamics NAV Server, og anmode om en oversigt over tilgængelige tjenester. Når du publicerer en webtjeneste, bliver den straks tilgængelig over netværket for godkendte brugere. Alle godkendte brugere kan få adgang til metadata til Microsoft Dynamics NAV, men kun brugere med tilstrækkelige Microsoft Dynamics NAV-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. Åbn Microsoft Dynamics NAV Windows klient eller Microsoft Dynamics NAV Webklient.

  2. I Microsoft Dynamics NAV Windows klient i feltet Søg skal du skrive Webservices og derefter vælge det relaterede link.

    I Microsoft Dynamics NAV Webklient skal du vælge knappen Søg efter side eller rapport, angive Webtjeneste og derefter vælge det relaterede link.

  3. På siden Webtjeneste skal du vælge Ny.

  4. I kolonnen Objekttype skal du vælge Kodeenhed, Side eller Forespørgsel.

    Bemærk
    Codeunit og Side er gyldige typer for SOAP-webtjenester. Side og Forespørgsel er gyldige typer for OData-webtjenester.

  5. I kolonnen Objekt-id skal du vælge objekt-id'et for det objekt, du vil vise. Hvis du f.eks. viser debitorkortet som en webtjeneste, skal du angive 21.

    Hvis databasen indeholder flere firmaer, kan du vælge et objekt-id, der er specifikt for ét af firmaerne.

  6. I feltet Servicenavn skal du tildele et navn til webtjenesten. Hvis du f.eks. viser debitorkortet som en webtjeneste, skal du angive Debitorer.

    Bemærk
    Servicenavnet er synligt for brugerne af webtjenesten og bruges som grundlag til at identificere og skelne mellem webtjenester, så du bør gøre navnet meningsfyldt. Hvis du konfigurerer integration med Microsoft Outlook ved hjælp af codeunit 5313, skal du derefter bruge DynamicsNAVsynchOutlook som tjenestenavn.

  7. Marker afkrydsningsfeltet i kolonnen Udgivet.

    Når du publicerer en webtjeneste, kan du i felterne URL-adresse til OData og URL-adresse til SOAP se de URL'er, der er genereret for webtjenesten. 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.

Når du publicerer en webtjeneste, er den tilgængelig på den Microsoft Dynamics NAV Server-computer, du var tilknyttet, da du publicerede den. Webtjenesten er tilgængelig på tværs af alle Microsoft Dynamics NAV Server-forekomster, der kører på servercomputeren.

Du kan kontrollere tilgængeligheden af denne webtjeneste ved hjælp af en browser, eller du kan vælge linket i vinduet URL-adresse til OData og URL-adresse til SOAP i vinduet 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 SOAP-webtjenester skal du bruge følgende format til din URI.

    Webtjenestetype Syntaks Eksempel

    SOAP

    https://Server:SOAPWebServicePort/ServerForekomst/WS/FirmaNavn/services/

    https://localhost:7047/DynamicsNAV90/WS/CRONUS International Ltd./services/

    OData

    https://Server:ODataWebServicePort/ServerForekomst/OData/Company('FirmaNavn')

    https://localhost:7048/DynamicsNAV90/OData/Company('CRONUS International Ltd.')

    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 Microsoft Dynamics NAV, 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.

 Kopier kode
https://localhost:7048/DynamicsNAV90/OData/Company('CRONUS International Ltd.')/Customer
 Kopier kode
https://localhost:7048/DynamicsNAV90/OData/Customer?company='CRONUS International Ltd.'
Tip!

Se også