ShowMessage
Zastosowanie
Funkcja wyświetla komunikat. Istnieją dwa typy komunikatów. Komunikat o błędzie oraz komunikat zwykły, informacyjny.
Od wydania 250331 systemu AMODIT zmieniono i rozszerzono zakres wyświetlanych typów komunikatów do trzech. Dodano również ikony wyróżniające poszczególne typy komunikatów.
Użyta w | ShowMessage(1,”….”) | ShowMessage(2,”….”), ShowMessage(3,”…”) |
Regule ręcznej | Wyświetli komunikat po kliknięciu w przycisk tej reguły ręcznej, w której została użyta.
Jeżeli przycisk reguły jest wyświetlany na liście spraw „Do wykonania” i naciśnięto go w tym miejscu, to komunikat również zostanie wyświetlony |
Wyświetli komunikat po kliknięciu w przycisk tej reguły ręcznej, w której została użyta.
Jeżeli przycisk reguły jest wyświetlany na liście spraw „Do wykonania” i naciśnięto go w tym miejscu, to komunikat również zostanie wyświetlony |
Regule automatycznej | Wyświetli komunikat w przypadku:
Nie wyświetli komunikatu:
|
Wyświetli komunikat w przypadku
Nie wyświetli komunikatu w przypadku
|
Regule okresowa | Nie wyświetla żadnych komunikatów, bo reguły okresowe wykonują się na serwerze bez udziału użytkownika. | Nie wyświetla żadnych komunikatów, bo reguły okresowe wykonują się na serwerze bez udziału użytkownika. |
Regule tabeli | Wyświetli komunikat w przypadku:
Nie wyświetli komunikatu przy wejściu (otwarciu) sprawy. |
Wyświetli komunikat w przypadku:
Nie wyświetli komunikatu przy wejściu (otwarciu) sprawy. |
Składnia
ShowMessage(type,message);
Argumenty
- type – (Decimal) typ komunikatu. Przyjmuje wartości: 1 – komunikat o błędzie, 2 – komunikat o ostrzeżeniu lub informacyjny, 3 – komunikat informacyjny (od wydania 250331);
- message – (String) treść komunikatu.
Zwracana wartość
Funkcja zwraca tekst.
Zwraca treść komunikatu wyświetloną użytkownikowi.
Elementy powiązane
- FieldIsCorrect
- FieldIsIncorrect
- SetFieldAlias
- SetFieldInfo
Przykłady
Przykład 1
Wyświetlanie wielu komunikatów informacyjnych z poziomu reguły ręcznej.
Należy pamiętać, że użycie ShowMessage() z typem 2 w regułach automatycznych nie będzie miało żadnego efektu. Komunikat nie wyświetli się.
ShowMessage(2,"To jest komunikat informacyjny nr 1") ShowMessage(2,"To jest komunikat informacyjny nr 2")
Przykład 2
Wyświetlanie komunikatu o błędzie w regule ręcznej
ShowMessage(1,"To jest komunikat o błędzie")
Funkcja użyta z typem 1:
- wyświetli komunikat o podanej treści,
- nie wykona działań związanych ze zmianą etapu zdefiniowanych dla tej reguły,
- spowoduje, że sprawa nie zostanie zapisana,
- spowoduje, że użytkownik pozostanie na formularzu sprawy, czyli nie wróci na listę spraw.