Zewnętrzna kontrolka użytkownika
Atrybut umożliwia osadzenie zewnętrznej aplikacji w formularzu. Korzystając z JS API w kontrolce, można za jej pomocą sterować zachowaniem całego formularza.
Aby zapewnić poprawne działanie, umieszczana w ramach kontrolki aplikacja musi używać do komunikacji protokołu odpowiadającego protokołowi formularza, w którym jest osadzona (domyślnie https).
Celem atrybutu jest możliwość przechowywania danych z zewnętrznych kontrolek w bazie danych BPS – obecnie również samo hostowanie kontrolki może się odbyć po stronie BPS.
Podstawową konfigurację atrybutów omówiono w rozdziale Konfiguracja podstawowa.
Konfiguracja zaawansowana
W prawym, dolnym rogu okna dostępny jest przycisk Konfiguracja zaawansowana zapewniający dostęp do dodatkowych opcji konfiguracyjnych.
1. Położenie nazwy atrybutu
Pole umożliwia określenie, w którym miejscu będzie wyświetlana nazwa atrybutu. Możliwe opcje:
- Nie pokazuj,
- Obok,
- Powyżej.
2. Tryb
- Zewnętrzna aplikacja - W tym trybie należy podać adres URL. Kontrolka wyświetli zawartość wskazanego adresu w elemencie iframe. Upewnij się, że podany URL jest poprawny i dostępny publicznie.
- Lokalny Hosting w BPS - Tryb umożliwia przesłanie pliku '.zip' z zawartością pola. Jako punkt wejścia wymagany jest pojedynczy plik o nazwie index.html. Wszystkie pliki będą hostowane lokalnie w portalu BPS. Pliki można umieszczać w podfolderach, a link do powiązanego pliku powinien mieć następujący format: 'nazwa_folderu/nazwa_pliku' lub './nazwa_folderu/nazwa_pliku'. Niedozwolone typy plików to: bat, com, dll, exe, msc, msi, msp, mst, ps1, reg, regs
3. Adres URL
Pole umożliwia wstawienie adresu aplikacji, która ma być wyświetlana w ramach kontrolki.
4. Lista Plików
Plik '.zip' z zawartością pola do trybu Lokalny Hosting w BPS
5. API
Integracja z User Defined API (Definicja API) konfigurowana jest w zakładce API. Kontrolka może komunikować się z endpointami Definicji API. Lista dostępnych definicji API została ograniczona do tych, które są aktywne i mają włączone uwierzytelnienie OAuth oraz do tych, które zostały wcześniej wybrane.