Konfigurowanie definicji schematu wymiany danych
Business Central można skonfigurować pod kątem wymiany danych w niektórych tabelach na dane z plików zewnętrznych, na przykład, aby wysyłać i odbierać dokumenty elektroniczne, importować i eksportować dane bankowe, takie jak płatności, kursy wymiany walut oraz katalogi zapasów. Dodatkowe informacje zamieszczono w artykule Elektroniczna wymiana danych.
W ramach przygotowań do utworzenia definicji schematu wymiany danych dla pliku lub strumienia danych, można użyć powiązanego schematu XML, aby zdefiniować elementy danych, które mają być zawarte na skróconej karcie Definicje kolumny. Szczegółowe informacje zawarto w kroku nr 6, w sekcji Aby opisać formatowanie wierszy i kolumn w pliku. Dodatkowe informacje zamieszczono w artykule Przygotowanie definicji schematów wymiany danych przy pomocy schematów XML.
Definicje schematu wymiany danych są zazwyczaj konfigurowane na stronie Definicje schematu wymiany danych. Jednakże uproszczony proces konfiguracji definicji schematu wymiany danych dla usługi odświeżania kursów wymiany walut rozpoczyna się na stronie Kartoteka konfiguracji kursów wymiany.
NOTE
Jeżeli konwertowany plik jest w formacie XML, termin „kolumna” powinien być w tym artykule interpretowany jako „element XML zawierający dane”.
W tym artykule zawarto następujące procedury:
- Aby utworzyć definicję schematu wymiany danych
- Aby wyeksportować definicję schematu wymiany danych w formie pliku XML do użytku innych
- Aby zaimportować plik XML do istniejącej definicji schematu wymiany danych
Aby utworzyć definicję schematu wymiany danych
Proces tworzenia definicji schematu wymiany danych składa się z dwóch zadań:
- Na stronie Definicja schematu wymiany danych opisz formatowanie wierszy i kolumn w pliku.
- Na stronie Mapowanie schematu wymiany danych zmapuj kolumny w plikach danych do pól w Business Central.
Proces opisano w poniższej procedurze.
TIP
Aby zobaczyć, które jednostki kodu są wykorzystywane przez Microsoft w istniejących w standardowym produkcie definicjach schematów wymiany danych, należy sprawdzić trzy pola Jednostka kodu w nagłówku strony Mapowanie pola dla każdej definicji.
Aby opisać formatowanie wierszy i kolumn w pliku
W polu Szukaj wprowadź Definicje schematu wymiany danych, a następnie wybierz powiązane łącze.
Wybierz akcję Nowy.
Na skróconej karcie Ogólne opisz definicję schematu wymiany danych i typ pliku danych, wypełniając pola zgodnie z opisem w poniższej tabeli.
Pole Definicja Kod W polu należy wprowadzić kod identyfikujący definicję schematu wymiany danych. Nazwa W polu należy wprowadzić nazwę definicji schematu wymiany danych. Typ pliku W polu należy określić typ pliku, dla którego używana jest definicja. Do wyboru dostępne są cztery typy plików:
- XML: Warstwy ciągów zawartości i znaczników otoczone przez etykiety wskazujące funkcję.
- Zmienny tekst: Rekordy mają zmienną długość i są rozdzielone znakiem, np. przecinkiem lub średnikiem. Takie rekordy nazywa się plikami rozdzielanymi.
- Stały tekst: Rekordy mają taką samą długość, używane są znaki wypełnienia, każdy rekord znajduje się w osobnej linii. Takie rekordy nazywa się plikami o stałej szerokości.
- Json: Warstwy ciągów zawartości napisane w JavaScript.Typ W polu należy określić typ aktywności biznesowej, do której zostanie użyta definicja schematu wymiany danych, na przykład Eksport płatności. Jednostka kodu przetwarzania. danych W polu należy określić jednostkę kodu odpowiedzialną za przesyłanie danych z i do tabel w Business Central. Jednostka kodu walidacji W polu należy określić jednostkę kodu używaną do sprawdzenia danych pod kątem predefiniowanych reguł biznesowych. Jednostka kodu odczytu/zapisu W polu należy określić jednostkę kodu przetwarzającą importowane dane przed mapowaniem i dane po mapowaniu. XMLport odczytu/zapisu W polu należy określić port XML, przez który zaimportowane dane lub serwis są wprowadzane przed mapowaniem, i przez który są eksportowane dane, jeśli jest przypisany do pliku danych lub usługi po mapowaniu Jednostka kodu przetw. danych zewn. W polu należy określić jednostkę kodu, która przenosi dane zewnętrzne do i z definicji schematu wymiany danych. Jednostka kodu reakcji użytkownika W polu należy określić jednostkę kodu, która wykonuje różne oczyszczanie po mapowaniu, takie jak oznaczanie wierszy jako wyeksportowane i usuwanie rekordów tymczasowych. Kodowanie pliku W polu należy określić kodowanie pliku. Uwaga: Pole jest istotne tylko podczas importu. Separator kolumny W polu należy określić, w jaki sposób rozdzielone są kolumny w pliku, jeśli typem pliku jest Zmienny tekst. Wiersze nagłówka W polu należy określić, ile z wierszy pliku jest wierszami nagłówka.
Ma to zapobiec importowaniu danych nagłówka. Uwaga: Pole jest istotne tylko podczas importu.Etykieta nagłówka Jeśli wiersz nagłówka istnieje w wielu pozycjach w pliku, należy wprowadzić zawartość pierwszej kolumny w wierszu nagłówka.
Ma to zapobiec importowaniu danych nagłówka. Uwaga: Pole jest istotne tylko podczas importu.Etykieta nagłówka Jeśli wiersz stopki istnieje w wielu pozycjach w pliku, należy wprowadzić zawartość pierwszej kolumny w wierszu stopki.
Ma to zapobiec importowaniu danych stopki. Uwaga: Pole jest istotne tylko podczas importu.Na skróconej karcie Definicje wierszy opisz formatowanie wierszy w pliku danych, wypełniając pola zgodnie z opisem w poniższej tabeli.
NOTE
Importując wyciągi bankowe należy utworzyć tylko jeden wiersz dla pojedynczego formatu pliku wyciągu bankowego, który ma być zaimportowany.
Eksportując płatności, można utworzyć wiersz dla każdego typu płatności, który ma być wyeksportowany. W tym przypadku, skrócona karta Definicje kolumny pokazuje różne kolumny dla każdego typu płatności.
Pole Opis Kod W polu należy wprowadzić kod identyfikujący wiersz w pliku. Nazwa W polu należy wprowadzić nazwę opisującą wiersz w pliku. Zliczanie kolumny W polu należy określić ile kolumn znajduje się w wierszu pliku z danymi. Uwaga: Pole jest istotne tylko podczas importu. Znacznik wiersza daty W polu należy określić pozycję elementu w powiązanym schemacie XML, reprezentującego główny zapis pliku danych. Uwaga: Pole jest istotne tylko podczas importu. Obszar nazwy W polu należy określić obszar nazwy, którego należy spodziewać się w pliku, aby uruchomić walidację obszaru nazwy. Pole może pozostać puste jeśli walidacja obszaru nazwy ma pozostać wyłączona. Powtarzaj krok 4, aby utworzyć wiersz dla każdego typu danych z pliku, które chcesz eksportować.
Kontynuuj opisywanie formatowania kolumn w pliku z danymi poprzez wypełnianie pól na skróconej karcie Definicje kolumny zgodnie z opisem w poniższej tabeli. Możesz użyć struktury pliku, takiego jak plik .XSD, aby plik z danymi automatycznie wypełnił skróconą kartę istotnymi elementami. Dodatkowe informacje zamieszczono w artykule Przygotowanie definicji schematów wymiany danych przy pomocy schematów XML.
Na skróconej karcie Definicje kolumny wybierz Pobierz strukturę pliku.
Na stronie Pobierz strukturę pliku wybierz powiązaną strukturę pliku, a następnie wybierz przycisk OK. Wiersze na skróconej karcie Definicje kolumny są wypełnione zgodnie ze strukturą pliku z danymi.
Na skróconej karcie Definicje kolumny edytuj lub wypełnij pola zgodnie z opisem w poniższej tabeli.
Pole Opis Nr kolumny W polu należy określić numer odpowiadający pozycji kolumny w wierszu pliku.
W przypadku plików XML, należy określić numer odpowiadający typowi elementu w pliku, który zawiera dane.Nazwa W polu należy określić nazwę kolumny.
W przypadku plików XML należy określić znacznik, który wskazuje dane mające zostać wymienione.Typ danych W polu należy określić czy wymieniane dane to Tekst, Data, czy Dziesiętne. Format danychW polu należy określić format danych, w razie potrzeby. Na przykład MM-dd-yyyy, jeśli typem danych jest Data. Uwaga: Eksport wymaga formatu danych zgodnych z Business Central. Import wymaga formatu danych zgodnego z .NET Framework. Dodatkowe informacje zamieszczono w artykule Ciągi formatu daty i godziny. Typ formatowania danych W polu można określić typ formatowania danych. Jeśli wybrano typ danych Dziesiętne, aby zapewnić odpowiednie umiejscowienie przecinka zgodnie z, na przykład, formatem Stanów Zjednoczonych, należy wybrać opcję en-US. Dodatkowe informacje zamieszczono w artykule Ciągi formatu daty i godziny. Uwaga: Pole jest istotne tylko podczas importu. Długość W przypadku plików typu Stały tekst, w polu należy określić stałą długość wiersza zawierającego kolumnę. Opis W polu należy wprowadzić opis kolumny w celach informacyjnych. Ścieżka W polu należy określić pozycję elementu w powiązanym schemacie XML. Identyfikator ujemnego znaku W polu należy wprowadzić wartość używaną do określenia ujemnych kwot w plikach, które nie mogą zawierać ujemnych znaków. Identyfikator jest używany podczas importu do odwrócenia znaku zidentyfikowanych kwot. Uwaga: Pole jest istotne tylko podczas importu. Stała W polu należy określić wszelkie dane, które użytkownik chce wyeksportować w tej kolumnie, takie jak informacje na temat typu płatności. Uwaga: Pole jest istotne tylko podczas eksportu. Powtarzaj krok 8 dla każdej kolumny lub elementu XML w pliku danych, który ma zostać zamieniony z Business Central.
Następnym krokiem w procesie tworzenia definicji wymiany danych jest decyzja, które kolumny lub elementy XML w pliku danych mają zostać zmapowane do [INCLUDEprod_short].
NOTE
Dokładne mapowanie jest zależne od biznesowego celu wymienianego pliku z danymi oraz od lokalnych wariacji. Nawet standardy bankowe SEPA mają różne wariacje. Business Central obsługuje import plików wyciągu bankowego SEPA CAMT, gotowych do zainstalowania. Jest to reprezentowane przez kod rekordu definicji schematu wymiany danych SEPA CAMT, na stronie Definicje schematu wymiany danych. Dodatkowe informacje na temat dokładnego mapowania pola dla wsparcia SEPA CAMT zamieszczono w artykule Mapowanie pola podczas importu plików SEPA CAMT.
Aby zmapować kolumny w pliku danych do pól w Business Central
TIP
Zdarza się, że pola, które mają być zmapowane zawierają różne wartości. Na przykład, w jednej z aplikacji biznesowych, kod języka Stanów Zjednoczonych to „U.S.”, a w innej „US.” Oznacza to, że podczas wymiany danych należy przetransformować tę wartość. Dzieje się to poprzez definiowane reguły transformacji dla pól. Dodatkowe informacje zamieszczono w artykule Reguły transformacji.
Na skróconej karcie Definicje wierszy wybierz wiersz, dla którego chcesz zmapować kolumny do pól, a następnie wybierz Mapowanie pola. Otworzy się strona Mapowanie schematu 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 W polu należy określić tabelę zawierającą pola, do których lub z których wymieniane są dane zgodnie z mapowaniem. Użyj jako tabeli pośredniej W polu należy określić, czy tabela, która została wybrana w polu Identyfikator tabeli jest tabelą pośrednią, w której przechowywane są zaimportowane dane, zanim zostaną one zmapowane do tabeli docelowej.
Tabelę pośrednią zazwyczaj stosuje się, kiedy definicja wymiany danych jest używana aby importować i konwertować dokumenty elektroniczne, takie jak faktury dostawców, na faktury zakupu w Business Central. Dodatkowe informacje zamieszczono w artykule Elektroniczna wymiana danych.Nazwa W polu należy wprowadzić nazwę ustawienia mapowania. Wstępne mapowanie jednostki kodu W polu należy określić jednostkę kodu, która przygotowuje mapowanie pomiędzy polami w Business Central i dane zewnętrzne. Mapowanie jednostki kodu W polu należy określić jednostkę kodu, używaną do mapowania określonych kolumn lub elementów danych XML do pól w Business Central. Wtórne mapowanie jednostki kodu W polu należy określić jednostkę kodu, uzupełniającą mapowanie między polami w Business Central i danymi zewnętrznymi. Uwaga: Kiedy rozszerzenie funkcji AMC Banking 365 Fundamentals jest używane, jednostka kodu konwertuje wyeksportowane dane z Business Central na format ogólny, gotowy do eksportu. Import wymaga konwersji danych zewnętrznych przez jednostkę kodu, na format gotowy do importu do Business Central. Na skróconej karcie Mapowanie pola określ kolumny, które mają zostać zmapowane do pól w Business Central poprzez wypełnienie pól według wzoru z poniższej tabeli.
Pole Opis Nr kolumny W polu należy określić kolumnę z pliku danych, dla której ma zostać zdefiniowane mapowanie.
Należy wybrać kolumny, które są przedstawione w formie wierszy na skróconej karcie Definicje kolumny, na stronie Definicja schematu wymiany danych.Identyfikator pola W polu należy określić pole, do którego kolumna z pola Nr kolumny ma być zmapowana.
Należy wybrać pole, które istnieje w tabeli określonej w polu Tabela, na skróconej karcie Ogólne.Opcjonalnie W polu należy określić czy mapowanie ma być pominięte jeśli pole jest puste. Uwaga: Jeśli pole wyboru nie zostanie zaznaczone, po napotkaniu pustego pola pojawi się błąd eksportu. Uwaga: Pole jest istotne tylko podczas eksportu. Identyfikator tabeli docelowej Pole jest widoczne tylko jeśli zaznaczono pole wyboruUżyj jako tabeli pośredniej.
Należy określić tabelę, do której jest mapowana wartość z pola Etykieta kolumny, w przypadku gdy do importu danych jest wykorzystywana tabela pośrednia.Etykieta tabeli docelowej Pole jest widoczne tylko jeśli zaznaczono pole wyboruUżyj jako tabeli pośredniej.
Należy określić nazwę tabeli wskazanej w polu Identyfikator tabeli docelowej, do której jest mapowana wartość z pola Etykieta kolumny, w przypadku gdy do importu danych jest wykorzystywana tabela pośrednia.Identyfikator pola docelowego Pole jest widoczne tylko jeśli zaznaczono pole wyboruUżyj jako tabeli pośredniej.
Należy określić pole w tabeli docelowej, do której jest mapowana wartość z pola Etykieta kolumny, w przypadku gdy do importu danych jest wykorzystywana tabela pośrednia.Etykieta pola docelowego Pole jest widoczne tylko jeśli zaznaczono pole wyboruUżyj jako tabeli pośredniej.
Należy określić nazwę pola w tabeli docelowej, do której jest mapowana wartość z pola Etykieta kolumny, w przypadku gdy do importu danych jest wykorzystywana tabela pośrednia.Opcjonalnie Pole jest widoczne tylko jeśli zaznaczono pole wyboruUżyj jako tabeli pośredniej.
Należy określić, czy mapowanie ma być pominięte jeśli pole jest puste. Jeśli pole wyboru nie zostanie zaznaczone, po napotkaniu pustego pola pojawi się błąd eksportu.
Można teraz uruchomić definicję schematu wymiany danych. Dodatkowe informacje zamieszczono w artykułach Konfigurowanie elektronicznego wysyłania i odbierania dokumentów, Konfigurowanie poleceń przelewu SEPA, Pobieranie płatności przy pomocy polecenia zapłaty SEPA i Płatności z użyciem rozszerzenia AMC Banking 365 Fundamentals lub polecenia przelewu SEPA.
Reguły transformacji
Jeśli wartości w mapowanych polach są od siebie różne, należy użyć reguł transformacji definicji schematu wymiany danych, aby je ujednolicić. Reguły transformacji definicji schematu wymiany danych są definiowane poprzez otwarcie istniejącej definicji lub stworzenie nowej definicji, a następnie, na skróconej karcie Definicje wierszy wybranie opcji Zarządzaj, a później Mapowanie pola. W systemie dostępne są wbudowane reguły, ale można również stworzyć nowe. Poniższa tabela opisuje dostępne do użytku transformacje.
Opcja | Opis |
---|---|
Wielkie litery | Powiększa wszystkie litery. |
Małe litery | Pomniejsza wszystkie litery. |
Jak nazwy własne | Powiększa pierwsze litery każdego słowa. |
Przytnij | Usuwa puste spacje przed i po wprowadzonej wartości. |
Podciąg | Transformuje określoną część wartości. Aby określić miejsce rozpoczęcia transformacji, należy wybrać Pozycję startową lub Tekst początkowy. Pozycja startowa to liczba reprezentująca pierwszy znak, który ma zostać przetransformowany. Tekst początkowy jest literą poprzedzającą literę, która ma być zamieniona. Aby rozpocząć transformację od pierwszej litery wartości, należy użyć pozycji startowej. Aby określić moment zakończenia transformacji, należy wybrać Długość, będącą liczbą znaków, które mają być zamienione, lub Tekst końcowy, który jest przedostatnim transformowanym znakiem. |
Zamień | Wyszukuje wartość i zamienia ją na inną. Reguła jest użyteczna w przypadku zmiany prostych wartości, takich jak określone słowo. |
Wyrażenie regularne - zamień | Używa wyrażenia regularnego jako elementu operacji wyszukania i zamiany. Reguła jest użyteczna do zamiany wielu, bardziej skomplikowanych wartości. |
Usuń znaki niealfanumeryczne | Usuwa wszystkie znaki, które nie są literami ani liczbami, takie jak symbole i znaki specjalne. |
Format daty | Określa w jakim formacie wyświetlać daty. Na przykład, format DD-MM-YYYY można przetransformować na format YYYY-MM-DD. |
Formatowanie dziesiętne | Definiuje reguły ilości miejsc po przecinku i dokładności zaokrąglania. |
Wyrażenie regularne - dopasuj | Używa wyrażenia regularnego do znalezienia jednej lub wielu wartości. Reguła jest podobna do opcji Podciąg i Wyrażenie regularne - zamień. |
Niestandardowa | Zaawansowana opcja wymagająca wsparcia programisty. Uruchamia zintegrowane zdarzenie, które można zasubskrybować w celu użycia go we własnym kodzie transformacji. Dodatkowe informacje dla programistów chcących użyć tej opcji zamieszczono poniżej, w sekcji „Porada dla programistów: Przykład opcji niestandardowej. |
Formatowanie daty i godziny | Definiuje jak wyświetlać bieżącą datę i godzinę. |
Porada 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;
}
Zdefiniowane reguły mogą zostać przetestowane. W sekcji Test należy wprowadzić przykładową wartość, która ma być przetransformowana, a następnie sprawdzić wynik.
Aby wyeksportować definicję schematu wymiany danych w formie pliku XML do użytku innych
Po utworzeniu definicji schematu wymiany danych dla określonego pliku z danymi, można ją wyeksportować w formie pliku XML, który można importować. Opisano to w poniższej procedurze.
W polu Szukaj wprowadź Definicje schematu wymiany danych, a następnie wybierz powiązane łącze.
Wybierz definicję schematu wymiany danych, którą chcesz wyeksportować.
Wybierz akcję Eksportuj definicję schematu wymiany danych.
Zapisz plik XML przedstawiający definicję schematu wymiany danych w odpowiedniej lokalizacji.
Jeśli definicja schematu wymiany danych została wcześniej utworzona, należy jedynie zaimportować do niej plik XML. Opisano to w poniższej procedurze.
Aby zaimportować istniejącą definicję schematu wymiany danych
- Zapisz plik XML przedstawiający definicję schematu wymiany danych w odpowiedniej lokalizacji.
- W polu Szukaj wprowadź Definicje schematu wymiany danych, a następnie wybierz powiązane łącze.
- Wybierz akcję Nowy. Otworzy się strona Definicja schematu wymiany danych.
- Wybierz akcję Importuj definicję schematu wymiany danych.
- Wybierz plik zapisany w korku 1.
Zobacz też
Konfigurowanie wymiany danych
Konfigurowanie elektronicznego wysyłania i odbierania dokumentów
Pobieranie płatności przy pomocy polecenia zapłaty SEPA
Realizacja płatności przy pomocy rozszerzenia AMC Banking 365 Fundamentals lub poleceń przelewu SEPA
Dokumenty przychodzące
Ogólna funkcjonalność dla firm