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

From version 6.4
edited by administrator BDP
on 2017/12/14 17:08
Change comment: There is no comment for this version
To version 8.3
edited by administrator BDP
on 2017/12/19 18:07
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
... ... @@ -91,46 +91,73 @@
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 //Assegna Valore //consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un 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 //Assegna Valore //consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un 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 +|=(% style="width: 200px;" %)**Parametro**|**Descrizione**
129 +|**Tipo di operazione**|(((
130 +Specificare se il sistema deve assegnare un nuovo valore alle Transfer Property, oppure salvare il loro contenuto. Selezionare una delle seguenti operazioni:
131 +
132 +* //Carica valore da//
133 +* //Salva valore in//
134 +)))
135 +|**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.
136 +|**Tipo di oggetto**|(((
137 +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:
138 +
139 +* Costante (solo per il caricamento)
140 +* Call Data
141 +* Transfer Property
142 +* Campo di un database Access
143 +* Campo di un database via ODBC
144 +* Entry di un file INI.
145 +)))
146 +| |
147 +| |
148 +
149 +
150 +I parametri da configurare variano in base al tipo d'operazione selezionata (caricamento o salvataggio) e dal tipo di sorgente/destinazione del dato.
151 +
152 +* Nella finestra //Assegna valore// selezionare il tipo di valore da assegnare e procedere a seconda del tipo scelto:
153 +** //Costante//: inserire il nome della costante oppure fare clic sul pulsante **Browse** per selezionare il file .wav da riprodurre.
154 +*
128 128  ** Fare clic su **Save**.
129 129  *** //Transfer Property//:
130 130  **** Scegliere il nome della Transfer Property dall'elenco a discesa.
131 131  *** //Call Data//:​​​​​
132 132  **** Inserire il nome della Call Data.
133 -** Fare clic su **OK**. Il valore indicato viene inserito automaticamente nel campo.
160 +** Fare clic su **OK**. Il valore indicato viene inserito automaticamente nel campo.Fare clic sul pulsante **Browse**.
134 134  * Fare clic su **Avanti**.
135 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**):
136 136  
... ... @@ -154,7 +154,7 @@
154 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:
155 155  
156 156  (% style="margin-left:40px" %)
157 -|**Tipo oggetto**|**Descrizione**
184 +|=(% style="width: 200px;" %)**Tipo oggetto**|**Descrizione**
158 158  |**Costante**|Inserire valore da assegnare alla Transfer Property
159 159  |Oppure|
160 160  |**[NOW]**|Data ed ora corrente
... ... @@ -186,23 +186,25 @@
186 186  
187 187  * Fare clic su **OK**.
188 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="HCQuerySetStore"]] 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.
216 +* 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.
190 190  
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 nessuna delle regole configurate viene attivato un servizio di default. 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.
220 +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.
194 194  
195 195  
196 -
197 197  **Parametri di Configurazione**
198 198  
199 199  Occorre definire il nome del servizio di default e, per ogni fascia oraria configurata:
200 200  
201 -* Nome : nome logico da assegnare alla fascia, deve essere univoco.
202 -* Dalle : ora di inizio della fascia oraria, espressa nel formato HH:MM.
203 -* Alle : ora di fine della fascia oraria, espressa nel formato HH:MM. **Nota:** per indicare mezzanotte come orario finale, occorre definire "24:00".
204 -* Giorni : giorni in cui la fascia oraria è valida.
205 -* Servizio (solo configurando il Servizio tramite MessengerConfigurator ): nome del servizio da attivare se l'ora attuale soddisfa le condizioni. Per ogni giorno "eccezionale" occorre definire: la data (ad esempio 25/12/1998) ed 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.
227 +(% style="margin-top:20px" %)
228 +|=(% style="width: 200px;" %)Parametro|=Descrizione
229 +|**Nome**|Nome logico da assegnare alla fascia, deve essere univoco.
230 +|**Dalle**|Ora di inizio della fascia oraria, espressa nel formato HH:MM.
231 +|**Alle**|Ora di fine della fascia oraria, espressa nel formato HH:MM. **Nota:** per indicare mezzanotte come orario finale, occorre definire "24:00".
232 +|**Giorni**|Giorni in cui la fascia oraria è valida.
233 +|**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.
234 +| |
206 206  
207 207  == UserSwitch (CUserSwitch) ==
208 208  
... ... @@ -209,42 +209,45 @@
209 209  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.
210 210  
211 211  
212 -
213 213  **Parametri di Configurazione**
214 214  
215 215  I parametri che dipendono dal tipo d'oggetto su cui prendere la decisione sono:
216 216  
217 -|**Tipo d'oggetto**|**Parametro**|**Descrizione**
218 -|Call Data|Nome|Nome del Call Data
219 -|Transfer Property|Nome|Nome della Transfer Property.
220 -|Campo MDB|Nome MDB|Nome e percorso del file MDB.
221 -| |Nome tabella|Nome della tabella del file MDB.
222 -| |Nome campo|Nome del campo sul cui valore prendere la decisione.
223 -| |Campo ricerca|Nome del campo su cui ricercare il record da considerare
224 -| |Valore ricerca|Valore da ricercare
225 -|Campo ODBC|DSN ODBC|Nome con cui è definito il database in ODBC
226 -| |Utente|Nome utente con cui accedere al DB
227 -| |Password|Password d'accesso per l'utente definito
228 -| |Nome tabella|Nome della tabella del file MDB.
229 -| |Nome campo|Nome del campo sul cui valore prendere la decisione.
230 -| |Campo ricerca|Nome del campo su cui ricercare il record da considerare
231 -| |Valore ricerca|Valore da ricercare
232 -|Entry file INI|Nome file|Nome e percorso del file INI
233 -| |Sezione|Nome della sezione del file INI
234 -| |Entry|Nome dell'entry sul cui valore prendere la decisione
245 +|=(% style="width: 200px;" %)**Tipo d'oggetto**|=(% style="width: 200px;" %)**Parametro**|**Descrizione**
246 +|**Call Data**|**Nome**|Nome del Call Data.
247 +|**Transfer Property**|**Nome**|Nome della Transfer Property.
248 +|**Campo MDB**|**Nome MDB**|Nome e percorso del file MDB.
249 +| |**Nome tabella**|Nome della tabella del file MDB.
250 +| |**Nome campo**|Nome del campo sul cui valore prendere la decisione.
251 +| |**Campo ricerca**|Nome del campo su cui ricercare il record da considerare.
252 +| |**Valore ricerca**|Valore da ricercare.
253 +|**Campo ODBC**|**DSN ODBC**|Nome con cui è definito il database in ODBC.
254 +| |**Utente**|Nome utente con cui accedere al DB.
255 +| |**Password**|Password d'accesso per l'utente definito.
256 +| |**Nome tabella**|Nome della tabella del file MDB.
257 +| |**Nome campo**|Nome del campo sul cui valore prendere la decisione.
258 +| |**Campo ricerca**|Nome del campo su cui ricercare il record da considerare.
259 +| |**Valore ricerca**|Valore da ricercare.
260 +|**Entry file INI**|**Nome file**|Nome e percorso del file INI.
261 +| |**Sezione**|Nome della sezione del file INI.
262 +| |**Entry**|Nome dell'entry sul cui valore prendere la decisione.
263 +| | |
235 235  
236 -I parametri validi indipendentemente dal tipo d'oggetto selezionato sono invece:
265 +I parametri validi indipendentemente dal tipo di oggetto selezionato sono invece:
237 237  
238 -|**Parametro**|**Descrizione**
239 -|Tipo del dato|Tipo del dato sui cui prendere la decisione (testo, numero o data).
240 -|Lista di instradamento|Lista di copie servizio-valore per la selezione del percorso da seguire
241 -|Messaggio d'attesa|Nel caso di accessi a basi dati lente è possibile indicare un messaggio di attesa che viene suonato in modo asincrono durante l'accesso ai dati.
267 +|=(% style="width: 200px;" %)**Parametro**|**Descrizione**
268 +|**Tipo del dato**|Tipo del dato sui cui prendere la decisione (testo, numero o data).
269 +|**Lista di instradamento**|Lista di coppie servizio-valore per la selezione del percorso da seguire.
270 +|**Messaggio d'attesa**|Nel caso di accesso a database lenti è possibile indicare un messaggio di attesa che viene riprodotto in modo asincrono durante l'accesso ai dati.
271 +| |
242 242  
243 243  Ad ogni possibile servizio successivo deve essere associata una regola di attivazione con le seguenti modalità:
244 244  
245 -* Intervallo di valori : nella forma "1=100", il servizio corrispondente viene attivato se l'oggetto indicato ha un valore compreso tra 1 e 100, limiti compresi.
246 -* Sequenza di valori : nella forma "1;3;5", il servizio corrispondente viene attivato se l'oggetto indicato vale 1, 3 oppure 5.
247 -* Singolo valore.
248 -* Limite superiore : nella forma "<100", il servizio corrispondente viene attivato se l'oggetto indicato ha un valore minore di 100.
249 -* Limite inferiore : nella forma ">100", il servizio corrispondente viene attivato se l'oggetto indicato ha un valore maggiore di 100.
250 -* Default : nella forma "-", il servizio corrispondente viene attivato se nessuna delle condizione precedenti è soddisfatta. Deve essere l'ultima condizione definita nella lista. Per le date è possibile specificare la data odierna con la parola chiave "NOW"; di conseguenza possono essere definite anche delle regole del tipo "<NOW" (il servizio associato viene attivato solo se la data dell'oggetto indicato è antecedente alla data odierna), ">NOW+5" (il servizio associato viene attivato solo se la data dell'oggetto indicato è successiva alla data odierna più 5 giorni, analogamente per il segno -) e tutte le possibili combinazioni. **Nota** : tutte queste condizioni devono essere scritte senza spazi.
275 +* //Intervallo di valori//: nella forma "1=100", il servizio corrispondente viene attivato se l'oggetto indicato ha un valore compreso tra 1 e 100, limiti compresi.
276 +* //Sequenza di valori//: nella forma "1;3;5", il servizio corrispondente viene attivato se l'oggetto indicato vale 1, 3 oppure 5.
277 +* //Singolo valore//.
278 +* //Limite superiore//: nella forma "<100", il servizio corrispondente viene attivato se l'oggetto indicato ha un valore minore di 100.
279 +* //Limite inferiore//: nella forma ">100", il servizio corrispondente viene attivato se l'oggetto indicato ha un valore maggiore di 100.
280 +* //Default//: nella forma "-", il servizio corrispondente viene attivato se nessuna delle condizione precedenti è soddisfatta. Deve essere l'ultima condizione definita nella lista. Per le date è possibile specificare la data odierna con la parola chiave "NOW"; di conseguenza possono essere definite anche delle regole del tipo "<NOW" (il servizio associato viene attivato solo se la data dell'oggetto indicato è antecedente alla data odierna), ">NOW+5" (il servizio associato viene attivato solo se la data dell'oggetto indicato è successiva alla data odierna più 5 giorni, analogamente per il segno -) e tutte le possibili combinazioni.
281 +
282 +**Nota** : tutte queste condizioni devono essere scritte senza spazi.