Adnotacje

---

Adnotacje to dodatkowe elementy dołączone do rekordu lub pola, które opisują zachowanie elementu, np. w następujących kontekstach: mapowanie jednego schematu na inny, zapisywanie rekordu do bazy danych, opis tekstowy, metoda obliczania wartości z innych pól, minimalna i maksymalna długość, typ, precyzja itp.

Na schemacie danych możesz wykonać szereg operacji, takie które zmieniają wyłącznie schemat danych i zmieniające treść rekordów danych.

1. Kliknij prawym na danym rekordzie lub polu w schemacie danych i z menu kontekstowego wybierz jedną z dostępnych opcji: Ustaw wartość, Użyj wartości lub Adnotacje.

Rodzaj dostępnych adnotacji jest różny dla pól oraz dla rekordów. W przypadku rekordu dostępne opcje to: Wypełnij rekord, Zmień/użyj rekordu, Adnotacje.

W przypadku użycia większości adnotacji aktywowany jest dodatkowy panel Szczegóły w dole ekranu, w którym należy określić dodatkowe parametry wykonywanej operacji. Patrz: panel Szczegóły.

Adnotacje nie interpretowane, dostępne w zasadzie wszędzie:

1. komentarz, długi komentarz,
2. element techniczny (np. wyłączony z zapisu i domyślnie z podglądu).

Opis – funkcja wprowadzania krótkiego opisu/informacji dotyczącej danego elementu.

Dane techniczne – opcja wprowadzania odpowiednich danych technicznych charakteryzujących element.

Adnotacje interpretowane, dostępne w zależności od sytuacji:

1. odwzorowanie – źródło wartości:

• wartość stała,
• kopia elementu wskazanego ścieżką,
• wyrażenie do wyliczenia zawartości,

2. odwzorowanie – pomocnicze:

• odwzorowanie słownikowe (wskazuje słownik, kolumny klucza i wartości, sposób obsługi błędów itp…),
• parser - bezpośrednio wybiera i konfiguruje element zmieniający postać danych,

3. zapis do bazy danych

• rekord bazy danych – wskazuje że ten rekord należy interpretować jako tabelę bazy - steruje operacjami wykonywanymi (INSERT, UPDATE, Dynamic itp…)
• warunek dołączenia pola do komendy Insert / UPDATE (oddzielne 2 adnotacje),
• nazwa obiektu bazy danych – nie musi być identyczna z nazwą pola,
• skrypt uruchamiany przed wykonaniem zapisu (np. sterowanie flagami sesji – SET IDENTITY INSERT tabela ON),

4. odwzorowanie do XML – nazwa elementu, przestrzeni nazw, rodzaj reprezentacji (element, atrybut, lista w atrybucie, lista w elemencie, Choice itd.), elementy zawarte (nie wszystkie dzieci muszą występować w XMLu wynikowym) itp.
5. przepis normalizacji rekordu (które pola są kluczami, które rekordy/pola dołączyć do elementów normalizowanych itp.),
6. wskazówki dla generatora danych losowych - zakres wartości (dowolnego typu)
7. wyrażenie regularne – używane na kilka sposobów, w zależności od miejsca może oznaczać:

• przepis podziału pola tekstowego na podpola / podrekordy,
• sposób wyparsowania treści z rekordu pliku (patrz bloczek wejściowy – parser wyrażeń regularnych),
• przepis do losowania napisów – można generować losowe napisy oparte na szkielecie wyrażenia regularnego – patrz bloczek generatora danych losowych.

Źródło wartości

Jednymi z podstawowych i najczęściej używanych adnotacji są adnotacje, które pozwalają między innymi na określenie źródła wartości dla pola.

Wartość stała – po wybraniu tej opcji oznaczony element będzie zawierał zawsze stałą, jednakową wartość. Stała wprowadzana jest przez Użytkownika w polu znajdującym się obok zmienianego elementu.

Wyrażenie – opcja pozwala ustawić wartość elementu, jako wyrażenia w prostym języku programowania. Wyrażenie takie może zawierać między innymi konkatenację łańcuchów znaków oraz różne wyrażenia logiczne (patrz: Wyrażenia). Definiowanie wyrażenia odbywa się z poziomu zakładki Szczegóły lub po przejściu do Edytora wyrażeń.

Kopia wartości – opcja pozwala na ustawienie wartości elementu, jako kopii wartości innego elementu, do którego ścieżkę można dowolnie konfigurować. Adnotacja ta ustawiana jest zwykle za pomocą operacji Drag&drop.

Lista wartości dopuszczalnych – użytkownik ma możliwość wprowadzenia listy wartości dopuszczalnych, jakie może zawierać edytowany element drzewa. Wartości wpisz w panelu Szczegóły.

Adnotacje dostępne dla baz danych

Adnotacje, które dostępne są tylko i wyłącznie dla baz danych to operacje, które możesz wykonać na rekordzie danych lub na polu. Adnotacje te dostępne są głównie dla bloczka Zapis do bazy danych w pakietach przetwarzania - patrz: Bloczki wyjściowe>Zapis do bazy danych.

1. Zapis rekordu do bazy danych – adnotacją oznaczane są rekordy, które mają zostać zapisane do bazy danych. Reprezentuje ona rodzaj operacji, jaka ma zostać wykonana dla oznaczonego nią rekordu. Możliwe opcje to:

• None
• Skip
• Update
• Insert
• Delete
• AUTO_Insert/Update – przed zapisem do bazy wykonywane jest zapytanie, sprawdzające czy rekord już istnieje w bazie, jeśli tak wykonywane jest zapytanie typu UPDATE, w przeciwnym wypadku typu INSERT,
• AUTO_InsertOnly – przed zapisem do bazy wykonywane jest zapytanie sprawdzające czy rekord już istnieje w bazie. Jeśli nie, wykonywana jest operacja typu INSERT
• Replace
• Dynamic – adnotacja pozwala na zdefiniowanie wyrażeń, które wyznaczą jedna z kliku wartości reprezentujących jedną z następujących operacji: Insert, Update, Skip, None, AUTO_InsertUpdate.

Operacja może być definiowana polem rekordu (pole Rodzaj operacji ) lub wyrażeniem. Ustawienia dokonywane są z poziomu zakładki Szczegóły.

2. Autoregeneracja – elementy oznaczone adnotacją są automatycznie generowane przez bazę danych – nie będzie generowana żadna wartość dla elementów oznaczonych tą adnotacją w pakietach przetwarzania.
3. Klucz obcy – element oznaczony adnotacją reprezentuje klucz obcy w bazie danych – dla elementu mającego tą adnotację wartość będzie wyliczona na podstawie skonfigurowanej ścieżki do rodzica relacji.

4. Klucz główny – element oznaczony adnotacją reprezentuje klucz główny w bazie danych.
5. Warunek wstawienia pola – wyrażenie, które jest ewaluowane - jeśli wyrażenie jest prawdziwe, pole zostanie wstawione do bazy, w przeciwnym wypadku wstawiona zostanie wartość NULL.
6. Warunek aktualizacji pola – wyrażenie, które jest ewaluowane - jeśli wyrażenie jest prawdziwe, pole będzie aktualizowane w bazie danych.
7. Nazwa kolumny/tabeli – element oznaczony adnotacją pobierać będzie odpowiadającą mu nazwę obiektu z bazy danych.
8. Dodatkowy skrypt SQL – w adnotacji wstawiany jest skrypt SQL, który będzie uruchamiany podczas wstawiania rekordu do bazy.

Zobacz również

Słownik

Operacja zapytania SQL

Operacja punktu kontrolnego integracji z modelem Entity Framework