← Powrót do listy dostępnych setterów
← Powrót do listy dostępnych zadań automatycznych
Jeśli masz problem ze zrozumieniem jak działa setter/zadanie automatyczne, sprawdź opisy: Setter, Zadanie automatyczne, Wykonanie warunkowe, Parametry komponentów
Podstawowe informacje
Kategoria: Baza danych
Dostępny od wersji: 1.0.0
Opis
Komponent zapisuje wartości zmiennych nagłówkowych i tabelarycznych w określonych tabelach określonej bazy danych. W nowej wersji istnieje możliwość dodania wartości stałej zamiast podania zmiennej formularza. W tym przypadku wartość stała pojawi się w każdym wierszu w odpowiadającej jej kolumnie. Jest też możliwość wyświetlenia własnego komunikatu błędu, w momencie nieprawidłowego działania komponentu.
Parametry konfiguracyjne
| Nazwa parametru | Od wersji | Opis | Typ parametru | Wartość domyślna | Rodzaj pola | Uwagi i ograniczenia |
|---|---|---|---|---|---|---|
| Konfiguracja połączenia z bazą danych | 1.0.0 | Nazwa konfiguracji zdefiniowana w ustawieniach eksploratora danych. | Tekst | Lista wartości | ||
| Tabela w bazie danych | 1.0.0 | Nazwa tabeli, do której trafiają dane formularza. | Tekst | Pole edytowalne | Parametr jest opcjonalny. Jeżeli go nie uzupełnimy, to pytanie zostaje pobrane stąd: Tabela z zapytaniami do bazy | |
| Schemat bazy danych | 1.0.39 | Nazwa schematu bazy danych. W przypadku braku uzupełnienia pola pobierany jest domyślny schemat. | Tekst | Pole edytowalne | ||
| Nazwy kolumn w bazie danych | 1.0.0 | Nazwy kolumn z tabeli bazy danych, odpowiadających poszczególnym zmiennym/stałym, których wartości mają zostać zapisane. | Tablica wartości tekstowych | Pole edytowalne | Od wersji 1.0.24 istnieje możliwość nie przekazywania żadnych parametrów do zapytania. | |
| Zmienne do zapisania w kolumnach | 1.0.0 | Tablica zmiennych formularza. Zmienne mogą być nagłówkowe lub tabelaryczne. W przypadku podania w tablicy zmiennych tabelarycznych choć jednej zmiennej nagłówkowej, jej wartość będzie kopiowana tyle razy, ile wynosić będzie liczba nowo zapisanych rekordów w bazie. | Tablica zmiennych | Pole edytowalne | ||
| Stałe wartości tablicowe do zapisania w kolumnach | 1.0.105 | Wartości tablicowe, które będą zapisywane po kolei do bazy. | Tablica funkcji | Pole edytowalne | Funkcja musi zwracać obiekt typu tablicowego. | |
| Stałe wartości do zapisania w kolumnach | 1.0.14 | Wartości stałe, które zostaną zapisane w odpowiednich kolumnach, które nie zostały zapisane przez zmienne. Przekazujemy je jako wartości tekstowe, które zostaną zamienione na odpowiedni typ. | Tablica wartości tekstowych | Pole edytowalne | ||
| Typy stałych wartości | 1.0.14 | Wszystkie wartości z parametru stałe muszą zostać zamienione na odpowiadający im typ w bazie danych. | Tablica wartości tekstowych | Lista wartości | Do wyboru: Wartość tekstowa, Wartość całkowita, Wartość zmiennoprzecinkowa, Wartość datowa, Wartość logiczna | |
| Klucz unikatowości rekordu | 1.0.0 | Nazwy kolumn tworzących klucz kompozytowy, na podstawie którego ustalana jest unikatowość rekordu. Jeśli w bazie zostanie odnaleziony rekord o tym samym kluczu, jego wartości zostaną zaktualizowane. Jeśli nie, zostanie utworzony nowy rekord. Uwaga: od wersji 1.0.53 jeżeli tabela posiada autoinkrementację i chcemy dodać nowe rekordy, to to pole zostawiamy puste. | Tablica wartości tekstowych | Pole edytowalne | ||
| Komentarz o błędzie | 1.0.19 | Decyduje o tym, czy komunikat błędu wykonania aplikacji ma być zapisywany w komentarzu zadania poprzedzającego zadanie automatyczne. | Logiczny | Pole edytowalne | ||
| Komunikat błędu | 1.0.19 | Nazwa własnego komunikatu błędu. Podczas akceptacji szeregowej wyświetli się użytkownikowi na formularzu w przypadku wyrzucenia wyjątku przez komponent. | Tekst | Pole edytowalne | ||
| Obsługa nierównych kolumn | 1.0.83 | Umożliwia wykorzystanie zmiennych tabelarycznych o różnych długościach, przy czym krótsze z nich zostaną wypełnione pustymi wartościami i zrównają się z długością najdłuższej zmiennej tabelarycznej. W przypadku ustawienia pola wartością Nie, nie będzie można używać zmiennych tabelarycznych o różnych długościach. | Logiczny | Nie | Pole edytowalne | |
| Zapisz puste wartości jako null | 1.0.94 | Konwertuje pusty tekst na wartość NULL i zapisuję do bazy | Logiczny | Nie | Pole edytowalne |
Przykładowa konfiguracja
Od wersji 1.0.X :
Change log
1.0.0
Dodanie komponentu
1.0.14
Możliwość dodania stałego tekstu do bazy danych
1.0.17
Dodanie możliwości zapisu do tabel bez konieczności podawania klucza
1.0.18
Poprawienie błędu konwersji liczb całkowitych
1.0.19
Dodanie komunikatu o błędzie zapisu
1.0.25
Poprawienie wyrzucania wyjątków
1.0.38
Dodanie dynamicznego formularza
1.0.39
Dodanie obsługi różnych schematów baz danych
1.0.41
Poprawienie zapisu na Oracle
1.0.43
Opracowanie nowej obsługi parametrów
Wymagalność pola z kluczem
1.0.51
Dodanie typu logicznego do dynamicznego formularza
1.0.53
Przywrócenie opcjonalności parametru z kluczem
1.0.64
Nowa obsługa bazy danych
1.0.73
Rzucanie wyjątku w przypadku, gdy ustawiane kolumny mają różne rozmiary.
1.0.83
Dodanie parametru "Obsługa nierównych kolumn", umożliwiającego zapis do bazy kolumn o różnych rozmiarach.
1.0.94
Dodanie parametru "Zapisz puste wartości jako null", umożliwiającego zapis do bazy pustych wartości tekstowych jako null
1.0.105
Dodanie parametru "Stałe wartości tablicowe do zapisania w kolumnach"
Przykład: Chcemy wypełnić tabelę z 9 kolumnami. W przypadku trzech z nich chcemy jedynie zapisać wartości stałe. Musimy zatem dodać 6 zmiennych w parametrze "Zmienne" i 3 stałe w parametrze "Stałe". Kolumny z bazy danych w parametrze "Nazwy kolumn" powinny być zaś uszeregowane w taki sposób, aby 3 kolumny w których zapisujemy stałe wystąpiły jako ostatnie i były w odpowiedniej kolejności.
Przykład
Opis
Zadanie zapisuję dane użytkowników z tabeli dynamicznej do tabeli "USERS" w bazie danych. Dodatkowo dla kolumny "age" wpisywana jest stała wartość 18, a dla kolumny "login" jest wykonywana funkcja, która zwraca tablice.
Konfiguracja aplikacji
Dane z formularza
Dane wgrane do bazy
Pakiet z przykładowym formularzem wykorzystującym aplikację
The license could not be verified: License Certificate has expired!
0 Comments