Changes for page 11 - Chat

Last modified by administrator BDP on 2024/10/16 17:42

From version 51.1
edited by administrator BDP
on 2019/04/29 12:22
Change comment: Uploaded new attachment "wtm_testo.png", version {1}
To version 68.2
edited by administrator BDP
on 2019/04/29 17:08
Change comment: Update document after refactoring.

Summary

Details

Page properties
Hidden
... ... @@ -1,1 +1,1 @@
1 -true
1 +false
Content
... ... @@ -10,7 +10,7 @@
10 10  
11 11  == ReadTextMessage ==
12 12  
13 -Questo blocchetto consente di leggere un messaggio di chat e memorizzarlo in una [[transfer property>>doc:ifmhelpplatform.MessengerConcetti.TransferProperty.WebHome||target="_blank"]] o [[Call Data>>doc:03 - Sviluppo Moduli Applicativi.CallData.WebHome||target="_blank"]].
13 +Questo blocchetto consente di leggere il testo di un messaggio di chat e memorizzarlo in una [[transfer property>>doc:ifmhelpplatform.MessengerConcetti.TransferProperty.WebHome||target="_blank"]] o [[Call Data>>doc:03 - Sviluppo Moduli Applicativi.CallData.WebHome||target="_blank"]].
14 14  
15 15  === **Parametri di Configurazione** ===
16 16  
... ... @@ -37,17 +37,13 @@
37 37  
38 38  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
39 39  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
40 -|**Out**|Port di uscita predefiito.
40 +|**Out**|Port di uscita predefinito.
41 41  
42 -
43 -
44 44  == WriteTextMessage ==
45 45  
46 -Questo blocchetto permette di convertire l'audio del chiamante (parlato) in testo tramite il motore di riconoscimento vocale di Google (//Google Speech API//). Il testo può essere salvato in una Transfer Property o in un CallData, per potere essere analizzato/elaborato successivamente da ulteriori blocchetti impostati nel flusso della chiamata.
44 +Questo blocchetto consente di selezionare il tipo di sorgente (stringa di testo, una [[transfer property>>doc:ifmhelpplatform.MessengerConcetti.TransferProperty.WebHome||target="_blank"]], [[Call Data>>doc:03 - Sviluppo Moduli Applicativi.CallData.WebHome||target="_blank"]], o tramite comando per il SocialMediaGateway) da cui prelevare il testo del messaggio da inviare in chat. Inoltre, solamente per Telegram, è possibile indicare o impostare una tastiera personalizzata da visualizzare nella chat.
47 47  
48 -Il servizio è disponibile anche in //compatibility mode.//
49 49  
50 -
51 51  === **Parametri di Configurazione** ===
52 52  
53 53  ==== **Proprietà** ====
... ... @@ -54,89 +54,119 @@
54 54  
55 55  Cliccando sulla funzionalità //Proprietà// del blocchetto sono visualizzate le seguenti schede:
56 56  
57 -//Scheda Messaggi//
53 +//Scheda Sorgente//
58 58  
59 -[[image:STT_skMessaggi.jpg||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:20px 10px"]]
55 +[[image:wtm_sorgente.png||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:20px 10px"]]
60 60  
61 61  L'elenco dei campi visualizzati è il seguente:
62 62  
63 63  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
64 64  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
65 -|**Lista messaggi**|Lista dei messaggi da riprodurre al chiamante come invito e istruzioni per ciò che deve dire.
61 +|**Tipo sorgente**|(((
62 +Selezionare il tipo di sorgente da cui prendere il testo del messaggio tra i seguenti:
66 66  
67 -Utilizzare i tasti **Nuovo**, **Modifica** e **Cancella** per selezionare e impostare il tipo di messaggio da riprodurre tra i seguenti:
64 +* Stringa di test costante
65 +* Transfer Property
66 +* Call Data
67 +* Comando per SMG
68 +)))
68 68  
69 -* File
70 -* Numero
71 -* Importo
72 -* Sequenza di caratteri
73 -* Lista formattata
74 -* Data/Ora
75 -* Data/Ora attuale
76 -* Data/Ora del file
77 -* Ordinale
70 +//Scheda Testo//
78 78  
79 -//Scheda Motore//
72 +Se è stata selezionata la sorgente //testo//, viene visualizzata la seguente scheda //Testo//:
80 80  
81 -[[image:STT_skMotore.jpg||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:20px 10px"]]
74 +[[image:wtm_testo.png||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:20px 10px"]]
82 82  
83 83  Impostare i campi seguenti:
84 84  
85 85  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
86 86  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
87 -|**Motore di riconoscimento vocale da utilizzare**|Selezionare il motore di riconoscimento da utilizzare. Al momento l’unico motore disponibile e configurabile è //Google Speech API//.
88 -|**Codice Lingua**|Indicare il codice della lingua, in formato [[BCP-47>>https://it.wikipedia.org/wiki/Codice_di_lingua_IETF||rel="noopener noreferrer" target="_blank"]], da utilizzare per il riconoscimento. Valore predefinito: //it-IT//.
89 -|**Termina riconoscimento su ricezione digits**|Selezionare se il riconoscimento può essere terminato dalla pressione di un digit da parte del chiamante.
90 -|**Tempo massimo di attesa**|Indicare il tempo massimo consentito, espresso in secondi, al chiamante per effettuare la sua scelta vocale. Valore predefinito: 30 secondi.
91 -|**Soglia di affidabilità**|Indicare il livello di affidabilità, tra 0 e 100, da raggiungere per considerare il riconoscimento valido. Valore predefinito: 70.
80 +|**Testo da sintetizzare**|Inserire il testo libero del messaggio da inviare sulla chat.
92 92  
93 -//Scheda Messaggi errore//
82 +//Scheda Transfer Property//
94 94  
95 -[[image:STT_skMessaggiErr.jpg||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:20px 10px"]]
84 +Se è stata selezionata la sorgente //Transfer Property//, viene visualizzata la seguente scheda //Transfer Property//:
96 96  
86 +[[image:wtm_tp.png||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:20px 10px"]]
87 +
97 97  Impostare i campi seguenti:
98 98  
99 99  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
100 100  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
101 -|**Numero massimo di tentativi**|Indicare il numero massimo di tentativi di riconoscimento. Se la fase di riconoscimento non avesse successo, indica il numero di tentativi consentiti al chiamante. Valore predefinito: 2.
102 -|**Messaggio di errore con invito a ripetere**|Indicare il messaggio da riprodurre in caso di mancato riconoscimento.
92 +|**Transfer Property**|Indicare la Transfer Property, il cui contenuto deve essere inviato come testo del messaggio di chat.
103 103  
104 -//Scheda Salvataggio scelta//
94 +//Scheda Call Data//
105 105  
106 -[[image:STT_skSalvataggio.jpg||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:20px 10px"]]
96 +Se è stata selezionata la sorgente //Call Data//, viene visualizzata la seguente scheda //Call Data//:
107 107  
98 +[[image:wtm_cd.png||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:20px 10px"]]
99 +
108 108  Impostare i campi seguenti:
109 109  
110 110  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
111 111  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
112 -|**Nome Transfer Property**|Selezionare la Transfer Property in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
113 -|**CallData**|Indicare il CallData in cui salvare il testo convertito (in caso di riconoscimento con successo) o il digit premuto.
104 +|**Call Data**|Indicare il Call Data, il cui contenuto deve essere inviato come testo del messaggio di chat.
114 114  
115 -==== Port di Uscita ====
106 +//Scheda Comando per SMG//
116 116  
117 -[[image:output_port.jpg||style="margin-bottom:20px; margin-top:20px"]]
108 +Se è stata selezionata la sorgente //Comando per SMG//, viene visualizzata la seguente scheda //Comando//:
118 118  
119 -Le funzionalità dei //Port di Uscita// del blocchetto sono le seguenti :
110 +[[image:wtm_smg.png||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:20px 10px"]]
120 120  
112 +Impostare i campi seguenti:
113 +
121 121  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
122 122  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
123 -|**Failure**|Indicare il servizio successivo da attivare nel caso in cui il motore non riconosca l'audio e non sia premuto dal chiamante alcun digit.
124 -|**Digit Detected**|Indicare il servizio successivo da attivare nel caso in cui il riconoscimento sia interrotto dalla pressione di un digit.
125 -|**Success**|Indicare il servizio successivo da attivare nel caso il riconoscimento abbia successo.
116 +|**Comando**|(((
117 +Selezionare dalla lista il comando da inviare al SocialMediaGateway tra i seguenti:
126 126  
127 -=== **Transfer Property** ===
119 +* **Comando 'HANDLED'**
120 +Segnala al SocialMediaGateway che il messaggio corrente è stato preso in carico dall'operatore. Il comando inviato sarà //"*begin*HANDLED%%%%%%§end§"//.
121 +
122 +* **Comando 'SETCALLDATA'**
123 +Consente di inviare ulteriori Call Data al SocialMediaGateway come parametri. Il formato dei parametri è il seguente: //CallData_1=[Value_1],CallData_2=[Value_2]//. Il comando inviato sarà //"*begin*SETCALLDATA%%%%%%CallData_1=Value_1,CallData_2=Value_2%%%%%%§end§"//.
124 +)))
128 128  
129 -Oltre alla Transfer Property definita in fase di configurazione, il blocchetto crea le due seguenti Transfer Property di sistema che possono essere eventualmente usate dai blocchetti successivi:
126 +//Scheda Keyboard//
130 130  
128 +Da utilizzare solamente per chat Telegram. Nella scheda //Keyboard// è possibile personalizzare una tastiera, selezionare un tastierino numerico o una scelta singola (Sì/No).
129 +
130 +[[image:wtm_key.png||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:20px 10px"]]
131 +
132 +Impostare i campi seguenti:
133 +
131 131  (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
132 132  (% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
133 -|**~_~_RecognizeResult~_~_**|Contiene l’esito della richiesta di riconoscimento.
134 -|**_ASR_Source**|(((
135 -Contiene la sorgente dell’informazione contenuta nella Transfer Property e nel Call Data definiti in configurazione. I valori possibili sono:
136 +|**Predefiniti**|(((
137 +Selezionare dalla lista uno dei seguenti valori:
136 136  
137 -* **“”** (stringa vuota): nel caso in cui non sia riconosciuto l'audio e non sia rilevato alcun digit.
138 -* **“DTMF”**: nel caso sia rilevato un digit che interrompe la fase di riconoscimento. La Transfer Property e il Call Data, eventualmente configurati come variabili di uscita, conterranno il digit ricevuto.
139 -* **“STT”**: nel caso il motore di riconoscimento restituisca un qualsiasi valore. La Transfer Property e il Call Data, eventualmente configurati come variabili di uscita, conterranno il testo riconosciuto.
139 +* **Personalizzata**
140 +Consente di impostare una tastiera in formato tabellare. Indicare il numero di righe e colonne e digitare il testo che si vuole visualizzare nella chat.
141 +\\[[image:wtm_keypers.png||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:20px 10px"]]
142 +
143 +
144 +* **Numerica**
145 +Consente di impostare un tastierino numerico predefinito.
146 +\\[[image:wtm_keynum.png||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:20px 10px"]]
147 +\\
148 +* **Sì/No**
149 +Consente di impostare una tastiera con i soli valori //Sì// e //No//.
150 +\\[[image:wtm_keysn.png||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:20px 10px"]]
151 +
140 140  )))
141 141  
154 +==== Port di Uscita ====
155 +
156 +[[image:wtm_po.png]]
157 +
158 +La funzionalità del //Port di Uscita// del blocchetto prevede solamente il seguente parametro:
159 +
160 +(% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
161 +(% style="background-color:#f0f0f0;" %)|(% style="width:200px" %)**Parametri**|**Descrizione**
162 +|**Out**|Port di uscita predefinito.
163 +
164 +
165 +
166 +
167 +
142 142  
wtm_cd.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +11.9 KB
Content
wtm_key.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +13.9 KB
Content
wtm_keynum.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +4.7 KB
Content
wtm_keypers.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +4.2 KB
Content
wtm_keysn.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +3.7 KB
Content
wtm_po.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +2.1 KB
Content
wtm_smg.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +12.9 KB
Content
wtm_tp.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.administrator
Size
... ... @@ -1,0 +1,1 @@
1 +13.6 KB
Content