Przejdź do głównej zawartości
Wersja: 2025 R2

Zewnętrzna kontrolka użytkownika

Atrybut umożliwia osadzenie zewnętrznej aplikacji w formularzu Modern. 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). Atrybut ten jest dostępny wyłącznie dla procesów uruchamianych w formularzu Modern.

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.

UserControl.png

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. Adres URL

Pole umożliwia wstawienie adresu aplikacji, która ma być wyświetlana w ramach kontrolki.

3. Konfiguracja JSON

Możliwość skonfigurowania kontrolki w formacie JSON.