Configurarea definițiilor Exchange de date

Aveți posibilitatea să parametrizați Business Central pentru a face schimb de date în anumite tabele cu date din fișiere externe, de exemplu pentru a trimite și primi documente electronice, pentru a importa și exporta date bancare sau alte date, ar fi salarii, cursuri de schimb valutar și cataloage de articole. Pentru mai multe informații, consultați Schimbul electronic de date.

Ca pregătire pentru crearea unei definiții de schimb de date pentru un fișier de date sau un flux de date, aveți posibilitatea să utilizați schema XML corelată pentru a defini ce elemente de date să includeți pe fila sintetică Definiții coloană. Consultați pasul 6 din Pentru a descrie formatarea liniilor și coloanelor din fișier. Pentru mai multe informații, consultați utilizarea schemelor XML pentru pregătirea definițiilor exchange de date.

În mod normal, parametrizați definiții de schimb de date în pagina Definiție Exchange de date. Cu toate acestea, când parametrizați o definiție de schimb de date pentru serviciul de reîmprospătare a cursurilor de schimb valutar, porniți procesul în pagina simplificată a fișei de parametrizare actualizare curs de schimb valutar.

Notă

Dacă fișierul care este convertit este în format XML, termenul "coloană" din acest subiect trebuie interpretat ca "element XML care conține date".

Acest subiect include următoarele proceduri:

Pentru a crea o definiție de schimb de date
Pentru a exporta o definiție de schimb de date ca fișier XML pentru a fi utilizat de alte persoane
Pentru a importa un fișier XML pentru o definiție existentă a schimbului de date

Pentru a crea o definiție de schimb de date

Crearea unei definiții de schimb de date implică două activități:

Pe pagina Definiție Exchange de date, descrieți formatarea liniilor și coloanelor din fișier.
Pe pagina Mapare Exchange de date, mapați coloanele din fișierul de date la câmpurile din Business Central.

Acest lucru este descris în următoarele proceduri.

Sfat

Pentru a vedea ce codeunit-uri utilizează Microsoft în definițiile existente în produsul standard, examinați cele trei câmpuri Codeunit de pe antetul paginii Mapare câmp pentru fiecare definiție.

Pentru a descrie formatarea liniilor și coloanelor din fișier

În caseta Căutare, introduceți Definiții schimb de date, apoi alegeți linkul corelat.
Alegeți acțiunea Nouă.

Pe fila sintetică General, descrieți definiția schimbului de date și tipul fișierului de date completând câmpurile descrise în tabelul următor.

câmp

	Definiție
Codul	Introduceți un cod pentru a identifica definiția schimbului de date.
nume	Introduceți un nume pentru definiția schimbului de date.
Tip fișier	Specificați pentru ce tip de fișier se utilizează definiția schimbului de date. Aveți posibilitatea să selectați între patru tipuri de fișiere: - XML: Șiruri stratificate de conținut și marcaje înconjurate de etichete care indică funcția. - Text variabil: Înregistrările au lungime variabilă și sunt separate de un caracter, ar fi virgula sau punct și virgulă. De asemenea, cunoscut sub numele de fișier delimitat. - Text fix: Înregistrările au aceeași lungime, utilizând caractere pad, și fiecare înregistrare este pe o linie separată. De asemenea, cunoscut sub numele de fișier cu lățime fixă. - Json:șiruri stratificate de conținut în JavaScript.
Tip	Specificați pentru ce tip de activitate de afaceri se utilizează definiția schimbului de date, ar fi Export plată.
Codeunit de tratare a datelor	Specificați codeunit-ul care transferă date în și din tabele în Business Central.
Codeunit de validare	Specificați codeunit-ul care este utilizat pentru a valida datele în raport cu regulile de afaceri predefinite.
Codeunit citire/scriere	Specificați codeunit-ul care procesează datele importate înainte de mapare și datele exportate după mapare.
Citire/scriere XMLport	Specificați portul XMLport prin care intră un fișier sau serviciu de date importat înainte de mapare și prin care datele exportate ies atunci când sunt scrise într-un fișier de date sau într-un serviciu după mapare.
Codeunit de tratare a datelor ext.	Specificați codeunit-ul care transferă date externe în și din cadrul de schimb de date.
Codeunit feedback utilizator	Specificați codeunit-ul care face diverse curățare după mapare, ar fi marcajele liniilor ca exportate și șterge înregistrările temporare.
Codificare fișier	Specificați codificarea fișierului. Notă: Acest câmp este relevant numai pentru import.
Separator coloană	Specificați modul în care sunt separate coloanele din fișierul de date, dacă fișierul este de tip Text variabil.
Linii antet	Specificați câte linii de antet există în fișier. Acest lucru asigură că datele antet nu este importat. Notă: Acest câmp este relevant numai pentru import.
Etichetă antet	Dacă există o linie antet în mai multe poziții din fișier, introduceți textul primei coloane de pe linia antetului. Acest lucru asigură că datele antet nu este importat. Notă: Acest câmp este relevant numai pentru import.
Etichetă subsol	Dacă există o linie de subsol în mai multe poziții din fișier, introduceți textul primei coloane din linia de subsol. Acest lucru asigură că datele subsolului nu sunt importate. Notă: Acest câmp este relevant numai pentru import.

Pe fila sintetică Definiții linie, descrieți formatarea liniilor din fișierul de date completând câmpurile descrise în tabelul următor.

Notă

Pentru importul extraselor bancare, creați o singură linie pentru formatul unic al fișierului extras bancar pe care doriți să îl importați.

Pentru exportul de plăți, aveți posibilitatea să creați o linie pentru fiecare tip de plată pe care doriți să îl exportați. În acest caz, fila sintetică Definiții coloană afișează coloane diferite pentru fiecare tip de plată.

câmp

	Descriere
Codul	Introduceți un cod pentru a identifica linia din fișier.
nume	Introduceți un nume care descrie linia din fișier.
Contor coloane	Specificați câte coloane are linia din fișierul de date. Notă: Acest câmp este relevant numai pentru import.
Etichetă linie de date	Specificați poziția din schema XML corelată a elementului care reprezintă intrarea principală a fișierului de date. Notă: Acest câmp este relevant numai pentru import.
Nume	Specificați spațiul de nume așteptat în fișier, pentru a activa validarea spațiului de nume. Aveți posibilitatea să lăsați acest câmp necompletat dacă nu doriți să activați validarea spațiului de nume.

Repetați pasul 4 pentru a crea o linie pentru fiecare tip de date de fișier pe care doriți să le exportați.

Continuați pentru a descrie formatarea coloanelor din fișierul de date completând câmpurile din fila sintetică Definiții coloane, așa este descris în tabelul de mai jos. Aveți posibilitatea să utilizați fișierul structură, ar fi un. XSD, pentru ca fișierul de date să preumile fila sintetică cu elementele relevante. Pentru mai multe informații, consultați Utilizarea schemelor XML pentru pregătirea definițiilor exchange de date.
Pe fila sintetică Definiții coloană, selectați Se obține structura fișierului.
Pe pagina Obțineți structura fișierului, selectați fișierul structură corelat, apoi alegeți butonul OK. Liniile de pe fila sintetică Definiții coloană sunt completate în funcție de structura fișierului de date.

Pe fila sintetică Definiții coloană, editați sau completați câmpurile așa este descris în tabelul următor.

câmp

	Descriere
Nr. coloană	Specificați numărul care reflectă poziția coloanei pe linia din fișier. Pentru fișierele XML, specificați numărul care reflectă tipul de element din fișierul care conține datele.
nume	Specificați numele coloanei. Pentru fișierele XML, specificați marcajul care marchează datele de schimbat.
Tip de date	Specificați dacă datele de schimbat sunt de tip Text, Datăsau Zecimal.
Format date	Specificați formatul datelor, dacă există. De exemplu, MM-dd-yyyy dacă tipul de date este Data. Notă: Pentru export, specificați formatul de date în conformitate cu Business Central. Pentru import, specificați formatul de date conform .NET Framework. Pentru mai multe informații, consultați Șiruri de format dată și oră standard.
Cultură formatare date	Specificați cultura formatului de date, dacă există. De exemplu, en-US dacă tipul de date este Zecimal pentru a vă asigura că virgula este utilizată ca separator .000, în conformitate cu formatul SUA. Pentru mai multe informații, consultați Șiruri de format dată și oră standard. Notă: Acest câmp este relevant numai pentru import.
Lungime	Specificați lungimea liniei cu lățime fixă care reține coloana dacă fișierul de date este de tip Text fix.
Descrierea /	Introduceți o descriere a coloanei, pentru informații.
Calea	Specificați poziția elementului în schema XML corelată.
Identificator semn negativ	Introduceți valoarea utilizată în fișierul de date pentru a identifica sumele negative, în fișierele de date care nu pot conține semne negative. Acest identificator este apoi utilizat pentru a inversa sumele identificate în semne negative în timpul importului. Notă: Acest câmp este relevant numai pentru import.
Constantă	Specificați toate datele pe care doriți să le exportați în această coloană, ar fi informații suplimentare despre tipul de plată. Notă: Acest câmp este relevant numai pentru export.

Repetați pasul 8 pentru fiecare coloană sau element XML din fișierul de date care are date pe care doriți să le schimbați cu Business Central.

Următorul pas în crearea unei definiții de schimb de date este să decideți ce coloane sau elemente XML din maparea fișierului de date la ce câmpuri din Business Central.

Notă

Maparea specifică depinde de scopul de afaceri al fișierului de date care urmează să fie schimbat și de variațiile locale. Chiar și standardul băncii SEPA are variații locale. Business Central acceptă importul fișierelor de extras bancar SEPA CAMT out-of-the-box. Aceasta este reprezentată de codul de înregistrare a definiției schimbului de date SEPA CAMT din pagina Definiții schimb de date. Pentru informații despre maparea specifică a câmpului din acest suport SEPA CAMT, consultați Maparea câmpurilor la importul fișierelor SEPA CAMT.

Pentru a mapa coloanele din fișierul de date la câmpurile din Business Central

Sfat

Uneori, valorile din câmpurile pe care doriți să le mapați sunt diferite. De exemplu, într-o aplicație de afaceri, codul de limbă pentru Statele Unite este "S.U.A." dar în celălalt este "SUA." Aceasta înseamnă că trebuie să transformați valoarea atunci când faceți schimb de date. Acest lucru se întâmplă prin regulile de transformare pe care le definiți pentru câmpuri. Pentru mai multe informații, consultați Reguli de transformare.

Pe fila sintetică Definiții linie, selectați linia pentru care doriți să mapați coloanele la câmpuri, apoi selectați Mapare câmp. Se deschide pagina Mapare Exchange de date.

Pe fila sintetică General, specificați parametrizarea mapării completând câmpurile așa sunt descrise în tabelul următor.

câmp

	Descriere
ID tabel	Specificați tabelul care conține câmpurile în sau din care sunt schimbate datele în conformitate cu maparea.
Utilizare ca tabel intermediar	Specificați dacă tabelul pe care îl selectați în câmpul ID tabel este un tabel intermediar în care sunt stocate datele importate înainte de a fi mapate la tabelul țintă. De obicei utilizați un tabel intermediar atunci când definiția schimbului de date este utilizată pentru importul și conversia documentelor electronice, ar fi facturile de furnizor în facturi de cumpărare în Business Central. Pentru mai multe informații, consultați Schimbul electronic de date.
nume	Introduceți un nume pentru parametrizarea mapării.
Pre-Mapare Codeunit	Specificați codeunit-ul care pregătește maparea între câmpurile din Business Central și datele externe.
Codeunit mapare	Specificați codeunit-ul care este utilizat pentru a mapa coloanele specificate sau elementele de date XML la câmpurile din Business Central.
Codeunit post-mapare	Specificați codeunit-ul care completează maparea între câmpurile din Business Central și datele externe. Notă: Când utilizați caracteristica de extensie AMC Banking 365 Fundamentals, codeunit-ul convertește datele exportate din Business Central într-un format generic care este gata pentru export. Pentru import, codeunit-ul face conversia datelor externe într-un format care este gata pentru import în Business Central.

Pe fila sintetică Mapare câmp, specificați coloanele care se mapează la câmpurile din Business Central completând câmpurile descrise în tabelul următor.

câmp

	Descriere
Nr. coloană	Specificați coloana din fișierul de date pentru care doriți să definiți o hartă. Aveți posibilitatea să selectați numai coloanele care sunt reprezentate de linii pe fila sintetică Definiții coloane din pagina Definiție Exchange de date.
ID câmp	Specificați câmpul la care este specificată coloana din câmpul Nr. coloană. Aveți posibilitatea să selectați numai din câmpurile care există în tabelul pe care l-ați specificat în câmpul Tabel de pe fila sintetică General.
Opţional	Specificați că harta va fi ignorată dacă câmpul este gol. Notă: Dacă nu bifați această casetă de selectare, va apărea o eroare de export dacă câmpul este gol. Notă: Acest câmp este relevant numai pentru export.
ID tabel țintă	Vizibilă numai când este bifată caseta de selectare Utilizare ca tabel intermediar. Specificați tabelul la care este mapată valoarea din câmpul Legendă coloană, când utilizați un tabel intermediar pentru importul de date.
Legendă tabel țintă	Vizibilă numai când este bifată caseta de selectare Utilizare ca tabel intermediar. Specificați numele tabelului în câmpul ID tabel țintă, care este tabelul la care este mapată valoarea din câmpul Legendă coloană, atunci când utilizați un tabel intermediar pentru importul de date.
ID câmp țintă	Vizibilă numai când este bifată caseta de selectare Utilizare ca tabel intermediar. Specificați câmpul din tabelul țintă la care este mapată valoarea din câmpul Legendă coloană, când utilizați un tabel intermediar pentru importul de date.
Legendă câmp țintă	Vizibilă numai când este bifată caseta de selectare Utilizare ca tabel intermediar. Specificați numele câmpului din tabelul țintă la care este mapată valoarea din câmpul Legendă coloană, atunci când utilizați un tabel intermediar pentru importul de date.
Opţional	Vizibilă numai când este bifată caseta de selectare Utilizare ca tabel intermediar. Specificați dacă harta trebuie ignorată dacă câmpul este gol. Dacă nu bifați această casetă de selectare, atunci va apărea o eroare de export dacă câmpul este gol.

Definiția schimbului de date este acum gata pentru a fi activată pentru utilizatori. Pentru mai multe informații, consultați Configurarea trimiterii și primirii documentelor electronice, Configurarea transferului de credit SEPA, Colectarea plăților cu debitul direct SEPAși Efectuarea plăților cu extensia AMC Banking 365 Fundamentals sau Transferul de credit SEPA.

Reguli de transformare

Dacă valorile din câmpurile pe care le mapați diferă, trebuie să utilizați regulile de transformare pentru definițiile schimbului de date pentru a le face aceleași. Definiți reguli de transformare pentru definițiile de schimb de date deschizând o definiție existentă sau creând o definiție nouă, apoi pe fila sintetică Definiții linie, selectând Gestionare, apoi Mapare câmp. Sunt furnizate reguli predefinite, dar aveți posibilitatea să le creați și pe ale dvs. Următorul tabel descrie tipurile de transformări pe care le puteți efectua.

Descriere opțiune
Majuscule	Scrie cu majusculă toate literele.
Litere mici	Faceți toate literele minuscule.
Caz titlu	Scrieți cu majusculă prima literă a fiecărui cuvânt.
Trim	Eliminați spațiile goale înainte și după valoare.
Subșir	Transformați o anumită porțiune a unei valori. Pentru a specifica de unde să porniți transformarea, selectați fie o poziție de început, fie un text de pornire. Poziția de pornire este un număr care reprezintă primul caracter de transformat. Textul de pornire este litera imediat înainte de litera de înlocuit. Dacă doriți să începeți cu prima literă din valoare, utilizați în schimb o poziție de pornire. Pentru a specifica unde să opriți transformarea, alegeți fie Lungime, care este numărul de caractere de înlocuit, fie Textul final, care este caracterul care este imediat după ultimul caracter de transformat.
Înlocui	Găsiți o valoare și înlocuiți-o cu alta. Acest lucru este util pentru înlocuirea valorilor simple, ar fi un anumit cuvânt.
Expresie regulată - Înlocuire	Utilizați o expresie regulată ca parte a unei operațiuni de găsire și înlocuire. Acest lucru este util pentru înlocuirea mai multor valori sau poate mai complexe.
Eliminare caractere non-alfanumerice	Ștergeți caracterele care nu sunt litere sau numere, ar fi simboluri sau caractere speciale.
Formatare dată	Specificați se afișează datele. De exemplu, aveți posibilitatea să transformați DD-MM-YYYY în YYYY-MM-DD.
Formatare zecimală	Definiți reguli pentru plasarea zecimală și precizia rotunjirii.
Expresie regulată - Potrivire	Utilizați o expresie obișnuită pentru a găsi una sau mai multe valori. Acest lucru este similar cu subșir și expresie regulată - Înlocuire opțiuni.
Particularizate	Aceasta este o opțiune complexă care necesită asistență de la un dezvoltator. Acesta permite un eveniment de integrare la care vă puteți abona dacă doriți să utilizați propriul cod de transformare. Dacă sunteți dezvoltator și doriți să utilizați această opțiune, consultați secțiunea "Sfat pentru dezvoltatori: exemplu de opțiune personalizată" de mai jos.
Formatare dată și oră	Definiți se afișează data curentă, precum și ora din zi.

Sfat pentru dezvoltatori: Exemplu de opțiune particularizată

Următorul exemplu arată să implementați propriul cod de transformare.

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;
}

După ce vă definiți regulile, le puteți testa. În secțiunea Testare, introduceți un exemplu de valoare pe care doriți să o transformați, apoi verificați rezultatele.

Pentru a exporta o definiție de schimb de date ca fișier XML pentru a fi utilizat de alte persoane

După ce ați creat definiția schimbului de date pentru un anumit fișier de date, aveți posibilitatea să exportați definiția schimbului de date ca fișier XML pe care îl puteți importa. Acest lucru este descris în următoarea procedură.

În caseta Căutare, introduceți Definiții schimb de date, apoi alegeți linkul corelat.
Selectați definiția schimbului de date pe care doriți să o exportați.
Alegeți acțiunea Export definiție Exchange de date.
Salvați fișierul XML care reprezintă definiția schimbului de date într-o locație adecvată.

Dacă s-a creat deja o definiție de schimb de date, trebuie doar să importați fișierul XML în Cadrul de schimb de date. Acest lucru este descris în următoarea procedură.

Pentru a importa o definiție existentă a schimbului de date

Salvați fișierul XML care reprezintă definiția schimbului de date într-o locație adecvată.
În caseta Căutare, introduceți Definiții schimb de date, apoi alegeți linkul corelat.
Alegeți acțiunea Nouă. Se deschide pagina Data Exchange Definitio.
Alegeți acțiunea Import definiție Exchange de date.
Alegeți fișierul pe care l-ați salvat în pasul 1.

A se vedea, de asemenea,

Parametrizarea schimbului de date
Configurarea trimiterii și primirii documentelor electronice
Colectarea plăților cu debitul direct SEPA
Efectuarea plăților cu extensia AMC Banking 365 Fundamentals sau transferul de credit SEPA
Documente de intrare
Funcționalitate generală de afaceri

Notă

Ne puteți spune despre preferințele dumneavoastră lingvistice de documentare? Fă un scurt sondaj.

Sondajul va dura aproximativ șapte minute. Nu sunt colectate date cu caracter personal(declarație de confidențialitate).