5.A.1.5.1. Uzyskanie informacji o "kluczu" i "komponencie" akcji
Wiele list danych, tabel, widoków, procedur oraz okien edycyjnych posiada zaimplementowany uniwersalny mechanizm akcji. Wystarczy aktywować jakąś zakładkę lub widok i sprawdzić czy widoczny jest przycisk [Akcje].
Każde miejsce gdzie znajduje się przycisk [Akcje] identyfikowany jest przez specjalny klucz będący unikalnym ciągiem znaków, np. "oracle-tables-actions". Drugą właściwością przycisku jest przyporządkowanie go do konkretnego komponentu, np. listy, edytora.
Aby dowiedzieć się jaki jest klucz i komponent skojarzony z przyciskiem akcji wystarczy trzymając klawisz [Ctrl] najechać myszką na przycisk. Pojawi się wtedy podpowiedź, w której opisane są właściwości.
5.A.1.5.2. Konfiguracja
Konfiguracja akcji dostępna jest w Program->Ustawienia->Ustawienia wtyczek->BeanShell->Skrypty akcji"
| Właściwość | Opis |
|---|---|
| Zakres | Zakres widoczności akcji, "Globalny" - dla wszystkich użytkowników lub "Użytkownika" - widoczny tylko przez zalogowanego użytkownika. |
| Tytuł | Tytuł akcji wyświetlany w menu po wybraniu przycisku [Akcje] |
| Klucz | Ciąg znaków określający miejsce (typ akcji) w którym akcja będzie podpięta |
| Sterownik | Sterownik pozwala określić dla których baz danych akcja będzię widoczna |
| Eksport | Pozwala zapisać akcje na dysku w postaci pliku XML |
| Import | Pozwala odczytać akcję z dysku i umieścić ją na liście akcji |
| Nowy | Pozwala utworzyć nowy skrypt akcji |
| Edytuj | Pozwala zmienić właściwości istniejącego skryptu akcji |
| Usuń | Pozwala usunąć akcję z listy |
Po wybraniu przycisku [Nowy] lub [Edytuj] dostępne jest okienko w którym zdefiniowac można właściwości skryptu akcji.
| Właściwość | Opis |
|---|---|
| Tytuł akcji | Tytuł akcji wyświetlany w menu po wybraniu przycisku [Akcje] |
| Klucz akcji | Ciąg znaków określający miejsce (typ akcji) w którym akcja będzie podpięta |
| Podpowiedź | Ciąg znaków wyświetlający się jako podpowiedź do akcji w menu |
| Dla sterownika | Sterownik pozwala określić dla których baz danych akcja będzię widoczna |
| Skrót klawiszowy | Pozwala zdefiniować skrót klawiszowy dostępu do akcji z komponentu związanego z typem akcji |
| Skrypt BeanShell | Wykonywalny skrypt BeanShell. Skrypt ten będzie wykonany po wybraniu akcji w menu. |
| Dla wszystkich użytkowników | Administrator ORBADA może określić zakres widoczności akcji. Akcja może być widoczna przez wszystkich użytkowników lub tylko bierzącego |
5.A.1.5.3. Dostępność elementów programu w skrypcie BeanShell
W skrypcie BeanShell dostępne są wszelkie klasy Java oraz obiekty programu. Zdefiniowane są również stałe:
| Właściwość | Opis |
|---|---|
| self | Stała oznaczająca obiekt klasy Interpreter biblioteki BeanShell |
| database | Jeśli dostępne jest połączenie z bazą danych, w tej stałej znajduje się obiekt klasy Database biblioteki UseDB |
| application | Pozwala uzyskać dostęp do właściwości aplikacji poprzez funkcje interfejsu IApplication programu ORBADA |
| component | Stała udostępniająca komponent związany z akcją |
5.A.1.5.4. Sprawdzenie działania akcji
Aby sprawdzić jak akcja działa trzeba ponownie wywołać widok w którym akcja jest podpięta. Aby wywołać skrypt należy wybrać przycisk [Akcje] i z menu wybrać pozycję akcji. Jeśli został określony skrót klawiszowy, można z przyporządkowanego komponentu wybrać ten skrót.