znacznik rodzaju wartość z triggera pozwala wstawić do szablonu wynik własnej logiki. Można w ten sposób przygotować komunikat zależny od danych obiektu, wyliczenie lub tekst, którego nie da się pobrać jednym znacznikiem pola.
znacznik uruchamia wskazany trigger podczas budowania swojej wartości. Nie jest przyciskiem uruchamianym dopiero przez odbiorcę wiadomości — takie zastosowanie ma osobny rodzaj Link e-mailowy.
1. Najpierw przygotuj trigger zwracający wynik #
- Utwórz trigger i określ właściwy Główny powiązany obiekt.
- W parametrze Wykonaj natychmiast wybierz Natychmiast.
- Przygotuj komendy ustalające potrzebną wartość.
- Zakończ logikę komendą Zakończ i zwróć wybraną wartość.
- Sprawdź wszystkie gałęzie warunków: każda powinna zwracać przewidziany wynik.
Tryb wykonania ma tu zasadnicze znaczenie. Warianty Opóźniony (wymaga powiązania z zadaniem pracy cyklicznej), Samoczynnie co kilka minut i Chwilę później (natychmiast zwraca true, nie czeka na wykonanie) nie dostarczają w tym wywołaniu obliczonego wyniku tak jak trigger natychmiastowy. znacznik może wtedy otrzymać potwierdzenie zlecenia zamiast oczekiwanej treści.
2. Utworzenie znacznika #
- Otwórz konfigurację znaczników i dodaj nową pozycję.
- W polu Rodzaj wybierz wartość z triggera.
- Uzupełnij Nazwa oraz Opis.
- W polu trigger wskaż przygotowaną definicję.
- Zapisz znacznik i skopiuj Symbol znacznika do szablonu.
- Umieść symbol w treści właściwego szablonu i sprawdź wynik dla konkretnego obiektu.
Pełny symbol ma postać podobną do {:ID|Nazwa znacznika}. Kopiuj rzeczywistą wartość z programu, zamiast wpisywać identyfikator z przykładu.
3. Kontekst obiektu #
trigger korzysta z obiektów przekazanych do mechanizmu budowania szablonu. Ten rodzaj znacznika przekazuje do triggera pierwszy dostępny obiekt z tego kontekstu. Nie wykonuje automatycznie pętli po wszystkich powiązanych obiektach.
pole obiekt początkowy dla znacznika oraz edycja ścieżki charakterystyczna dla znacznika „pole” nie są udostępniane jako standardowa konfiguracja tego rodzaju. Logikę wyboru danych przygotuj w triggerze i sprawdź rzeczywisty kontekst, zwłaszcza gdy dokument korzysta z więcej niż jednej klasy.
Jeżeli potrzebujesz wyłącznie wartości jednego pola, prostszy będzie znacznik rodzaju „Pole”.
4. Format zwracanej wartości #
Dla rodzaju „wartość z triggera” program nie ustala typu tak jak dla znacznika konkretnego pola. Nie zakładaj więc dostępności automatycznego formatowania daty, liczby lub wariantów. Przygotuj oczekiwany tekst w triggerze.
Jeżeli zwracasz HTML, sprawdź wynik w docelowym rodzaju szablonu. Wiadomość HTML, zwykły tekst, Word i PDF mają różne możliwości prezentacji. Zwrócenie obiektu lub tablicy nie jest równoznaczne z utworzeniem czytelnego tekstu dla odbiorcy.
5. Przykład: komunikat o kompletności zlecenia #
szablon potwierdzenia ma pokazywać jeden z dwóch tekstów: „Zlecenie gotowe do realizacji” albo „Prosimy uzupełnić dane kontaktowe”.
- W triggerze pobierz obiekt zlecenia powiązany z wykonaniem.
- Sprawdź obecność wymaganych danych.
- W odpowiedniej gałęzi przypisz do zmiennej tekst komunikatu.
- Zakończ przez Zakończ i zwróć wybraną wartość, wskazując tę zmienną.
- Wstaw znacznik do szablonu potwierdzenia.
- Wygeneruj treść dla zlecenia kompletnego i niekompletnego.
Budowanie tekstu i warunków opisują zmienne tworzone za pomocą formuły oraz komendy warunkowe.
6. Ograniczenia i kontrola skutków #
znacznik może być przeliczany podczas podglądu i kolejnego generowania dokumentu. trigger budujący treść powinien przede wszystkim odczytywać i obliczać dane. Jeżeli zawiera zapis, wysyłkę lub inne skutki, samo ponowne wygenerowanie treści może je powtórzyć.
Sprawdź wynik bez obiektu, z brakującymi danymi i po zmianie uprawnień użytkownika. Unikaj cyklu, w którym trigger odczytuje ten sam znacznik, który go uruchomił.
