Konfigurer datautvekslingsdefinisjoner
Du kan opprette Business Central for å utveksle data i bestemte tabeller med data i eksterne filer. Du kan for eksempel sende og motta elektroniske dokumenter, importere og eksportere bankdata eller andre data, for eksempel lønn, og varekataloger. Lær mer på Utveksle data elektronisk.
For å opprette en datautvekslingsdefinisjon for en datafil eller -strøm, kan du bruke det tilknyttede XML-skjemaet til å definere hvilke dataelementer skal tas med i hurtigfanen Kolonnedefinisjoner. Se trinn 6 under Slik beskriver du formateringen av linjer og kolonner i filen. Lær mer på Bruke XML-skjemaer til å klargjøre datautvekslingsdefinisjoner.
Vanligvis setter du opp datautvekslingsdefinisjoner på siden Datautvekslingsdefinisjon. Når det gjelder oppdatering av valutakurser, er det imidlertid raskere å bruke en valutakurstjeneste. Finn ut mer på Oppdatere valutakurser.
Merk
Hvis filen som konverteres, er i XML-format, skal begrepet "kolonne" i denne artikkelen tolkes som et XML-element som inneholder data.
Denne artikkelen inneholder følgende fremgangsmåter:
- Opprett en datautvekslingsdefinisjon.
- Eksporter en datautvekslingsdefinisjon som en XML-fil som andre kan bruke.
- Importer en XML-fil for en eksisterende datautvekslingsdefinisjon.
Opprette en datautvekslingsdefinisjon
Oppretting av en datautvekslingsdefinisjon omfatter to oppgaver:
- På siden Datautvekslingsdefinisjon beskriver du formateringen for linjer og kolonner i filen. Lær mer i delen Slik beskriver du formateringen av linjer og kolonner i filen.
- På siden Tildeling for datautveksling tildeler du kolonner i datafilen til felter i Business Central. Lær mer i delen Slik tildeler du kolonner i datafilen til felt i Business Central.
Slik beskriver du formateringen av linjer og kolonner i filen
Velg ikonet
, skriv inn Datautvekslingsdefinisjoner, og velg deretter det relaterte opprette en kobling.Velg handlingen Ny.
I hurtigfanen Generelt beskriver du datautvekslingsdefinisjonen og datafiltypen ved å fylle ut feltene som beskrevet i tabellen nedenfor.
Felt Definisjon Kode Skriv inn en kode for å identifisere datautvekslingsdefinisjonen. Navn Angi et navn for datautvekslingsdefinisjonen. Filtype Angi hvilken type fil datautvekslingsdefinisjonen brukes til. Du kan velge mellom fire filtyper:
- XML: Lagdelte innholdsstrenger og markering omgitt av koder som indikerer funksjon.
- Variabel tekst: Poster har variabel lengde og er atskilt med et tegn, for eksempel komma eller semikolon, også kjent som fil medskilletegn.
- Fast tekst: Poster har samme lengde ved hjelp av pad-tegn, og hver post er på en egen linje, også kjent som fil medfast bredde.
- Json: Lagdelte strenger med innhold i JavaScript.Type Angi hvilken type forretningsvirksomhet datautvekslingsdefinisjonen brukes til, for eksempel betalingseksport. Kodeenhet for databehandling Angi codeunit som overfører data inn i og ut av tabeller i Business Central. Valideringskodeenhet Angi kodeenheten som brukes til å validere data mot forhåndsdefinerte forretningsregler. Lese-/skrivekodeenhet Angi kodeenheten som behandler importerte data før tilordning og eksporterte data etterpå. Lesing/skriving XMLport Angi XMLport som en importert datafil eller tjeneste blir angitt via før tilordning, og der eksporterte data skrives til en datafil eller tjeneste via denne etterpå. Kodeenhet for ekstern databehandling Angi kodeenheten som overfører eksterne data inn i og ut av rammeverket for datautveksling. Kodeenhet for tilbakemelding fra bruker Angi kodeenheten som inneholder ulike oppryddinger etter tilordning, for eksempel markerer linjene som eksporteres og sletter midlertidige poster. Filkoding Angi kodingen for filen. Merk: Dette feltet er bare relevant for import. Kolonneskilletegn Angi hvordan kolonner skilles i datafilen, hvis filen er av typen Variabel tekst. Overskriftslinjer Angi hvor mange topptekstlinjer det er i filen.
Denne innstillingen sikrer at topptekstdataene ikke importeres. Merk: Dette feltet er bare relevant for import.Topptekst Tag Hvis det finnes en topptekst på flere steder i filen, kan du angi teksten i den første kolonnen på topptekstlinjen.
Dette alternativet sikrer at topptekstdataene ikke importeres. Merk: Dette feltet er bare relevant for import.Bunntekstkode Hvis det finnes en bunntekst på flere steder i filen, kan du angi teksten i den første kolonnen på bunntekstlinjen.
Dette alternativet sikrer at bunntekstdataene ikke importeres. Merk: Dette feltet er bare relevant for import.Tips
Hvis du vil se hvilke codeuniter Microsoft bruker i eksisterende definisjoner i standardproduktet, kan du se de tre Codeunit-feltene i hodet på Felttilordning-siden for hver definisjon under hurtigfanen Generelt for hver definisjon.
I hurtigfanen Linjedefinisjoner beskriver du formateringen av linjer i datafilen ved å fylle ut feltene som beskrevet i tabellen nedenfor.
Merk
For import av bankkontoutdrag kan du bare opprette én linje for enkeltformatet til bankkontoutdragsfilen som du vil importere.
For eksport av betalinger kan du opprette en linje for hver betaling du vil eksportere. I slike tilfeller viser hurtigfanen Kolonnedefinisjoner forskjellige kolonner for hver betalingstype.
Felt Description Linjetype Angir linjetypen i filen. Kode Angi en kode som identifiserer linjen i filen. Navn Angi et navn som beskriver linjen i filen. Antall kolonner Angi hvor mange kolonner det er på linjen i datafilen. Merk: Dette feltet er bare relevant for import. Kode for datalinje Angi posisjonen til elementet som representerer hovedposten i datafilen, i det tilknyttede XML-skjemaet. Merk: Dette feltet er bare relevant for import. Namespace Angi navneområdet som forventes i filen, for å aktivere validering av navneområde. Du kan la dette feltet stå tomt hvis du ikke vil aktivere validering av navneområde. overordnet kode Angi linjens overordnede, som vise i feltet Kode, i tilfeller der datautvekslingsoppsettet gjelder for filer med overordnede og underordnede poster, for eksempel dokumenttopptekst og -linjer. Gjenta trinn 4 for å opprette en linje for hver fildatatype du vil eksportere.
Beskriv formateringen av kolonner i datafilen ved å fylle ut feltene på hurtigfanen Kolonnedefinisjoner, som beskrevet i tabellen i trinn 8. Du kan bruke en strukturfil, for eksempel en XSD-fil, for datafilen til å forhåndsutfylle hurtigfanen med de aktuelle elementene. Lær mer på Bruke XML-skjemaer til å klargjøre datautvekslingsdefinisjoner.
I hurtigfanen Kolonnedefinisjoner velger du handlingen Hent filstruktur.
På siden Hent filstruktur velger du den relaterte strukturfilen og velger deretter OK. Linjene i hurtigfanen Kolonnedefinisjoner fylles ut i henhold til strukturen til datafilen.
I hurtigfanen Kolonnedefinisjoner redigerer eller fyller du ut feltene som beskrevet i tabellen nedenfor.
Felt Description Kolonnenr. Angi tallet som gjenspeiler kolonneposisjonen på linjen i filen.
For XML-filer angir du tallet som gjenspeiler elementtype i filen som inneholder dataene.Navn Angi navnet på kolonnen.
For XML-filer kan du angi markeringen som merker dataene som skal utveksles.Datatype Angi om dataene som skal utveksles, er av typen Tekst, Dato eller Desimal. Dataformat Angi det eventuelle dataformatet. Eksempel: dd.MM.åååå hvis datatypen er Dato. Merknad: For eksport angir du dataformatet i henhold til Business Central. For import angir du dataformatet i henhold til .NET Framework. Finn ut mer på Standard formatstrenger for dato og klokkeslett. Kultur for dataformatering Angi det eventuelle regionale dataformatet. For eksempel en-US hvis datatypen er Desimal for å sikre at komma brukes som 0,000-skilletegn, i henhold til USA-formatet. Finn ut mer på Standard formatstrenger for dato og klokkeslett. Merk: Dette feltet er bare relevant for import. Lengde Angi lengden på linjen med fast bredde som inneholder kolonnen, hvis datafilen er av typen Fast tekst. Beskrivelse Angir en beskrivelse av kolonnen for informasjonsformål. Sti Angi posisjonen til elementet i det tilknyttede XML-skjemaet. Identifikator med negativt fortegn Angi verdien som brukes i datafilen til å identifisere negative beløp i datafiler som ikke kan inneholde negative fortegn. Denne identifikatoren brukes deretter til å gi de identifiserte beløpene negative fortegn under import. Merk: Dette feltet er bare relevant for import. Konstant Angi data du vil eksportere i denne kolonnen, for eksempel tilleggsinformasjon om betalingstypen. Merk: Dette feltet er bare relevant for eksport. Tekstutfylling kreves Angir at dataene må inkludere tekstutfylling. Blokktegn Angi tekstens utfyllingstegn. Rettferdiggjørelse Angi om kolonnejusteringen er mot høyre eller venstre. Gjenta trinn 8 for hvert kolonne- eller XML-element i datafilen som har data du vil utveksle med Business Central.
Det neste trinnet i å opprette en datautvekslingsdefinisjon er å bestemme hvilke felter kolonner eller XML-elementer i datafilen skal tildeles til i Business Central.
Merk
Den bestemte tilordningen avhenger av forretningsformålet med datafilen som skal utveksles, og av lokale variasjoner. Selv SEPA-bankstandarden har lokale variasjoner. Business Central støtter import av standard SEPA CAMT-bankkontoutdragsfiler. Dette er angitt med SEPA CAMT-postkoden for datautvekslingsdefinisjon på siden Datautvekslingsdefinisjoner. For informasjon om spesifikk felttilordning av SEPA CAMT-støtten kan du se Felttilordning ved import av SEPA CAMT-filer.
Slik tilordner du kolonner i datafilen til felt i Business Central
Tips
Noen ganger er verdiene i feltene du vil tilordne, forskjellige. For eksempel, i én virksomhetsapp er språkkoden for USA U.S., men i den andre er det US. Det betyr at du må transformere verdien når du utveksler data. Dette skjer gjennom transformeringsregler som du definerer for feltene. Lær mer om Transformasjonsregler.
Du kan også gruppere etter et hvilket som helst felt, bruke nøkkelindeksen til å sortere resultater og de nye transformasjonstypene avrunding og feltoppslag.
I hurtigfanen Linjedefinisjoner velger du linjen for tilordning av kolonner til felt, og deretter velger du Felttilordning. Siden Tilordning for datautveksling åpnes.
I hurtigfanen Generelt angir du tilordningsoppsettet ved å fylle ut feltene som beskrevet i tabellen nedenfor.
Felt Beskrivelse Tabell-ID Angi tabellen som inneholder feltene som data utveksles til eller fra i samsvar med tilordningen. Bruk som mellomliggende tabell Angi om tabellen du Velg i Tabell-ID-feltet , er en mellomliggende tabell der de importerte dataene lagres før de tilordnes måltabellen.
Du bruker vanligvis en mellomliggende tabell når datautvekslingsdefinisjonen importerer og konverterer elektroniske dokumenter i Business Central. Det kan for eksempel være dokumenter som leverandørfakturaer til kjøpsfakturaer. Lær mer på Utveksle data elektronisk.Navn Angi et navn for tilordningsoppsettet. Nøkkelindeks Angi nøkkelindeksen for å sortere kildeoppføringene før eksport. Kodeenhet for forhåndstilordning Angi codeunit som klargjør tilordningen mellom felter i Business Central og eksterne data. tildeling Kodeenhet Angi codeunit som brukes til å tilordne de angitte kolonnene eller XML-dataelementene til felter i Business Central. Kodeenhet for ettertilordning Angi codeunit som fullfører tildelingen mellom felter i Business Central og eksterne data. Merknad: Når du bruker utvidelsesfunksjonen AMC Banking 365 Fundamentals , konverterer kodeenheten eksporterte data fra Business Central til et generelt format som er klart for eksport. For import konverterer codeunit eksterne data til et format som er klar for import til Business Central. På hurtigfanen Felttildeling angir du hvilke kolonner som skal tildeles felter i Business Central ved å fylle ut feltene som beskrevet i tabellene nedenfor, avhengig av om feltet Bruk som midlertidig tabell var aktivert eller ikke.
Når Bruk som foreløpig tabell er deaktivert:
Felt Description Kolonnenr. Angi hvilken kolonne i datafilen du vil definere en tilordning for.
Du kan bare velge kolonner som vises som linjer i hurtigfanen Kolonnedefinisjoner på siden Datautvekslingsdefinisjon.Kolonneoverskrift Angi tittelen for kolonnen i den eksterne filen som er tilordnet til feltet i feltet Måltabell-ID, når du bruker en mellomliggende tabell for dataimport. Felt-ID Angi hvilket felt kolonnen i feltet Kolonnenr. tildeles til.
Du kan bare velge blant felt som finnes i tabellen du har angitt i Tabell-ID-feltet i hurtigfanen Generelt.Felttekst Angi tittelen for feltet i den eksterne filen som er tilordnet til feltet i feltet Måltabell-ID , når du bruker en mellomliggende tabell for dataimport. Valgfri Angi om tilordningen skal hoppes over hvis feltet er tomt. Hvis du ikke merker av for dette alternativet, vil det oppstå en eksportfeil hvis feltet er tomt. Transformasjonsregel Angi regelen som omdanner importert tekst til en verdi som støttes, før den kan tilordnes til et angitt felt. Når du velger en verdi i dette feltet, blir den samme verdien angitt i feltet for Transformeringsregel i tabellen Buffer for felttilordning for datautveksl. og omvendt. Hvis du vil vite mer om hvordan du bruker transformasjonsregler, kan du gå til Transformasjonsregler. Overskriv verdi Angi at den nye verdien kan overskrive den gjeldende verdien. Prioritet Angi rekkefølgen som felttilordningene må behandles i. Felttilordningen med det høyeste prioritetsnummeret behandles først. Multiplikator Angi en multiplikator som skal brukes på numeriske data, inkludert negative verdier. Når Bruk som foreløpig tabell er aktivert:
Felt Description Kolonnenr. Angi hvilken kolonne i datafilen du vil definere en tilordning for.
Du kan bare velge kolonner som vises som linjer i hurtigfanen Kolonnedefinisjoner på siden Datautvekslingsdefinisjon.Kolonneoverskrift Angi tittelen for kolonnen i den eksterne filen som er tilordnet til feltet i feltet Måltabell-ID, når du bruker en mellomliggende tabell for dataimport. Måltabell-ID Angi tabellen som verdien i Kolonneoverskrift-feltet er tilordnet til, når du bruker en mellomliggende tabell for dataimport. Tabelloverskrift Angi navnet på tabellen i feltet Måltabell-ID , som er tabellen som verdien i Kolonneoverskrift-feltet er tilordnet til, når du bruker en mellomliggende tabell for dataimport. ID for målfelt Angi feltet i måltabellen som verdien i Kolonneoverskrift-feltet er tilordnet til, når du bruker en mellomliggende tabell for dataimport. Felttekst Angi navnet på feltet i måltabellen som verdien i Kolonneoverskrift-feltet er tilordnet til, når du bruker en mellomliggende tabell for dataimport. Bare valider Angi at element-til-felt-tilordningen ikke brukes til å konvertere data, men bare til å validere data. Transformasjonsregel Angi regelen som omdanner importert tekst til en verdi som støttes, før den kan tilordnes til et angitt felt. Når du velger en verdi i dette feltet, blir den samme verdien angitt i feltet for Transformeringsregel i tabellen Buffer for felttilordning for datautveksl. og omvendt. Hvis du vil vite mer om transformasjonsregler, kan du gå til Transformasjonsregler. Prioritet Angi rekkefølgen som felttilordningene må behandles i. Felttilordningen med det høyeste prioritetsnummeret behandles først.
På hurtigfanen Feltgruppering angir du regler du vil bruke til å gruppere feltene når du oppretter filen, ved å fylle ut feltene som beskrevet i tabellen nedenfor.
Felt Description Felt-ID Angi nummeret for feltet i den eksterne filen som brukes til gruppering, og dette feltet må angis av brukeren. Felttekst Angir tittelen for feltet i den eksterne filen som brukes til gruppering.
Transformasjonsregler
Hvis verdiene i feltene du tilordner, er forskjellige, må du bruke transformeringsregler for datautvekslingsdefinisjoner for å gjøre dem like. Du definerer transformeringsregler for datautvekslingsdefinisjoner ved å åpne en eksisterende definisjon eller opprette en ny definisjon, og deretter, på hurtigfanen Linjedefinisjoner, velger du Administrerog deretter Felttilordning. Forhåndsdefinerte regler er angitt, men du kan også opprette dine egne. Tabellen nedenfor beskriver hvilke typer transformasjoner du kan utføre.
| Alternativ | Beskrivelse |
|---|---|
| Store bokstaver | Gjør alle bokstaver til store bokstaver. |
| Små bokstaver | Gjør alle bokstaver til små bokstaver. |
| Tittelsak | Den første bokstaven i hvert ord er en stor bokstav. |
| Trimme | Fjern tomme mellomrom før og etter verdien. |
| Delstreng | Transformer en bestemt del av en verdi. Hvis du vil angi hvor transformasjonen skal starte, velger du enten Startposisjon eller Starttekst. Startposisjonen er et tall som representerer det første tegnet som skal transformeres. Startteksten er bokstaven rett foran bokstaven som skal erstattes. Hvis du vil begynne med den første bokstaven i verdien, bruker du en startposisjon i stedet. Hvis du vil angi hvor du vil stoppe transformeringen, velger du Lengde, som er antall tegn som skal erstattes, eller Sluttekst, som er tegnet som er rett etter det siste tegnet som skal transformeres. |
| Erstatte | Finn en verdi, og erstatt den med en annen. Denne transformasjonen er nyttig når du skal erstatte enkle verdier, for eksempel et bestemt ord. |
| Regulært uttrykk – erstatt | Bruk et regulært uttrykk som en del av en søk-og-erstatt-operasjon. Denne transformasjonen er nyttig for å erstatte flere, eller mer komplekse, verdier. |
| Fjerne ikke-alfanumeriske tegn | Slett tegn som ikke er bokstaver eller tall, for eksempel symboler eller spesialtegn. |
| Datoformatering | Angi hvordan datoer skal vises. Du kan for eksempel transformere DD-MM-ÅÅÅÅ til ÅÅÅÅ-MM-DD. |
| Desimalformatering | Definer regler for desimalplassering og avrundingspresisjon. |
| Regulært uttrykk – samsvar | Bruk et regulært uttrykk for å finne én eller flere verdier. Denne regelen ligner på alternativene Delstreng og Vanlig uttrykk - Erstatt. |
| Skikk | Denne transformasjonsregelen er et avansert alternativ som krever assistanse fra en utvikler. Det muliggjør en integreringshendelse som du kan abonnere på, hvis du vil bruke din egen transformeringskode. Hvis du er utvikler og vil bruke dette alternativet, kan du gå til Tips for utviklere: Eksempel på det egendefinerte alternativet. |
| Dato- og klokkeslettformatering | Definer hvordan gjeldende dato og tidspunktet på dagen skal vises. |
| Feltoppslag | Bruk felter fra forskjellige tabeller. Du må følge noen regler for å kunne bruke den. Først bruker du Tabell-ID til å angi ID-en for tabellen som inneholder posten for feltoppslaget. Deretter angir du ID-en til feltet som inneholder posten for feltoppslaget, i feltet Kildefelt-ID. Til slutt angir du ID-en til feltet for å finne posten for feltoppslaget, i feltet Målfelt-ID. Hvis du vil, kan du bruke feltet Feltoppslagsregel til å angi typen feltoppslag. Verdien fra Målfelt-ID brukes for målfeltet, selv om det er tomt. For feltet Original hvis målet er tomt brukes den opprinnelige verdien hvis målet er tomt. |
| Rund | Avrund verdien i dette feltet ved hjelp av noen tilleggsregler. I feltet Presisjon angir du en avrundingspresisjon. Deretter angir du avrundingsretningen i Retning-feltet. |
Merk
Lær mer om dato-og klokkeslettformatering på Standard formatstrenger for dato og klokkeslett.
Tips for utviklere: eksempel på det egendefinerte alternativet
Følgende eksempel viser hvordan du implementerer din egen transformeringskode.
codeunit 60100 "Hello World"
{
[EventSubscriber(ObjectType::Table, Database::"Transformation Rule", 'OnTransformation', '', false, false)]
procedure OnTransformation(TransformationCode: Code[20]; InputText: Text; var OutputText: Text)
begin
if TransformationCode = 'CUST' then
OutputText := InputText + ' testing';
end;
}
Når du har definert reglene, kan du teste dem. I hurtigfanen Test skriver du inn et eksempel på en verdi du vil transformere, og deretter kontrollerer du resultatene ved å velge Oppdater.
Eksporter en datautvekslingsdefinisjon som en XML-fil som andre kan bruke
Når du har opprettet datautvekslingsdefinisjonen for en bestemt datafil, kan du eksportere datautvekslingsdefinisjonen som en XML-fil som du kan importere. Denne oppgaven er beskrevet i følgende fremgangsmåte.
Velg ikonet
, skriv inn Datautvekslingsdefinisjoner, og velg deretter det relaterte opprette en kobling.Velg datautvekslingsdefinisjonen du vil eksportere.
Velg Eksporter datautvekslingsdefinisjon.
Lagre XML-filen som representerer datautvekslingsdefinisjonen, på en passende plassering.
Hvis en datautvekslingsdefinisjon allerede er opprettet, trenger du bare å importere XML-filen til rammeverket for datautveksling. Denne oppgaven er beskrevet i følgende fremgangsmåte.
Importere en eksisterende datautvekslingsdefinisjon
- Lagre XML-filen som representerer datautvekslingsdefinisjonen, på en passende plassering.
- Velg ikonet , skriv inn Datautvekslingsdefinisjoner, og velg deretter det relaterte opprette en kobling.
- Velg Importer datautvekslingsdefinisjon.
- Velg filen du lagret i trinn 1.
Se også
Konfigurere datautveksling
Konfigurere sending og mottak av elektroniske dokumenter
Innkreve betalinger med SEPA Direct Debit
Foreta betalinger med AMC Banking 365 Fundamentals forlengelse eller SEPA-kredittoverføring
Inngående dokumenter
Generell forretningsfunksjonalitet