Konfigurer API-maler

API-biblioteket for Business Central gir en forenklet visning av de underliggende enhetene. Alle egenskapene i programmet vises ikke via det tilknyttede API-et. På API-oppsett-siden kan du definere maler som brukes til å fylle ut tomme egenskaper på en enhet når du oppretter en POST-handling gjennom API-et.

Hvis for eksempel en konfigurasjonsmal er definert for vareenheten, når en ny varepost opprettes gjennom vare-API-et, blir egenskaper for den nye varen som ikke er definert i API-kallet, fylt ut fra den valgte malen. Hvis for eksempel ingen verdi er definert for Bokføringsgruppe - vare-feltet gjennom API-et, men en verdi er definert i den valgte malen, brukes bokføringsgruppeverdien som er definert i malen, for den nye varen.

Definere enhetsmalen

Hvis du vil bruke maler med API-biblioteket, må du først konfigurere og definere egenskaper for malene. Du kan sette opp malene på siden Konfigurasjonsmaler. Hvis du vil ha mer informasjon, kan du se Overfør lokale data til Business Central Online (bare på engelsk) i administrasjonsinnholdet.

Tilordne malen til et API

Hvis du vil tilordne en mal til et API, må du gå gjennom fremgangsmåten nedenfor.

Obs!

API-maler kan bare opprettes med følgende API-sider: kontakter, countriesRegions, valutaer, kunder, ansatte, itemCategories, paymentMethods, paymentTerms, shipmentMethods, unitsOfMeasure og leverandører.

1. Velg ikonet og angi API-oppsett, og velg den relaterte koblingen.

2. Velg Ny, og velg deretter Rekkefølge-verdien for posten.

   Hvis det er mer enn én mal som er valgt for et API (side-ID), brukes malene i rekkefølgen som er definert i Rekkefølge-kolonnen.

   Når hver mal er brukt, brukes bare feltverdiene som er definert i malen, på felt som ikke allerede har fått en verdi definert, enten eksplisitt i API-et eller i en mal som er brukt tidligere i rekkefølgen.

3. Velg en verdi for Side-ID.

   Dette er siden for API-et som malen skal brukes på. Side-ID-oppslaget gir en oversikt over alle API-er som er tilgjengelige i biblioteket.

4. Velg en verdi i Malkode-feltet.

   Malkoden er koden for malen som ble definert på Konfigurasjonsmaler-siden. Malverdiene som er definert, brukes på API-et.

5. I feltet Betingelser angir du hvilken mal som skal brukes.

   Den definerte malen brukes på en ny post som er opprettet gjennom API-et, hvis, og bare hvis, betingelsene som er definert i Betingelser-feltet er oppfylt av verdiene som allerede er definert for den nye forekomsten av enheten.

Se også

API-dokumentasjon
Utvikle Connect Apps for Business Central
Aktivere API-ene
Endepunkt for API-ene
Administrasjon

Finn nettlæringsmoduler for Business Central her