Wiki source code of 04 - Diramazione Flusso


Show last authors
1 (% class="box infomessage" style="width:225px; padding: 5px; font-family:verdana; font-size:12px; color: #04ace3; background-color: #fafbfc;" %)
2 (((
3 [[image:acrobat-logo.png]] [[Scarica la pagina come pdf>>https://wiki.ifmgroup.it/bin/export/ifmhelpplatform/MessengerServiziBase/DiramazioneFlusso/?format=pdf||rel="noopener noreferrer" target="new"]]
4 )))
5
6 {{box cssClass="floatinginfobox" width="300px" title="**Sommario**"}}
7 {{toc start="2" depth="3"/}}
8 {{/box}}
9
10 (% class="box errormessage" %)
11 (((
12 **ATTENZIONE**: i caratteri **cancelletto** (#) e **dollaro** ($) sono considerati caratteri speciali in quanto definiscono i calldata e le transfer property. Se è necessario inserire uno di questi caratteri, in un qualsiasi campo, occorre specificarli in coppia, ad esempio "~#~#" oppure "$$".
13 )))
14
15
16 == DistributeCall (CDistributeCall) ==
17
18 Il blocchetto //DistributeCall// permette di distribuire le chiamate tra i servizi successivi con percentuali prefissate.
19
20 [[image:Blocchetto_DistributeCall_01.png||height="453" 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" width="350"]]
21
22
23 **Parametri di Configurazione**
24
25 L'utente può utilizzare i tasti //Nuovo//, //Modifica// e //Cancella// per definire le regole di instradamento per i servizi. La somma delle percentuali indicate deve essere sempre 100%.
26
27 [[image:Blocchetto_DistributeCall_02.png||height="453" 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" width="350"]]
28
29 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
30 (% style="background-color:#f0f0f0" %)|=(% style="width: 200px;" %)**Parametro**|**Descrizione**
31 |**Percentuale**|Selezionare dalla lista oppure inserire la percentuale di chiamate che devono essere trasferite a un servizio.
32 |**Vai a port**|Selezionare dalla lista oppure inserire il port di uscita dal blocchetto che viene creato per la fascia percentuale indicata.
33
34 == LoopCounter (CLoopCounter) ==
35
36 Il blocchetto //LoopCounter// permette di eseguire una serie di ripetizioni di uno o più servizi. Se usato, deve essere inserito nella campagna in due punti: il primo crea ed inizializza il contatore di ripetizioni, quindi attiva il primo servizio del ciclo; dopo l'ultimo servizio del ciclo occorre inserire un altro CLoopConter che incrementa il contatore e, in base al suo valore, riattiva il primo servizio del ciclo o prosegue con i servizi.
37
38
39 **Parametri di Configurazione**
40
41 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
42 (% style="background-color:#f0f0f0" %)|=(% style="width: 200px;" %)**Parametro**|**Descrizione**
43 |**Nome contatore**|Nome del contatore da creare o da incrementare. Il tasto //Assegna Valore// consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un Call Data.
44 |**Inizializza/Incrementa**|Tipo d'operazione da eseguire sul contatore: creazione o incremento.
45 |**Valore di partenza**|Valore da assegnare al contatore al momento della creazione.
46 |**Valore limite**|Limite massimo raggiungibile dal contatore.
47 |**Passo di incremento**|Valore di cui incrementare il contatore ad ogni ciclo.
48 |**Su inizializzazione**|//Solo configurando il Servizio tramite Messenger Configurator//. Servizio da attivare dopo la creazione e inizializzazione del contatore. Il tasto //Selezione// consente di recuperare il servizio dall'elenco dei servizi, tramite Transfer Property oppure Call Data.
49 |**Su incremento**|//Solo configurando il Servizio tramite Messenger Configurator//. Servizio da attivare dopo l'incremento del contatore nel caso non si sia raggiunto il limite. Il tasto //Selezione// consente di recuperare il servizio dall'elenco dei servizi, tramite Transfer Property oppure Call Data.
50 |**Su raggiungimento limite**|//Solo configurando il Servizio tramite MessengerConfigurator.// Servizio da attivare dopo l'incremento del contatore nel caso si sia raggiunto il limite previsto. Il tasto //Selezione// consente di recuperare il servizio dall'elenco dei servizi, tramite Transfer Property oppure Call Data.
51
52 == Menu (CMenu) ==
53
54 Il blocchetto //Menu// presenta un menu di opzioni e, in base alla scelta del chiamante, attiva il servizio associato. Permette di configurare la sequenza di messaggi (file WAV/AVI, numeri, date, ecc.) da riprodurre all'utente per invitarlo a segnalare al sistema la sua scelta. E' inoltre possibile, nel caso di nessuna scelta o di scelta errata, configurare un servizio predefinito.
55
56
57 **Parametri di Configurazione**
58
59 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
60 (% style="background-color:#f0f0f0" %)|=(% style="width: 200px;" %)**Parametro**|**Descrizione**
61 |**Lista dei messaggi**|(((
62 L'utente, tramite i bottoni **Nuovo**, **Modifica**, **Cancella **e le frecce, deve indicare la lista dei messaggi. Per ogni singolo messaggio da riprodurre, occorre selezionarne il tipo da aggiungere alla lista:
63
64 * File WAV o AVI
65 * Numero
66 * Importo
67 * Sequenza di caratteri
68 * Lista formattata
69 * Data/Ora
70 * Data/Ora corrente
71 * Data/Ora di un file
72 * Ordinale
73
74 Per ogni tipo, oltre alla selezione o al valore, occorre indicare ulteriori parametri specifici, come formato di data e ora, sequenze, numero di decimali, ecc.
75 Inotre è possibile indicare eventuali parametri specifici per la lingua corrente.
76
77 (% class="box errormessage" %)
78 (((
79 Questo parametro gestisce esclusivamente l'italiano e lo spagnolo. Per entrambe le lingue, se questo parametro è impostato con "F", gli ordinali sono riprodotti al femminile, in tutti gli altri casi al maschile. Solo per lo spagnolo, se questo parametro è impostato con "F", il numero 1 è riprodotto al femminile, altrimenti al maschile. Solo per l'italiano, se questo parametro è impostato con "E", l'importo è riprodotto in EURO altrimenti in Lire.
80 )))
81 )))
82 |**Numero massimo di Digit da acquisire**|Numero massimo di digit che l'utente può inserire. Il tasto //Assegna Valore //consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un Call Data.
83 |**Tempo massimo per l'inserimento**|Tempo massimo che il sistema attende per l'inserimento dei digit. Il tasto //Assegna Valore //consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un Call Data.
84 |**Eventuale Digit di fine acquisizione**|Eventuale digit che termina la sequenza inserita indipendentemente dal tempo massimo, normalmente # (cancelletto) oppure * (asterisco).
85 |**Numero tentativi se selezione errata**|Indica il numero di tentativi che l'utente ha a disposizione per effettuare una scelta valida (se 0 termina al primo errore).
86 |**Ignora eventuali acquisizioni del Digit 1 (DPD)**|Questo parametro permette di istruire il sistema in modo tale che ignori, durante la scelta di menu, l'acquisizione di eventuali Digit "1". Questo è utile nel caso sia abilitato il riconoscimento di cifre decadiche; infatti, le schede Dialogic con tale caratteristica hanno una certa percentuale di errore e, in presenza di linee "disturbate", possono riconoscere degli "1" inesistenti.
87 |**Disabilita cut-off del messaggio di menu**|Se selezionata, questa opzione rende il messaggio (o i messaggi) del menu non interrompibili: l'utente può effettuare la sua scelta solo alla fine della riproduzione.
88 |**Servizio da attivare a seconda della scelta dal chiamante**|(((
89 Utilizzando i tasti //Nuovo//, //Modifica// e //Cancella//, indicare la sequenza che l'utente deve digitare per attivare l'opzione e il servizio da attivare. Le due opzioni richieste sono descritte di seguito.
90 )))
91 |**Sequenza di digit**|Indicare la sequenza che l'utente deve digitare per attivare l'opzione. Se s'indica come digit il carattere "-", il servizio associato è quello predefinito attivato nel caso che nessuna delle altre condizioni sia soddisfatta al termine delle ripetizioni previste.
92 |**Servizio attivato**|Indicare il nome del servizio da attivare per la particolare sequenza (//solo configurando il Servizio tramite Messenger Configurator//).
93 |**Abilitazione salvataggio scelta**|Se selezionato, abilita il salvataggio della scelta dell'utente in una Transfer Property.
94 |**Nome Transfer Property**|Nome della Transfer Property in cui salvare la scelta.
95 |**Aggiunegere all'attuale valore**|Se selezionato, la scelta dell'utente viene accodata, separata da virgola, all'attuale contenuto della Transfer Property. Questa opzione permette di usare una Transfer Property per memorizzare tutta la sequenza di scelta dell'utente.
96
97 == TimeSwitch (CTimeSwitch) ==
98
99 Il blocchetto //TimeSwitch// permette di selezionare il servizio successivo da attivare in base all'ora e al giorno della settimana. Nel caso che l'ora attuale non soddisfi alcuna delle regole configurate, viene attivato un servizio predefinito. Per la gestione delle festività questo servizio permette di definire una lista di giorni eccezionali e associare a ciascuno di essi un particolare giorno della settimana (ad esempio le //feste patronali//). In tali giorni il sistema ignora il giorno reale della settimana, ma si comporta come se fosse una festività.
100
101
102 **Parametri di Configurazione**
103
104 L'utente può utilizzare i tasti //Nuovo//, //Modifica// e //Cancella// per definire i periodi e le fascie orarie e associarli al servizio opportuno.
105
106 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
107 (% style="background-color:#f0f0f0" %)|=(% style="width: 200px;" %)Parametro|=Descrizione
108 |**Nome Periodo**|Inserire il nome logico da assegnare alla fascia, deve essere univoco.
109 |**Dalle**|Indicare l'ora di inizio della fascia oraria, espressa nel formato HH:MM.
110 |**Alle**|(((
111 Indicare l'ora di fine della fascia oraria, espressa nel formato HH:MM. 
112
113 (% class="box errormessage" %)
114 (((
115 **Nota:** per indicare mezzanotte come orario finale, occorre specificare "24:00" (e NON "23:59").
116 )))
117 )))
118 |**Servizio**|//Solo configurando il Servizio tramite Messenger Configurator//. Selezionare dalla lista il servizio da attivare quando l'ora corrente soddisfa le condizioni.
119 |**Per i giorni di**|Giorni della settimana a cui associare la fascia oraria.
120 |**Festività associata al giorno della settimana**|L'utente può utilizzare i tasti //Nuovo//, //Modifica //e //Cancella// per associare una ricorrenza al giorno della settimana o definirla //festiva// o //prefestiva//. Per ogni giorno eccezionale occorre indicarne la data (giorno, mese, anno) e come deve essere considerato (giorno della settimana, festivo o prefestivo). Se la festività è ricorrente, allora è possibile specificare l'anno con le "X", ad esempio //25/12/XXXX//, e il sistema lo accetterà per tutti gli anni futuri.
121 |**Nome Servizio successivo**|//Solo configurando il Servizio tramite Messenger Configurator.// Servizio successivo da attivare. Il tasto //Selezione //consente di recuperare il servizio dall'elenco dei servizi, tramite Transfer Property oppure CallData.
122
123 == UserSwitch (CUserSwitch) ==
124
125 Il blocchetto //UserSwitch// consente di gestire il flusso di una chiamata, permettendo di definire regole di instradamento verso il port appropriato in base al valore contenuto in una Transfer Property, un Call Data, o all'interno di un campo di un file INI. Questo strumento versatile offre, inoltre, la flessibilità di instradare le chiamate, utilizzando anche dati provenienti da un database Access o da un database remoto tramite ODBC.
126
127
128 **Scheda Tipo Oggetto**
129
130 Occorre selezionare il tipo di oggetto su cui eseguire il controllo per la selezione del percorso da seguire. Può essere: un Call Data, una Transfer Property, il campo di un database Access o via ODBC, un parametro definito in un file .INI.
131
132 [[image:UserSwitch01.png||height="522" 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" width="400"]]
133
134
135 In base al tipo oggetto selezionato il blocchetto mostra una scheda differente in cui indicare i dati di riferimento del tipo.
136
137
138 **Scheda Tipo di Dato**
139
140 Nella scheda //Tipo di Dato// occorre indicare il tipo di dato da utilizzare per la regola di instradamento.
141
142 [[image:attach:UserSwitch03.png||height="522" 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" width="400"]]
143
144 Occorre indicare:
145
146 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
147 (% style="background-color:#f0f0f0" %)|=(% style="width: 200px;" %)**Parametro**|**Descrizione**
148 |**Tipo del dato**|(((
149 Tipologia del dato sui cui prendere la decisione. Può essere:
150
151 * Un valore numerico
152 * Una stringa di testo
153 * Una data e/o ora
154 * Un modello (operatore LIKE).
155 )))
156 |**Messaggio di attesa**|Se l'accesso al database risulta lento, è possibile indicare un messaggio di attesa che viene riprodotto in modo asincrono durante l'accesso ai dati.
157
158 **Scheda Associazioni**
159
160 Nella scheda //Associazioni// occorre indicare il port di output da attivare in base al valore dell'oggetto indicato. È possibile indicare un intervallo di valori (//xxx=yyy//), un insieme di valori (//xx;yy;zz//), un singolo valore o un caso predefinito ("-") se non è soddisfatta alcuna condizione. Utilizzare i tasti //Nuovo//, //Modifica// e //Cancella// per indicare una lista di coppie //valore-port// per la selezione delle regole di instradamento.
161
162 [[image:attach:UserSwitch04.png||height="522" 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" width="400"]]
163
164 Specificare:
165
166 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
167 (% style="background-color:#f0f0f0" %)|=(% style="width: 200px;" %)**Parametro**|**Descrizione**
168 |**Valore**|(((
169 Indicare il valore a cui associare il port da attivare. L'utente può utilizzare le seguenti modalità:
170
171 * //Singolo valore//.
172 * //Intervallo di valori//: nella forma (% style="font-family:Courier New,Courier,monospace" %)"1=100"(%%), il port corrispondente viene attivato se l'oggetto indicato ha un valore compreso tra 1 e 100, limiti compresi.
173 * //Sequenza di valori//: nella forma(% style="font-family:Courier New,Courier,monospace" %) "1;3;5"(%%), il port corrispondente viene attivato se l'oggetto indicato vale 1, 3 oppure 5.
174 * //Limite superiore//: nella forma (% style="font-family:Courier New,Courier,monospace" %)"<100"(%%), il port corrispondente viene attivato se l'oggetto indicato ha un valore minore di 100.
175 * //Limite inferiore//: nella forma(% style="font-family:Courier New,Courier,monospace" %) ">100"(%%), il port corrispondente viene attivato se l'oggetto indicato ha un valore maggiore di 100.
176 * //Default//: nella forma (% style="font-family:Courier New,Courier,monospace" %)"-"(%%), il port corrispondente viene attivato se nessuna delle condizione precedenti è soddisfatta. Deve essere indicata come ultima condizione.
177
178 In caso di date, è possibile specificare la data odierna con la parola chiave (% style="font-family:Courier New,Courier,monospace" %)"NOW"(%%). Possono essere definite anche delle regole del tipo (% style="font-family:Courier New,Courier,monospace" %)"<NOW"(%%) (il port associato viene attivato solo se la data dell'oggetto indicato è antecedente alla data odierna), (% style="font-family:Courier New,Courier,monospace" %)">NOW+5"(%%) (il port associato viene attivato solo se la data dell'oggetto indicato è successiva di 5 giorni rispetto alla data odierna, analogamente per il segno -) e tutte le possibili combinazioni. 
179
180 (% class="box infomessage" %)
181 (((
182 **Nota** : le condizioni devono essere scritte senza spazi.
183 )))
184
185 Il tasto //Assegna Valore// consente di recuperare il valore indicato da una costante, oppure da una transfer property o un Call Data.
186 )))
187 |**Port di output**|Selezionare dall'elenco il port di output verso cui il flusso della chiamata deve essere instradato.
188
189 **Scheda Call Data**
190
191 Se nella scheda //Tipo Oggetto// è stato selezionato il tipo //Call Data//, viene mostrata la scheda //Call Data//. Occorre inserire il nome del Call Data sul cui valore il sistema provvederà a eseguire la regola per il percorso da seguire.
192
193
194 **Scheda Transfer Property**
195
196 Se nella scheda //Tipo Oggetto// è stato selezionato il tipo //Transfer Property//, viene mostrata la scheda //Transfer Property//. Occorre in cui inserire il nome della transfer property sul cui valore il sistema provvederà a eseguire la regola per il percorso da seguire.
197
198
199 **Scheda MDB**
200
201 Se nella scheda //Tipo Oggetto// è stato selezionato il tipo //Campo di un DB Access//, viene mostrata la scheda //MDB//. Occorre indicare il nome del file MDB, di una sua tabella e di un suo campo sul cui valore il sistema provvederà a eseguire la regola per il percorso da seguire. È possibile impostare anche un criterio di ricerca sui record, indicando il campo su cui eseguire la ricerca e il valore ricercato.
202
203 [[image:attach:UserSwitch05.png||height="522" 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" width="400"]]
204
205 Specificare:
206
207 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
208 (% style="background-color:#f0f0f0" %)|=(% style="width: 200px;" %)**Parametro**|**Descrizione**
209 |**Nome MDB**|Nome e percorso del file MDB. Il tasto //Assegna Valore// consente di recuperare il valore da una costante, oppure da una Transfer Property o un Call Data.
210 |**Nome tabella**|Nome della tabella del file MDB. Il tasto //Assegna Valore// consente di recuperare il valore da una costante, oppure da una Transfer Property o un Call Data.
211 |**Nome campo**|Nome del campo sul cui valore prendere la decisione. Il tasto //Assegna Valore// consente di recuperare il valore da una costante, oppure da una Transfer Property o un Call Data.
212 |**Nome campo su cui fare la ricerca**|Nome del campo su cui ricercare il record da considerare. Il tasto //Assegna Valore// consente di recuperare il valore da una costante, oppure da una Transfer Property o un Call Data.
213 |**Valore da ricercare**|Valore da ricercare. Il tasto //Assegna Valore// consente di recuperare il valore da una costante, oppure da una Transfer Property o un Call Data.
214
215 **Campo di un DB via ODBC**
216
217 Se nella scheda //Tipo Oggetto// è stato selezionato il tipo //Campo di un DB via ODBC//, viene mostrata la scheda //ODBC//. Occorre indicare il nome del dsn ODBC, di una sua tabella e di un suo campo sul cui valore il sistema provvederà a eseguire la regola per il percorso da seguire. È possibile impostare anche un criterio di ricerca sui record, indicando il campo su cui eseguire la ricerca e il valore ricercato.
218
219
220 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
221 (% style="background-color:#f0f0f0" %)|=(% style="width: 200px;" %)**Parametro**|**Descrizione**
222 |**DSN**|Nome con cui è definito il database in ODBC. Il tasto //Assegna Valore// consente di recuperare il valore da una costante, oppure da una Transfer Property o un Call Data.
223 |**Utente / Password**|Nome utente e password con cui accedere al database. Il tasto //Assegna Valore// consente di recuperare il valore da una costante, oppure da una Transfer Property o un Call Data.
224 |**Tabella**|Nome della tabella del file MDB. Il tasto //Assegna Valore// consente di recuperare il valore da una costante, oppure da una Transfer Property o un Call Data.
225 |**Campo**|Nome del campo sul cui valore prendere la decisione. Il tasto //Assegna Valore// consente di recuperare il valore da una costante, oppure da una Transfer Property o un Call Data.
226 |**Nome campo su cui fare la ricerca**|Nome del campo su cui ricercare il record da considerare. Il tasto //Assegna Valore// consente di recuperare il valore da una costante, oppure da una Transfer Property o un Call Data.
227 |**Valore da ricercare**|Valore da ricercare. Il tasto //Assegna Valore// consente di recuperare il valore da una costante, oppure da una Transfer Property o un Call Data.
228
229 **Entry di un file INI**
230
231 Se nella scheda //Tipo Oggetto// è stato selezionato il tipo //Entry di un file INI//, viene mostrata la scheda //File INI//. Occorre indicare il nome del file .INI, della sua sezione e dell'elemento il cui valore il sistema provvederà a eseguire la regola per il percorso da seguire.
232
233 [[image:attach:UserSwitch06.png||height="522" 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" width="400"]]
234
235 Specificare:
236
237 (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %)
238 (% style="background-color:#f0f0f0" %)|=(% style="width: 200px;" %)**Parametro**|**Descrizione**
239 |**Nome file INI**|Nome e percorso del file INI. Il tasto //Assegna Valore// consente di recuperare il nome da una costante, oppure da una Transfer Property o un Call Data.
240 |**Nome Sezione**|Nome della sezione del file INI. Il tasto //Assegna Valore// consente di recuperare il valore da una costante, oppure da una Transfer Property o un Call Data.
241 |**Nome Entry**|Nome dell'elemento il cui valore deve essere verificato per impostare il percorso da seguire. Il tasto //Assegna Valore// consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un Call Data.
242
243