Komendy z grupy „Operacje na zmiennej – modyfikacja, zapis, usunięcie, kopia” wykonują operacje na zmiennych wcześniej zadeklarowanych w bieżącym triggerze.

Pozwalają między innymi:

• zapisywać obiekty do bazy danych,
• usuwać obiekty,
• tworzyć kopie zmiennych,
• wykonywać operacje na listach identyfikatorów.

1. Zapisz do bazy obiekt dowolnej klasy ze zmiennej i zwróć, czy się udało #

Komenda „Zapisz do bazy obiekt dowolnej klasy ze zmiennej i zwróć, czy się udało” zapisuje obiekt znajdujący się w zmiennej triggerowej.

Może to być:

• nowy obiekt, który nie został jeszcze zapisany,
• istniejący obiekt, którego pola zostały zmienione.

1.1. Wskazanie zmiennej #

Podczas konfiguracji należy wskazać wcześniej zadeklarowaną zmienną triggerową typu obiekt.

Program podejmie próbę zapisania tego obiektu w bazie danych.

1.2. Brak zmian w obiekcie #

Jeżeli istniejący obiekt nie został zmodyfikowany, operacja zapisu nie zostanie wykonana.

Program zapisuje obiekt tylko wtedy, gdy:

• jest on nowy,
• zawiera zmiany wymagające utrwalenia.

1.3. Wynik komendy #

Komenda staje się jednocześnie nową zmienną triggerową typu boolean.

Jeżeli zapis:

• przejdzie wszystkie walidacje,
• zostanie prawidłowo wykonany,

zmienna przyjmie wartość:

true

Jeżeli zapis nie powiedzie się, komenda zwróci:

false

1.4. Przykład zastosowania #

Trigger tworzy pusty obiekt zadania, uzupełnia jego pola, a następnie zapisuje go do bazy.

Po zapisie można sprawdzić wynik:

• jeżeli wynik wynosi true, wyświetlić zielony komunikat,
• jeżeli wynik wynosi false, wyświetlić komunikat o błędzie.

2. Usuń z bazy danych obiekt #

Komenda „Usuń z bazy danych obiekt” służy do usunięcia istniejącego obiektu z bazy.

Podczas konfiguracji należy wskazać zmienną triggerową typu obiekt zawierającą rekord przeznaczony do usunięcia.

2.1. Walidacja usunięcia #

Przed usunięciem program wykonuje odpowiednie walidacje.

Operacja może się nie udać na przykład wtedy, gdy:

• obiekt nie może zostać usunięty z powodu powiązań,
• obowiązują reguły blokujące usunięcie,
• użytkownik nie ma odpowiednich uprawnień,
• inne mechanizmy programu nie pozwalają na wykonanie operacji.

2.2. Wynik komendy #

Komenda zwraca wartość boolean:

• true – obiekt został prawidłowo usunięty,
• false – usunięcie nie zostało wykonane.

Wartość ta może zostać wykorzystana w dalszych warunkach triggera.

3. Zrób kopię zmiennej #

Komenda „Zrób kopię zmiennej” tworzy nową zmienną triggerową będącą kopią wcześniej zadeklarowanej zmiennej.

Można kopiować zmienne różnych typów, między innymi:

• obiekt,
• tekst,
• liczbę,
• inne obsługiwane typy.

Nowa zmienna otrzymuje ten sam typ co zmienna źródłowa.

3.1. Konfiguracja #

Podczas konfiguracji należy wskazać zmienną triggerową, której wartość ma zostać skopiowana.

Komenda staje się nową zmienną zawierającą kopię tej wartości.

3.2. Kopiowanie zmiennej typu obiekt #

Jeżeli kopiowana jest zmienna typu obiekt, powstaje nowy obiekt będący kopią danych obiektu źródłowego.

Nowy obiekt:

• nie ma jeszcze identyfikatora,
• nie jest zapisany w bazie danych,
• może być modyfikowany przed zapisem.

Dopiero po wykonaniu komendy zapisującej obiekt otrzyma nowe ID.

3.3. Przykład zastosowania #

W bazie istnieje zadanie cykliczne.

Trigger może:

1. pobrać zadanie z bazy,
2. utworzyć jego kopię,
3. zmienić termin,
4. zmienić odpowiedzialną osobę,
5. zapisać kopię jako nowe zadanie.

Oryginalny obiekt pozostanie bez zmian.

4. Operacja na ID ze zmiennych #

Komenda „Operacja na ID ze zmiennych” służy do wykonywania operacji na zmiennych triggerowych typu ID.

Zmienna typu ID może zawierać jeden lub wiele identyfikatorów.

Komenda może:

• utworzyć nową zmienną typu ID,
• zmodyfikować istniejącą zmienną typu ID,
• wykonać operację logiczną na dwóch listach identyfikatorów.

5. Sposoby uzyskania zmiennej typu ID #

Zmienną typu ID można utworzyć bezpośrednio za pomocą komendy „Operacja na ID ze zmiennych”.

Może ona również powstać przez odczytanie wartości pola obiektu typu powiązanie.

Przykładowo pole powiązania może zawierać identyfikatory:

• kontrahentów,
• użytkowników,
• projektów,
• dokumentów,
• innych powiązanych obiektów.

6. Złącz ID z obu zmiennych #

Formuła „Złącz ID z obu zmiennych” łączy identyfikatory znajdujące się w dwóch zmiennych typu ID.

Podczas konfiguracji należy wskazać:

• pierwszą zmienną,
• drugą zmienną,
• zmienną docelową.

Do zmiennej docelowej zostanie zapisana połączona lista identyfikatorów.

6.1. Przykład #

Pierwsza zmienna zawiera ID:

1, 2, 3

Druga zmienna zawiera ID:

4, 5

Po wykonaniu operacji zmienna docelowa będzie zawierała:

1, 2, 3, 4, 5

Komenda jest przydatna, gdy identyfikatory pochodzą z kilku źródeł i mają zostać wspólnie wykorzystane w dalszej części triggera.

7. Zostaw część wspólną obu list ID #

Formuła „Zostaw część wspólną obu list ID” zapisuje do zmiennej docelowej wyłącznie identyfikatory występujące w obu wskazanych zmiennych.

Jest to odpowiednik części wspólnej dwóch zbiorów.

7.1. Przykład #

Pierwsza zmienna zawiera:

1, 2, 3, 4

Druga zmienna zawiera:

3, 4, 5, 6

Wynik będzie zawierał:

3, 4

Operacja może być wykorzystywana na przykład do ustalenia, które obiekty należą jednocześnie do dwóch różnych grup.

8. Usuń ID z pierwszej zmiennej od docelowej #

Formuła „Usuń ID z pierwszej zmiennej od docelowej” usuwa ze zmiennej docelowej identyfikatory występujące w pierwszej wskazanej zmiennej.

Jest to operacja różnicy dwóch list ID.

8.1. Przykład #

Zmienna docelowa zawiera:

1, 2, 3, 4, 5

Pierwsza zmienna zawiera:

2, 4

Po wykonaniu operacji w zmiennej docelowej pozostaną:

1, 3, 5

Komenda może być wykorzystana na przykład do usunięcia z listy obiektów, które zostały już wcześniej obsłużone.

9. Zastosowanie operacji na ID #

Operacje na listach identyfikatorów mogą być stosowane między innymi do:

• łączenia obiektów z kilku źródeł,
• ustalania części wspólnej dwóch grup,
• wykluczania określonych obiektów,
• przygotowywania identyfikatorów do zapytań do bazy,
• ograniczania wariantów pól formularza,
• tworzenia lub modyfikowania powiązań.

10. Podsumowanie #

Komendy z grupy operacji na zmiennych pozwalają wykonywać podstawowe działania na danych przygotowanych wcześniej w triggerze.

Najważniejsze komendy umożliwiają:

• zapis obiektu do bazy i sprawdzenie wyniku,
• usunięcie obiektu i sprawdzenie wyniku,
• kopiowanie zmiennych dowolnego typu,
• tworzenie kopii obiektów przeznaczonych do późniejszego zapisu,
• łączenie list ID,
• wyznaczanie części wspólnej list ID,
• usuwanie identyfikatorów z listy.

Wyniki operacji mogą być wykorzystywane w kolejnych komendach i instrukcjach warunkowych triggera.