Configurazione widget
Per poter essere caricato in AD, il widget deve prima essere configurato in AgentDesktopManager. Per prima cosa è necessario crearlo andando nella sezione Widgets, compilare i campi e salvare il widget appena creato. Se il widget che si vuole creare è monocontatto, effettuare le operazioni nella sezione AgentDesktop widgets; nel caso in cui sia multicontatto, compilare i campi nella sezione Multicontact widgets.
I campi da compilare sono i seguenti:
Nome campo |
Descrizione |
Esempio |
Widget Id |
Identificativo univoco del widget che verrà utilizzato per invio di notifiche e messaggi all'interno di AgentDesktop |
Es. MY_WIDGET_EXAMPLE |
Widget Title |
Titolo del widget che verrà visualizzato in AgentDesktop nella barra laterale dei widget. |
MyWidget |
Widget URI |
Url del widget da caricare. Può essere di tipo relativo nel caso l'applicazione venga ospitata sullo stesso server dove è presente AgentDesktop, oppure, grazie al supporto della funzionalità POST Message, può essere un URL appartenente ad un dominio differente ad AgentDektop |
|
Widget Icon |
Icona del widget che verrà visualizzata in AgentDesktop nella barra laterale dei widget |
fa fa-lightbulb-o fa-2x |
Infine, è necessario abilitarlo andando nella sezione Profiles, scegliere il profilo a cui associare la visualizzazione del widget creato e nella parte relativa ai Widgets o Multicontact (se multicontatto), cliccare sul suo nome per portarlo nella colonna di quelli abilitati.
Creazione di un widget
Caricare nel codice dell'applicativo web da includere il modulo
<script src="/widget/agentdesktop_widget.js"></script>,
In questo modo si avrà a disposizione un namespace AGENTDESKTOP.
Con il namespace AGENTDESKTOP si avrà a disposizione una serie di Widget per:
- aprire/chiudere i Tab (AGENTDESKTOP.TAB),
- visualizzare finestre informative (AGENTDESKTOP.ALERT),
- registrarti le tue callback (AGENTDESKTOP.WIDGET),
- effettuare chiamate (AGENTDESKTOP.CONTACT),
- gestire lo stato dell'operatore (AGENTDESKTOP.AGENT),
- gestire un contatto di tipo chat (AGENTDESKTOP.CHAT),
- gestire eventi relativi all'apertura/chiusura di finsestre di dialogo (AGENTDESKTOP.UI).
Requisiti
La possibilità di integrazione di un applicazione web all'interno del AD utilizzando i Widget è soggetta ad alcune requisiti.
X-Frame-Options
Molti amministratori di sistema di default settano IIS per evitare che le pagine web hostate possano essere inserite da altri come iframe su altri domini (siti web) e questo avviene per motivi di sicurezza (per evitare il "framesniffing").
Viene riportato un esempio di abilitazione per IIS o su web.config l'header "X-Frame-Options" come segue:
<configuration> |
Le altre 2 opzioni possono essere: SAMEORIGIN o DENY.
Controllo del TOP
Alcune applicazioni web verificano se sono incluse in un iframe, in qual caso cercano di ricaricarsi sostituendo la pagina principale.
Un esempio di questo codice è come segue:
<script type="text/javascript">
if (top.frames.length!=0)
top.location=self.document.location;
</script>
In questo caso, si dovrà modificare il codice per permettere l'inclusione in un iframe se la finestra padre è un url di Contact.