Skip to Content

Wiki source code of Transfer Property

Show last authors
1 {{box cssClass="floatinginfobox" title="**Sommario**" width="300px"}}
2 {{toc start=2 depth="3"/}}
3 {{/box}}
4
5 == Introduzione ==
6
7 Le **Transfer Property** sono variabili utilizzate per trasferire dati da un [[servizio del Messenger>>doc:MessengerConcetti.ServiziMessenger.WebHome||target="_blank"]] 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 appartenenti alla stessa [[campagna di #phones>>doc:CampagnePhones.WebHome||target="_blank"]]. Esistono due tipi di transfer property:
8
9 * [[transfer property di sistema>>||anchor="Letransferpropertydisistema"]]
10 * [[transfer property personalizzate (create dall'utente)>>||anchor="Letransferpropertypersonalizzate"]]
11
12
13 == Le Transfer Property di Sistema ==
14
15 Le transfer property di sistema vengono create dal Messenger ed alcune possono ricevere soltanto dei valori specifici, ossia compresi all'interno di un arco ben definito.
16
17 |**Transfer Property**|(% style="width:356px" %)**Valore**|(% style="width:587px" %)**Descrizione**
18 |**~_~_CallerParty**|(% style="width:356px" %)Numero di telefono|(% style="width:587px" %)Contiene il numero del chiamante se disponibile dalla rete pubblica. E' il numero che #phones passa nel CallData ExternalParty.
19 |**~_~_CalledParty**|(% style="width:356px" %)Numero di telefono|(% style="width:587px" %)Contiene il numero composto dal chiamante, ma è disponibile solo con schede di flusso e se la centrale lo mette a disposizione.
20 |**~_~_CallMediaType**|(% style="width:356px" %)1 = audio
21 2 = @Phones
22 5 = video|(% style="width:587px" %)Specifica il tipo di chiamata in corso.
23 |**~_~_RecognizeResult~_~_**|(% style="width:356px" %)vvpMaxNonSilence = 4
24 vvpMaxSilence = 3
25 vvpRunTimeError = -1
26 vvpStopped = 1
27 vvpTermDigit = 2
28 vvpTimeOut = 6
29 vvpEngineUnavailable = 18
30 vvpNotRecognized = 19|(% style="width:587px" %)Contiene l'esito dell'ultima operazione di riconoscimento vocale (ASR).
31 |**_ASR_Source**|(% style="width:356px" %)ASR
32 DTMF|(% style="width:587px" %)Indica la modalità di riconoscimento: ASR o DTMF.
33 |**~_~_CallForwardingResult~_~_**|(% style="width:356px" %)(((
34 0: se l'operazione è andata a buon fine
35 1: se l'operazione ha generato un errore
36 )))|(% style="width:587px" %)Esito del CallForwarding.
37 |**~_~_CallForwardingCallGuid~_~_**|(% style="width:356px" %)GUID|(% style="width:587px" %)Contiene la GUID della chiamata outbound emessa a seguito della richiesta di CallForwarding.
38 |**~_~_CallForwardingCallID~_~_**|(% style="width:356px" %)CallID|(% style="width:587px" %)Contiene la CallID di #phones della chiamata outbound emessa a seguito della richiesta di CallForwarding.
39 |**~_~_CallForwardingCallResult~_~_**|(% style="width:356px" %)Numero intero|(% style="width:587px" %)Se la chiamata outbound fallisse, riporta la causa dell'errore ([[Codice fallimento>>../input/hashphones.phonebar-oggetti-interfaccia-programmazione#fallimento||anchor="Linkdaimpostare"]]).
40 |**~_~_CallForwardingCallProtocolSpecificCause~_~_**|(% style="width:356px" %)Numero intero|(% style="width:587px" %)Se la chiamata outbound fallisse, la transfer property riporta la causa dell'errore connessa al protocollo usato ([[Cause di disconnessione SIP>>../input/hashphones.phonebar-oggetti-interfaccia-programmazione#causedsconnessione||anchor="Linkdaimpostare"]], [[Cause di disconnessione ISDN>>../input/hashphones.phonebar-oggetti-interfaccia-programmazione#ISDN||anchor="Linkdaimpostare"]]).
41 |**~_~_CallForwardingReportingError~_~_**|(% style="width:356px" %)0: operazione eseguita
42 1: operazione fallita|(% style="width:587px" %)Il CallForwarding può salvare l'esito dentro un database. Contiene il risultato dell'operazione di salvataggio dentro il database.
43 | |(% style="width:356px" %) |(% style="width:587px" %)
44
45 Le transfer property di sistema tipicamente sono in sola lettura, vengono create e valorizzate dal Messenger e sono usate all'interno dei servizio del Messenger, siano essi i [[servizi base del Messenger>>doc:MessengerServiziBase.WebHome||target="_blank"]] o i [[servizi del Messenger personalizzati>>doc:MessengerConcetti.ServiziMessenger.WebHome||anchor="HServizipersonalizzati" target="_blank"]].
46
47 ==== Esempio ====
48
49 Ipotizziamo un [[servizio di #phones>>doc:ServiziPhones.WebHome||target="_blank"]], creato con il [[Call Designer>>doc:CallDesigner.WebHome||target="_blank"]], concepito per acquisire un codice alfanumerico immesso dall'utente del contact center. Il codice alfanumerico può essere fornito in due modi differenti:
50
51 * tramite tastiera
52 * o in forma vocale
53
54 Il servizio di #phones deve essere in grado di individuare il meccanismo appropriato di acquisizione, ossia [[toni DTMF>>doc:Glossario.WebHome||anchor="HDualToneMultipleFrequencyDetection" target="_blank"]] o [[ASR>>doc:Glossario.WebHome||anchor="HASR"]].
55
56 [[image:hashphones.messenger-le-transfer-property.html_html_m36a08770.png||height="342" width="642" style="margin-bottom:20px; margin-top:20px"]]
57
58 Nell'immagine precedente è raffigurato un grafo nel quale è presente una [[campagna di #phones>>doc:CampagnePhones.WebHome||target="_blank"]] contenente due blocchetti (ossia due servizi del Messenger):
59
60 * [[GetAlfaNumCode>>doc:MessengerServiziBase.VoiceRecognition.WebHome||anchor="HGetAlfaNumCode28CGetAlfaNumCode29" target="_blank"]]
61 * [[UserSwitch>>doc:MessengerServiziBase.DiramazioneFlusso.WebHome||anchor="HUserSwitch28CUserSwitch29" target="_blank"]]
62
63 Poiché si tratta di un esempio, il port "Failure" del blocchetto GetAlfaNumCode si limita ad eseguire un servizio contenuto nel blocchetto [[PlayBack>>doc:MessengerServiziBase.TrasferimentoControlloChiamata.WebHome||anchor="HPlayBack28CPlayBack29" target="_blank"]], il quale di fatto recita un messaggio ed esce.
64
65 (% style="text-align:center" %)
66 [[image:hashphones.messenger-le-transfer-property.html_html_m5eb524cc.png||height="401" width="533" style="margin:20px 0"]]
67
68 Il blocchetto //GetAlfaNumCode //è concepito per identificare un codice fornito dall'utente del contact center. Questo codice può essere inserito attraverso la tastiera telefonica (toni DTMF) oppure l'utente del contact center può letteralmente recitarlo (ASR). A seconda del segnale individuato, il blocchetto //GetAlfaNumCode//, all'interno della transfer property di sistema// [[_ASR_Source>>||anchor="HLeTransferPropertydiSistema"]]//, registra un valore che indica appunto il tipo di riconoscimento effettuato; il valore della transfer property// _ASR_Source// potrà dunque assumere uno dei seguenti valori:
69
70 * **DTMF**: se il riconoscimento è stato effettuato tramite i toni DTMF
71 * **ASR**: se il riconoscimento è stato effettuato tramite l'ASR.
72
73 In un secondo momento, la transfer property di sistema //_ASR_Source//, valorizzata dal blocchetto //GetAlfaNumCode//, viene //passata// al blocchetto successivo, che nell'esempio illustrato è appunto il blocchetto //UserSwitch//. Quest'ultimo utilizza il valore della transfer property //_ASR_Source// per selezionare il port di uscita:
74
75 * se //DTMF// (tono DTMF): verrà usato il port denominato **DTMF**
76 * se //ASR// (ASR): verrà usato il port denominato **ASR**.
77
78 Per comprendere questo comportamento è necessario aprire la finestra delle proprietà del blocchetto //UserSwitch//, come raffigurato nell'immagine seguente.
79
80 Nella scheda **Tipo oggetto** impostare **Transfer Property**: questa attiva la scheda **Transfer Property** (vedere immagine seguente).
81
82 [[image:hashphones.messenger-le-transfer-property.html_html_6f04bbf8.png||height="447" width="400" alt="" style="-moz-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); -webkit-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); margin-top:20px; margin-bottom:20px;"]]
83
84 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).
85
86 [[image:hashphones.messenger-le-transfer-property.html_html_m1146f627.png||height="511" width="400" style="-moz-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); -webkit-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); margin-top:20px; margin-bottom:20px;"]]
87
88 Affinché il blocchetto [[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]] operi correttamente, è necessario inserire i [[port>>path:#BlockConnection]] che intendiamo usare.
89
90 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**.
91
92 [[image:hashphones.messenger-le-transfer-property.html_html_7a0e058d.png||height="511" width="400" style="-moz-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); -webkit-box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8); box-shadow:5px 5px 10px 0px rgba(204,204,204,0.8);margin-top:20px;margin-bottom:20px;"]]
93
94 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.
95
96 == Le Transfer Property Personalizzate ==
97
98 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.
99
100 ==== Esempio ====
101
102 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.
103
104 [[image:hashphones.messenger-le-transfer-property.html_html_m230054ff.png||height="289" width="642"]]
105
106 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]]:
107
108 * [[SetStoreProperty>>path:../input/hashphones.messenger-configurator-servizi-base#_Csetstoreproperty_]]
109 * [[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]]
110 * [[PlayMessage>>path:../input/hashphones.messenger-configurator-servizi-base#_CPlayBack_]] ([[blocchetto>>path:../input/hashphones.phonesenterprise-client-call-designer#TipiDiBlocchetti]] **PlayError**)
111
112 Ipotizziamo un database contenente la tabella Clienti caratterizzata dai seguenti campi:
113
114 * **IDCliente**: identificativo univoco del cliente
115 * **CampoNome**: nome del cliente
116 * **CampoCognome**: cognome del cliente
117 * **CampoPriorita**: ipotetica priorità del client (per esempio cliente VIP), che ammette i valori "1", "2" o "3".
118
119 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 \\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:
121
122 * se //Priorita// è uguale ad 1: **Op1**
123 * se //Priorita// è uguale ad 2: **Op2**
124 * se //Priorita// è uguale ad 3: **OpX**.
125
126 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**).
127
128 ==== Descrizione della configurazione ====
129
130 (% id="HIlblocchettoSetStoreProperty" %)
131 (% style="font-size:18px" %)**Il blocchetto SetStoreProperty**
132
133 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**.
134
135 [[image:hashphones.messenger-le-transfer-property.html_html_m755891a0.jpg||height="561" width="434"]]
136
137 Si attiva la nuova scheda **ODBC**.
138
139 [[image:hashphones.messenger-le-transfer-property.html_html_31695171.png||height="447" width="350"]]
140
141 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**.
142
143 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.
144
145 [[image:hashphones.messenger-le-transfer-property.html_html_90c9293.jpg||height="562" width="435"]]
146
147 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.
148 \\Per creare una nuova property personalizzata e per associarla al campo del database, premere il pulsante **Nuovo** per effettuare nuovi assegnazioni.
149
150 [[image:hashphones.messenger-le-transfer-property.html_html_m93f2fd6.png||height="447" width="350"]]
151
152 ==== Il blocchetto UserSwitch ====
153
154 Per poter usare le transfer property personalizzate occorre impostare anche la configurazione del blocchetto [[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]].
155
156 Nella finestra delle proprietà, nella scheda **Tipo oggetto**, è necessario selezionare **Transfer Property**.
157
158 [[image:hashphones.messenger-le-transfer-property.html_html_ma1aa187.png||height="447" width="350"]]
159
160 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.
161
162 [[image:hashphones.messenger-le-transfer-property.html_html_m7ce42b3a.png||height="447" width="350"]]
163
164 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]].
165
166 [[image:hashphones.messenger-le-transfer-property.html_html_m3a562169.png||height="447" width="350"]]
167
168