Potřebujete mít u klienta po ruce dashboard z BI nástroje, mapu nebo kartu zákazníka z ERP? Nově můžete přímo do detailu záznamu vložit IFRAME – záložku nebo panel, který zobrazí externí web. Uživatelé tak vidí data z jiných systémů v Raynetu a nemusí přeskakovat mezi okny.
IFRAME nastavuje administrátor v customizaci karty. Výsledek pak vidí všichni uživatelé, kteří mají k danému záznamu přístup. Jde o techničtější funkci, kterou nejvíc ocení IT administrátoři a integrační partneři.
Kde IFRAME najdete
IFRAME je součástí customizace detailu záznamu – tedy nastavení, kde si přizpůsobujete vzhled karty, přidáváte vlastní záložky, panely a pole. Najdete ho v kontextovém menu záložky nebo panelu pod volbou Změnit na IFRAME.
Použít ho můžete na detailu záznamů ve všech hlavních modulech – u Klientů, Osob, Leadů, Obchodních případů, Nabídek, Objednávek, Aktivit, Projektů i Produktů. U Ceníků IFRAME zatím k dispozici není a nefunguje ani jako portlet na nástěnce.
Jak vytvořit IFRAME záložku
Otevřete customizaci karty daného modulu.
Vytvořte novou záložku stejně jako obvykle a pojmenujte ji – název uvidí uživatelé na kartě.
Nechte záložku prázdnou. Převést na IFRAME lze jen záložku, ve které zatím nejsou žádné panely ani pole.
V kontextovém menu záložky (ikona se třemi tečkami) zvolte Změnit na IFRAME.
Vyplňte HTTPS URL webu, který chcete zobrazit. Adresa musí začínat
https://.Volitelně přidejte parametry, které se do odkazu doplní – viz Předávání parametrů do odkazu.
Uložte. Při prvním nastavení (a vždy, když změníte doménu odkazu) se zeptáme, jestli cílové službě opravdu důvěřujete – potvrďte tlačítkem Pokračovat.
Nastavení můžete kdykoliv upravit: v kontextovém menu záložky se pak nabídne volba Nastavit IFRAME.
Přepnutí na IFRAME je trvalé. Zpět na běžnou záložku se přepnout nedá – pokud ji budete potřebovat, smažte IFRAME záložku a vytvořte novou.
Jak vytvořit IFRAME panel
Postup je stejný jako u záložky – nejdřív vytvořte klasický panel, nechte ho prázdný (bez polí) a v jeho kontextovém menu zvolte Změnit na IFRAME.
U panelu navíc nastavujete výšku posuvníkem, a to v rozmezí 100 až 1080 px. Výchozí hodnota je 200 px. Výška určuje, kolik místa panel na kartě zabere; u záložky se IFRAME roztáhne na celou dostupnou plochu.
Předávání parametrů do odkazu
Aby cílový web věděl, o který záznam nebo o kterého uživatele jde, můžete do odkazu poslat parametry. Ty se přidají do URL jako běžné query parametry, například https://vas-web.cz/dashboard?klient=123.
Parametr přidáte tlačítkem Přidat parametr. Vlevo zadáte název parametru, vpravo jeho hodnotu. Hodnotu buď napíšete jako konstantu, nebo klikněte na ikonu odkazu vedle pole a vyberte jednu z proměnných:
| Zdroj hodnoty | Co se do odkazu doplní |
|---|---|
| Konstanta | Pevný text, který zadáte |
| ID aktuálního záznamu | ID záznamu, na jehož detailu IFRAME je |
| ID přihlášeného uživatele | ID uživatele, který si detail právě prohlíží |
| Uživatelské jméno přihlášeného uživatele | Přihlašovací jméno uživatele |
| Volitelné pole | Hodnota vybraného volitelného pole daného záznamu |
Co je dobré vědět:
Název parametru musí začínat písmenem a dál může obsahovat písmena, číslice, podtržítko, tečku nebo pomlčku. Názvy se nesmí opakovat.
Volitelná pole typu Soubor použít nelze, v nabídce se proto neobjeví.
Pokud je volitelné pole u konkrétního záznamu prázdné, parametr se do odkazu vůbec nepřidá.
Data se předávají v odkazu, tedy v adrese, kterou cílový web uvidí. Neposílejte touto cestou nic citlivého.
Jak IFRAME vidí uživatelé
Uživatel otevře záznam a na dané záložce nebo v panelu se rovnou načte externí web. Obsah se obnoví vždy s načtením detailu, takže vidí aktuální data. Ručně ho může kdykoliv načíst znovu ikonou Obnovit v hlavičce panelu, respektive nad obsahem záložky.
Během načítání se zobrazí načítací kolečko. Uživatelé nic nenastavují – vidí jen výsledek, který jste připravili.
Bezpečnost a omezení
Funkční jsou pouze adresy https://. Odkaz nesmí obsahovat přihlašovací údaje (tvar
https://jmeno:heslo@web.cz).Vložený web běží v odděleném režimu – nemá přístup ke kameře, mikrofonu, poloze, sdílení obrazovky ani ke schránce a nevidí, z jaké stránky byl otevřen.
Vložený web nemá přístup k datům v Raynetu. Dostane jen ty hodnoty, které mu sami pošlete v parametrech odkazu.
Cílový web běží v prohlížeči každého uživatele, který si záznam otevře. Vkládejte proto jen obsah ze služeb, kterým důvěřujete.
IFRAME nastavuje výhradně administrátor.
Když se obsah nenačte
Někdy se místo webu zobrazí hláška Externí obsah se nepodařilo načíst. Zkontrolujte pravidla cílového webu a zkuste obsah obnovit. Nejčastější důvody:
Cílový web zakazuje vkládání do rámce. Weby to řídí hlavičkami
Content-Security-PolicyaX-Frame-Optionsa Raynet toto nastavení nedokáže obejít. Zákaz musí povolit správce cílového webu, případně použijte jinou adresu určenou pro vkládání.Adresa není platná HTTPS URL, nebo obsahuje přihlašovací údaje.
Web vyžaduje přihlášení – pak se uvnitř rámce zobrazí přihlašovací obrazovka dané služby.
Když si nebudete jistí, ozvěte se nám na podpora@raynet.cz – rádi se na nastavení podíváme společně.