SMART Data Template
Rozszerzenie – SMART Data Template
Rozszerzenie SMART Data Template to dodatek dla Microsoft Dynamics 365 Business Central, który umożliwia elastyczną konfigurację mapowania i przekształcania danych. Rozszerzenie pozwala tworzyć szablony z wieloma tabelami, mapowaniami i wyrażeniami w celu automatyzacji integracji, raportowania i eksportu danych – bez zmian w kodzie.
Najważniejsze funkcje:
- Definiowanie szablonów danych z dowolną liczbą tabel (jako zmiennych).
- Konfigurowanie kodów mapowania i wyrażeń do obliczania wartości.
- Obsługa struktur pojedynczych i powtarzalnych (opartych na wierszach).
- Elastyczne ustawianie filtrów i relacji między tabelami.
- Automatyzacja eksportu, integracji i raportowania.
SMART Data Template pozwala skonfigurować złożoną logikę wyboru i przekształcania danych w interfejsie użytkownika. Określasz, których tabel użyć, jak są ze sobą powiązane, jakie dane pobrać i jak je obliczyć lub przekształcić – bez pisania kodu.
- Szablony grupują wszystkie ustawienia jednego scenariusza.
- Tabele pełnią rolę zmiennych i kontekstu wyboru danych.
- Mapowania określają, jakie dane mają zostać zwrócone.
- Wyrażenia opisują, jak obliczyć każde mapowanie.
- Filtry określają, które rekordy uwzględnić i jak tabele są ze sobą powiązane.
Takie podejście pozwala użytkownikom biznesowym i konsultantom elastycznie i wydajnie automatyzować przepływy danych, raportowanie i integracje.
Aby korzystać z szablonu danych, należy wykonać następujące kroki konfiguracji.
Jak to działa
Przeczytaj to raz, a pięć stron konfiguracji przestanie być pięcioma niezwiązanymi listami.
Szablon danych odpowiada aplikacji, która go wywołuje, na jedno pytanie: dla danego rekordu – rekordu, który przekazuje – jakie są wartości moich nazwanych kodów mapowania? Wszystko w konfiguracji służy temu zdaniu.
Tabele danych są zmiennymi. Każdy wiersz strony Tabele szablonu danych to zmienna typu Rekord: tabela Business Central oraz reguła określająca, z którym jej rekordem pracuje szablon. Jedna zmienna jest zmienną główną – to rekord przekazywany przez aplikację wywołującą, dlatego nie jest filtrowana. Każda inna zmienna jest wyznaczana na podstawie swojego kodu danych nadrzędnych: jej wiersz typu Pole powiązane pobiera wartość pola rekordu nadrzędnego, więc zmienna podrzędna podąża za swoją zmienną nadrzędną, zamiast być wyszukiwana samodzielnie. Zmienna może też istnieć samodzielnie i być ustalona stałym filtrem – w ten sposób odwołuje się do stałego rekordu danych podstawowych (rachunku bankowego firmy). Zmienna oznaczona jako Powtarzalna jest odczytywana wiersz po wierszu, zamiast wskazywać jeden rekord. Panel Struktura na stronach Szablony danych, Tabele szablonu danych i Szablon danych rysuje to drzewo, więc hierarchii nie trzeba odczytywać wiersz po wierszu z kolumny Kod danych nadrzędnych.
Kody mapowania to wynik. Każdy wiersz strony Mapowanie szablonu danych to jedna nazwana wartość, której aplikacja wywołująca żąda po nazwie. Kod mapowania, który nie jest powtarzalny, jest obliczany raz, dla przekazanego rekordu. Powtarzalny jest obliczany raz dla każdego wiersza swojej powtarzalnej tabeli danych, a jego zmienne są wyznaczane ponownie dla tego wiersza – więc kod mapowania na tabeli wierszy daje jedną wartość na wiersz, a kod mapowania odczytujący powiązany rekord daje powiązany rekord tego wiersza.
Wyrażenia to formuła. Każdy wiersz strony Wyrażenie szablonu danych dodaje jedną wartość – stałą, pole
zmiennej, wartość innego kodu mapowania lub jedną wartość obliczoną dla całego zestawu rekordów – a jego
Operacja określa, jak ta wartość jest łączona z wynikiem wierszy powyżej. Wiersze są obliczane ściśle od
góry do dołu, bez priorytetu operatorów: 2 + 3 * 4 daje 20, a nie 14.
W czasie wykonywania, w tej kolejności: zmienne niepowtarzalne są wyznaczane od zmiennej głównej w dół, obliczane są niepowtarzalne kody mapowania, a następnie każda powtarzalna tabela danych jest odczytywana wiersz po wierszu, a jej kody mapowania są obliczane dla każdego wiersza. Zmienna, która nie znajdzie rekordu, pozostawia swoje pola puste, zgłasza błąd albo używa wartości domyślnej, zależnie od pola Przy braku rekordu. Na koniec każda wartość przechodzi drugi etap formatowania – Typ danych kodu mapowania – i aplikacja wywołująca otrzymuje tekst, którego nie musi interpretować.
Jak czytać kolumnę Formuła
Kolumna Formuła na stronie Mapowanie szablonu danych (oraz pole Formuła nad wierszami na stronie Wyrażenie szablonu danych) przedstawia wszystkie wiersze wyrażenia jednego kodu mapowania w jednej linii, dzięki czemu formułę można odczytać bez jej otwierania:
| W formule | Oznacza |
|---|---|
"text" |
stałą (Typ = Stała) |
[TABLE.Field] |
pole zmiennej TABLE (Typ = Pole) |
{CODE} |
wartość kodu mapowania CODE (Typ = Dane) |
Sum([TABLE.Field]) |
agregację po zestawie rekordów TABLE (Typ = Agregacja) |
Count(TABLE) |
agregację, która zlicza rekordy i nie odczytuje żadnego pola |
Join([TABLE.Field], ", ") |
agregację, która łączy wartości separatorem |
Sum(TABLE.{CODE}) |
agregację po obliczonych wartościach powtarzalnego kodu mapowania |
RULE(...) |
regułę przekształcenia stosowaną tylko do tego wiersza |
& |
wiersz jest dołączany (Operacja = Złącz) |
+ - * / |
wiersz jest dodawany, odejmowany, mnożony, dzielony |
?? |
wiersz jest dołączany tylko wtedy, gdy dotychczasowy wynik jest pusty (Jeśli puste) – wartość zastępcza |
?& |
wiersz jest dołączany tylko wtedy, gdy dotychczasowy wynik nie jest pusty (Jeśli niepuste) |
( ... ) |
kolejność obliczania od góry do dołu: ([A] - [B]) - [C], nigdy [A] - ([B] - [C]) |
-> Decimal(2) |
zadeklarowany Typ danych kodu mapowania, gdy zmienia on postać wartości |
#index |
kod mapowania ma włączoną opcję Indeks powtórzenia: wartością jest numer wiersza, a wiersze wyrażenia są ignorowane |
? |
coś nie zostało jeszcze wypełnione – brakujący kod mapowania, pole lub typ agregacji |
Zatem [SALE_HEADER.Amount Including VAT] - [SALE_HEADER.Amount] to odejmowanie dwóch pól nagłówka,
a UPPERCASE([CUSTOMER.Name]) & ", " & [REGION.Code] to nazwa wielkimi literami, po której następuje przecinek
i kod pocztowy.
Jak przejść z jednego poziomu na następny
- Szablony danych → wybierz szablon, aby otworzyć stronę Szablon danych, która pokazuje nagłówek, zmienne i kody mapowania tego jednego szablonu w jednym miejscu, z drzewem struktury obok.
- Tabele szablonu danych → Filtry otwiera wiersze filtrów i połączeń wybranej zmiennej. (Kolumna Filtrowana nadal otwiera tę samą stronę, gdy wybierzesz jej wartość).
- Mapowanie szablonu danych → Wyrażenia otwiera wiersze wyrażenia wybranego kodu mapowania. (Wybranie wartości w kolumnie Formuła nadal działa tak samo).
- Każda strona konfiguracji po naciśnięciu F1 otwiera sekcję tego artykułu, która ją opisuje.
1. Tworzenie szablonu danych
Strona: Szablony danych
Utwórz nowy szablon danych, wypełniając następujące pola:
| Pole | Opis |
|---|---|
| Kod | Unikatowy identyfikator szablonu. |
| Opis | Opis szablonu. |
| Typ | Wybierz typ szablonu: Mapowanie lub Filtr rekordów. Aby eksportować informacje zgodnie z określonym mapowaniem danych, wybierz typ Mapowanie. |
| Identyfikator tabeli źródłowej | Identyfikator tabeli głównej. |
| Nazwa tabeli źródłowej | Nazwa tabeli głównej (wypełniana automatycznie). |
2. Dodawanie tabel do szablonu
Dla wybranego szablonu należy dodać tabele, które będą używane jako zmienne (konteksty) w szablonie danych.
Strona: Tabele szablonu danych (wybierz przycisk Tabele danych na stronie Szablony danych)
| Pole | Opis |
|---|---|
| Kod | Unikatowy kod tabeli zmiennej. |
| Opis | Opis tabeli. |
| Identyfikator tabeli | Identyfikator tabeli w Business Central. |
| Nazwa tabeli | Nazwa tabeli (wypełniana automatycznie). |
| Główna | Oznacza tabelę główną (wypełniane automatycznie). |
| Powtarzalna | Jeśli zaznaczone, tabela jest powtarzalna (oparta na wierszach). |
| Kod danych nadrzędnych | Kod tabeli nadrzędnej używanej do pobierania powiązanych rekordów. |
| Żądaj dodatkowych filtrów | Jeśli zaznaczone, podczas generowania raportu pojawi się strona żądania filtrów. |
| Ostatni | Jeśli filtrom odpowiada kilka rekordów, zwraca ostatni rekord w poniższej kolejności sortowania zamiast pierwszego. Zobacz uwagę w sekcji Sortowanie. |
| Identyfikator pola sortowania | Identyfikator pola, według którego odczytywane są rekordy tej tabeli. 0 zachowuje kolejność klucza podstawowego. |
| Identyfikator pola sortowania 2 | Identyfikator drugiego pola, które rozstrzyga kolejność rekordów o tej samej wartości w polu Identyfikator pola sortowania. |
| Kolejność sortowania | Kolejność pola sortowania: Rosnąco lub Malejąco. |
| Maks. liczba rekordów | Dla tabeli powtarzalnej: maksymalna liczba wierszy do wygenerowania. 0 oznacza brak limitu. |
| Obowiązkowa | Oznacza tabelę, która musi wskazywać na rekord. Włączenie ustawia w polu Przy braku rekordu wartość Pokaż błąd. |
| Przy braku rekordu | Co się dzieje, gdy żaden rekord nie pasuje: Pozostaw puste, Pokaż błąd lub Użyj wartości domyślnej. |
| Wartość domyślna | Wartość zwracana przez każde wyrażenie tej tabeli, gdy nie znaleziono rekordu (tylko dla Użyj wartości domyślnej). |
Sortowanie rekordów tabeli
Domyślnie tabela jest odczytywana w kolejności klucza podstawowego. Ustaw Identyfikator pola sortowania (a gdy potrzebne jest rozstrzygnięcie remisów, także Identyfikator pola sortowania 2), aby odczytywać ją w kolejności innego pola, a polem Kolejność sortowania odwróć tę kolejność. Dla tabeli powtarzalnej jest to kolejność, w jakiej wiersze pojawiają się w wyniku; dla tabeli niepowtarzalnej decyduje ona, który pojedynczy rekord zostanie wybrany.
- Nie według każdego pola można sortować. Pola obliczane (FlowFields, takie jak suma liczona z wierszy), pola obrazów i pola BLOB nie mogą być częścią kolejności sortowania. Jeśli wprowadzisz takie pole, system od razu je odrzuci i wyświetli pola, których można użyć zamiast niego. Najszybszym wyborem są pola, od których zaczyna się jeden z kluczy tabeli.
- Opcja
Ostatnipodąża za tą kolejnością sortowania. Bez skonfigurowanego pola sortowania Ostatni oznacza ostatni rekord w kolejności klucza podstawowego – nie oznacza „najnowszy według daty”. Aby uzyskać najnowszy rekord według daty, ustaw w polu Identyfikator pola sortowania pole daty i włącz opcję Ostatni. - Sortowanie decyduje także o kolejności agregacji Pierwszy, Ostatni i Połącz (zobacz Agregacja zestawu rekordów).
Ograniczanie liczby wierszy
Maks. liczba rekordów ogranicza liczbę wierszy generowanych przez tabelę powtarzalną. System przestaje odczytywać rekordy po osiągnięciu limitu, więc jest to także zabezpieczenie przy bardzo dużych dokumentach. Warto wiedzieć dwie rzeczy:
- Agregacja po tej samej tabeli jest ograniczana w ten sam sposób, więc suma zawsze odpowiada wierszom, które faktycznie wygenerowano.
- Aplikacja korzystająca z szablonu może sprawdzić, czy jakieś rekordy pominięto, i odmówić wygenerowania niekompletnego dokumentu. Łącz pole Maks. liczba rekordów z polem Kolejność sortowania, aby zachowane wiersze były tymi, których potrzebujesz, a nie przypadkowym wyborem.
Co się dzieje, gdy nic nie zostanie znalezione
Tabela, której filtrom nie odpowiada żaden rekord, daje puste wartości – to zachowanie domyślne i nie zmieniło się. Pole Przy braku rekordu pozwala wybrać inne zachowanie:
| Wartość | Zachowanie |
|---|---|
| Pozostaw puste | Każde wyrażenie tej tabeli zwraca pustą wartość. Dokument nadal jest generowany. To wartość domyślna. |
| Pokaż błąd | Generowanie zatrzymuje się z błędem, który wskazuje szablon, tabelę i zastosowane filtry, dzięki czemu widać, dlaczego nic nie pasowało. |
| Użyj wartości domyślnej | Każde wyrażenie tej tabeli zwraca Wartość domyślną. |
Wartość domyślna jest stosowana tylko wtedy, gdy nie znaleziono rekordu. Jeśli rekord został
znaleziony, a odczytywane pole jest po prostu puste, otrzymujesz pustą wartość – nie wartość domyślną.
Wprowadź wartość domyślną w tym samym neutralnym formacie, jaki szablon generuje w innych miejscach, na
przykład 1234.56, 2026-08-17 lub true.
Uwaga: dla szablonu typu Filtr rekordów pole Przy braku rekordu jest ignorowane. Ten typ szablonu odpowiada na pytanie „czy wszystkie wymagane rekordy istnieją?” i musi móc odpowiedzieć nie bez zatrzymywania tworzonego dokumentu.
3. Konfigurowanie filtrów tabel
Zdefiniuj filtry dla każdej tabeli, aby ograniczyć lub powiązać dane. Aby ustawić filtry, na stronie Tabele szablonu danych dla odpowiedniej tabeli przejdź do pola Filtrowana i wypełnij wymagane filtry:
| Pole | Opis |
|---|---|
| Identyfikator pola | Identyfikator pola, według którego filtrować. |
| Etykieta pola | Nazwa pola (wypełniana automatycznie). |
| Typ | Typ filtru: Filtr lub Pole powiązane. Użyj typu Filtr, aby filtrować rekordy bieżącej tabeli. Użyj typu Pole powiązane, aby powiązać dane z tabelą nadrzędną. |
| Wartość filtru | Dla wpisów typu Filtr podaj wartość lub wyrażenie. |
| Identyfikator pola powiązanego | Dla wpisów typu Pole powiązane podaj pole łączące. |
| Nazwa pola powiązanego | Nazwa pola powiązanego (wypełniana automatycznie). |
Uwaga: wartości w polu Wartość filtru należy wprowadzać w języku interfejsu, z którego będzie uruchamiany raport. Na przykład jeśli raport jest uruchamiany z interfejsu w języku polskim, wszystkie wartości filtrów należy podać po polsku.
4. Dodawanie kodów mapowania
Kody mapowania są używane dla zmiennych podczas generowania raportu lub wykonywania integracji.
Strona: Mapowanie szablonu danych (wybierz przycisk Kody mapowania danych na stronie Szablony danych)
| Pole | Opis |
|---|---|
| Kod | Unikatowy kod mapowanej zmiennej. |
| Opis | Opis mapowania. |
| Powtarzalny | Jeśli zaznaczone, to mapowanie dotyczy tabeli powtarzalnej. |
| Powtarzalna tabela danych | Kod tabeli powtarzalnej. |
| Typ danych | Czym jest obliczona wartość: Tekst (domyślnie), Liczba całkowita, Dziesiętne, Data, Data i godzina, Godzina lub Wartość logiczna. Zobacz poniżej Czym jest wartość. |
Pozostałe ustawienia kodu mapowania znajdują się w panelu Typ wyniku po prawej stronie strony, który zawsze pokazuje kod mapowania wybrany na liście:
| Pole | Opis |
|---|---|
| Typ danych | To samo pole co na liście, powtórzone tutaj, ponieważ zależą od niego poniższe pola. |
| Miejsca dziesiętne | Tylko dla Typ danych = Dziesiętne. Liczba cyfr zapisywanych po separatorze dziesiętnym, na przykład 2. Wartość jest zaokrąglana do tej liczby miejsc. |
| Wyrażenie formatu | Opcjonalne. Ciąg formatu Business Central, używany dokładnie w postaci wpisanej i nigdy nietłumaczony, na przykład <Year4>-<Month,2>. Zastępuje standardową postać liczby, daty, daty i godziny lub godziny. |
| Przytnij | Usuwa spacje na początku i na końcu wartości, na przykład gdy pole źródłowe ma stałą długość. |
| Puste jako zero | Pozwala traktować pustą wartość jako 0 w obliczeniach tego kodu mapowania. Bez tej opcji pusty operand zatrzymuje obliczenie z błędem. |
Czym jest wartość – typy danych i formatowanie
Bez tych ustawień kod mapowania generuje tekst w stałej, niezależnej od języka postaci: liczbę dziesiętną jako
1234.56, datę jako 2026-08-17, pole Tak/Nie jako jego etykietę. Każda aplikacja korzystająca z szablonu musi
wtedy wiedzieć, czym naprawdę jest ten tekst, a większość z nich przechowuje własną kopię tej informacji.
Typ danych pozwala szablonowi określić to raz.
- Tekst jest wartością domyślną i niczego nie zmienia. Kod mapowania skonfigurowany przed wprowadzeniem tej funkcji generuje dokładnie to samo co wcześniej.
- Pusta wartość pozostaje pusta niezależnie od typu danych. Pusta wartość to brakujące dane, a nie
uszkodzona liczba, więc nigdy nie jest zamieniana na
0ani zgłaszana jako błąd. - Dziesiętne zaokrągla do liczby Miejsc dziesiętnych, a następnie zapisuje dokładnie tyle cyfr:
1234.5z dwoma miejscami daje1234.50, a z zerem miejsc1235. Zaokrąglanie następuje do najbliższej wartości, a połowa jest zaokrąglana od zera (1234.5→1235,-1234.5→-1235). - Liczba całkowita oczekuje liczby całkowitej i odrzuca wartość z częścią dziesiętną. Jeśli potrzebujesz zaokrąglania, wybierz Dziesiętne z Miejsca dziesiętne = 0 – wtedy konfiguracja mówi, co się dzieje.
- Data, Data i godzina oraz Godzina są zapisywane w neutralnej postaci ISO (
2026-08-17) niezależnie od języka sesji, chyba że Wyrażenie formatu stanowi inaczej. - Wartość logiczna jest zapisywana jako
truelubfalse– nigdy jako Tak/Nie w języku sesji. - Wartość, której nie można odczytać jako zadeklarowanego typu danych, zatrzymuje obliczenie z błędem, który
wskazuje szablon i kod mapowania. Na tym polega sens deklarowania typu: ten sam błąd ujawniał się
wcześniej znacznie później, wewnątrz aplikacji korzystającej z szablonu, która nie mogła już wskazać, który kod
mapowania był nieprawidłowy. Jeśli kod mapowania odczytuje tabelę z ustawioną Wartością domyślną (zobacz
Co się dzieje, gdy nic nie zostanie znalezione), ta wartość domyślna również musi dać się odczytać jako
ten typ danych:
N/Aprzy Typ danych = Dziesiętne to błąd konfiguracji. - Przytnij działa przed zastosowaniem typu danych, więc pole źródłowe uzupełnione spacjami nadal można odczytać jako liczbę lub datę.
- Puste jako zero dotyczy operandów
+,-,*i/, a nie wyniku. Bez tej opcji pusty operand jest błędem konfiguracji – celowo, ponieważ niepostrzeżenie brakująca kwota jest gorsza niż zatrzymany eksport. - Kod mapowania, który odczytuje inny kod mapowania (Typ = Dane), widzi jego sformatowaną wartość.
Zatem kod mapowania zadeklarowany jako Dziesiętne z dwoma miejscami przekazuje
1234.50temu, kto go odczytuje.
5. Dodawanie wyrażeń
Każdy kod mapowania danych musi mieć co najmniej jedno wyrażenie. Wyrażenia określają, jakie dane zostaną wyprowadzone do raportu. Aby dodać wyrażenia, na stronie Mapowanie szablonu danych przejdź do pola Wyrażenie odpowiedniego kodu mapowania i wprowadź potrzebne wyrażenia:
| Pole | Opis |
|---|---|
| Operacja | Typ operacji (Złącz, +, -, *, /, Jeśli puste itd.). Użyj operacji Złącz, aby pobrać wartość pola. Użyj operatorów arytmetycznych do obliczeń. Użyj operacji Jeśli puste, aby sprawdzić puste wartości i podać wartość zastępczą. Użyj operacji Jeśli niepuste, aby sprawdzić wartości niepuste. |
| Typ | Typ wyrażenia (Stała, Pole, Dane, Agregacja). Użyj typu Pole, aby odwołać się do pola tabeli; Stała – dla wartości statycznych; Agregacja – aby obliczyć jedną wartość z zestawu rekordów (zobacz poniżej). |
| Wartość stała | Podaj wartość stałą, jeśli Typ to Stała. |
| Dane powiązanej tabeli | Kod tabeli, z której pobierane są dane. |
| Nazwa tabeli | Nazwa powiązanej tabeli. |
| Identyfikator pola | Identyfikator pola w powiązanej tabeli. |
| Etykieta pola | Nazwa pola w powiązanej tabeli (wypełniana automatycznie). |
| Typ agregacji | Tylko dla Typ = Agregacja. Sposób agregowania rekordów: Suma, Średnia, Liczba, Minimum, Maksimum, Pierwszy, Ostatni lub Połącz. |
| Źródło agregacji | Tylko dla Typ = Agregacja. Pole agreguje wartości pola o Identyfikatorze pola; Mapowanie agreguje obliczone wartości powtarzalnego kodu mapowania. |
| Kod mapowania agregacji | Tylko dla Źródło agregacji = Mapowanie. Powtarzalny kod mapowania, którego wartości są agregowane. Musi używać tej samej tabeli powtarzalnej co pole Dane powiązanej tabeli. |
| Separator | Tylko dla Typ agregacji = Połącz. Tekst wstawiany między dwiema wartościami. Domyślnie przecinek i spacja; pozostaw puste, aby łączyć bez separatora. |
| Reguła przekształcenia | Użyj, jeśli wartość wynikową trzeba przekształcić do innego formatu. |
Agregacja zestawu rekordów
Wyrażenie o Typ = Agregacja zwraca jedną wartość obliczoną dla wszystkich rekordów tabeli wskazanej w polu Dane powiązanej tabeli zamiast wartości jednego rekordu. Z tego składa się suma dokumentu: bez agregacji tylko aplikacja korzystająca z szablonu może zsumować wiersze, co jest niemożliwe dla pola nagłówka dokumentu.
Agregowany zestaw to zmienna tabeli wyznaczona w bieżącym zakresie – jej własne filtry oraz jej powiązanie ze zmienną nadrzędną. Nic więcej nie trzeba konfigurować, a ta jedna reguła daje oba kształty:
- z kodu mapowania, który nie jest powtarzalny, po powtarzalnej tabeli wierszy ⇒ suma dokumentu (wszystkie wiersze dokumentu);
- z kodu mapowania, który jest powtarzalny, po tabeli powiązanej z tabelą wierszy ⇒ suma częściowa wiersza (tylko rekordy należące do obliczanego wiersza).
Reguły, które warto znać przed skonfigurowaniem agregacji:
- Suma i Średnia wymagają pola typu Decimal lub Integer. Każdy inny typ pola jest odrzucany z błędem wskazującym szablon, kod mapowania i wiersz wyrażenia.
- Dla pustego zestawu Suma i Liczba zwracają
0, a każdy inny typ agregacji zwraca pustą wartość. Średnia nigdy nie kończy się błędem dzielenia przez zero. - Puste wartości są pomijane przez Sumę, Średnią, Minimum, Maksimum i Połącz. Pierwszy i Ostatni są pozycyjne i zwracają wartość pierwszego lub ostatniego rekordu, nawet jeśli jest pusta.
- Liczba zlicza rekordy i ignoruje Identyfikator pola.
- Pierwszy, Ostatni i kolejność Połącz podążają za polami Identyfikator pola sortowania i Kolejność sortowania tabeli, a gdy pole sortowania nie jest ustawione – za jej kluczem podstawowym (zobacz Sortowanie rekordów tabeli).
- Maks. liczba rekordów tabeli ogranicza również agregację, więc suma zawsze odpowiada wierszom, które faktycznie wygenerowano.
- Minimum i Maksimum porównują liczby jako liczby, a wszystko inne jako tekst. Daty, daty z godziną i godziny są sortowane poprawnie, ponieważ mechanizm formatuje je w postaci ISO.
- Reguła przekształcenia wiersza jest stosowana do wyniku agregacji, a nie do każdego rekordu.
- Źródło agregacji = Mapowanie oblicza tabelę powtarzalną na żądanie, jeśli mechanizm jeszcze do niej nie dotarł. Agregacja, która w efekcie zależy od samej siebie, jest odrzucana z błędem pokazującym łańcuch kodów mapowania.
- Wydajność: agregacja odczytuje rekordy zestawu jeden raz. Jeśli tabela ma już pole FlowField, które sumuje to, czego potrzebujesz (na przykład Kwota całkowita w nagłówku dokumentu), wyrażenie o Typ = Pole na tym polu FlowField jest szybsze, ponieważ baza danych odpowiada na nie z indeksu.
6. Sprawdzanie szablonu
Akcja Sprawdź szablon na liście Szablony danych i na karcie Szablon danych sprawdza całą konfigurację wybranego szablonu i wyświetla wszystko, co może w niej znaleźć nie tak – w jednym przebiegu, dzięki czemu poprawiasz listę, zamiast znajdować jeden błąd na każdy dokument.
Co kontrola robi, a czego nie robi:
- Odczytuje wyłącznie konfigurację i metadane tabel. Nigdy nie odczytuje rekordu biznesowego, więc można ją bezpiecznie uruchomić w dowolnym momencie i w dowolnej firmie – i nie może powiedzieć, czy Twoje dane pasują do filtrów, a jedynie czy same filtry są prawidłowe.
- Niczego nie zmienia. Przebieg walidacji nie tworzy, nie zmienia ani nie usuwa żadnego wiersza konfiguracji i niczego nie naprawia automatycznie.
- Nic nie uruchamia jej za Ciebie. Szablon, który nigdy nie został sprawdzony, nadal po raz pierwszy zawiedzie w aplikacji wywołującej.
- Jednej rzeczy nigdy nie sprawdzi: które aplikacje używają tego szablonu. To rozszerzenie nie zależy od aplikacji, które je wywołują, i nie może odczytać ich konfiguracji, więc żadna reguła nie powie, kto odwołuje się do kodu szablonu lub kodu mapowania. Zmiana nazwy lub usunięcie któregokolwiek z nich jest bezpieczne dopiero po sprawdzeniu konfiguracji samej aplikacji wywołującej.
Każdy wiersz wyniku to uwaga:
| Kolumna | Co to jest |
|---|---|
| Ważność | Jak istotna jest uwaga – zobacz poniżej. |
| Kod reguły | Stały kod reguły, która ją wygenerowała, opisany w sekcji Opis reguł. |
| Komunikat | Co jest nie tak i co należy zmienić. |
| Kod tabeli, Kod mapowania, Nr wiersza wyrażenia | Którego wiersza konfiguracji dotyczy uwaga. |
Wybierz Pokaż wiersz, aby otworzyć ten wiersz konfiguracji i go poprawić. Akcja jest wyłączona dla uwagi, która dotyczy całego szablonu.
Ważność
- Błąd – szablon nie może wygenerować poprawnego wyniku. Większość błędów zatrzymuje całe obliczenie, a nie tylko jedną wartość, więc aplikacja wywołująca nie otrzymuje niczego.
- Ostrzeżenie – konfiguracja jest akceptowana, ale prawdopodobnie nie robi tego, na co wygląda. Przeczytaj i zdecyduj; nic Cię nie blokuje.
- Informacja – warto wiedzieć. Nic nie jest uszkodzone.
Opis reguł
Szablon
| Kod reguły | Ważność | Co oznacza | Jak naprawić |
|---|---|---|---|
TPL-MISSING |
Błąd | Kod szablonu już nie istnieje. | Odśwież listę; szablon został usunięty, gdy strona była otwarta. |
TPL-EMPTY |
Błąd | Szablon nie ma tabel ani kodów mapowania, więc niczego nie generuje. | Dodaj zmienną odczytującą rekord tabeli źródłowej, a następnie kody mapowania. |
TPL-NO-SOURCE |
Błąd | Pole Identyfikator tabeli źródłowej jest puste, więc szablon nie określa, co przekazuje aplikacja wywołująca. | Wprowadź numer tej tabeli, na przykład 112 dla tabeli Nagłówek zaksięgowanej faktury sprzedaży. |
TPL-BAD-SOURCE |
Błąd | Identyfikator tabeli źródłowej nie jest tabelą w tej bazie danych. | Wybierz istniejącą tabelę. Aplikacja, do której należała poprzednia tabela, mogła zostać odinstalowana. |
TPL-NO-ROOT |
Błąd | Żadna tabela szablonu nie jest oznaczona jako główna, więc nic nie jest wyznaczane na podstawie przekazanego rekordu. | Wprowadź numer tabeli źródłowej w polu Identyfikator tabeli tej tabeli, która reprezentuje ten rekord; walidacja tego pola ustawia opcję Główna. |
TPL-ROOT-MISMATCH |
Błąd | Tabela jest oznaczona jako główna, ale odczytuje inną tabelę niż wskazana w polu Identyfikator tabeli źródłowej. Główna to zapisany znacznik i pole Identyfikator tabeli źródłowej go nie przelicza, więc tak wygląda szablon po zmianie jego tabeli źródłowej. | Popraw pole Identyfikator tabeli tej tabeli albo ustaw inną tabelę jako główną. |
TPL-ROOT-NOT-SET |
Błąd | Tabela odczytuje dokładnie tabelę źródłową, ale nie jest oznaczona jako główna, więc rekord przekazywany przez aplikację wywołującą nigdy nie jest używany. | Wprowadź ponownie jej Identyfikator tabeli – walidacja tego pola ustawia opcję Główna. |
TPL-MULTI-ROOT |
Błąd | Więcej niż jedna tabela jest oznaczona jako główna. | Zachowaj jedną tabelę główną i zmień Identyfikator tabeli pozostałych. |
TPL-NO-MAPPINGS |
Błąd | Typ to Mapowanie, ale nie ma kodów mapowania, więc obliczenie niczego nie zwraca. | Dodaj kody mapowania, których żąda aplikacja wywołująca, lub zmień typ. |
TPL-FILTER-MAPPINGS |
Ostrzeżenie | Typ to Filtr rekordów, więc kody mapowania nigdy nie są obliczane. | Usuń je lub zmień typ na Mapowanie. |
TPL-FILTER-REPEAT |
Informacja | Szablon typu Filtr rekordów zawiera tabelę powtarzalną, którą kontrola tak/nie ignoruje. | Nic nie trzeba zmieniać. Wyłącz opcję Powtarzalna, jeśli ta tabela miała być sprawdzana. |
Tabele
| Kod reguły | Ważność | Co oznacza | Jak naprawić |
|---|---|---|---|
TAB-NO-TABLE |
Błąd | Zmienna nie określa, którą tabelę odczytuje. Zatrzymuje to cały szablon, łącznie z odpowiedzią tak/nie szablonu typu Filtr rekordów. | Wprowadź Identyfikator tabeli lub usuń zmienną. |
TAB-BAD-TABLE |
Błąd | Identyfikator tabeli nie jest tabelą w tej bazie danych. | Wybierz istniejącą tabelę. |
TAB-NO-PARENT |
Ostrzeżenie | Zmienna nie jest główna, nie ma Kodu danych nadrzędnych ani filtrów, więc wskazuje pierwszy rekord całej tabeli. | Dodaj kod danych nadrzędnych z filtrem pola powiązanego albo stały filtr. Pozostaw bez zmian tylko dla tabeli, która ma dokładnie jeden rekord, takiej jak Informacje o firmie. |
TAB-PARENT-MISSING |
Błąd | Kod danych nadrzędnych wskazuje zmienną, która nie istnieje. | Wybierz istniejącą zmienną lub wyczyść pole. |
TAB-PARENT-CYCLE |
Błąd | Łańcuch kodów danych nadrzędnych jest cykliczny. Komunikat pokazuje ten łańcuch. | Przerwij łańcuch na jednej ze wskazanych zmiennych. |
TAB-REPEAT-NO-LINK |
Błąd | Zmienna powtarzalna wskazuje zmienną nadrzędną, ale nie ma filtru pola powiązanego, więc dla każdego dokumentu odczytywane są wszystkie rekordy tabeli. | Dodaj filtr o Typ = Pole powiązane, który łączy ją z rekordem nadrzędnym. |
TAB-LATEST-REPEAT |
Błąd | Opcje Powtarzalna i Ostatni są jednocześnie włączone i wzajemnie się wykluczają. | Wyłącz jedną z nich: Ostatni pobiera ostatni rekord, Powtarzalna pobiera wszystkie. |
TAB-SORT-FIELD |
Błąd | Identyfikator pola sortowania lub Identyfikator pola sortowania 2 nie istnieje, jest wyłączony albo jest polem, według którego baza danych nie może porządkować – FlowField, FlowFilter albo pole BLOB lub multimedialne. | Wybierz inne pole sortowania lub wprowadź 0, aby zachować kolejność klucza podstawowego. |
TAB-MAX-RECORDS |
Błąd | Maks. liczba rekordów jest ustawiona dla zmiennej, która nie jest powtarzalna, więc limit nigdy nie jest stosowany. | Włącz opcję Powtarzalna lub ustaw Maks. liczba rekordów na 0. |
TAB-NO-DEFAULT |
Błąd | Przy braku rekordu ma wartość Użyj wartości domyślnej, ale pole Wartość domyślna jest puste. | Wprowadź wartość domyślną lub wybierz Pozostaw puste. |
TAB-DEFAULT-TYPE |
Błąd | Wartości domyślnej nie można odczytać jako typu danych kodu mapowania, który odczytuje tę zmienną. | Wprowadź ją w formacie niezależnym od języka dla tego typu (0, 1234.56, 2026-08-17, true) lub zmień typ danych kodu mapowania. |
Filtry
| Kod reguły | Ważność | Co oznacza | Jak naprawić |
|---|---|---|---|
FLT-FIELD-MISSING |
Błąd | Filtrowane pole nie istnieje w tabeli odczytywanej przez zmienną lub jest wyłączone. | Usuń wiersz filtru i wprowadź go ponownie. |
FLT-FIELD-OBSOLETE |
Ostrzeżenie | Filtrowane pole jest oznaczone w Business Central jako przestarzałe, więc aktualizacja może je usunąć. | Filtruj inne pole. |
FLT-ORPHAN |
Informacja | Wiersze filtrów należą do zmiennej, która już nie istnieje. Nigdy nie są stosowane, a strony konfiguracji w ogóle nie mają do nich dostępu, ponieważ filtry otwiera się z wiersza zmiennej. | Wybierz Pokaż wiersz dla uwagi – to jedyna droga do nich – i usuń je. Albo utwórz zmienną ponownie. |
FLT-STALE-TABLE |
Błąd | Wiersz filtru nadal zawiera tabelę z poprzedniej konfiguracji. | Usuń filtr i wprowadź go ponownie. |
FLT-STALE-PARENT |
Błąd | Połączenie nadal oczekuje tabeli nadrzędnej z poprzedniej konfiguracji. | Wprowadź ponownie Kod tabeli zmiennej, co odświeży zapisaną tabelę nadrzędną. |
FLT-LINK-NO-PARENT |
Błąd | Typ to Pole powiązane, ale zmienna nie ma Kodu danych nadrzędnych, z którego można pobrać wartość. | Wprowadź kod danych nadrzędnych lub zmień typ filtru na Filtr. |
FLT-LINK-NO-FIELD |
Błąd | Typ to Pole powiązane, ale pole Identyfikator pola powiązanego jest puste. | Wprowadź pole rekordu nadrzędnego, którego wartości używa połączenie. |
FLT-LINK-BAD-FIELD |
Błąd | Identyfikator pola powiązanego nie istnieje w tabeli nadrzędnej lub jest wyłączony. | Wybierz inne pole powiązane. |
FLT-LINK-TYPE |
Błąd | Dwa łączone pola mają typy, których nie można porównać, na przykład pole kodu połączone z polem opcji. | Łącz pola tego samego typu. |
FLT-VALUE-SYNTAX |
Błąd | Wartość filtru nie jest wyrażeniem filtru akceptowanym przez Business Central dla tego pola. Sprawdzane dla obu typów filtrów: w wierszu Filtr wartość jest całym filtrem, w wierszu Pole powiązane jest wzorcem, do którego wstawiana jest wartość nadrzędna. Kontrola przekazuje wartość platformie bez uruchamiania filtru, więc żaden rekord nie jest odczytywany. | Popraw ją, na przykład na 1000..2000, <>'' lub A\|B. |
FLT-PATTERN-TOKEN |
Ostrzeżenie | Wiersz Pole powiązane ma Wartość filtru, która jest wtedy używana jako wzorzec dla wartości nadrzędnej – ale nie zawiera %1, więc wartość nadrzędna jest pomijana, a połączenie po cichu dopasowuje wszystko, na co pozwala wzorzec. |
Wstaw %1 w miejscu wartości nadrzędnej (<>%1, %1..) lub wyczyść Wartość filtru, aby łączyć według równości. |
FLT-VALUE-LANGUAGE |
Ostrzeżenie | Wartość filtru pola opcji, wartości logicznej, daty, daty i godziny lub godziny zawiera tekst zależny od języka sesji – etykietę opcji, Tak/Nie lub zlokalizowaną datę. Szablon przestaje wtedy znajdować dopasowania, gdy działa w innym języku. | Użyj wartości niezależnej od języka: numeru opcji, 1/0 lub daty ISO, takiej jak 20260817. |
Kody mapowania
| Kod reguły | Ważność | Co oznacza | Jak naprawić |
|---|---|---|---|
MAP-NO-REPEAT-TABLE |
Błąd | Opcja Powtarzalny jest włączona, ale pole Powtarzalna tabela danych jest puste. | Wprowadź zmienną powtarzalną, dla której wierszy ten kod mapowania generuje wartości. |
MAP-BAD-REPEAT-TABLE |
Błąd | Powtarzalna tabela danych wskazuje zmienną, która nie istnieje lub nie jest powtarzalna. | Wybierz zmienną z włączoną opcją Powtarzalna. |
MAP-INDEX-NOT-REPEAT |
Błąd | Opcja Indeks powtórzenia jest włączona, ale Powtarzalny jest wyłączona, więc nic nie jest numerowane. | Włącz opcję Powtarzalny lub wyłącz Indeks powtórzenia. |
MAP-NO-EXPRESSIONS |
Błąd | Kod mapowania nie ma wierszy wyrażenia, więc jego wartość jest zawsze pusta. | Dodaj co najmniej jeden wiersz wyrażenia. Kod mapowania z opcją Indeks powtórzenia nie potrzebuje żadnego i nigdy nie jest zgłaszany. |
MAP-UNREFERENCED |
Informacja | W szablonie typu Filtr rekordów żadne wyrażenie nie odczytuje tego kodu mapowania i żadna wartość nigdy nie trafia do aplikacji wywołującej. W szablonie typu Mapowanie ta uwaga nigdy nie jest zgłaszana: kody mapowania istnieją po to, aby odczytywała je aplikacja wywołująca, której to rozszerzenie nie widzi, więc „brak uwagi” nie oznacza tutaj „ktoś go używa”. | Usuń go lub zmień typ szablonu. |
MAP-FORMAT-TYPE |
Błąd | Miejsca dziesiętne lub Wyrażenie formatu są ustawione dla typu danych, który ich nie używa. | Wyczyść je lub wybierz inny typ danych. Miejsca dziesiętne dotyczą typu Dziesiętne; format dotyczy typów Liczba całkowita, Dziesiętne, Data, Data i godzina oraz Godzina. |
MAP-FORMAT-INVALID |
Błąd | Wyrażenie formatu nie jest formatem, który Business Central może zastosować do zadeklarowanego typu danych. | Popraw je, na przykład na <Year4>-<Month,2>. |
Wyrażenia
| Kod reguły | Ważność | Co oznacza | Jak naprawić |
|---|---|---|---|
EXP-ORPHAN |
Informacja | Istnieją wiersze wyrażenia dla kodu mapowania, który już nie istnieje. Nigdy nie są obliczane – martwa konfiguracja, nieszkodliwa w czasie wykonywania. | Usuń je lub utwórz kod mapowania. |
EXP-CONST-EMPTY |
Błąd | Typ to Stała, a pole Wartość stała jest puste, więc wiersz niczego nie dodaje. | Wprowadź tekst lub usuń wiersz. |
EXP-NO-TABLE |
Błąd | Typ to Pole lub Agregacja, a pole Dane powiązanej tabeli jest puste. | Wprowadź kod zmiennej do odczytu. |
EXP-TABLE-MISSING |
Błąd | Dane powiązanej tabeli wskazują zmienną, która nie istnieje w tym szablonie. | Wybierz istniejącą zmienną. |
EXP-NO-TABLE-ID |
Błąd | Wiersz w ogóle nie zawiera numeru tabeli swojej zmiennej, więc obliczenie się na nim zatrzymuje. Wiersz może znaleźć się w tym stanie tylko w wyniku importu: wprowadzenie kodu zmiennej uzupełnia numer. | Wprowadź ponownie kod zmiennej. |
EXP-STALE-TABLE |
Błąd | Wiersz nadal odczytuje pola tabeli, którą zmienna odczytywała wcześniej. | Wprowadź ponownie kod zmiennej, co odświeży numer tabeli zapisany w wierszu. |
EXP-NO-FIELD |
Błąd | Wiersz musi wskazywać pole, a go nie wskazuje. Zatrzymuje to całe obliczenie. | Wprowadź Identyfikator pola. Agregacja typu Liczba go nie potrzebuje. |
EXP-FIELD-MISSING |
Błąd | Pole nie istnieje w tabeli odczytywanej przez zmienną lub jest wyłączone. | Wybierz inne pole. |
EXP-FIELD-OBSOLETE |
Ostrzeżenie | Pole jest oznaczone w Business Central jako przestarzałe, więc aktualizacja może je usunąć. | Odczytuj inne pole. |
EXP-DATA-EMPTY |
Błąd | Typ to Dane, ale nie wskazano kodu mapowania. Zatrzymuje to całe obliczenie. | Wprowadź kod mapowania, którego wartość odczytuje wiersz. Pamiętaj, że gdy Typ to Dane, pole Dane powiązanej tabeli zawiera kod mapowania. |
EXP-DATA-MISSING |
Błąd | Typ to Dane, a wskazany kod mapowania nie istnieje. | Wybierz istniejący kod mapowania. |
EXP-DATA-CYCLE |
Błąd | Dwa lub więcej kodów mapowania odczytuje się nawzajem w cyklu, więc żadnego z nich nie można obliczyć. | Przerwij cykl. |
EXP-REPEAT-READS |
Ostrzeżenie | Powtarzalny kod mapowania odczytuje kod mapowania obliczany raz dla całego dokumentu, więc ta sama wartość pojawia się w każdym wierszu. | W niektórych szablonach jest to zamierzone – numer dokumentu powtarzany w każdym wierszu. W przeciwnym razie odczytuj pole wiersza. |
EXP-FIRST-OPERATION |
Ostrzeżenie | Pierwszy wiersz kodu mapowania używa +, -, * lub /, które nie mają na czym działać; mechanizm dołącza wtedy wiersz. |
Ustaw Operacja na Złącz w pierwszym wierszu lub przenieś wiersz niżej. |
EXP-DIV-EMPTY |
Ostrzeżenie | Wiersz dzieli przez wartość, która może być pusta lub równa zero, a obliczenie zatrzymuje się wtedy z błędem. | Upewnij się, że dzielnik nigdy nie jest pusty ani równy zero, lub dziel przez stałą. |
EXP-RULE-MISSING |
Błąd | Reguła przekształcenia wskazuje regułę, która nie istnieje. | Wybierz istniejącą regułę przekształcenia lub wyczyść pole. |
EXP-AGG-NO-TYPE |
Błąd | Typ to Agregacja, a pole Typ agregacji jest puste. | Wybierz sposób agregowania rekordów, na przykład Suma. |
EXP-AGG-NO-SOURCE |
Błąd | Typ to Agregacja, a pole Źródło agregacji jest puste. | Wybierz Pole lub Mapowanie. |
EXP-AGG-FIELD-TYPE |
Błąd | Suma lub Średnia po polu, które nie jest liczbą. | Agreguj pole liczbowe lub wybierz Liczba, Minimum, Maksimum, Pierwszy, Ostatni albo Połącz. |
EXP-AGG-MAPPING |
Błąd | Kod mapowania agregacji nie istnieje, nie jest powtarzalny lub należy do innej zmiennej powtarzalnej niż agregowana. | Wybierz powtarzalny kod mapowania tej samej zmiennej co w polu Dane powiązanej tabeli. |
EXP-AGG-SEPARATOR |
Informacja | Separator jest ustawiony dla agregacji innej niż Połącz, a każdy inny typ go ignoruje. | Wyczyść go lub wybierz Połącz. |
Inne
| Kod reguły | Ważność | Co oznacza | Jak naprawić |
|---|---|---|---|
INTERNAL |
Błąd | Nie udało się wykonać reguły samej kontroli – na przykład dlatego, że tabela należy do aplikacji, która nie jest już zainstalowana. Wszystkie pozostałe reguły zostały wykonane. | Uwaga mówi, że brakuje części kontroli, a nie co jest nie tak z szablonem. Zgłoś zawarty w niej komunikat. |
7. Przenoszenie szablonu między firmami
Szablon danych to dużo konfiguracji, która zwykle jest budowana raz, a potem potrzebna gdzie indziej – w innej firmie, w innej dzierżawie, w testowej bazie danych. Służą do tego trzy akcje na liście Szablony danych i na karcie Szablon danych: Eksportuj szablon, Importuj szablon i Kopiuj szablon.
Co zawiera plik
Eksportuj szablon zapisuje wybrany szablon w jednym pliku JSON: nagłówek szablonu, każdą zmienną z jej filtrami, każdy kod mapowania z jego wierszami wyrażenia. Nic więcej – plik zawiera wyłącznie konfigurację, nigdy ani jednego rekordu biznesowego, więc można go bezpiecznie wysłać współpracownikowi lub dołączyć do zgłoszenia serwisowego.
Plik jest zapisywany tak, aby był czytelny i porównywalny:
| Właściwość | Co oznacza dla Ciebie |
|---|---|
| Wszystko w jednym pliku | Jeden kompletny szablon. Nie ma drugiego pliku ani kolejności, w jakiej trzeba importować kilka plików. |
| Numery tabel i pól, każdy z nazwą | Zawsze decyduje numer. Nazwa jest zapisywana dla czytelnika – człowieka lub AI – aby plik mówił, czym naprawdę są tabela 112 i pole 22; podczas importu jest całkowicie ignorowana. Nazwy są nieprzetłumaczonymi nazwami Business Central, więc ten sam szablon eksportuje się do tego samego pliku w każdym języku. |
| Wartości zapisane w całości | W pliku jest każde ustawienie, także puste, zerowe lub wyłączone. To, co widzisz, to całe słownictwo konfiguracji. |
| Bez daty, użytkownika i firmy | Dwukrotny eksport tego samego szablonu daje dokładnie ten sam plik, więc dwa pliki można porównać dowolnym narzędziem tekstowym, aby zobaczyć, co faktycznie się różni. |
schemaVersion |
Wersja formatu. Zobacz poniżej Co robi starszy lub nowszy plik. |
Plik jest zwykłym tekstem. Można go edytować, ale bezpiecznym sposobem zmiany szablonu jest zaimportowanie go i zmiana w Business Central – import sprawdza to, co mu przekazujesz, a edytor nie.
Importowanie
Importuj szablon prosi o plik, a szablon jest importowany pod kodem zawartym w pliku. Jeśli w tej firmie istnieje już szablon danych o tym kodzie, system pyta raz, czy go zastąpić – odpowiedz Nie, a nic się nie stanie; odpowiedz Tak, a istniejący szablon zostanie usunięty, a plik zapisany na jego miejsce, w jednym kroku. Zanim odpowiesz Tak, przeczytaj poniżej sekcję Zanim zastąpisz szablon.
Aby mieć ten sam szablon dwa razy w jednej firmie, zaimportuj go, a następnie użyj akcji Kopiuj szablon, aby zduplikować go pod drugim kodem.
Nic nie jest zapisywane, dopóki wszystko nie przejdzie kontroli. Import najpierw odczytuje cały plik, następnie sprawdza, czy każda wskazana w nim tabela i każde pole istnieją w tej bazie danych, potem zapisuje szablon, a następnie uruchamia tę samą kontrolę co Sprawdź szablon – a jeśli ta kontrola znajdzie błąd, cały import zostaje cofnięty. Nie ma częściowo zaimportowanego szablonu: albo szablon jest i jest kompletny, albo ta firma jest dokładnie w takim stanie jak wcześniej.
W odpowiedzi otrzymujesz listę uwag na tej samej stronie i z tymi samymi poziomami ważności co w akcji Sprawdź szablon (§6): Błąd oznacza, że nic nie zostało zaimportowane, Ostrzeżenie oznacza, że szablon został zaimportowany i jest coś, o czym powinieneś wiedzieć, Informację warto przeczytać raz.
Import nigdy nie zmienia nazw w szablonie: kod szablonu pochodzi z pliku, a kody zmiennych, kody mapowania i wszystkie odwołania między nimi są dokładnie takie, jak w pliku.
Zanim zastąpisz szablon
Aplikacje, które używają szablonu danych, odwołują się do niego za pomocą jego kodu, a ich konfiguracja znajduje się w rozszerzeniach, od których to rozszerzenie nie zależy i których nie może odczytać. Żadna kontrola nie powie tutaj, kto używa szablonu – dlatego system w ogóle pyta, zamiast po prostu dokonać zastąpienia. Zanim odpowiesz Tak, sprawdź konfigurację samej aplikacji wywołującej: kod mapowania, którego nie ma w pliku, to wartość, której ta aplikacja przestanie otrzymywać.
Co robi starszy lub nowszy plik
Format ma wersję zapisaną jako major.minor.
- Nowsza wersja pomocnicza (
1.1, gdy ta wersja odczytuje1.0) importuje się normalnie. Ustawienia, których ta wersja nie zna, są ignorowane. - Starszy plik również importuje się normalnie. Ustawienie, którego w nim nie ma, przyjmuje wartość domyślną.
- Inna wersja główna (
2.0) jest odrzucana z komunikatem wskazującym wersję, którą odczytuje ta wersja. Wyeksportuj plik ponownie z Business Central w odpowiedniej wersji.
Kopiowanie szablonu w obrębie jednej firmy
Kopiuj szablon tworzy kompletny duplikat pod nowym kodem: każdą zmienną, filtr, kod mapowania i wiersz wyrażenia. Niczego wewnątrz szablonu nie zmienia – kody zmiennych i kody mapowania pozostają dokładnie takie same, ponieważ znaczą to samo pod każdym kodem szablonu.
Warto wiedzieć dwie rzeczy:
- Kopia nie jest sprawdzana. To celowe: szablon często kopiuje się właśnie dlatego, że jest uszkodzony i potrzebne jest miejsce, w którym można go naprawić. Po zakończeniu zmian wybierz dla kopii akcję Sprawdź szablon.
- Nowy kod musi być wolny. Kod, który jest używany, zostanie odrzucony, a istniejący szablon pozostanie nietknięty.
Opis reguł importu
Każda uwaga wygenerowana przez import ma jeden z tych kodów. Mogą się tu pojawić również kody akcji Sprawdź szablon (§6): import uruchamia tę kontrolę dla zapisanego szablonu, a każdy wykryty przez nią błąd cofa import.
| Kod reguły | Ważność | Co oznacza | Jak naprawić |
|---|---|---|---|
IMP-VERSION |
Błąd | Plik nie określa, której wersji formatu używa, wersji nie można odczytać albo jej wersja główna jest nieznana tej wersji. | Wyeksportuj plik ponownie z Business Central w wersji wskazanej w komunikacie. |
IMP-JSON |
Błąd | Czegoś w pliku brakuje lub ma niewłaściwy rodzaj – liczba zamiast tekstu, lista zamiast ustawienia. Komunikat wskazuje miejsce w pliku. | Popraw plik w tym miejscu lub wyeksportuj go ponownie zamiast edytować. |
IMP-CODE |
Błąd | Kod szablonu jest pusty albo wartość w pliku jest dłuższa niż pole, które ją przechowuje. Nic nie jest skracane, ponieważ skrócony kod to inny szablon. | Popraw wartość w pliku lub popraw ją w szablonie źródłowym i wyeksportuj go ponownie. |
IMP-EXISTS |
Błąd | Kod już istnieje, a zastąpienie nie zostało potwierdzone. Niczego nie zmieniono. Tak samo zawsze odpowiada import zaplanowany lub programowy, aby nigdy nie mógł po cichu nadpisać szablonu. | Zaimportuj plik ponownie i potwierdź zastąpienie albo najpierw zmień nazwę istniejącego szablonu. |
IMP-ENUM |
Błąd | Wartość wyboru w pliku jest nieznana tej wersji – plik pochodzi z bazy danych z rozszerzeniem, które nie jest tu zainstalowane, albo wartość została błędnie wpisana. | Zainstaluj brakujące rozszerzenie lub popraw tę wartość w pliku. |
IMP-TABLE |
Błąd | Plik wskazuje tabelę, która nie istnieje w tej bazie danych. Nic nie jest wymyślane i nic nie jest importowane. | Zainstaluj rozszerzenie, do którego należy ta tabela, lub wskaż w szablonie tabelę, która tu istnieje. |
IMP-FIELD |
Błąd | Plik wskazuje pole, którego tabela tutaj nie ma. | Tak samo: zainstaluj to, do czego pole należy, lub popraw pole w szablonie źródłowym i wyeksportuj go ponownie. |
8. Scenariusze użycia
Scenariusz 1: Eksport danych dokumentu
- Utwórz szablon dla dokumentu (np. faktury sprzedaży).
- Dodaj główną tabelę dokumentu i jego tabelę wierszy jako powtarzalną.
- Skonfiguruj filtry, aby powiązać wiersze z nagłówkiem.
- Zdefiniuj kody mapowania dla pól nagłówka i wierszy.
- Dodaj wyrażenia do obliczania wartości (np. łączenia pól, warunków).
Scenariusz 2: Integracja danych
- Utwórz szablon dla integracji.
- Dodaj wszystkie potrzebne tabele (np. Nabywca, Nagłówek sprzedaży, Wiersz sprzedaży).
- Użyj filtrów, aby wybrać wymagane rekordy.
- Zdefiniuj kody mapowania dla pól integracji.
- Użyj wyrażeń do przekształcenia danych.
Scenariusz 3: Raportowanie niestandardowe
- Utwórz szablon dla raportu.
- Dodaj tabele i skonfiguruj ich relacje.
- Zdefiniuj kody mapowania dla kolumn raportu.
- Użyj wyrażeń dla kolumn obliczanych (np. sum, wartości warunkowych).