Last modified by administrator BDP on 2024/11/06 16:38

From version 7.1
edited by administrator BDP
on 2017/12/14 17:52
Change comment: There is no comment for this version
To version 10.2
edited by administrator BDP
on 2017/12/21 11:13
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -05 - Operazioni su Transfer Properties
1 +05 - Operazioni su Transfer Property
Content
... ... @@ -4,7 +4,7 @@
4 4  
5 5  == PropertiesManager (CPropertiesManager) ==
6 6  
7 -Permette di manipolare in vari modi il contenuto di una [[Transfer Property>>path:../input/hashphones.messenger-configurator-servizi#TransferProperties]]. Le operazioni disponibili sono le seguenti:
7 +Permette di manipolare in vari modi il contenuto di una [[Transfer Property>>doc:MessengerConfigurator.TransferProperty.WebHome]]. Le operazioni disponibili sono le seguenti:
8 8  
9 9  * **Conversione di formato** (0 - Custom format): permette di formattare il valore contenuto nella Transfer Property sorgente. Il formato finale del dato, salvato nella Transfer Property destinazione è dato dal parametro contenente la regola di formattazione. Questa è la composizione di un insieme differente di parti base a seconda dal tipo di dato sorgente. Gli elementi base ammessi sono, a seconda del tipo del dato sorgente, i seguenti (vedere anche [[esempi di conversione>>||anchor="HEsempidiconversione"]] in fondo alla sezione):
10 10  
... ... @@ -91,122 +91,121 @@
91 91  
92 92  **Parametri di Configurazione**
93 93  
94 -* Tipo d'operazione: indica cioè se si vogliono assegnare dei nuovi valori a delle Transfer Property oppure salvare Il loro contenuto.
95 -* Tipo d'oggetto: indica la sorgente dei dati da caricare nelle Transfer Property, o la destinazione del loro contenuto.
96 -** Se il tipo d'oggetto è un MDB Access occorre indicare:
97 -*** Il nome del file MDB.
98 -*** Criterio di ricerca del record cioè la Query in linguaggio SQL che il sistema deve eseguire sul database indicato.
99 -** Se il tipo d'oggetto è un database acceduto via ODBC occorre indicare:
100 -*** Il suo DSN: nome con cui è definito nell'ODBC.
101 -*** Eventuale nome utente e password d'accesso.
102 -*** Criterio di ricerca del record cioè la Query in linguaggio SQL che il sistema deve eseguire sul database indicato.
103 -* Eventuale lista delle associazioni Transfer Property – nome del campo.
104 -* Servizio successivo (//solo configurando il Servizio tramite Messenger Configurator//): nome servizio successivo da attivare.
105 -* Messaggio di attesa: nel caso di accesso a database lenti, ad esempio db remoti connessi via ODBC, è possibile indicare un messaggio di attesa che viene riprodotto in modo asincrono durante l'accesso ai dati. Il servizio termina quando sia l'accesso ai dati che la riproduzione del messaggio sono terminati; è quindi opportuno valutarne accuratamente la lunghezza.
94 +|=(% style="width: 200px;" %)Parametro|**Descrizione**
95 +|=(% scope="col" style="width: 200px;" %)Tipo operazione|(((
96 +Specificare se il sistema deve assegnare un nuovo valore alle Transfer Property, salvare il loro contenuto oppure eseguire solo una query SQL. Selezionare una delle seguenti operazioni:
106 106  
107 -== SetStoreProperty (CSetStoreProperty) ==
98 +* //Carica valore da//
99 +* //Salva valore in//
100 +* //Esegui Query (Execute)//
101 +)))
102 +|**Eventuale messaggio di attesa per accesso al Db**|In caso di accesso a database lenti, ad esempio remoti connessi via ODBC, è possibile indicare un messaggio di attesa che viene riprodotto in modo asincrono durante l'accesso ai dati. Il servizio termina quando sia l'accesso ai dati che la riproduzione del messaggio sono terminati. E' quindi opportuno valutarne accuratamente la lunghezza. Il tasto //Assegna Valore// consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un Call Data.
103 +|**Operazione su DB Access o altro tipo**|(((
104 +Specificare se l'operazione deve essere eseguita su un database Access o su un altro tipo via ODBC.
108 108  
109 -Permette di assegnare un nuovo valore ad una o più Transfer Property, o di salvare il loro contenuto. La sorgente o la destinazione dei dati può essere:
106 +* Se si seleziona //Campo di un db Access// occorre indicare:
107 +** Il nome del file MDB. Il tasto //Assegna Valore// consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un Call Data.
108 +** Query SQL che il sistema deve eseguire sul database indicato.
109 +* Se si seleziona //Campo di un db via ODBC// occorre indicare:
110 +** DSN: nome con cui è definito nell'ODBC. Il tasto //Assegna Valore// consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un Call Data.
111 +** Eventuale nome utente e password di accesso. Il tasto //Assegna Valore// consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un Call Data.
112 +** Query in linguaggio SQL che il sistema deve eseguire sul database indicato. Il tasto //Assegna Valore// consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un Call Data.
113 +)))
114 +|**Elenco Transfer Property**|Utilizzando i tasti //Nuovo//, //Modifica// e //Cancella//, indicare l'elenco delle Transfer Property il valore da associare o il campo in cui il suo contenuto deve essere salvato.
115 +|**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 Call Data.
116 +|**Nome Servizio successivo in caso di errore**|//Solo configurando il Servizio tramite Messenger Configurator.// Servizio successivo da attivare in caso di errore durante l'operazione. Il tasto //Selezione //consente di recuperare il servizio dall'elenco dei servizi, tramite Transfer Property oppure Call Data.
117 +| |
110 110  
111 -* una costante (solo per il caricamento)
112 -* un Call Data
113 -* un'altra Transfer Property
114 -* un campo di un Database Access
115 -* una voce di un file INI
116 -* un campo di un database remoto a cui si accede tramite ODBC.
119 +== SetStoreProperty (CSetStoreProperty) ==
117 117  
118 -I parametri da configurare variano in base al tipo d'operazione selezionata (caricamento o salvataggio) e dal tipo di sorgente/destinazione del dato.
121 +Permette assegnare un nuovo valore ad una o più Transfer Property, o di salvare il loro contenuto. La sorgente o la destinazione dei dati può essere: una costante (solo per il caricamento), un call data, un'altra Transfer Property, un campo di un Database Access, una voce di un file INI oppure un campo di un database remoto a cui si accede tramite ODBC.
119 119  
123 +I parametri da configurare variano in base al tipo di operazione selezionata (caricamento o salvataggio) e dal tipo di sorgente/destinazione del dato.
120 120  
125 +
121 121  **Parametri di Configurazione**
122 122  
123 -* Nella prima finestra di dialogo dell'assistente di configurazione selezionare tra le due opzioni **Carica valore da** e **Salvare valore in**.
124 -* (Opzionale) Indicare nel campo sottostante il Messaggio di attesa. **Nota**: nel caso di accesso a database lenti, ad esempio db remoti connessi via ODBC, è possibile indicare un messaggio di attesa che viene riprodotto in modo asincrono durante l'accesso ai dati. Il servizio termina quando sia l'accesso ai dati che la riproduzione del messaggio sono terminati; è quindi opportuno valutarne accuratamente la lunghezza.
125 -** Fare clic sul pulsante **Browse**.
126 -** Nella finestra //Assegna valore// selezionare il tipo di valore da assegnare e procedere a seconda del tipo scelto:
127 -*** //Costante//: inserire il nome della costante oppure fare clic sul pulsante **Browse** per selezionare il file .wav da riprodurre.
128 -** Fare clic su **Save**.
129 -*** //Transfer Property//:
130 -**** Scegliere il nome della Transfer Property dall'elenco a discesa.
131 -*** //Call Data//:​​​​​
132 -**** Inserire il nome della Call Data.
133 -** Fare clic su **OK**. Il valore indicato viene inserito automaticamente nel campo.
134 -* Fare clic su **Avanti**.
135 -* Selezionare il tipo di oggetto dall'elenco ed effettuare l'associazione Property – Valore. **Nota**: Se si seleziona tra gli oggetti //Costante//, //Call Data// o //Transfer Property// proseguire dal punto successivo. Se si seleziona uno tra gli oggetti seguenti indicare i seguenti parametri aggiuntivi (facendo clic su **Avanti**):
128 +|=(% style="width: 200px;" %)(((
129 +**Parametro**
130 +)))|(% style="width:936px" %)**Descrizione**
131 +|(% style="width:210px" %)**Tipo di operazione**|(% style="width:936px" %)(((
132 +Specificare se il sistema deve assegnare un nuovo valore alle Transfer Property, oppure salvare il loro contenuto. Selezionare una delle seguenti operazioni:
136 136  
137 -(% style="margin-left:40px" %)
138 -|**Oggetto**|**Parametri**
139 -|**Campo di un DB Access**|Nome del file MDB.
140 -| |Nome della tabella.
141 -| |Se si sta salvando il contenuto delle Transfer Property nel MDB si può indicare al sistema di creare un nuovo record nella tabella.
142 -| |Criterio di ricerca del record: nome del campo su cui fare la ricerca, valore da ricercare e tipo del dato.
143 -|**Campo di un DB via ODBC**|Il suo DSN: nome con cui è definito nell'ODBC.
144 -| |Eventuale nome utente e password d'accesso.
145 -| |Il nome della tabella.
146 -| |Se si sta salvando il contenuto delle Transfer Property nel database si può indicare al sistema di creare un nuovo record nella tabella.
147 -| |Criterio di ricerca del record: nome del campo su cui fare la ricerca, valore da ricercare e tipo del dato.
148 -|**Entry in un file INI**|Nome del file, completo di percorso.
149 -| |Nome della sezione.
150 -| |
134 +* //Carica valore da//
135 +* //Salva valore in//
136 +)))
137 +|(% style="width:210px" %)**Eventuale messaggio di attesa per accesso al Db**|(% style="width:936px" %)In caso di accesso a database lenti, ad esempio remoti connessi via ODBC, è possibile indicare un messaggio di attesa che viene riprodotto in modo asincrono durante l'accesso ai dati. Il servizio termina quando sia l'accesso ai dati che la riproduzione del messaggio sono terminati. E' quindi opportuno valutarne accuratamente la lunghezza. Il tasto //Assegna Valore// consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un Call Data.
138 +|(% style="width:210px" %)**Tipo di oggetto**|(% style="width:936px" %)(((
139 +Specificare il tipo di oggetto da cui caricare i valori da assegnare alle Transfer Property o in cui salvare le Transfer Property, tra i seguenti:
151 151  
152 -* Fare clic su **Avanti**.
153 -* Inserire una nuova associazione Property-Valore facendo clic su **Nuovo**. Oppure selezionare una Transfer Property dall'elenco e fare clic su **Modifica**.
154 -* Nella finestra //Associa //selezionare una Transfer Property dall'elenco ed inserire un Valore nel campo sottostante dove valore indica, a seconda del tipo dell'oggetto scelto come sorgente/destinazione nella finestra di dialogo precedente:
141 +* Costante (solo per il caricamento)
142 +* Call Data
143 +* Transfer Property
144 +* Campo di un db Access
145 +* Campo di un db via ODBC
146 +* Entry di un file INI.
147 +)))
148 +|(% style="width:210px" %)**Transfer Property e Valore**|(% style="width:936px" %)(((
149 +Utilizzare i tasti //Nuovo//, //Modifica// e //Cancella// per indicare le Transfer Property e il tipo di oggetto da associare.
155 155  
156 -(% style="margin-left:40px" %)
157 -|=(% style="width: 200px;" %)**Tipo oggetto**|**Descrizione**
158 -|**Costante**|Inserire valore da assegnare alla Transfer Property
159 -|Oppure|
160 -|**[NOW]**|Data ed ora corrente
161 -|**[EXTENSION]**|Il numero di telefono dell'agente sintetico
162 -|**[CHNUM]**|Il numero di canale dell'agente sintetico
163 -|**[LOGINNAME]**|Il nome di login dell'agente sintetico (ad esempio "IVR0001")
164 -|**Call Data**|Nome del Call Data il cui valore deve essere assegnato alla Transfer Property.
165 -|**Transfer Property**|Nome della Transfer Property.
166 -|**Campo di un DB Access**|Nome del campo.
167 -|**Campo di un DB via ODBC**|Nome del campo.
168 -|**Entry in un file INI**|Chiave del valore.
169 -| |
151 +In caso di __caricamento__ da costante, Transfer Property o Call Data, selezionare la Transfer Property e indicare il nome della costante, Transfer Property o Call Data da cui caricare il valore.
170 170  
171 -* Fare clic su **OK**.
172 -* Fare clic su **Avanti**.
173 -* (//Solo configurando il Servizio tramite Messenger Configurator//) Indicare il nome del Servizio successivo da attivare facendo clic sul pulsante **Browse**.
174 -* Selezionare il Servizio:
153 +In caso di __salvataggio__ su Call Data o Transfer Property (non su costante), selezionare la Transfer Property e indicare il nome del Call Data o altra Transfer Property su cui salvare il valore.
175 175  
176 -(% style="margin-left:40px" %)
177 -|=(% style="width: 200px;" %)**Per**|**E**
178 -|**Nome**|Selezionarlo dall'elenco a discesa(((
179 -
155 +In caso di caricamento o salvataggio impostando i tipi di oggetto //Campo di un db Access//, //Campo di un db via ODBC// o //Entry di un file INI//, occorre prima indicare i database o il file INI utilizzati (vedere parametri seguenti).
180 180  )))
181 -|**Transfer Property**|Selezionarlo dall'elenco a discesa(((
182 -
157 +|(% style="width:210px" %)**DB Access**|(% style="width:936px" %)Se, come tipo di oggetto, è stato selezionato //Campo di un db Access//, indicare il nome del file MDB e della sua tabella dai cui campi devono essere prelevati i valori da assegnare alla Transfer Property (in fase di caricamento) o i cui campi devono essere usati per salvare le Transfer Property (in fase di salvataggio). Il tasto //Assegna Valore//, accanto ai campi,// //consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un Call Data.
158 +|(% style="text-align:right; width:210px" %)**Nome MDB**|(% style="width:936px" %)Nome del file MDB.
159 +|(% style="text-align:right; width:210px" %)**Nome Tabella**|(% style="width:936px" %)Nome della tabella.
160 +|(% style="text-align:right; width:210px" %)**Creare un nuovo record
161 +nel DataBase**|(% style="width:936px" %)Se si sta salvando il contenuto delle Transfer Property nel MDB, si può indicare al sistema di creare un nuovo record nella tabella.
162 +|(% style="text-align:right; width:210px" %)**Criterio di ricerca record**|(% style="width:936px" %)Indicare il nome del campo, il valore o il tipo di dato (numerico, testo, o data/ora) su cui fare la ricerca.
163 +|(% style="width:210px" %)** DB via ODBC**|(% style="width:936px" %)Se, come tipo di oggetto, è stato selezionato //Campo di un db via ODBC//, inserire il DSN, utente e password, nome della tabella dai cui campi devono essere prelevati i valori da assegnare alla Transfer Property (in fase di caricamento) o i cui campi devono essere usati per salvare le Transfer Property (in fase di salvataggio). Il tasto //Assegna Valore//, accanto ai campi,// //consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un Call Data.
164 +|(% style="text-align:right; width:210px" %)**DSN**|(% style="width:936px" %)Nome con cui il database è definito nell'ODBC.
165 +|(% style="text-align:right; width:210px" %)**Utente / Password**|(% style="width:936px" %)Eventuale nome utente e password di accesso.
166 +|(% style="text-align:right; width:210px" %)**Tabella**|(% style="width:936px" %)Nome della tabella.
167 +|(% style="text-align:right; width:210px" %)**Creare un nuovo record
168 +nel DataBase**|(% style="width:936px" %)Se si sta salvando il contenuto delle Transfer Property nel database, si può indicare al sistema di creare un nuovo record nella tabella.
169 +|(% style="text-align:right; width:210px" %)**Criterio di ricerca
170 +del record**|(% style="width:936px" %)Indicare il nome del campo, il valore o il tipo di dato (numerico, testo, o data/ora) su cui fare la ricerca.
171 +|(% style="width:210px" %)**Entry in un file INI**|(% style="width:936px" %)(((
172 +Indicare il nome del file INI e della sua section dai cui campi devono essere prelevati i valori da assegnare alle Transfer Property (in fase di caricamento) o i cui campi devono essere usati per salvare le Transfer Property (in fase di salvataggio). Il tasto //Assegna Valore//, accanto ai campi,// //consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un Call Data.
183 183  )))
184 -|**Call Data**|Inserire il nome del Call Data desiderato.
174 +|(% style="width:210px" %)**Nome Servizio successivo**|(% style="width:936px" %)//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 Call Data.
185 185  | |
186 186  
187 -* Fare clic su **OK**.
188 -* Fare clic su **Avanti**.
189 -* Fare clic su **Salva**. **Nota**: un servizio analogo, nel caso di database Access o ODBC, è fornito dalla classe [[CQuerySetStore>>||anchor="HQuerySetStore28CQuerySetStore29"]] che, a differenza di questa, richiede di specificare una query di ricerca (SELECT), espressa in linguaggio SQL, per la selezione del record su cui agire; in questo modo permette di operare su dati suddivisi su più tabelle o con criteri di ricerca articolati.
177 +(% class="box infomessage" %)
178 +(((
179 +**Nota**: un servizio analogo, nel caso di database Access o ODBC, è fornito dalla classe [[CQuerySetStore>>||anchor="HQuerySetStore28CQuerySetStore29"]] che, a differenza di questa, richiede di specificare una query di ricerca (SELECT), espressa in linguaggio SQL, per la selezione del record su cui agire. Questo modo permette di operare su dati suddivisi su più tabelle o con criteri di ricerca articolati.
180 +)))
190 190  
182 +
191 191  == TimeSwitch (CTimeSwitch) ==
192 192  
193 -Permette di selezionare il servizio successivo da attivare in base all'ora ed 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" ed associare a ciascuno di essi un particolare giorno della settimana (ad esempio Domenica). In tali giorni il sistema ignora il reale giorno della settimana, ma si comporta come se fosse realmente Domenica.
185 +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à.
194 194  
195 195  
196 196  **Parametri di Configurazione**
197 197  
198 -Occorre definire il nome del servizio di default e, per ogni fascia oraria configurata:
190 +L'utente può utilizzare i tasti //Nuovo//, //Modifica //e //Cancella// per definire i periodi e le fascie orarie e associarli al servizio opportuno.
199 199  
200 200  (% style="margin-top:20px" %)
201 201  |=(% style="width: 200px;" %)Parametro|=Descrizione
202 -|**Nome**|Nome logico da assegnare alla fascia, deve essere univoco.
203 -|**Dalle**|Ora di inizio della fascia oraria, espressa nel formato HH:MM.
204 -|**Alle**|Ora di fine della fascia oraria, espressa nel formato HH:MM. **Nota:** per indicare mezzanotte come orario finale, occorre definire "24:00".
205 -|**Giorni**|Giorni in cui la fascia oraria è valida.
206 -|**Servizio**|//Solo configurando il Servizio tramite Messenger Configurator//. Nome del servizio da attivare se l'ora attuale soddisfa le condizioni. Per ogni giorno "eccezionale" occorre definire: la data (ad esempio 25/12/2017) e il giorno della settimana da associargli. Nel caso che questa festività sia valida tutti gli anni, è possibile sostituire l'anno con delle "X", ad esempio 25/12/XXXX.
194 +|**Nome Periodo**|Inserire il nome logico da assegnare alla fascia, deve essere univoco.
195 +|**Dalle**|Indicare l'ora di inizio della fascia oraria, espressa nel formato HH:MM.
196 +|**Alle**|(((
197 +Indicare l'ora di fine della fascia oraria, espressa nel formato HH:MM.
198 +
199 +(% class="box errormessage" %)
200 +(((
201 +**Nota:** per indicare mezzanotte come orario finale, occorre specificare "24:00".
202 +)))
203 +)))
204 +|**Servizio**|//Solo configurando il Servizio tramite Messenger Configurator//. Selezionare dalla lista il servizio da attivare quando l'ora corrente soddisfa le condizioni.
205 +|**Per i giorni di**|Giorni della settimana a cui associare la fascia oraria.
206 +|**Festività associata al giorno della settimana**|L'utente può utilizzare i tasti //Nuovo//, //Modifica //e //Cancella// per associare una ricorrenza al giorno della settimana e definirla //festiva// o //prefestiva//. Per ogni giorno eccezionale occorre indicarne la data (giorno, mese, anno) e come dessere considerato (giorno della settimana, festivo o prefestivo). Se la festività è ricorrente, è possibile specificare l'anno con "X", ad esempio //25/12/XXXX//, .
207 207  | |
208 208  
209 -
210 210  == UserSwitch (CUserSwitch) ==
211 211  
212 212  Permette di selezionare il successivo servizio da attivare in base al valore memorizzato in una Transfer Property, un Call Data, il valore di un campo di un file INI, un campo di un MDB o di un database remoto visto tramite ODBC.
... ... @@ -236,7 +236,6 @@
236 236  | |**Entry**|Nome dell'entry sul cui valore prendere la decisione.
237 237  | | |
238 238  
239 -
240 240  I parametri validi indipendentemente dal tipo di oggetto selezionato sono invece:
241 241  
242 242  |=(% style="width: 200px;" %)**Parametro**|**Descrizione**