Skrypty JavaScript udostępniane przez archITekta
Formularze udostępniają zestaw skryptów, których projektant formularza może użyć.
Globalne
VBP.Click(nazwa_biznesowa lub guid_akcji)– kliknięcie wskazanego przycisku,VBP.ClosePopup()– zmaknięcie okna popup,VBP.Disable(nazwa_biznesowa[, …])– wyłączenie wskazanych kontrolek,VBP.DisableIf(warunek, nazwa_biznesowa[, …])– warunkowe wyłączenie wskazanych kontrolek,VBP.DownloadFile(url)– pobiera plik znajdujący się pod wskazanym adresem url,VBP.Enable(nazwa_biznesowa[, …])– włączenie wskazanych kontrolek,VBP.Get(nazwa_biznesowa)– pobranie obiektu DOM kontrolki o wskazanej nazwie biznesowej,VBP.GetCurrentTab(nazwa_biznesowa_kontrolki_zakładek)– pobranie indeksu aktualnie wybranej zakładki,VBP.GetValue(nazwa_biznesowa[, index])– pobranie wartości wskazanej kontrolki. W przypadku wielu kontrolek o tej samej nazwie (np. na liście powtarzalnej), należy wskazać indeks kontrolki,VBP.Hide(nazwa_biznesowa[, …])– ukrywa kontrolki o podanych nazwach biznesowych,VBP.IsDisabled(nazwa_biznesowa)– sprawdza, czy kontrolka jest wyłączona,VBP.IsEmpty(nazwa_biznesowa)– sprawdza, czy wskazana kontrolka jest pusta (wartość nie jest ustawiona),VBP.IsVisible(nazwa_biznesowa)– sprawdza, czy wskazana kontrolka jest widoczna,VBP.SetValue(nazwa_binzesowa, wartość[, index])– ustawia wartość wskazanej kontrolki. Jeśli istnieje więcej kontrolek o tej samej nazwie biznesowej (np. na liście powtarzalnej), należy wskazać indeks kontrolki,VBP.Show(nazwa_biznesowa[, …])– pokazuje kontrolki o podanych nazwach biznesowych,VBP.ShowIf(warunek, nazwa_biznesowa[, …])– warunkowe pokazanie kontrolek o podanych nazwach biznesowych,Dialog.FireAction(id_akcji, dane_akcji)– pozwala wykonać akcję o podanym identyfikatorze i przekazać do niej podane dane,CLID(nazwa_biznesowa)– zwraca wszystkie wygenerowane identyfikatory dla kontrolki o wskazanej nazwie biznesowej (jeśli kontrolka znajduje się na liście powtarzalnej, takich identyfikatorów będzie tyle ile wystąpień danej kontrolki).
Okienko potwierdzenia
Dialog.Confirm(treść, funkcja_na_OK)Dialog.Confirm(treść, tytuł, funkcja_na_OK)Dialog.Confirm(treść, tytuł, nazwa_przycisku_OK, funkcja_na_OK)Dialog.Confirm(treść, tytuł, nazwa_przycisku_OK, nazwa_przycisku_Anuluj, funkcja_na_OK)
Okienko informacyjne
Dialog.Ok(treść)Dialog.Ok(treść, tytuł)Dialog.Ok(treść, tytuł, nazwa_przycisku)
Okienko dowolne
Dialog.Custom(treść, tytuł, {})– okienko bez przycisków,Dialog.Custom(treść, tytuł, przyciski)– okienko z przyciskami, gdzie przyciski budowane jako obiekt:
{
”Przycisk 1”: function(e) { … },
”Przycisk 2”: function(e) { … }
}
Okienko z ramką (iframe) – pozwala otworzyć inną stronę wewnątrz popupa
Dialog.ShowIFrame(argumenty)– argumenty okna popup w postaci obiektu:
{
url: adres strony,
width: szerokość,
height: wysokość,
title: tytuł
sidebar_label: "Skrypty JavaScript"
sidebar_position: 20
}
Dla list powtarzalnych (funkcje wołane w ramach zdarzenia na kontrolce znajdującej się na liście powtarzalnej, przykład poniżej)
VBP.List.Setup(this, nazwa_biznesowa_kontrolki)– „poinformowanie” skryptu, że będziemy operować w ramach listy powtarzalnej (argument pierwszy – aktualna kontrolka, argument drugi - nazwa biznesowa aktualnej kontrolki). Funkcja zawsze wołana jako pierwsza,VBP.List.Disable(nazwa_biznesowa[, …])- wyłączenie wskazanych kontrolek,VBP.List.DisableIf(nazwa_biznesowa[, …])- warunkowe wyłączenie wskazanych kontrolek,VBP.List.Enable(nazwa_biznesowa[, …])- włączenie wskazanych kontrolek, 5.VBP.List.Get(nazwa_biznesowa)– zwraca obiekt DOM wskazanej kontrolki,VBP.List.GetValue(nazwa_biznesowa)– zwraca wartość wskazanej kontrolki,VBP.List.Hide(nazwa_biznesowa[, …])– ukrywa kontrolki o podanych nazwach biznesowych,VBP.List.IsDisabled(nazwa_biznesowa)– sprawdza, czy wskazana kontrolka jest wyłączona,VBP.List.IsEmpty(nazwa_biznesowa)- sprawdza, czy wskazana kontrolka jest pusta (wartość nie jest ustawiona),VBP.List.IsVisible(nazwa_biznesowa)- sprawdza, czy wskazana kontrolka jest widoczna,VBP.List.SetValue(nazwa_biznesowa, wartość)– ustawia wartość wskazanej kontrolki,VBP.List.Show(nazwa_biznesowa[, …])– pokazuje kontrolki o podanych nazwach biznesowych,VBP.List.ShowIf(warunek, nazwa_biznesowa[, …])– warunkowe pokazanie kontrolek o podanych nazwach biznesowych.
Skrypt wykonywany w ramach elementu listy powtarzalnej
Na kontrolce wyboru na zdarzeniu OnChange (właściwość Zdarzenia JavaScript) definiujemy skrypt.
Element listy powtarzalnej
Skrypt na zdarzeniu OnChange
Powyższy skrypt w linii nr 1 „informuje” listę, że będziemy wykonywać operacje na aktualnym elemencie listy. W argumencie przekazujemy this (aktualna kontrolka) oraz nazwę biznesową kontrolki, z której poleciało zdarzenie OnChange. Później mamy logikę, w której pobieramy wartość kontrolki wyboru o podanej nazwie i w zależności od zwróconej wartości, pokazujemy lub ukrywamy kontrolkę o nazwie FormGroupStrField. Wszystko odbywa się w ramach jednego elementu listy powtarzalnej.
Zamykanie okna popup
Innym przykładem wykorzystania skryptu jest zamknięcie okna popup.
- Na formularzu możesz zdefiniować akcję złożoną.
- Po akcji Zapisz wybierz akcje Kod JavaScript.
- Na panelu Właściwości w sekcji Kod JavaScript wpisz skrypt umożliwiający zamknięcie okna popup:
VBP.ClosePopup(); - Wybierz Tryb wykonania kodu. Tutaj jest to Naciśnięcie przycisku.
- Okno zostanie zamknięte zaraz po wykonaniu akcji Zapisz.
