Gå til innhold
Norsk – Norge
  • Det finnes ingen forslag fordi søkefeltet er tomt.

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

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.