Standardweb-API

  • Artikel

Vigtigt

Dette indhold er arkiveret og opdateres ikke. Du kan få den nyeste dokumentation ved at se Microsoft Dynamics 365-dokumentation. Du kan få vist de seneste udgivelsesplaner i Udgivelsesplaner til Dynamics 365 og Microsoft Power Platform.

Bemærk

Disse produktbemærkninger beskriver funktionalitet, der muligvis ikke er udgivet endnu. Gennemgå Nyheder og planlagte tiltag for Dynamics 365 Business Central for at se, hvornår denne funktion er planlagt til frigivelse. Leveringstidsplaner og forventet funktionalitet ændres muligvis eller udsendes muligvis ikke (se Microsoft-gruppepolitik).

Standardweb-API'en forlader beta. API'en har været i beta, mens den var under udvikling på baggrund af feedback fra partner-community. Denne frigivelse integrerer endelige forbedringer og flere nye objekter i API'en som version 1.0.

Udviklerforbedringer

  • Udvikle API'er i AL ved hjælp af brugerdefinerede navneområder
  • Åben API-specifikation 3.x

Ændringer fra beta til v1.0 API'er

  • Dyb indlejringer af objekter
  • Enkle nøgler
  • API for registrering af medarbejdertimeseddel

Forretningsværdi

Standardweb-API'en viser mere end 48 objekter, der muliggør løst sammenkædede integrationer i Business Central. Hvis du bruger web-API'en, behøver du ikke udvikling eller implementering i Business Central. De vigtigste designmål har været at levere API'er, som ikke kræver et dybt kendskab til Business Central, og at levere en kontrakt med fast version, hvilket muliggør en standardiseret måde at integrere på tværs af lokaliseringer og implementeringer i Business Central.

Standard-API'en er som standard aktiveret i Business Central online og kan også aktiveres til lokale installationer.

Udvikle API'er i AL

Udvidelser kan vise API'er, som udnytter API-platformen i Business Central. Dette betyder, at brugerdefinerede API'er har samme funktioner som standard-API'er. Dette omfatter understøttelse af webhooks, OAS 3.0, OData v4 og versionsstyring.

Udvikling af API'er udnytter brugerdefinerede navneområder – en måde, hvorpå API'er kan segmenteres i grupper. Dette kræver, at API'en angiver APIPublisher-, APIGroup- og APIVersion-egenskaber.

page 50100 ApiPageExpenses
{
    PageType = API;
    Caption = 'apiPageName';
    APIPublisher = 'contoso';
    APIGroup = 'expenses';
    APIVersion = 'v2.0';
    EntityName = 'Receipt';
    EntitySetName = 'Receipts';
    SourceTable = ContosoReceipt;
    InsertAllowed = true;
    DeleteAllowed = true;
    layout
    {
        area(Content)

Eksemplet ovenfor får rutetabeller til at blive opdateret på implementeringstidspunktet og viser slutpunktet i det angivne navneområde.

GET https://api.businesscentral.dynamics.com/v1.0/api/contoso/expenses/v2.0/companies(7d0b2f2d-150e-4596-b064-e66f3491811c)/Receipts

Åben API-specifikation 3.x

Business Central understøtter generering af OAS 3.0. OAS leverer et fælles metadataformat, hvorfra SDK'er kan genereres til de fleste programmeringssprog.

Efter april 2019 genereres Business Central API-dokumentationen også via OAS.

Dybere indlejring af objekter

På grund af begrænsninger i delsider er det ikke muligt at have en objektstuktur, der er dybere end to niveauer. Eksempel:

/journal({id})/journalLine(id)

Med denne begrænsning i dette eksempel bliver det besværligt at bruge vedhæftede filer til journalLines, da ressourcen ikke kan adresseres direkte:

/journal({id})/journalLine(id)/attachment(id)

De nuværende beta-implementeringer har vedhæftede filer i roden.

Enkle nøgler

Nøgler i flere dele/komplekse nøgler gør API'erne sværere at bruge, da konstruktionen af anmodninger kan kræve flere parametre. Fra april 2019 vil API'erne bruge enkle nøgler.

API for registrering af medarbejdertimeseddel

Medarbejdertimesedler aktiveres via standard-API'en. Timesedler i Business Central understøtter i øjeblikket tidsregistrering for medarbejder efter ressourcer. Med den nuværende implementering kan en ressource repræsentere flere maskiner og personer. Fra april 2019 vil brug af timeseddelregistrering for medarbejdere kræve den ressource, som tidspunktet er registreret til, for at pege på én medarbejder.

Karakterer

Slutbrugere, administratorer, tilpassere, citizen-udviklere, udviklere

Status

I øjeblikket er alle API'er i beta. Fra april 2019 publiceres v1.0 API'er med de forbedringer, der er beskrevet ovenfor.

Tilgængelighed

SaaS, det lokale miljø

Fortæl os, hvad du synes

Hjælp os med at forbedre Dynamics 365 Business Central ved at diskutere ideer, stille forslag og give feedback. Brug Business Central-forummet på https://aka.ms/businesscentralideas.