Konfigurowanie definicji wymiany danych

Business Central można skonfigurować do wymiany danych w określonych tabelach z danymi dotyczącymi plików zewnętrznych, na przykład do wysyłania i odbierania dokumentów elektronicznych, importowania i eksportowania danych bankowych lub innych danych, takich jak lista płac, kursy wymiany walut i katalogi towarów. Aby uzyskać więcej informacji, zobacz Elektroniczna wymiana danych.

W ramach przygotowań do utworzenia definicji wymiany danych dla pliku danych lub strumienia można użyć powiązanego schematu XML, aby zdefiniować, które elementy danych mają być uwzględniane na skróconej karcie Definicje kolumn. Zobacz krok 6 w tecie Aby opisać formatowanie wierszy i kolumn w pliku. Aby uzyskać więcej informacji, zobacz Używanie schematów XML do przygotowywania definicji wymiany danych.

Definicje wymiany danych są zwykle skonfigurowane na stronie Definicja wymiany danych. Jednak po skonfigurowaniu definicji wymiany danych dla usługi odświeżania kursów wymiany walut proces rozpoczyna się w uproszczonym Exch. Oceń stronę karty konfiguracji aktualizacji.

Uwaga

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

Ten temat obejmuje następujące procedury:

Aby utworzyć definicję wymiany danych
Aby wyeksportować definicję wymiany danych jako plik XML do użytku przez inne osoby
Aby zaimportować plik XML dla istniejącej definicji wymiany danych

Aby utworzyć definicję wymiany danych

Tworzenie definicji wymiany danych obejmuje dwa zadania:

Na stronie Definicja wymiany danych opisz formatowanie wierszy i kolumn w pliku.
Na stronie Mapowanie wymiany danych zamapuj kolumny w pliku danych na pola w Business Central.

Jest to opisane w poniższych procedurach.

Wskazówka

Aby zobaczyć, których jednostek kodowych używa firma Microsoft w istniejących definicjach w produkcie standardowym, przejrzyj trzy pola Codeunit w nagłówku strony Mapowanie pól dla każdej definicji.

Aby opisać formatowanie linii i kolumn w pliku

W polu Wyszukaj wpisz 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	Określ typ pliku, dla którego jest używana definicja wymiany danych. Możesz wybrać jeden z czterech typów plików: - XML: Warstwowe ciągi treści i znaczników otoczone znacznikami wskazującymi funkcję. - Tekst zmienny: Rekordy mają zmienną długość i są oddzielone znakiem, takim jak przecinek lub średnik. Znany również jako plik rozdzielany. - Poprawiono tekst: Rekordy mają tę samą długość, przy użyciu znaków padu, a każdy rekord znajduje się w osobnym wierszu. Znany również jako plik o stałej szerokości. - Json: Warstwowe ciągi treści w JavaScript.
Typ	Określ, do jakiego rodzaju działalności biznesowej jest używana definicja wymiany danych, na przykład Eksport płatności.
Obsługa danych Codeunit	Określ codeunit, która przesyła dane do i z tabel w Business Central.
Walidacja Codeunit	Określ codeunit, która jest używana do sprawdzania poprawności danych pod względem wstępnie zdefiniowanych reguł biznesowych.
Odczyt/Pisanie Codeunit	Określ codeunit, która przetwarza zaimportowane dane przed mapowaniem i wyeksportowane dane po mapowaniu.
Odczyt/Zapis XMLport	Określ XMLport, przez który importowany plik danych lub usługa jest wprowadzana przed mapowaniem i przez którą eksportowane dane są zamykane, gdy są zapisywane w pliku danych lub usłudze po mapowaniu.
Ext. Obsługa danych Codeunit	Określ codeunit, która przesyła dane zewnętrzne do i z struktury wymiany danych.
Codeunit opinii użytkowników	Określ codeunit, która wykonuje różne porządki po mapowaniu, na przykład oznacza wiersze jako eksportowane i usuwa rekordy tymczasowe.
Kodowanie plików	Określ kodowanie pliku. Uwaga: To pole dotyczy tylko importu.
Separator kolumn	Określ sposób oddzielania kolumn w pliku danych, jeśli plik jest typu Tekst zmienny.
Wiersze nagłówka	Określ, ile wierszy nagłówka istnieje w pliku. Dzięki temu dane nagłówka nie są importowane. Uwaga: To pole dotyczy tylko importu.
Znacznik nagłówka	Jeśli wiersz nagłówka istnieje w kilku pozycjach w pliku, wprowadź tekst pierwszej kolumny w wierszu nagłówka. Dzięki temu dane nagłówka nie są importowane. Uwaga: To pole dotyczy tylko importu.
Znacznik stopki	Jeśli wiersz stopki istnieje w kilku pozycjach w pliku, wprowadź tekst pierwszej kolumny w wierszu stopki. Dzięki temu dane stopki nie są importowane. Uwaga: To pole dotyczy tylko importu.

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 importowania wyciągów bankowych należy utworzyć tylko jeden wiersz dla pojedynczego formatu pliku wyciągu bankowego, który ma zostać zaimportowany.

W przypadku eksportowania płatności można utworzyć wiersz dla każdego typu płatności, który ma zostać wyeksportowany. W takim przypadku na skróconej karcie Definicje kolumn są wyświetlane różne kolumny dla każdego typu płatności.

Pole	Opis
Kod	Wprowadź kod identyfikujący wiersz w pliku.
Nazwa	Wprowadź nazwę opisującą wiersz w pliku.
Liczba kolumn	Określ, ile kolumn ma wiersz w pliku danych. Uwaga: To pole dotyczy tylko importu.
Znacznik linii danych	Określ pozycję w powiązanym schemacie XML elementu, który reprezentuje główny wpis pliku danych. Uwaga: To pole dotyczy tylko importu.
Namespace	Określ przestrzeń nazw, która jest oczekiwana w pliku, aby włączyć sprawdzanie poprawności obszaru nazw. To pole można pozostawić puste, jeśli nie chcesz włączać sprawdzania poprawności przestrzeni nazw.

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

Przejdź do opisu formatowania kolumn w pliku danych, wypełniając pola na skróconej karcie Definicje kolumn zgodnie z opisem w poniższej tabeli. Można użyć pliku struktury, takiego jak plik . XSD, aby plik danych wstępnie wypełnić skróconą kartę odpowiednimi elementami. Aby uzyskać więcej informacji, zobacz Przygotowywanie definicji wymiany danych za pomocą schematów XML.
Na skróconej karcie Definicje kolumn wybierz pozycję Pobierz strukturę plików.
Na stronie Pobierz strukturę plików wybierz powiązany plik struktury, a następnie wybierz przycisk OK. Wiersze na skróconej karcie Definicje kolumn są wypełniane 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
Kolumna nr	Określ liczbę odzwierciedlającą położenie kolumny w wierszu w pliku. W przypadku plików XML określ liczbę odzwierciedlającą typ elementu w pliku zawierającym dane.
Nazwa	Określ nazwę kolumny. W przypadku plików XML określ znaczniki oznaczające dane, które mają być wymieniane.
Typ danych	Określ, czy dane, które mają być wymieniane, są typu Tekst, Dataczy Dziesiętny.
Format danych	Określ format danych, jeśli istnieje. Na przykład MM-dd-rrrr, jeśli typem danych jest Data. Uwaga: W przypadku eksportu określ format danych zgodnie z Business Central. W przypadku importu określ format danych zgodnie z programem .NET Framework. Aby uzyskać więcej informacji, zobacz Standardowe ciągi formatu daty i godziny.
Kultura formatowania danych	Określ kulturę formatu danych, jeśli istnieje. Na przykład en-US, jeśli typ danych to Dziesiętny, aby upewnić się, że przecinek jest używany jako separator .000, zgodnie z formatem US. Aby uzyskać więcej informacji, zobacz Standardowe ciągi formatu daty i godziny. Uwaga: To pole dotyczy tylko importu.
Długość	Określ długość linii o stałej szerokości, która zawiera kolumnę, jeśli plik danych jest typu Fixed Text.
Opis	Wprowadź opis kolumny, aby uzyskać informacje.
Ścieżka	Określ położenie elementu w powiązanym schemacie XML.
Identyfikator znaku negatywnego	Wprowadź wartość używaną w pliku danych do identyfikowania wartości ujemnych w plikach danych, które nie mogą zawierać znaków ujemnych. Identyfikator ten jest następnie używany do odwrócenia zidentyfikowanych ilości do znaków ujemnych podczas przywozu. Uwaga: To pole dotyczy tylko importu.
Stały	Określ w tej kolumnie wszelkie dane, które chcesz wyeksportować, takie jak dodatkowe informacje o typie płatności. Uwaga: To pole jest istotne tylko dla eksportu.

Powtórz krok 8 dla każdej kolumny lub elementu XML w pliku danych zawierającego dane, które chcesz wymienić z Business Central.

Następnym krokiem w tworzeniu definicji wymiany danych jest podjęcie decyzji, które kolumny lub elementy XML w pliku danych mapuje się na które pola w Business Central.

Uwaga

Konkretne mapowanie zależy od celu biznesowego pliku danych, który ma być wymieniany, oraz od lokalnych odmian. Nawet standard bankowy SEPA ma lokalne odmiany. Business Central obsługuje importowanie plików wyciągów bankowych SEPA CAMT od wyjęciu z pudełka. Jest to reprezentowane przez kod rekordu definicji wymiany danych SEPA CAMT na stronie Definicje wymiany danych. Aby uzyskać informacje na temat mapowania pól specyficznych dla tej obsługi SEPA CAMT, zobacz Mapowanie pól podczas importowania plików SEPA CAMT.

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

Wskazówka

Czasami wartości w polach, które mają być mapowane, są różne. Na przykład w jednej aplikacji biznesowej kod języka dla Stanów Zjednoczonych to "USA", ale w drugiej to "USA". Oznacza to, że musisz przekształcić wartość podczas wymiany danych. Dzieje się tak za pomocą reguł transformacji zdefiniowanych dla pól. Aby uzyskać więcej informacji, zobacz Reguły transformacji.

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

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

Pole	Opis
Identyfikator tabeli	Określ tabelę zawierającą 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 są przechowywane zaimportowane dane, zanim zostanie zamapowana na tabelę docelową. Tabela pośrednia jest zwykle używana, gdy definicja wymiany danych jest używana do importowania i konwertowania dokumentów elektronicznych, takich jak faktury od dostawcy na faktury zakupu w Business Central. Aby uzyskać więcej informacji, zobacz Elektroniczna wymiana danych.
Nazwa	Wprowadź nazwę konfiguracji mapowania.
Pre-Mapping Codeunit	Określ codeunit, która przygotowuje mapowanie między polami w Business Central a danymi zewnętrznymi.
Mapowanie Codeunit	Określ codeunit, która jest używana do mapowania określonych kolumn lub elementów danych XML na pola w Business Central.
Codeunit po mapowaniu	Określ codeunit, która kończy mapowanie między polami w Business Central a danymi zewnętrznymi. Uwaga: Podczas korzystania z funkcji rozszerzenia AMC Banking 365 Fundamentals jednostka codeunit konwertuje wyeksportowane dane z Business Central na ogólny format, który jest gotowy do eksportu. W przypadku importu codeunit konwertuje dane zewnętrzne na format gotowy do zaimportowania do Business Central.

Na skróconej karcie Mapowanie pól określ, które kolumny mają być mapowe na które pola w Business Central, wypełniając pola zgodnie z opisem w poniższej tabeli.

Pole	Opis
Kolumna nr	Określ kolumnę w pliku danych, dla której chcesz zdefiniować mapę. Można wybrać tylko kolumny, które są reprezentowane przez wiersze na skróconej karcie Definicje kolumn na stronie Definicja wymiany danych.
Identyfikator pola	Określ pole, na które jest mapowane kolumna w polu Nr kolumny. Można wybierać tylko spośród pól istniejących w tabeli określonych w polu Tabela na skróconej karcie Ogólne.
Fakultatywny	Określ, że mapa zostanie pominięta, jeśli pole jest puste. Uwaga: Jeśli to pole wyboru nie zostanie zaznaczone, jeśli pole jest puste, wystąpi błąd eksportu. Uwaga: To pole jest istotne tylko dla eksportu.
Identyfikator tabeli docelowej	Opcja widoczna tylko wtedy, gdy pole wyboru Użyj jako tabeli pośredniej jest zaznaczone. Określ tabelę, na którą ma być mapowana wartość w polu Podpis kolumny, gdy do importowania danych jest używana tabela pośrednia.
Podpis tabeli docelowej	Opcja widoczna tylko wtedy, gdy pole wyboru Użyj jako tabeli pośredniej jest zaznaczone. Określ nazwę tabeli w polu Identyfikator tabeli docelowej, która jest tabelą, na którą jest mapowana wartość w polu Podpis kolumny, gdy używasz tabeli pośredniej do importowania danych.
Identyfikator pola docelowego	Opcja widoczna tylko wtedy, gdy pole wyboru Użyj jako tabeli pośredniej jest zaznaczone. Określ pole w tabeli docelowej, na które jest mapowana wartość w polu Podpis kolumny, gdy do importowania danych jest używana tabela pośrednia.
Podpis pola docelowego	Opcja widoczna tylko wtedy, gdy pole wyboru Użyj jako tabeli pośredniej jest zaznaczone. Określ nazwę pola w tabeli docelowej, na które jest mapowana wartość w polu Podpis kolumny, gdy do importowania danych jest używana tabela pośrednia.
Fakultatywny	Opcja widoczna tylko wtedy, gdy pole wyboru Użyj jako tabeli pośredniej jest zaznaczone. Określ, czy mapa ma być pomijana, jeśli pole jest puste. Jeśli to pole wyboru nie zostanie zaznaczone, jeśli pole jest puste, wystąpi błąd eksportu.

Definicja wymiany danych jest teraz gotowa do włączenia dla użytkowników. Aby uzyskać więcej informacji, zobacz Konfigurowanie elektronicznego wysyłania i odbierania dokumentów, Konfigurowanie polecenia przelewu SEPA, Zbieranie płatności za pomocą polecenia zapłaty SEPAi Dokonywanie płatności za pomocą rozszerzenia AMC Banking 365 Fundamentals lub polecenia przelewu SEPA.

Reguły transformacji

Jeśli wartości w mapowane polach różnią się, należy użyć reguł transformacji dla definicji wymiany danych, aby były takie same. Reguły transformacji dla definicji wymiany danych definiuje się, otwierając istniejącą definicję lub tworząc nową definicję, a następnie na skróconej karcie Definicje wierszy wybierz pozycję Zarządzaj, a następnie Mapowanie pól. Dostępne są wstępnie zdefiniowane reguły, ale można również utworzyć własne. W poniższej tabeli opisano typy przeksztowań, które można wykonać.

Opcja	Opis
Wielka litera	Wielkie litery.
Małe litery	Wszystkie litery należy pisać małymi literami.
Przypadek tytułu	Pisz wielką literą pierwszą literę każdego słowa.
Przycinać	Usuń puste spacje przed i po wartości.
Podciąg	Przekształcanie określonej części wartości. Aby określić, gdzie ma rozpocząć transformację, wybierz pozycję początkową lub tekst początkowy. Pozycja wyjściowa to liczba reprezentująca pierwszy znak do przekształcenia. Tekst początkowy to litera bezpośrednio poprzedzający literę do zastąpienia. Jeśli chcesz zacząć od pierwszej litery wartości, użyj pozycji początkowej. Aby określić, gdzie zatrzymać przekształcenie, należy wybrać opcję Długość, która jest liczbą znaków do zastąpienia,lub Tekst końcowy, który jest znakiem bezpośrednio po ostatnim znaku do przekształcenia.
Zastąpić	Znajdź wartość i zastąp ją inną. Jest to przydatne do zastępowania prostych wartości, takich jak określone słowo.
Wyrażenie regularne — zamień	Użyj wyrażenia regularnego jako części operacji znajdowania i zamieniania. Jest to przydatne do zastępowania wielu, a może nawet bardziej złożonych wartości.
Usuwanie znaków niealfanumerycznych	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żna przekształcić DD-MM-RRRR na RRRR-MM-DD.
Formatowanie dziesiętne	Zdefiniuj reguły umieszczania dziesiętnego i precyzji zaokrąglania.
Wyrażenie regularne - Dopasowanie	Użyj wyrażenia regularnego, aby znaleźć jedną lub więcej wartości. Jest to podobne do opcji Podciągi i Wyrażenie regularne - Zamień.
Zwyczaj	Jest to zaawansowana opcja, która wymaga pomocy programisty. Umożliwia zdarzenie integracyjne, które można subskrybować, jeśli chcesz użyć własnego kodu transformacji. Jeśli jesteś programistą i chcesz skorzystać z tej opcji, zobacz "Porada dla programistów: Przykład sekcji "Opcja niestandardowa" poniżej.
Formatowanie daty i godziny	Zdefiniuj sposób wyświetlania bieżącej daty oraz pory dnia.

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żesz je przetestować. W sekcji Test wprowadź przykład wartości, którą chcesz przekształcić, a następnie sprawdź wyniki.

Aby wyeksportować definicję wymiany danych jako plik XML do użytku przez inne osoby

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

W polu Wyszukaj wpisz 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. Jest to opisane w poniższej procedurze.

Aby zaimportować istniejącą definicję wymiany danych

Zapisz plik XML reprezentujący definicję wymiany danych w odpowiedniej lokalizacji.
W polu Wyszukaj wpisz Definicje wymiany danych, a następnie wybierz powiązane łącze.
Wybierz akcję Nowy. Zostanie otwarta strona Definicje wymiany danych.
Wybierz akcję Importuj definicję wymiany danych.
Wybierz plik zapisany w kroku 1.

Zobacz też

Konfigurowanie wymiany danych
Konfigurowanie wysyłania i odbierania dokumentów elektronicznych
Zbieraj płatności za pomocą polecenia zapłaty
SEPADoceń płatności za pomocą rozszerzenia AMC Banking 365 Fundamentals lub przelewu
SEPADokumenty
przychodząceOgólna funkcjonalność biznesowa