© navision.pl | Opracowano na podstawie: Microsoft Learn (CC BY 4.0)

Konfigurowanie definicji wymiany danych

Można skonfigurować Business Central do wymiany danych w określonych tabelach z danymi w plikach zewnętrznych. Na przykład do wysyłania i odbierania dokumentów elektronicznych, importowania i eksportowania danych bankowych lub innych danych, takich jak listy płac i katalogi zapasów. Dowiedz się więcej w artykule Dokumenty elektroniczne w Business Central.

Aby utworzyć definicję wymiany danych dla pliku lub strumienia danych, można użyć powiązanego schematu XML do określenia, które elementy danych mają być uwzględnione na skróconej karcie Definicje kolumn. Zobacz krok 6 w sekcji Definiowanie sposobu elektronicznej wymiany danych. Dowiedz się więcej w artykule Schematy XML do przygotowania definicji wymiany danych.

Zazwyczaj definicje wymiany danych konfiguruje się na stronie Definicja wymiany danych. Jednak w przypadku aktualizowania kursów wymiany walut szybsze jest użycie usługi kursów wymiany walut. Dowiedz się więcej w artykule Aktualizowanie kursów wymiany walut.

Uwaga

Jeśli konwertowany plik jest w formacie XML, termin "kolumna" w tym artykule należy interpretować jako "element XML zawierający dane".

Ten artykuł zawiera następujące procedury:

Tworzenie definicji wymiany danych.
Eksportowanie definicji wymiany danych jako pliku XML do użycia przez innych.
Importowanie pliku XML dla istniejącej definicji wymiany danych.

Tworzenie definicji wymiany danych

Tworzenie definicji wymiany danych obejmuje dwa zadania:

Na stronie Definicja wymiany danych opisz formatowanie wierszy i kolumn w pliku. Dowiedz się więcej w sekcji Aby opisać formatowanie wierszy i kolumn w pliku.
Na stronie Mapowanie wymiany danych zmapuj kolumny w pliku danych na pola w Business Central. Dowiedz się więcej w sekcji Aby zmapować kolumny w pliku danych na pola w Business Central.

Aby opisać formatowanie wierszy i kolumn w pliku

Wybierz ikonę , wprowadź Definicje wymiany danych, a następnie wybierz powiązane łącze.
Wybierz akcję Nowy.

Na skróconej karcie Ogólne opisz definicję wymiany danych i typ pliku danych, wypełniając pola zgodnie z opisem w poniższej tabeli.

Pole	Definicja
Kod	Wprowadź kod identyfikujący definicję wymiany danych.
Nazwa	Wprowadź nazwę definicji wymiany danych.
Typ pliku	Specify what type of file the data exchange definition is used for. You can select between four file types: - XML: Layered strings of content and markup surrounded by tags indicating function. - Variable Text: Records have variable length and are separated by a character, such as a comma or semi-colon, also known as delimited file. - Fixed Text: Records have the same length, using pad characters, and each record is on a separate line, also known as fixed-width file. - Json: Layered strings of content in JavaScript.
Typ	Określ typ działalności biznesowej, dla której jest używana definicja wymiany danych, na przykład Eksport płatności.
Codeunit obsługi danych	Określ codeunit, który przenosi dane do i z tabel w Business Central.
Codeunit walidacji	Określ jednostkę kodu, która służy do walidacji danych względem predefiniowanych reguł biznesowych.
Jednostka kodu odczytu/zapisu	Określ jednostkę kodu, która przetwarza zaimportowane dane przed mapowaniem oraz wyeksportowane dane po mapowaniu.
XMLport odczytu/zapisu	Określ XMLport, przez który zaimportowany plik danych lub usługa wchodzi przed mapowaniem, oraz przez który wyeksportowane dane są zapisywane do pliku danych lub usługi po mapowaniu.
Jednostka kodu obsługi danych zewn.	Określ jednostkę kodu, która przesyła dane zewnętrzne do i z platformy wymiany danych.
Jednostka kodu informacji zwrotnej użytkownika	Określ jednostkę kodu, która wykonuje różne operacje porządkowania po mapowaniu, takie jak oznaczanie wierszy jako wyeksportowanych i usuwanie rekordów tymczasowych.
Kodowanie pliku	Określ kodowanie pliku. Uwaga: To pole dotyczy tylko importu.
Separator kolumn	Określ sposób rozdzielania kolumn w pliku danych, jeśli plik jest typu Tekst zmienny.
Wiersze nagłówka	Określ, ile wierszy nagłówka istnieje w pliku. To ustawienie zapewnia, że dane nagłówka nie zostaną zaimportowane. Uwaga: To pole dotyczy tylko importu.
Znacznik nagłówka	Jeśli wiersz nagłówka występuje w kilku pozycjach w pliku, wprowadź tekst pierwszej kolumny w wierszu nagłówka. Ta opcja zapewnia, że dane nagłówka nie zostaną zaimportowane. Uwaga: To pole dotyczy tylko importu.
Znacznik stopki	Jeśli wiersz stopki występuje w kilku pozycjach w pliku, wprowadź tekst pierwszej kolumny w wierszu stopki. Ta opcja zapewnia, że dane stopki nie zostaną zaimportowane. Uwaga: To pole dotyczy tylko importu.

Porada

Aby sprawdzić, których jednostek kodu Microsoft używa w istniejących definicjach w produkcie standardowym, przejrzyj trzy pola Jednostka kodu na stronie Mapowanie pól dla każdej definicji.

Na skróconej karcie Definicje wierszy opisz formatowanie wierszy w pliku danych, wypełniając pola zgodnie z opisem w poniższej tabeli.

Uwaga

W przypadku importu wyciągów bankowych tworzysz tylko jeden wiersz dla pojedynczego formatu pliku wyciągu bankowego, który chcesz zaimportować. W przypadku eksportu płatności możesz utworzyć wiersz dla każdego typu płatności, który chcesz wyeksportować. W takim przypadku skrócona karta Definicje kolumn pokazuje różne kolumny dla każdego typu płatności.

Powtórz krok 4, aby utworzyć wiersz dla każdego typu danych pliku, który chcesz wyeksportować.

Przejdź do opisu formatowania kolumn w pliku danych, wypełniając pola na skróconej karcie Definicje kolumn zgodnie z opisem w tabeli w kroku 8. Możesz użyć pliku struktury, takiego jak plik .xsd, aby wstępnie wypełnić skróconą kartę odpowiednimi elementami. Dowiedz się więcej na stronie Schematy XML do przygotowania definicji wymiany danych.
Na skróconej karcie Definicje kolumn wybierz akcję Pobierz strukturę pliku.
Na stronie Pobierz strukturę pliku wybierz powiązany plik struktury, a następnie wybierz OK. Wiersze na skróconej karcie Definicje kolumn zostaną wypełnione zgodnie ze strukturą pliku danych.

Na skróconej karcie Definicje kolumn edytuj lub wypełnij pola zgodnie z opisem w poniższej tabeli.

Pole	Opis
Nr kolumny	Określ numer odzwierciedlający pozycję kolumny w wierszu w pliku. W przypadku plików XML określ numer odzwierciedlający typ elementu w pliku zawierającego dane.
Nazwa	Określ nazwę kolumny. W przypadku plików XML określ znacznik oznaczający dane do wymiany.
Typ danych	Określ, czy dane do wymiany są typu Tekst, Data czy Dziesiętny.
Format danych	Określ format danych, jeśli dotyczy. Na przykład MM-dd-yyyy, jeśli typ danych to Data. Uwaga: W przypadku eksportu określ format danych zgodnie z Business Central. W przypadku importu określ format danych zgodnie z .NET Framework. Dowiedz się więcej na stronie Standardowe ciągi formatów daty i godziny.
Kultura formatowania danych	Określ regionalny format danych, jeśli dotyczy. Na przykład en-US, jeśli typ danych to Dziesiętny, aby upewnić się, że przecinek jest używany jako separator 0,000 zgodnie z formatem amerykańskim. Dowiedz się więcej na stronie Standardowe ciągi formatów daty i godziny. Uwaga: To pole dotyczy tylko importu.
Długość	Określ długość wiersza o stałej szerokości zawierającego kolumnę, jeśli plik danych jest typu Tekst stały.
Opis	Określa opis kolumny w celach informacyjnych.
Ścieżka	Określ pozycję elementu w powiązanym schemacie XML.
Identyfikator znaku ujemnego	Wprowadź wartość używaną w pliku danych do identyfikowania kwot ujemnych w plikach danych, które nie mogą zawierać znaków ujemnych. Ten identyfikator jest następnie używany do konwersji zidentyfikowanych kwot na znaki ujemne podczas importu. Uwaga: To pole dotyczy tylko importu.
Stała	Określ dowolne dane, które chcesz wyeksportować w tej kolumnie, takie jak dodatkowe informacje o typie płatności. Uwaga: To pole dotyczy tylko eksportu.
Wymagane dopełnienie tekstu	Określ, że dane muszą zawierać dopełnienie tekstu.
Znak dopełnienia	Określ znak dopełnienia tekstu.
Justowanie	Określ, czy justowanie kolumny jest lewe czy prawe.

Powtórz krok 8 dla każdej kolumny lub elementu XML w pliku danych, który zawiera dane, które chcesz wymieniać z Business Central.

Następnym krokiem w tworzeniu definicji wymiany danych jest określenie, które kolumny lub elementy XML w pliku danych są mapowane na które pola w Business Central.

Uwaga

Konkretne mapowanie zależy od celu biznesowego pliku danych do wymiany i od lokalnych wariantów. Nawet standard bankowy SEPA ma lokalne warianty. Business Central obsługuje import plików wyciągów bankowych SEPA CAMT od razu po instalacji. Jest to reprezentowane przez kod rekordu definicji wymiany danych SEPA CAMT na stronie Definicje wymiany danych. Aby dowiedzieć się więcej o konkretnym mapowaniu pól dla tej obsługi SEPA CAMT, przejdź do Mapowanie pól podczas importowania plików SEPA CAMT.

Aby mapować kolumny w pliku danych na pola w Business Central

Porada

Czasami wartości w polach, które chcesz mapować, są różne. Na przykład w jednej aplikacji biznesowej kod języka dla Stanów Zjednoczonych to "U.S.", ale w innej to "US". Oznacza to, że musisz przekształcić wartość podczas wymiany danych. Dzieje się to poprzez reguły transformacji, które definiujesz dla pól. Dowiedz się więcej w Definiowanie sposobu elektronicznej wymiany danych.

Możesz także grupować według dowolnego pola, używać indeksu klucza do sortowania wyników oraz nowych typów transformacji Zaokrąglanie i Wyszukiwanie pola.

Na skróconej karcie Definicje wierszy wybierz wiersz, dla którego chcesz mapować kolumny na pola, a następnie wybierz Mapowanie pól. Zostanie otwarta strona Mapowanie wymiany danych.

Na skróconej karcie Ogólne określ konfigurację mapowania, wypełniając pola zgodnie z opisem w poniższej tabeli.

Pole	Opis
Identyfikator tabeli	Określ tabelę, która zawiera pola, do których lub z których dane są wymieniane zgodnie z mapowaniem.
Użyj jako tabeli pośredniej	Określ, czy tabela wybrana w polu Identyfikator tabeli jest tabelą pośrednią, w której importowane dane są przechowywane przed mapowaniem do tabeli docelowej. Tabela pośrednia jest zwykle używana, gdy definicja wymiany danych importuje i konwertuje dokumenty elektroniczne w Business Central. Na przykład dokumenty takie jak faktury od dostawców na faktury zakupu. Dowiedz się więcej w Dokumenty elektroniczne w Business Central.
Nazwa	Wprowadź nazwę dla konfiguracji mapowania.
Indeks klucza	Określ indeks klucza do sortowania rekordów źródłowych przed eksportem.
Jednostka Codeunit przed mapowaniem	Określ jednostkę Codeunit, która przygotowuje mapowanie między polami w Business Central a danymi zewnętrznymi.
Jednostka Codeunit mapowania	Określ jednostkę Codeunit używaną do mapowania określonych kolumn lub elementów danych XML na pola w Business Central.
Jednostka Codeunit po mapowaniu	Określ jednostkę Codeunit, która kończy mapowanie między polami w Business Central a danymi zewnętrznymi. Uwaga: Podczas korzystania z rozszerzenia AMC Banking 365 Fundamentals jednostka Codeunit konwertuje wyeksportowane dane z Business Central do formatu ogólnego gotowego do eksportu. W przypadku importu jednostka Codeunit konwertuje dane zewnętrzne do formatu gotowego do importu do Business Central.

Na skróconej karcie Mapowanie pól określ, które kolumny są mapowane na które pola w Business Central, wypełniając pola zgodnie z opisem w poniższych tabelach, w zależności od tego, czy pole Użyj jako tabeli pośredniej jest włączone.

Przy wyłączonym przełączniku Użyj jako tabeli pośredniej:

Pole	Opis
Nr kolumny	Określ, dla której kolumny w pliku danych chcesz zdefiniować mapowanie. Możesz wybrać tylko kolumny reprezentowane przez wiersze na skróconej karcie Definicje kolumn na stronie Definicja wymiany danych.
Podpis kolumny	Określ podpis kolumny w pliku zewnętrznym, który jest mapowany na pole w polu Identyfikator tabeli docelowej podczas korzystania z tabeli pośredniej do importu danych.
Identyfikator pola	Określ, na które pole jest mapowana kolumna w polu Nr kolumny. Możesz wybierać tylko spośród pól istniejących w tabeli określonej w polu Identyfikator tabeli na skróconej karcie Ogólne.
Podpis pola	Określ podpis pola w pliku zewnętrznym, który jest mapowany na pole w polu Identyfikator tabeli docelowej podczas korzystania z tabeli pośredniej do importu danych.
Opcjonalne	Określ, czy mapowanie powinno zostać pominięte, jeśli pole jest puste. Jeśli nie wybierzesz tej opcji, wystąpi błąd eksportu, gdy pole będzie puste.
Reguła transformacji	Określ regułę, która przekształca zaimportowany tekst na obsługiwaną wartość, zanim będzie można go mapować na określone pole. Po wybraniu wartości w tym polu ta sama wartość jest wprowadzana w polu Reguła transformacji w tabeli Bufor mapowania pól wymiany danych i odwrotnie. Aby dowiedzieć się więcej o stosowaniu reguł transformacji, przejdź do Reguły transformacji.
Zastąp wartość	Określ, że nowa wartość może zastąpić bieżącą wartość.
Priorytet	Określ kolejność przetwarzania mapowań pól. Mapowanie pola z najwyższym numerem priorytetu jest przetwarzane jako pierwsze.
Mnożnik	Określ mnożnik, który ma być stosowany do danych liczbowych, w tym wartości ujemnych.

Po włączeniu przełącznika Użyj jako tabeli pośredniej:

Pole	Opis
Nr kolumny	Określ, dla której kolumny w pliku danych chcesz zdefiniować mapowanie. Możesz wybrać tylko kolumny reprezentowane przez wiersze na skróconej karcie Definicje kolumn na stronie Definicja wymiany danych.
Podpis kolumny	Określ podpis kolumny w pliku zewnętrznym, który jest mapowany na pole w polu Identyfikator tabeli docelowej podczas korzystania z tabeli pośredniej do importu danych.
Identyfikator tabeli docelowej	Określ tabelę, do której jest mapowana wartość w polu Nagłówek kolumny, gdy używasz tabeli pośredniej do importu danych.
Nagłówek tabeli	Określ nazwę tabeli w polu Identyfikator tabeli docelowej, czyli tabeli, do której jest mapowana wartość w polu Nagłówek kolumny, gdy używasz tabeli pośredniej do importu danych.
Identyfikator pola docelowego	Określ pole w tabeli docelowej, do którego jest mapowana wartość w polu Nagłówek kolumny, gdy używasz tabeli pośredniej do importu danych.
Podpis pola	Określ nazwę pola w tabeli docelowej, do którego jest mapowana wartość w polu Nagłówek kolumny, gdy używasz tabeli pośredniej do importu danych.
Tylko sprawdzanie poprawności	Określ, że mapowanie elementu na pole nie jest używane do konwertowania danych, ale tylko do sprawdzania poprawności danych.
Reguła transformacji	Określ regułę, która przekształca zaimportowany tekst na obsługiwaną wartość, zanim będzie można go zmapować do określonego pola. Po wybraniu wartości w tym polu ta sama wartość jest wprowadzana w polu Reguła przekształcenia w tabeli Bufor mapowania pól wymiany danych i odwrotnie. Aby dowiedzieć się więcej o regułach przekształcenia, przejdź do sekcji Reguły przekształcenia.
Priorytet	Określ kolejność przetwarzania mapowań pól. Mapowanie pola z najwyższym numerem priorytetu jest przetwarzane jako pierwsze.

Na skróconej karcie Grupowanie pól określ reguły, których chcesz użyć do grupowania pól podczas tworzenia pliku, wypełniając pola zgodnie z opisem w poniższej tabeli.

Pole	Opis
Identyfikator pola	Określ numer pola w pliku zewnętrznym, które jest używane do grupowania i które użytkownik musi ustawić.
Podpis pola	Określ nagłówek pola w pliku zewnętrznym, które jest używane do grupowania.

Reguły przekształcenia

Jeśli wartości w mapowanych polach różnią się, musisz użyć reguł przekształcenia dla definicji wymiany danych, aby je ujednolicić. Reguły przekształcenia dla definicji wymiany danych definiujesz, otwierając istniejącą definicję lub tworząc nową, a następnie na skróconej karcie Definicje wierszy wybierając Zarządzaj, a następnie Mapowanie pól. Dostępne są predefiniowane reguły, ale możesz też tworzyć własne. Poniższa tabela opisuje typy przekształceń, które możesz wykonać.

Opcja	Opis
Wielkie litery	Zamień wszystkie litery na wielkie.
Małe litery	Zamień wszystkie litery na małe.
Jak w tytule	Zamień pierwszą literę każdego wyrazu na wielką.
Przytnij	Usuń puste spacje przed i po wartości.
Podciąg	Przekształć określoną część wartości. Aby określić, gdzie rozpocząć przekształcenie, wybierz Pozycję początkową lub Tekst początkowy. Pozycja początkowa to liczba reprezentująca pierwszy znak do przekształcenia. Tekst początkowy to litera bezpośrednio przed literą do zastąpienia. Jeśli chcesz zacząć od pierwszej litery wartości, użyj zamiast tego pozycji początkowej. Aby określić, gdzie zakończyć przekształcenie, wybierz Długość, czyli liczbę znaków do zastąpienia, lub Tekst końcowy, czyli znak bezpośrednio po ostatnim znaku do przekształcenia.
Zamień	Znajdź wartość i zamień ją na inną. To przekształcenie jest przydatne do zamiany prostych wartości, takich jak konkretne słowo.
Wyrażenie regularne — zamień	Użyj wyrażenia regularnego jako części operacji znajdowania i zamiany. To przekształcenie jest przydatne do zamiany wielu lub bardziej złożonych wartości.
Usuń znaki inne niż alfanumeryczne	Usuń znaki, które nie są literami ani cyframi, takie jak symbole lub znaki specjalne.
Formatowanie daty	Określ sposób wyświetlania dat. Na przykład możesz przekształcić DD-MM-RRRR na RRRR-MM-DD.
Formatowanie dziesiętne	Zdefiniuj reguły umieszczania miejsc dziesiętnych i precyzji zaokrąglania.
Wyrażenie regularne — dopasuj	Użyj wyrażenia regularnego, aby znaleźć jedną lub więcej wartości. Ta reguła jest podobna do opcji Podciąg i Wyrażenie regularne — zamień.
Niestandardowe	Ta reguła przekształcenia jest zaawansowaną opcją wymagającą pomocy programisty. Umożliwia ona zdarzenie integracji, które możesz subskrybować, jeśli chcesz użyć własnego kodu przekształcenia. Jeśli jesteś programistą i chcesz użyć tej opcji, przejdź do sekcji Wskazówka dla programistów: przykład opcji niestandardowej.
Formatowanie daty i godziny	Zdefiniuj sposób wyświetlania bieżącej daty i godziny.
Wyszukiwanie pola	Użyj pól z różnych tabel. Aby z tego skorzystać, musisz przestrzegać pewnych reguł. Najpierw użyj Identyfikatora tabeli, aby określić identyfikator tabeli zawierającej rekord do wyszukiwania pola. Następnie w polu Identyfikator pola źródłowego określ identyfikator pola zawierającego rekord do wyszukiwania pola. Na koniec w polu Identyfikator pola docelowego określ identyfikator pola, dla którego ma zostać znaleziony rekord wyszukiwania pola. Opcjonalnie użyj pola Reguła wyszukiwania pola, aby określić typ wyszukiwania pola. Dla pola Cel używana jest wartość z Identyfikatora pola docelowego, nawet jeśli jest pusta. Dla pola Oryginał, jeśli cel jest pusty używana jest wartość oryginalna, jeśli cel jest pusty.
Zaokrąglij	Zaokrąglij wartość w tym polu, korzystając z dodatkowych reguł. Najpierw w polu Precyzja określ precyzję zaokrąglania. Następnie w polu Kierunek określ kierunek zaokrąglania.

Uwaga

Aby dowiedzieć się więcej o formatowaniu daty i godziny, przejdź do artykułu Standardowe ciągi formatujące datę i godzinę.

Wskazówka dla programistów: Przykład opcji niestandardowej

Poniższy przykład pokazuje, jak zaimplementować własny kod transformacji.

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

Po zdefiniowaniu reguł można je przetestować. Na skróconej karcie Test wprowadź przykładową wartość, którą chcesz przekształcić, a następnie sprawdź wyniki, wybierając Aktualizuj.

Eksportowanie definicji wymiany danych jako pliku XML do użytku przez innych

Po utworzeniu definicji wymiany danych dla określonego pliku danych można wyeksportować definicję wymiany danych jako plik XML, który można zaimportować. To zadanie jest opisane w poniższej procedurze.

Wybierz ikonę , wprowadź Definicje wymiany danych, a następnie wybierz powiązane łącze.
Wybierz definicję wymiany danych, którą chcesz wyeksportować.
Wybierz akcję Eksportuj definicję wymiany danych.
Zapisz plik XML reprezentujący definicję wymiany danych w odpowiedniej lokalizacji.

Jeśli definicja wymiany danych została już utworzona, wystarczy zaimportować plik XML do struktury wymiany danych. To zadanie jest opisane w poniższej procedurze.

Importowanie istniejącej definicji wymiany danych

Zapisz plik XML reprezentujący definicję wymiany danych w odpowiedniej lokalizacji.
Wybierz ikonę , wprowadź Definicje wymiany danych, a następnie wybierz powiązane łącze.
Wybierz akcję Importuj definicję wymiany danych.
Wybierz plik zapisany w kroku 1.

Powiązane informacje

Konfigurowanie wymiany danych do wysyłania i odbierania plików
Jak skonfigurować wysyłanie i odbieranie dokumentów elektronicznych
Polecenie zapłaty SEPA w Business Central
Dokonywanie płatności za pomocą bankowości AMC (USA) lub polecenia przelewu SEPA (UE)
Praca z dokumentami przychodzącymi
Korzystanie z ogólnych funkcji w różnych obszarach biznesowych

Znajdź bezpłatne moduły e-learningowe dla Business Central tutaj