Skip to Content

Changes for page Transfer Property

From version 15.2
edited by administrator BDP
on 2018/01/11 17:52
Change comment: There is no comment for this version
To version 15.1
edited by administrator BDP
on 2018/01/11 17:46
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -Transfer Property
1 +Introduzione
Content
... ... @@ -1,4 +1,4 @@
1 -== Introduzione ==
1 += Introduzione__[[ >>path:#Introduzione_5]]__ =
2 2  
3 3  Le **Transfer Property** sono variabili utilizzate per trasferire dati da un __[[servizio del Messenger>>path:../input/hashphones.messenger-configurator-servizi]]__ ad un altro. Dal punto di vista dell'utente, tuttavia le transfer property assumono la forma di coppie formate dal nome della proprietà seguito dal valore ad essa assegnato. Le transfer property possono essere utilizzate soltanto dai __[[servizi del Messenger>>path:../input/hashphones.messenger-configurator-servizi]]__ appartenenti alla stessa __[[campagna di #phones>>path:../input/hashphones.campagne]]__. Esistono due tipi di transfer property:
4 4  
... ... @@ -5,7 +5,7 @@
5 5  * __[[transfer property di sistema>>path:#tp-sistema]]__
6 6  * __[[transfer property personalizzate (create dall'utente)>>path:#tp-custom]]__
7 7  
8 -== Le transfer property di sistema ==
8 += Le transfer property di sistema__[[ >>path:#Le_transfer_property_di_sistema_6]]__ =
9 9  
10 10  Le transfer property di sistema vengono create dal __[[Messenger>>path:../input/hashphones.messenger]]__ ed alcune possono ricevere soltanto dei valori specifici, ossia compresi all'interno di un arco ben definito.
11 11  
... ... @@ -33,9 +33,10 @@
33 33  |**~_~_CallForwardingReportingError~_~_**|0: operazione eseguita;
34 34  1: operazione fallita|Il CallForwarding può salvare l'esito dentro un database; la transfer property //~_~_CallForwardingReportingError~_~_// contiene il risultato dell'operazione di salvataggio dentro il database.
35 35  
36 +
36 36  Le transfer property di sistema tipicamente sono in sola lettura, vengono create e valorizzate dal __[[Messenger>>path:../input/hashphones.messenger]]__ e sono usate all'interno dei __[[servizio del Messenger>>path:../input/hashphones.messenger-configurator-servizi]]__, siano essi i __[[servizi base del Messenger>>path:../input/hashphones.messenger-configurator-servizi#Base]]__ o i __[[servizi del Messenger personalizzati>>path:../input/hashphones.messenger-configurator-servizi#Personalizzati]]__.
37 37  
38 -==== Esempio ====
39 +== Esempio__[[ >>path:#Esempio_3]]__ ==
39 39  
40 40  Ipotizziamo un __[[servizio di #phones>>path:../input/hashphones.servizi]]__, creato con il __[[Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer]]__, concepito per acquisire un codice alfanumerico immesso __[[dall'utente del contact center>>path:../input/hashphones.glossario#Cliente]]__. Il codice alfanumerico può essere fornito in due modi differenti:
41 41  
... ... @@ -42,56 +42,66 @@
42 42  * tramite tastiera
43 43  * o in forma vocale
44 44  
46 +
45 45  Il __[[servizio di #phones>>path:../input/hashphones.servizi]]__ deve essere in grado di individuare il meccanismo appropriato di acquisizione, ossia __[[toni DTMF>>path:../input/hashphones.glossario#_Dualtonemultiplefrequencydetection_]]__ o __[[ASR>>path:../input/hashphones.glossario#_ASR-automaticspeechrecognition_]]__.
46 46  
47 47  |[[image:hashphones.messenger-le-transfer-property.html_html_m36a08770.png||height="342" width="642"]]
48 48  
51 +
49 49  Nell'immagine precedente è raffigurato un grafo nel quale è presente una __[[campagna di #phones>>path:../input/hashphones.campagne]]__ contenente due blocchetti (ossia due __[[servizi del Messenger>>path:../input/hashphones.messenger-configurator-servizi]]__):
50 50  
51 51  * __[[GetAlfaNumCode>>path:../input/hashphones.messenger-configurator-servizi-base#_Cgetalfanumcode_]]__
52 52  * __[[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]]__
53 53  
57 +
54 54  Poiché si tratta di un esempio, il __[[port "Failure">>path:#BlockConnection]]__ del blocchetto __[[GetAlfaNumCode>>path:../input/hashphones.messenger-configurator-servizi-base#_Cgetalfanumcode_]]__ si limita ad eseguire un servizio contenuto nel blocchetto __[[PlayBack>>path:../input/hashphones.messenger-configurator-servizi-base#_Cplayback_]]__, il quale di fatto recita un messaggio ed esce.
55 55  
56 56  |[[image:hashphones.messenger-le-transfer-property.html_html_m5eb524cc.png||height="401" width="533"]]
57 57  
62 +
58 58  Il blocchetto __[[GetAlfaNumCode>>path:../input/hashphones.messenger-configurator-servizi-base#_Cgetalfanumcode_]]__ è concepito per identificare un codice fornito __[[dall'utente del contact center>>path:../input/hashphones.glossario#Cliente]]__. Questo codice può essere inserito attraverso la tastiera telefonica (__[[toni DTMF>>path:../input/hashphones.glossario#_Dualtonemultiplefrequencydetection_]]__) oppure __[[l'utente del contact center>>path:../input/hashphones.glossario#Cliente]]__ può letteralmente recitarlo. A seconda del segnale individuato, il blocchetto __[[GetAlfaNumCode>>path:../input/hashphones.messenger-configurator-servizi-base#_Cgetalfanumcode_]]__, all'interno della __[[transfer property di sistema _ASR_Source>>path:../input/hashphones.messenger-le-transfer-property#tp-sistema]]__, registra un valore che indica appunto il tipo di riconoscimento effettuato; il valore __[[della transfer property di sistema _ASR_Source>>path:../input/hashphones.messenger-le-transfer-property#tp-sistema]]__ potrà dunque assumere uno dei seguenti valori:
59 59  
60 60  * **DTMF**: se il riconoscimento è stato effettuato tramite i __[[toni DTMF>>path:../input/hashphones.glossario#_Dualtonemultiplefrequencydetection_]]__;
61 61  * **ASR**: se il riconoscimento è stato effettuato tramite l'__[[ASR>>path:../input/hashphones.glossario#_ASR-automaticspeechrecognition_]]__.
62 62  
68 +
63 63  In un secondo momento, la __[[transfer property di sistema _ASR_Source>>path:../input/hashphones.messenger-le-transfer-property#tp-sistema]]__, valorizzata dal blocchetto __[[GetAlfaNumCode>>path:../input/hashphones.messenger-configurator-servizi-base#_Cgetalfanumcode_]]__, viene //passata// al blocchetto successivo, che nell'esempio illustrato è appunto il blocchetto __[[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]]__. Quest'ultimo utilizza il valore della __[[transfer property di sistema _ASR_Source>>path:../input/hashphones.messenger-le-transfer-property#tp-sistema]]__ per selezionare il __[[port>>path:#BlockConnection]]__ di uscita:
64 64  
65 65  * se //DTMF// (__[[tono DTMF>>path:../input/hashphones.glossario#_Dualtonemultiplefrequencydetection_]]__): verrà usato il __[[port>>path:#BlockConnection]]__ denominato **DTMF**
66 66  * se //ASR// (__[[ASR>>path:../input/hashphones.glossario#_ASR-automaticspeechrecognition_]]__): verrà usato il __[[port>>path:#BlockConnection]]__ denominato **ASR**.
67 67  
74 +
68 68  Per comprendere questo comportamento è necessario aprire la finestra delle proprietà del blocchetto __[[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]]__, come raffigurato nell'immagine seguente.
69 69  \\Nella scheda **Tipo oggetto** impostare **Transfer Property**: questa attiva la scheda **Transfer Property** (immagine successiva).
70 70  
71 71  |[[image:hashphones.messenger-le-transfer-property.html_html_6f04bbf8.png||height="511" width="400"]]
72 72  
80 +
73 73  Nella sezione **Transfer Property** va inserito il nome della __[[transfer property>>path:../input/hashphones.messenger-le-transfer-property]]__ della quale si intendono utilizzare i valori; in questo caso la __[[transfer property di sistema _ASR_Source>>path:../input/hashphones.messenger-le-transfer-property#tp-sistema]]__ (immagine precedente).
74 74  
75 75  |[[image:hashphones.messenger-le-transfer-property.html_html_m1146f627.png||height="511" width="400"]]
76 76  
85 +
77 77  Affinché il blocchetto __[[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]]__ operi correttamente, è necessario inserire i __[[port>>path:#BlockConnection]]__ che intendiamo usare.
78 78  \\Nella sezione **Associazioni** possiamo associare (appunto) il valore contenuto __[[nella transfer property di sistema _ASR_Source>>path:../input/hashphones.messenger-le-transfer-property#tp-sistema]]__ ad un __[[port>>path:#BlockConnection]]__ specifico. Infatti come illustrato nell'immagine, i due valori possibili della __[[transfer property>>path:../input/hashphones.messenger-le-transfer-property]]__, ossia //DTMF// e //ASR//, contenuti nel campo **Valore**, sono associati al __[[port>>path:#BlockConnection]]__ indicato nel campo **Port**.
79 79  
80 80  |[[image:hashphones.messenger-le-transfer-property.html_html_7a0e058d.png||height="511" width="400"]]
81 81  
91 +
82 82  Il risultato di questa operazione è visibile nel blocchetto __[[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]]__ raffigurato nell'immagine all'inizio di questo paragrafo.
83 -\\
93 +\\\\
84 84  
85 -== Le transfer property personalizzate ==
95 += Le transfer property personalizzate__[[ >>path:#Le_transfer_property_personalizzate_7]]__ =
86 86  
87 87  Le **transfer property personalizzate** sono delle transfer property create dall'utente; ma come le __[[transfer property di sistema>>path:#tp-sistema]]__, possono essere usate in tutti i __[[servizi del Messenger>>path:../input/hashphones.messenger-configurator-servizi]]__: __[[servizi base>>path:../input/hashphones.messenger-configurator-servizi#Base]]__ o __[[servizi personalizzati>>path:../input/hashphones.messenger-configurator-servizi#Personalizzati]]__. Ciò che differenzia le transfer property tra loro, è la definizione del nome. Quello delle __[[transfer property di sistema>>path:#tp-sistema]]__ è definito dal sistema stesso, come i loro valori, mentre il nome delle transfer property personalizzate è imposto dall'utente.
88 88  
89 -==== Esempio ====
99 +== Esempio__[[ >>path:#Esempio_4]]__ ==
90 90  
91 91  Immaginiamo un __[[servizio di #phones>>path:../input/hashphones.servizi]]__, creato con il __[[Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer]]__, concepito per leggere dei dati dalla tabella di un database e trasferirli dentro una transfer property personalizzata.
92 92  
93 93  |[[image:hashphones.messenger-le-transfer-property.html_html_m230054ff.png||height="289" width="642"]]
94 94  
105 +
95 95  Il __[[servizio di #phones>>path:../input/hashphones.servizi]]__, rappresentato nell'immagine, contiene la __[[campagna di #phones>>path:../input/hashphones.campagne]]__ **TP-Custom**, la quale si compone dei seguenti __[[blocchetti>>path:../input/hashphones.phonesenterprise-client-call-designer#TipiDiBlocchetti]]__:
96 96  
97 97  * __[[SetStoreProperty>>path:../input/hashphones.messenger-configurator-servizi-base#_Csetstoreproperty_]]__
... ... @@ -98,6 +98,7 @@
98 98  * __[[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]]__
99 99  * __[[PlayMessage>>path:../input/hashphones.messenger-configurator-servizi-base#_CPlayBack_]]__ (__[[blocchetto>>path:../input/hashphones.phonesenterprise-client-call-designer#TipiDiBlocchetti]]__ **PlayError**)
100 100  
112 +
101 101  Ipotizziamo un database contenente la tabella Clienti caratterizzata dai seguenti campi:
102 102  
103 103  * **IDCliente**: identificativo univoco del cliente
... ... @@ -105,7 +105,8 @@
105 105  * **CampoCognome**: cognome del cliente
106 106  * **CampoPriorita**: ipotetica priorità del client (per esempio cliente VIP), che ammette i valori "1", "2" o "3".
107 107  
108 -Il blocchetto __[[SetStoreProperty>>path:../input/hashphones.messenger-configurator-servizi-base#_Csetstoreproperty_]]__ interroga la tabella del database di cui sopra e, tramite il valore della chiave //IDCliente//, ottiene un record con i valori //CampoNome//, //CampoCognome// e //CampoPriorita//; questi dati vengono salvati nelle transfer property personalizzate //Nome//, //Cognome//, //Priorita//.
120 +
121 +Il blocchetto __[[SetStoreProperty>>path:../input/hashphones.messenger-configurator-servizi-base#_Csetstoreproperty_]]__ interroga la tabella del database di cui sopra e, tramite il valore della chiave //IDCliente//, ottiene un record con i valori //CampoNome//, //CampoCognome// e //CampoPriorita//; questi dati vengono salvati nelle transfer property personalizzate //Nome//, //Cognome//, //Priorita//.
109 109  \\Il blocchetto __[[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]]__ legge la transfer property //Priorita//, generata nel punto precedente, ed in base al suo valore, seleziona il __[[port>>path:#BlockConnection]]__ di uscita:
110 110  
111 111  * se //Priorita// è uguale ad 1: **Op1**
... ... @@ -112,31 +112,35 @@
112 112  * se //Priorita// è uguale ad 2: **Op2**
113 113  * se //Priorita// è uguale ad 3: **OpX**.
114 114  
128 +
115 115  Il blocchetto **PlayError** (__[[PlayMessage>>path:../input/hashphones.messenger-configurator-servizi-base#_CPlayBack_]]__) viene attivato soltanto se __[[SetStoreProperty>>path:../input/hashphones.messenger-configurator-servizi-base#_Csetstoreproperty_]]__ provoca un errore; in tal caso il __[[blocchetto>>path:../input/hashphones.phonesenterprise-client-call-designer#TipiDiBlocchetti]]__ recita un messaggio ed esce (__[[port>>path:#BlockConnection]]__ di uscita **Err**).
116 116  
117 -=== Descrizione della configurazione ===
131 +=== Descrizione della configurazione__[[ >>path:#Descrizione_della_configurazione_2]]__ ===
118 118  
119 -==== Il blocchetto SetStoreProperty ====
133 +==== Il blocchetto SetStoreProperty__[[ >>path:#Il_blocchetto_SetStoreProperty_0]]__ ====
120 120  
121 121  Nelle proprietà del blocchetto __[[SetStoreProperty>>path:../input/hashphones.messenger-configurator-servizi-base#_Csetstoreproperty_]]__ cliccare sulla scheda **Sorgente/Destinazione** e selezionare **Campo di un DB via ODBC**.
122 122  
123 123  |[[image:hashphones.messenger-le-transfer-property.html_html_m755891a0.jpg||height="561" width="434"]]
124 124  
139 +
125 125  Si attiva la nuova scheda **ODBC**.
126 126  
127 127  |[[image:hashphones.messenger-le-transfer-property.html_html_31695171.png||height="447" width="350"]]
128 128  
144 +
129 129  All'interno della sezione **Database** sono stati inseriti i valori di connessione del nostro ipotetico database, nonché il nome della tabella **Clienti**. Nella parte inferiore, nell'area **Criterio di ricerca record**, è stato inserito il nome del campo **IDCliente**, ossia il campo con la chiave univoca del singolo cliente, e l'identificativo del nostro cliente (nell'esempio //12345//) nel campo **Valore da cercare**.
130 130  \\Affinché i dati ottenuti attraverso l'interrogazione del database siano salvati dentro le transfer property, è necessario che nella scheda **Operazione** sia selezionata l'opzione indicata nella figura precedente.
131 131  
132 132  |[[image:hashphones.messenger-le-transfer-property.html_html_90c9293.jpg||height="562" width="435"]]
133 133  
150 +
134 134  Nella scheda **Associazioni** avviene l'associazione tra i valori ricavati dai campi //CampoNome//, //CampoCognome// e //CampoPriorita// della tabella **Clienti** e le transfer property personalizzate. Nella figura seguente è visibile una tabella: nella colonna di sinistra, campo **Property**, sono indicate le transfer property personalizzate //Nome//, //Cognome//, //Priorita//, mentre a destra, campo **Valore**, è indicato il campo del database ad esse connesso.
135 135  \\Per creare una nuova property personalizzata e per associarla al campo del database, premere il pulsante **Nuovo** per effettuare nuovi assegnazioni.
136 136  
137 137  |[[image:hashphones.messenger-le-transfer-property.html_html_m93f2fd6.png||height="447" width="350"]]
138 138  
139 -==== Il blocchetto UserSwitch ====
156 +==== Il blocchetto UserSwitch__[[ >>path:#Il_blocchetto_UserSwitch_1]]__ ====
140 140  
141 141  Per poter usare le transfer property personalizzate occorre impostare anche la configurazione del blocchetto __[[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]]__.
142 142  \\Nella finestra delle proprietà, nella scheda **Tipo oggetto**, è necessario selezionare **Transfer Property**.
... ... @@ -143,12 +143,14 @@
143 143  
144 144  |[[image:hashphones.messenger-le-transfer-property.html_html_ma1aa187.png||height="447" width="350"]]
145 145  
163 +
146 146  Quindi nella scheda **Transfer Property** occorre inserire il nome di una delle transfer property personalizzate definite nel blocchetto __[[SetStoreProperty>>path:../input/hashphones.messenger-configurator-servizi-base#_Csetstoreproperty_]]__, in questo caso la transfer property personalizzata **Priorita**, ossia quella che contiene il valore da utilizzare per la selezione del __[[port>>path:#BlockConnection]]__ di uscita.
147 147  
148 148  |[[image:hashphones.messenger-le-transfer-property.html_html_m7ce42b3a.png||height="447" width="350"]]
149 149  
168 +
150 150  Nella scheda **Associazioni** avviene appunto l'associazione tra il __[[port>>path:#BlockConnection]]__ ed il valore contenuto nella transfer property personalizzata **Priorita**. Come illustrato nell'immagine, a sinistra nella colonna **Valore** sono collocati i valori possibili di **Priorita**; invece a destra, sotto nella colonna **Port**, sono presenti i nomi dei __[[port>>path:#BlockConnection]]__ di uscita del __[[blocchetto>>path:../input/hashphones.phonesenterprise-client-call-designer#TipiDiBlocchetti]]__.
151 151  
152 152  |[[image:hashphones.messenger-le-transfer-property.html_html_m3a562169.png||height="447" width="350"]]
153 153  
154 -
173 +__[[Top>>path:#PageTop]]__