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. Paczkę ze skryptem JS API oraz jego dokumentacją można pobrać tutaj.
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.

Działanie kontrolki pod alternatywnym adresem aplikacji

Komunikacja kontrolki z formularzem odbywa się przez postMessage, które wymaga zgodności z adresem (origin) okna formularza. Aby kontrolka działała zarówno w Portalu, jak i pod alternatywnym adresem aplikacji, należy:

1. korzystać ze skryptu w wersji webcon.min.1.1.0.js lub nowszej,
2. nie definiować w nim zmiennej __WEBCON_PORTAL_ADDRESS__ — kontrolka samodzielnie ustala adres Portalu.

Kontrolki skonfigurowane wcześniej ze zmienną __WEBCON_PORTAL_ADDRESS__ będą działać wyłącznie pod adresem podanym w tej zmiennej. Po udostępnieniu aplikacji pod alternatywnym adresem konieczna jest aktualizacja skryptu kontrolki.

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.