Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Con il namespace CTVIEW si potrà accedere ad una serie di oggetti e metodi che consentono di specifiare specificare quali risorse e quali metriche si vuole monitorare nella propria applicazione.

...

Funzione

Descrizione

CTVIEW.WIDGET.startMonitorResourceScalar

String ResourceType, String Resources, String Scalars

Richiede il monitoring delle risorse e delle metriche (Scalars) indicati dai seguenti parametri:

  • ResourceType: categoria di risorse. Può assumere i valori “AGENT” oppure “QUEUE”

  • Resources: regular expression per filtrare quali risorse si vuole monitorare. E' possibile indicare asterisco “*” come shortcut per monitorare tutte le risorse appartenenti ad una categoria.
    Esempio: "^QUEUE.*" (tutti i Gruppi il cui identificativo inizia con QUEUE) oppure "*"

  • Elenco separato da “,” di uno o più identificativi di Scalar da monitorare. Esempio: "30210,12002"

CTVIEW.WIDGET.stopMonitorResourceScalar

String ResourceType, String Resources

Interrompe il monitoraggio di tutti gli Scalar sulla risorsa specificata.

CTVIEW.WIDGET.startMonitorDistinctScalar

String ResourceType, String Resources, String Scalars

Richiede il monitoring di un particolare sottoinsieme di Scalar fornendo il valore totale calcolandolo univocamente sulla base delle risorse selezionate. Gli Scalar disponibili per il monitoraggio distinto per risorsa sono i seguenti:

  • 13002 (AgentsLoggedIn) : numero di operatori in stato LOGGEDIN

  • 13003 (AgentsPaused) : numero di operatori in stato PAUSA

  • 2001 (AgentsSchedulable): numero di operatori schedulabili su qualsiasi media (telefonico, chat, multimediale)

  • 36000 (AgentsTot): numero totale di operatori in stato LOGGEDIN e PAUSA

Una volta richiesto il monitoring di un particolare Scalar, CTView provvederà a notificare alla funzione di callback la somma totale dei valori distinti per risorsa. Se per esempio prendiamo lo Scalar 13002 (AgentsLoggedIn) se un operatore risulta loggato su più code nel totale verrà conteggiato in modo univoco.

Questo metodo è differente dall’eseguire una pura e semplice somma del valore dello Scalar 13002 per ciascuna coda in quanto si può facilmente riscontrare il problema di conteggi multipli dello stesso operatore.

Il metodo richiede i seguenti parametri:

  • ResourceType: categoria di risorse. Può assumere il valori “QUEUE”

  • Resources: regular expression per filtrare quali risorse si vuole monitorare. E' possibile indicare asterisco “*” come shortcut per monitorare tutte le risorse appartenenti ad una categoria.
    Esempio: "^QUEUE.*" (tutti i Gruppi il cui identificativo inizia con QUEUE) oppure "*"

  • L’identificativo di un singolo Scalar scelto tra i seguenti: "13002,13003,2001,36000"

Code Block
languagejs
CTVIEW.WIDGET.startMonitorDistinctScalar("QUEUE", "*", "13002");

CTVIEW.WIDGET.stopMonitorDistinctScalar

Interrompe il monitoraggio di tutti gli Scalar aggregati per risorsa

CTVIEW.WIDGET.bindScalarChangeCallback

Javascript function

Effettua la bind di una propria funzione javascript al fine di ricevere una notifica contenente nuovi dati aggiornati.

Il dato aggiornato viene notificato alla funzione di callback mediante un oggetto con le seguenti proprietà:

  • resource_device: identificativo della risorsa coinvoltsa (solo device name)

  • resource_domain: dominio applicativo della risorsa coinvolta

  • resource_id: identificativo completa della risorsa coinvolta

  • resource_type: “AGENT” oppure “QUEUE”

  • scalar_id: identificativo numerico dello Scalar aggiornato

  • scalar_type: tipologia dello Scalar. Può assumere i seguenti valori:

    • INTEGER: il valore è un numero intero

    • FLOAT: il valore è un numero in virgola mobile

    • PERCENTAGE: il valore rappresenta una percentuale

    • TIME: il valore rappresenta una durata temporale in msec

    • DATETIME: il valore è un timestamp

  • scalar_value: valore aggiornato

Code Block
languagejs
CTVIEW.WIDGET.bindScalarChangeCallback(ScalarChanged);
function ScalarChanged(event, data) {
  var DataObj = null;
  if (typeof data === "string") {
    DataObj = JSON.parse(data);
  }
  if (typeof dats === "object") {
    DataObj = data;
  }
  console.log("[CTVIEW WIDGET IFRAME] Scalar Changed", DataObj);
  // Do Some Stuff...
};

CTVIEW.WIDGET.bindDistinctScalarChangeCallback

Javascript function

Effettua la bind di una propria funzione javascript al fine di ricevere una notifica contenente nuovi dati aggregati aggiornati.

Il dato aggiornato viene notificato alla funzione di callback mediante un oggetto con le seguenti proprietà.

  • resource_device: il campo non è utilizzato ed è valorizzato a stringa vuota ““

  • resource_domain: il campo non è utilizzato ed è valorizzato a stringa vuota ““

  • resource_id: lista degli identificativi delle risorse coinvolte nell’aggregato

  • resource_type: “QUEUE”

  • scalar_id: identificativo numerico dello Scalar

  • scalar_type: tipologia dello Scalar. Può assumere i seguenti valori:

    • INTEGER: il valore è un numero intero

    • FLOAT: il valore è un numero in virgola mobile

  • scalar_value: totale aggiornato

Code Block
languagejs
CTVIEW.WIDGET.bindDistinctScalarChangeCallback(DistinctScalarChanged);
CTVIEW.WIDGET.startMonitorDistinctScalar("QUEUE", "*", "13002");
function DistinctScalarChanged(jQuery_eventType, data) {
  var DataObj = null;
  var ScalarValue = "";
  if (typeof data === "string") {
    DataObj = JSON.parse(data);
  }
  if (typeof dats === "object") {
    DataObj = data;
  }
  console.log("[QUEUES SDK WIDGET] Distinct Scalar Changed", DataObj);
};

CTVIEW.WIDGET.bindScalarDumpCallback

Javascript function

Effettua la bind di una propria funzione javascript al fine di ricevere una notifica contenente il dump iniziale di tutti gli Scalar che si è scelto di monitorare.

Il dump aggiornato viene notificato alla funzione di callback mediante un array dove ciascun elemento è un oggetto con le seguenti proprietà:

Image Added
Code Block
languagejs
CTVIEW.WIDGET.bindScalarDumpCallback(ScalarDump);
function ScalarDump(jQuery_eventType, data) {
  var DataObj = null;
  var ScalarValue = "";
  if (typeof data === "string") {
    DataObj = JSON.parse(data);
  }
  if (typeof data === "object") {
    DataObj = data;
  }
  console.log("[QUEUES SDK WIDGET] Scalar Dump", DataObj);
};

Informazioni sulla utenza loggata

...

Funzione

Descrizione

CTVIEW.WIDGET.getCTViewUserData

Richiede alcune informazioni relative alla utenza loggata in CTView. Viene restuita restituita una promise Javascript che verrà risolta restituendo un oggetto composto dalle seguenti proprietà:

  • user: identificativo della utenza loggata in CTView

  • sso_token: token Single Sign On restituito dalla login verso l’Identity Provider EasyCIM

  • x2l_session: Identificativo di Sessione verso il processo Hub X2L di Contact 7.

  • call_center: Oggetto complesso che contiene la lista di tutti i CallCenter visibili in CTView dalla utenza “user”. Per ogni CallCenter vengono elencate anche MacroAttività, Partner e Tipologia.

Code Block
languagejs
CTVIEW.WIDGET.getCTViewUserData().then(
  function(data) {
    console.log("[CTVIEW WIDGET IFRAME] User Data", data);
  }
);