Słownik
Adnotacja Słownik – umożliwia pobieranie danych ze słownika. Przy użyciu słownika wartość elementu będzie zamieniona. Słowniki i odpowiednie mapowania są konfigurowalne.
Słownik służy do zapamiętania niewielkiej ilości płaskich rekordów, a zwłaszcza odwzorowania pewnych atrybutów w inne, np.
- krótka nazwa i opis,
- kod wejściowy i kod wyjściowy,
- kompletna tabela opisująca nazwy, kody, typy, opisy dużej struktury danych.
W adnotacji Słownik np. w edytorze odwzorowania w miejscu lub na zakładce Mapowania startowe możemy ustawić następujące elementy:
- Nazwę słownika i parę kolumn odwzorowania klucz>wartość.
Dla przykładu:
Jeżeli chcemy aby w polu Type prezentowana była wartość słownikowa z kolumny Name (Corporate lub Individual) wówczas należy wybrać przypisanie w sekcji Mapping Id=>Name.
Przed wykorzystaniem adnotacji Słownik należy pobrać wartość Guid słownika.
- Dodaj adnotację Wyrażenie do pola i przejdź do edytora wyrażeń.
- Przejdź na drzewko DIC. Dostępne tutaj są wszystkie słowniki zdefiniowane w archITekt Studio.
- Przeciągnij do edytora wartość słownikową.
- Na schemacie danych dodaj do pola adnotację Słownik.
- W panelu Szczegóły wybierz przypisanie Id=>Name dla wybranej wartości słownikowej.
Jeżeli chcesz wyświetlić opis elementu słownikowego wybierz mapowanie Id=>Description.
Można też wykorzystać wbudowane funkcje do pobierania elementów słownikowych jak: DicItemName() oraz DicItemDescription() w edytorze wyrażeń po wcześniejszym dodaniu adnotacji Wyrażenie. Więcej patrz: Wyrażenia>Funkcje słownikowe.
Na zakładce Opcje wykorzystania słownika dodatkowo można określić:
- Błąd mapowania - postępowanie w przypadku niedopasowania klucza:
-
Wpisz domyślne dane - wpisz do pola, którego dotyczy mapowanie dane znajdujące się w polu konfiguracyjnym Domyślna wartość lub Domyślny klucz.
Wpisz domyślną wartość, jeśli jej nie ma, to wartość dla domyślnego klucza, jeśli jej nie ma, to klucz wejściowy.
-
Wpisz puste dane - wpisuje pustą wartość do pola jako wynik mapowania. Dodatkowo, w zależności od opcji Raportuj błędy zgłasza do rekordu Errors informację o nieudanym mapowaniu przez słownik.
-
Przerwij działanie pakietu - przerywa działanie pakietu, umieszcza na wyjściu błędów rekord z niepoprawnym mapowaniem przez słownik.
-
Pomiń rekord – pomija rekord z głównego przetwarzania i umieszcza go na wyjściu błędów, dodatkowo, umieszczając w kolekcji błędów (w rekordzie Errors) informację o nieudanym mapowaniu.
- Domyślną wartość i domyślny klucz – wykorzystywane przy ustawieniu Wpisz domyślne dane.
- Obcinaj białe znaki z klucza – czy przed wykonywaniem mapowania obciąć białe znaki (spacje, taby itd..) z obu końców wartości wejściowej? Oprócz standardowych opcji Tak/Nie możliwy jest także wybór opcji Dziedzicz z ustawień pakietu, która oznacza pobranie wartości z ustawień globalnych pakietu (dostępnych do edycji w panelu Właściwości dla całego pakietu).
- Raportuj błędy – czy doklejać do rekordu informację (w technicznym rekordzie „Errors”) ostrzeżenie o niedopasowaniu klucza? Często jest to niepotrzebne, a może mieć niemały wpływ na tempo działania pakietu. Opcja możliwa do ustawienia tylko jeśli w polu Błąd mapowania wybrano opcję Wpisz puste dane. Ma ona głównie znaczenie optymalizacyjne - jeśli w mapowaniu słownika bardzo często występuje brak klucza i zgłaszane błędy nie są nigdzie używane, włączenie opcji może spowodować znaczne przyspieszenie działania pakietu. Podobnie jak opcja Obcinaj białe znaki z klucza, domyślnie dziedziczy swoje ustawienia z opcji pakietu.
- Uwzględniaj wielkość liter klucza – Czy podczas wyszukiwania klucza w słowniku, przy porównywaniu liter brać pod uwagę ich wielkość (czy litera ‘a’ ma być tożsama z literą ‘A’)?
Zobacz również
Pole w formacie stałopozycyjnym