Changes for page Transfer Property

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -10,17 +10,17 @@
10	10	* [[transfer property personalizzate (create dall'utente)>>||anchor="Letransferpropertypersonalizzate"]]
11	11
12	12
13		-== Le transfer property di sistema ==
	13	+== Le Transfer Property di Sistema ==
14	14
15	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	16
17		-|**Transfer Property**|(% style="width:368px" %)**Valore**|(% style="width:575px" %)**Descrizione**
18		-|**~_~_CallerParty**|(% style="width:368px" %)Numero di telefono|(% style="width:575px" %)Contiene il numero del chiamante se disponibile dalla rete pubblica. E' il numero che #phones passa nel CallData ExternalParty.
19		-|**~_~_CalledParty**|(% style="width:368px" %)Numero di telefono|(% style="width:575px" %)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:368px" %)1 = audio
	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	21	2 = @Phones
22		-5 = video|(% style="width:575px" %)Specifica il tipo di chiamata in corso.
23		-|**~_~_RecognizeResult~_~_**|(% style="width:368px" %)vvpMaxNonSilence = 4
	22	+5 = video|(% style="width:587px" %)Specifica il tipo di chiamata in corso.
	23	+|**~_~_RecognizeResult~_~_**|(% style="width:356px" %)vvpMaxNonSilence = 4
24	24	vvpMaxSilence = 3
25	25	vvpRunTimeError = -1
26	26	vvpStopped = 1
...	...	@@ -27,76 +27,77 @@
27	27	vvpTermDigit = 2
28	28	vvpTimeOut = 6
29	29	vvpEngineUnavailable = 18
30		-vvpNotRecognized = 19|(% style="width:575px" %)Contiene l'esito dell'ultima operazione di riconoscimento vocale (ASR).
31		-|**_ASR_Source**|(% style="width:368px" %)ASR
32		-DTMF|(% style="width:575px" %)Indica la modalità di riconoscimento: ASR o DTMF.
33		-|**~_~_CallForwardingResult~_~_**|(% style="width:368px" %)(((
	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	34	0: se l'operazione è andata a buon fine
35	35	1: se l'operazione ha generato un errore
36		-)))|(% style="width:575px" %)Esito del CallForwarding.
37		-|**~_~_CallForwardingCallGuid~_~_**|(% style="width:368px" %)GUID|(% style="width:575px" %)Contiene la GUID della chiamata outbound emessa a seguito della richiesta di CallForwarding.
38		-|**~_~_CallForwardingCallID~_~_**|(% style="width:368px" %)CallID|(% style="width:575px" %)Contiene la CallID di #phones della chiamata outbound emessa a seguito della richiesta di CallForwarding.
39		-|**~_~_CallForwardingCallResult~_~_**|(% style="width:368px" %)Numero intero|(% style="width:575px" %)Se la chiamata outbound fallisse, riporta la causa dell'errore ([[Codice fallimento>>path:../input/hashphones.phonebar-oggetti-interfaccia-programmazione#fallimento]]).
40		-|**~_~_CallForwardingCallProtocolSpecificCause~_~_**|(% style="width:368px" %)Numero intero|(% style="width:575px" %)Se la chiamata outbound fallisse, la transfer property riporta la causa dell'errore connessa al protocollo usato ([[Cause di disconnessione SIP>>path:../input/hashphones.phonebar-oggetti-interfaccia-programmazione#causedsconnessione]], [[Cause di disconnessione ISDN>>path:../input/hashphones.phonebar-oggetti-interfaccia-programmazione#ISDN]]).
41		-|**~_~_CallForwardingReportingError~_~_**|(% style="width:368px" %)0: operazione eseguita
42		-1: operazione fallita|(% style="width:575px" %)Il CallForwarding può salvare l'esito dentro un database. Contiene il risultato dell'operazione di salvataggio dentro il database.
43		-| |(% style="width:368px" %) |(% style="width:575px" %)
	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	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>>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]].
	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	46
47		-=== Esempio ===
	47	+==== Esempio ====
48	48
49		-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. Il codice alfanumerico può essere fornito in due modi differenti:
	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	50
51	51	* tramite tastiera
52	52	* o in forma vocale
53	53
54		-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_]].
	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	55
56		-[[image:hashphones.messenger-le-transfer-property.html_html_m36a08770.png||height="342" width="642"]]
	56	+[[image:hashphones.messenger-le-transfer-property.html_html_m36a08770.png||height="342" width="642" style="margin-bottom:20px; margin-top:20px"]]
57	57
58		-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]]):
	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	59
60		-* [[GetAlfaNumCode>>path:../input/hashphones.messenger-configurator-servizi-base#_Cgetalfanumcode_]]
61		-* [[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]]
	60	+* [[GetAlfaNumCode>>doc:MessengerServiziBase.VoiceRecognition.WebHome||anchor="HGetAlfaNumCode28CGetAlfaNumCode29" target="_blank"]]
	61	+* [[UserSwitch>>doc:MessengerServiziBase.DiramazioneFlusso.WebHome||anchor="HUserSwitch28CUserSwitch29" target="_blank"]]
62	62
63		-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.
	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	64
65		-[[image:hashphones.messenger-le-transfer-property.html_html_m5eb524cc.png||height="401" width="533"]]
	65	+(% style="text-align:center" %)
	66	+[[image:hashphones.messenger-le-transfer-property.html_html_m5eb524cc.png||height="401" width="533" style="margin:20px 0"]]
66	66
67		-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:
	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:
68	68
69		-* **DTMF**: se il riconoscimento è stato effettuato tramite i [[toni DTMF>>path:../input/hashphones.glossario#_Dualtonemultiplefrequencydetection_]];
70		-* **ASR**: se il riconoscimento è stato effettuato tramite l'[[ASR>>path:../input/hashphones.glossario#_ASR-automaticspeechrecognition_]].
	70	+* **DTMF**: se il riconoscimento è stato effettuato tramite i toni DTMF
	71	+* **ASR**: se il riconoscimento è stato effettuato tramite l'ASR.
71	71
72		-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:
	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:
73	73
74		-* se //DTMF// ([[tono DTMF>>path:../input/hashphones.glossario#_Dualtonemultiplefrequencydetection_]]): verrà usato il [[port>>path:#BlockConnection]] denominato **DTMF**
75		-* se //ASR// ([[ASR>>path:../input/hashphones.glossario#_ASR-automaticspeechrecognition_]]): verrà usato il [[port>>path:#BlockConnection]] denominato **ASR**.
	75	+* se //DTMF// (tono DTMF): verrà usato il port denominato **DTMF**
	76	+* se //ASR// (ASR): verrà usato il port denominato **ASR**.
76	76
77		-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.
	78	+Per comprendere questo comportamento è necessario aprire la finestra delle proprietà del blocchetto //UserSwitch//, come raffigurato nell'immagine seguente.
78	78
79		-Nella scheda **Tipo oggetto** impostare **Transfer Property**: questa attiva la scheda **Transfer Property** (immagine successiva).
	80	+Nella scheda **Tipo oggetto** impostare **Transfer Property**: questa attiva la scheda **Transfer Property** (vedere immagine seguente).
80	80
81		-[[image:hashphones.messenger-le-transfer-property.html_html_6f04bbf8.png||height="511" width="400"]]
	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;"]]
82	82
83	83	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).
84	84
85		-[[image:hashphones.messenger-le-transfer-property.html_html_m1146f627.png||height="511" width="400"]]
	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;"]]
86	86
87	87	Affinché il blocchetto [[UserSwitch>>path:../input/hashphones.messenger-configurator-servizi-base#_Cuserswitch_]] operi correttamente, è necessario inserire i [[port>>path:#BlockConnection]] che intendiamo usare.
88	88
89	89	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**.
90	90
91		-[[image:hashphones.messenger-le-transfer-property.html_html_7a0e058d.png||height="511" width="400"]]
	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;"]]
92	92
93	93	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.
94	94
95		-== Le transfer property personalizzate ==
	96	+== Le Transfer Property Personalizzate ==
96	96
97	97	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.
98	98
99		-=== Esempio ===
	100	+==== Esempio ====
100	100
101	101	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.
102	102
...	...	@@ -165,4 +165,4 @@
165	165	[[image:hashphones.messenger-le-transfer-property.html_html_m3a562169.png||height="447" width="350"]]
166	166
167	167
168		-
	169	+