Business NXT – lese DME-felt (Data Model Extensions) i importer
Oppsett import av DME-felter fra Business NXT
Business NXT lar deg utvide datamodellen med egne felt og tabeller (DME – Data Model Extensions). Denne artikkelen viser hvordan BxLogistics leser slike felt i en import, og hva du bør sjekke hvis verdiene ikke kommer inn.
Innhold- 1. Hva er DME
- 2. Forutsetninger i Business NXT
- 3. Oppsett i importfeltmapping
- 4. Eksempler
- 5. Feilsøking
- 6. Begrensninger
- 7. Oppsummert
1. Hva er DME
DME-felt er egendefinerte felt som er lagt til på en standardtabell i Business NXT, for eksempel ordrelinje, eller i en egen DME-tabell. I API-et til Business NXT ligger de ikke som vanlige felt. De ligger under extensions på hver rad, og verdien hentes med navnet på feltet og datatypen.
2. Forutsetninger i Business NXT
- Feltet må være opprettet og aktivt i selskapet du importerer fra.
- Bruk det tekniske navnet på feltet, med prefikset, for eksempel
mittPrefiks_MittFelt. Skriv navnet med samme store og små bokstaver som i Business NXT. - Du må vite hvilken datatype feltet har (heltall, tekst, dato osv.), se 3.2 Datatyper.
3. Oppsett i importfeltmapping
DME-felt legges inn som kildefelt i importfeltmappingen i BxAdmin, på samme måte som andre felt fra Business NXT.
3.1 DME-felt på en standardtabell
Legg til extensions.<type>Value(<feltnavn>) etter tabellen feltet ligger på:
<tabell>.items.extensions.<type>Value(<feltnavn>)
BxLogistics lager spørringen mot Business NXT selv. Ikke skriv GraphQL-syntaks med { }, alias eller name: i kildefeltet.
3.2 Datatyper
| Datatype i Business NXT | Skriv i mappingen |
| Heltall | integerValue(...) |
| Desimaltall | decimalValue(...) |
| Tekst | stringValue(...) |
| Ja/nei | booleanValue(...) |
| Dato | dateValue(...) |
| Klokkeslett | timeValue(...) |
| Tidsstempel | timestampValue(...) |
Feltnavnet kan skrives med eller uten anførselstegn: integerValue(mittFelt) og integerValue("mittFelt") fungerer begge.
3.3 DME-relasjoner (joinup/joindown)
Hvis DME-oppsettet har egne relasjoner, kan du følge dem slik:
Opp til en relatert rad:
<tabell>.items.extensions.joinup(<relasjon>).<type>Value(<felt>) <tabell>.items.extensions.joinup(<relasjon>,<til>).<type>Value(<felt>)
Ned til relaterte rader:
<tabell>.items.extensions.joindown(<relasjon>,<fra>).items.<type>Value(<felt>)
3.4 DME-tabell som rottabell
En egen DME-tabell kan brukes som rottabell i en import ved å starte kildefeltet med table(<tabellnavn>):
table(<tabellnavn>).items.<type>Value(<felt>)
Det kan bare være én DME-rottabell per import. Filter for importen settes med nøkkelen table.
4. Eksempler
Heltallsfelt på ordrelinje i salgsordreimporten:
order.items.joindown_OrderLine_via_Order.items.extensions.integerValue(mittPrefiks_MittFelt)
Tekstfelt på ordrehodet:
order.items.extensions.stringValue(mittPrefiks_MinTekst)
Desimalfelt på produkt:
product.items.extensions.decimalValue(mittPrefiks_MittTall)
5. Feilsøking
- Importen går uten feil, men feltet blir tomt (NULL): Sjekk først syntaksen i kildefeltet. Hvis kildefeltet er skrevet som GraphQL, for eksempel
...extensions { felt: integerValue(name: "felt") }, kan importen gå uten feil, men BxLogistics finner ikke verdien i svaret. Bruk formatet i 3.1. - Sjekk at feltnavnet, prefikset og store og små bokstaver stemmer med Business NXT.
- Sjekk at datatypen i mappingen er den samme som i Business NXT.
- Sjekk at BxLogistics-feltet du mapper til har en datatype som passer. Et heltall bør for eksempel ikke gå til et datofelt.
- Hvis du filtrerer importen: Når du setter et eget
filter.<felt>, blir alle standardfiltrene for importen fjernet.
6. Begrensninger
- BxLogistics kan foreløpig bare lese DME-felt (import). Eksport som skriver tilbake til DME-felt i Business NXT er ikke tilgjengelig ennå.
7. Oppsummert
Bruk <tabell>.items.extensions.<type>Value(<feltnavn>) i importfeltmappingen, med teknisk feltnavn og riktig datatype. Skriv aldri GraphQL-syntaks direkte i kildefeltet.