Wiki source code of 03 - Funzioni di Input
Last modified by administrator BDP on 2024/10/16 17:21
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 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/FunzioniInput/?format=pdf||rel="noopener noreferrer" target="new"]] | ||
| 4 | ))) | ||
| 5 | |||
| 6 | {{box cssClass="floatinginfobox" title="**Sommario**" width="300px"}} | ||
| 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 | == DPDEnabler (CDPDEnabler) == | ||
| 16 | |||
| 17 | Richiede al chiamante di premere due volte il tasto asterisco per verificare se il telefono di cui dispone è in multifrequenza o meno. Se il sistema riceve il digit richiesto non abilita il riconoscimento delle cifre in decadico, altrimenti lo abilita. Il servizio successivo attivato nei due casi può essere differenziato tramite i seguenti parametri: | ||
| 18 | |||
| 19 | |||
| 20 | **Parametri di Configurazione** | ||
| 21 | |||
| 22 | (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %) | ||
| 23 | (% style="background-color:#f0f0f0;" %)|=(% style="width: 200px;" %)**Parametro**|**Descrizione** | ||
| 24 | |**File da suonare**|Indica il nome del file wav o avi da riprodurre per invitare l'utente a premere due volte il tasto asterisco sul suo telefono. Il tasto //Assegna Valore// consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un Call Data. | ||
| 25 | |**Nome Servizio successivo se rilevato"*"**|//Solo configurando il Servizio tramite Messenger Configurator//. Nome del servizio successivo da attivare se il sistema rileva il tasto asterisco. Il tasto //Selezione// consente di recuperare il servizio dall'elenco dei servizi, tramite Transfer Property oppure Call Data. | ||
| 26 | |**Servizio successivo se NON ricevuto "*"**|//Solo configurando il Servizio tramite Messenger Configurator//. Nome del servizio successivo da attivare se il sistema NON rileva il tasto asterisco. Il tasto //Selezione// consente di recuperare il servizio dall'elenco dei servizi, tramite Transfer Property oppure Call Data. | ||
| 27 | |||
| 28 | == GetDate (CGetDate) == | ||
| 29 | |||
| 30 | Richiede al chiamante l'inserimento di una data ed attiva un diverso servizio a seconda della condizione soddisfatta. Al chiamante viene chiesto prima l'inserimento del giorno, quindi del mese ed infine dell'anno. La richiesta del giorno può essere omessa, utile per le date di scadenza delle carte di credito; in tal caso si può decidere di assumere come giorno il primo o l'ultimo del mese inserito. | ||
| 31 | |||
| 32 | |||
| 33 | **Parametri di Configurazione** | ||
| 34 | |||
| 35 | (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %) | ||
| 36 | (% style="background-color:#f0f0f0;" %)|=(% style="width: 200px;" %)**Parametro**|**Descrizione** | ||
| 37 | |**Directory dei Messaggi**|Indica il nome della cartella, contenuta nella directory base dei messaggi definita nella configurazione, da cui prelevare i file Wav/Avi da riprodurre. La tabella //Messaggi Audio// in fondo alla sezione elenca i messaggi predefiniti forniti. | ||
| 38 | |**Numero massimo di tentativi**|Numero massimo di tentativi concessi per inserire una data valida. Il valore 0 indica l'uscita al primo errore. | ||
| 39 | |**Richiedi solo Mese ed Anno**|Abilitare quest'opzione se non si vuole richiedere il giorno; in tal caso occorre specificare uno dei due casi seguenti. | ||
| 40 | |**Primo del mese**|Se l'opzione precedente //Richiedi solo Mese ed Anno// è stata selezionata, il sistema assume, come giorno, il primo del mese indicato. | ||
| 41 | |**Ultimo del mese**|Se l'opzione precedente //Richiedi solo Mese ed Anno// è stata selezionata, il sistema assume, come giorno, l'ultimo del mese indicato. | ||
| 42 | |**Nome Transfer Property**|Selezionare la [[Transfer Property>>doc:ifmhelpplatform.MessengerConfigurator.TransferProperty.WebHome]] in cui memorizzare la data indicata. | ||
| 43 | |**Periodi di validità**|Indicare gli intervalli validi per le date, utilizzando i tasti **Nuovo**, **Modifica** e **Cancella**. | ||
| 44 | |**Nome Servizio successivo per Data Valida**|//Solo configurando il Servizio tramite Messenger Configurator//. Indicare il servizio da attivare se la data è compresa in uno dei periodi definiti. Il tasto //Selezione //consente di recuperare il servizio dall'elenco dei servizi, tramite Transfer Property oppure Call Data. | ||
| 45 | |**Nome Servizio successivo per Data NON Valida**|//Solo configurando il Servizio tramite Messenger Configurator//. Indicare il servizio da attivare se la data non è valida, cioè non è compresa in alcuno dei periodi definiti. Il tasto //Selezione// consente di recuperare il servizio dall'elenco dei servizi, tramite Transfer Property oppure Call Data. | ||
| 46 | |||
| 47 | **Messaggi Audio** | ||
| 48 | |||
| 49 | (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %) | ||
| 50 | (% style="background-color:#f0f0f0;" %)|=(% style="width: 200px;" %)**Nome file**|**Messaggio** | ||
| 51 | |**GetDay.wav**|Digitare il giorno della data. | ||
| 52 | |**GetMonth.wav**|Digitare il mese. | ||
| 53 | |**GetYear.wav**|Digitare l'anno (4 cifre). | ||
| 54 | |**OutOfRange.wav**|Data fuori dai limiti previsti. | ||
| 55 | |**InvalidDate.wav**|Data non valida. | ||
| 56 | |||
| 57 | (% class="box infomessage" %) | ||
| 58 | ((( | ||
| 59 | Se il servizio configurato in [[#phones Client>>doc:ifmhelpplatform.ClientPhones.WebHome]] a cui viene assegnato questo servizio base del Messenger è in grado di ricevere sia chiamate video che solo audio, non occorre indicare l'estensione del file (ad esempio //GetDay //invece di //GetDay.wav//). | ||
| 60 | |||
| 61 | Circa la definizione dei periodi di validità, la data inserita dall'utente viene ritenuta corretta se cade in uno dei periodi di validità definiti nella configurazione. Per ogni periodo di validità deve essere definita sia la data di inizio che quella di fine, facendo attenzione a rispettare il formato imposto dalle "Impostazioni Internazionali" del server IVR. | ||
| 62 | |||
| 63 | E' possibile usare la parola chiave [NOW] per indicare la data odierna. Sono anche accettati valori del tipo "[NOW]+//x//" o "[NOW]-//x//" dove //x// indica un numero di giorni. | ||
| 64 | ))) | ||
| 65 | |||
| 66 | |||
| 67 | == GetUserCode (CGetUserCode) == | ||
| 68 | |||
| 69 | Richiede al chiamante l'inserimento di un codice che salva nei [[Call Data>>doc:03 - Sviluppo Moduli Applicativi.CallData.WebHome]] o nelle [[Transfer Property>>path:../input/hashphones.messenger-configurator-servizi#TransferProperties]]. E' possibile definire anche la stringa di digit che l'utente deve inserire per proseguire; in questo caso il Servizio funziona come una richiesta di password d'accesso. | ||
| 70 | |||
| 71 | |||
| 72 | **Parametri di Configurazione** | ||
| 73 | |||
| 74 | (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %) | ||
| 75 | (% style="background-color:#f0f0f0;" %)|=(% style="width: 200px;" %)**Parametro**|**Descrizione** | ||
| 76 | |**Directory dei Messaggi**|Indica il nome della cartella, contenuta nella directory base dei messaggi definita nella configurazione, da cui prelevare i file Wav/Avi da suonare. La tabella //Messaggi Audio// in fondo alla sezione elenca i messaggi predefiniti forniti. | ||
| 77 | |**Lunghezza dei codici validi**| | ||
| 78 | |(% style="text-align:right" %)**min**|Numero minimo di digit da attendere per il codice.Il tasto //Assegna Valore// consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un Call Data. | ||
| 79 | |(% style="text-align:right" %)**Max**|Numero massimo di digit del codice utente. Il tasto //Assegna Valori// consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un Call Data. | ||
| 80 | |**Numero massimo di tentativi**|Numero massimo di tentativi in caso di codice non valido (nessuna digitazione). Il tasto //Assegna Valori// consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un Call Data. | ||
| 81 | |**Unica sequenza valida**|Se questo parametro è indicato, il flusso prosegue col servizio successivo solo se il codice inserito coincide con quello qui dichiarato. Il tasto //Assegna Valori// consente di salvare il valore indicato in una Costante, oppure recuperarlo da una Transfer Property o un Call Data. | ||
| 82 | |**Abilita richiesta conferma codice inserito**|Se selezionato, indica che il servizio deve chiedere conferma all'utente del codice digitato. | ||
| 83 | |**Conferma**|Se è stato selezionato il parametro precedente **Abilita richiesta conferma codice inserito**, specificare il tasto (digit) per la conferma del codice inserito. | ||
| 84 | |**Non conferma**|Se è stato selezionato il parametro precedente **Abilita richiesta conferma codice inserito**, specificare il tasto del telefono per non confermare il codice. | ||
| 85 | |**Transfer Property**|Selezionare la Transfer Property in cui salvare il codice inserito. | ||
| 86 | |**Call Data**|Inserire il nome del call data in cui salvare il codice inserito. | ||
| 87 | |**Nome Servizio successivo codice corretto**|//Solo configurando il Servizio tramite Messenger Configurator//. Indicare il nome del servizio da attivare dopo la digitazione del codice corretto (lasciare vuoto per terminare). Il tasto //Selezione// consente di recuperare il servizio dall'elenco dei servizi, tramite Transfer Property oppure Call Data. | ||
| 88 | |**Nome Servizio successivo codice errato**|//Solo configurando il Servizio tramite Messenger Configurator//. Indicare il nome del servizio da attivare dopo la digitazione di un codice non corretto (lasciare vuoto per terminare). Il tasto //Selezione// consente di recuperare il servizio dall'elenco dei servizi, tramite Transfer Property oppure Call Data. | ||
| 89 | |||
| 90 | **Messaggi Audio** | ||
| 91 | |||
| 92 | (% border="1" style="border:1px solid #cccccc; margin-bottom:50px" %) | ||
| 93 | (% style="background-color:#f0f0f0;" %)|=(% style="width: 200px;" %)**Nome file**|**Descrizione** | ||
| 94 | |**InsertCode.wav**|Digitare il proprio codice seguito da # (cancelletto). | ||
| 95 | |**InvalidCode1.wav**|Riprodotto nel caso che il codice inserito non soddisfi i vincoli indicati e non si sia raggiunto il numero massimo di tentativi concessi. | ||
| 96 | |**InvalidCode2.wav**|Riprodotto nel caso che il codice inserito non soddisfi i vincoli indicati e si sia raggiunto il numero massimo di tentativi concessi. | ||
| 97 | |**YourCodeIs.wav**|Prima parte del messaggio di richiesta conferma: //Il codice da Lei inserito è//. | ||
| 98 | |**Confirm.wav**|Seconda parte del messaggio di conferma: //Premere X per confermare, Y per annullare//. | ||
| 99 | |||
| 100 | (% class="box infomessage" %) | ||
| 101 | ((( | ||
| 102 | Se il servizio configurato in [[#phones Client>>doc:ifmhelpplatform.ClientPhones.WebHome]] a cui viene assegnato questo [[servizio base del Messenger>>doc:WebHome]] è in grado di ricevere sia chiamate video che chiamate solo audio è possibile non indicare l'estensione del file (ad esempio InsertCode invece di InsertCode.wav ). | ||
| 103 | ))) | ||
| 104 | |||
| 105 | |||
| 106 | |||
| 107 |