Skip to Content

Changes for page Registrazione Chiamate

From version 16.2
edited by administrator BDP
on 2017/09/19 11:50
Change comment: Update document after refactoring.
To version 17.1
edited by administrator BDP
on 2017/09/19 12:43
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,189 +1,177 @@
1 -= Introduzione__[[ >>path:#Introduzione_8]]__ =
1 +{{box cssClass="floatinginfobox" title="**Sommario**" width="300px"}}
2 +{{toc start=2 depth="3"/}}
3 +{{/box}}
2 2  
3 -Gli strumenti di registrazione delle chiamate telefoniche messi a disposizione da #phones permettono appunto di registrare le chiamate di tipo inbound e di tipo outbound, infine di salvarle, su file wave. Esistono due tecniche di attivazione della registrazione: la prima comprende la realizzazione di un __[[driver di PhoneBar personalizzato>>path:../input/hashphones.phonebar-sviluppo-applicativi]]__ e consente un'ampia libertà di implementazione ed utilizzo; mentre la seconda, quella che verrà trattata all'interno del presente documento, prevede l'utilizzo di un dispositivo già predisposto: l**'AudioRecordingManager**.
5 +== Introduzione ==
4 4  
5 -= AudioRecordingManager__[[ >>path:#AudioRecordingManager_9]]__ =
7 +Gli strumenti di registrazione delle chiamate telefoniche messi a disposizione da #phones permettono appunto di registrare le chiamate di tipo inbound e di tipo outbound, infine di salvarle, su file wave. Esistono due tecniche di attivazione della registrazione: la prima comprende la realizzazione di un [[driver di PhoneBar personalizzato>>path:../input/hashphones.phonebar-sviluppo-applicativi]] e consente un'ampia libertà di implementazione ed utilizzo; mentre la seconda, quella che verrà trattata all'interno del presente documento, prevede l'utilizzo di un dispositivo già predisposto: l**'AudioRecordingManager**.
6 6  
7 -L'AudioRecordingManager è un __[[servizio base del Messenger>>path:../input/hashphones.messenger-configurator-servizi#Base]]__. In quanto tale, può essere configurato in due modi:
9 +== AudioRecordingManager ==
8 8  
9 -* attraverso il __[[Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer]]__
10 -* oppure attraverso il __[[Messenger Configurator>>path:../input/hashphones.messenger-configurator]]__; questo metodo è noto come __[[Compatibility Mode>>path:../input/hashphones.phonesenterprise-client#Compatibility]]__.
11 +L'AudioRecordingManager è un [[servizio base del Messenger>>path:../input/hashphones.messenger-configurator-servizi#Base]]. In quanto tale, può essere configurato in due modi:
11 11  
13 +* attraverso il [[Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer]]
14 +* oppure attraverso il [[Messenger Configurator>>path:../input/hashphones.messenger-configurator]]; questo metodo è noto come [[Compatibility Mode>>path:../input/hashphones.phonesenterprise-client#Compatibility]].
12 12  
13 -La scelta del metodo dipende in particolare dal __[[modo in cui viene gestito il call flow>>path:../input/hashphones.phonesenterprise-client-call-flow#callflowconfiguration]]__.
16 +La scelta del metodo dipende in particolare dal [[modo in cui viene gestito il call flow>>path:../input/hashphones.phonesenterprise-client-call-flow#callflowconfiguration]].
14 14  
15 -= Configurazione di AudioRecordingManager attraverso il Call Designer__[[ >>path:#Configurazione_di_AudioRecordingManager]]__ =
18 +== Configurazione di AudioRecordingManager attraverso il Call Designer ==
16 16  
17 -Il __[[Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer]]__ mette a disposizione un nuovo tipo di __[[blocchetto>>path:../input/hashphones.phonesenterprise-client-call-designer#TipiDiBlocchetti]]__, appartenente alla categoria dei __[[blocchetti di sistema>>path:../input/hashphones.phonesenterprise-client-call-designer#Sistema]]__, di tipo **AudioRecordingManager**. Il nuovo __[[blocchetto>>path:../input/hashphones.phonesenterprise-client-call-designer#TipiDiBlocchetti]]__ è visibile all'interno della __[[tool-box del Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer#Tool-box]]__, in particolare nella sezione **Base Messenger services**.
20 +Il [[Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer]] mette a disposizione un nuovo tipo di [[blocchetto>>path:../input/hashphones.phonesenterprise-client-call-designer#TipiDiBlocchetti]], appartenente alla categoria dei [[blocchetti di sistema>>path:../input/hashphones.phonesenterprise-client-call-designer#Sistema]], di tipo **AudioRecordingManager**. Il nuovo [[blocchetto>>path:../input/hashphones.phonesenterprise-client-call-designer#TipiDiBlocchetti]] è visibile all'interno della [[tool-box del Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer#Tool-box]], in particolare nella sezione **Base Messenger services**.
18 18  
19 -|[[image:hashphones.la-registrazione-delle-chiamate.html_html_m233861ef.png||height="477" width="642"]]
22 +[[image:hashphones.la-registrazione-delle-chiamate.html_html_m233861ef.png||width="400"]]
20 20  
24 +Nell'immagine, evidenziato in rosso, è illustrato il comando posto all'interno della [[tool-box del Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer#Tool-box]] che permette di creare un [[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]] contenente il [[blocchetto>>path:../input/hashphones.phonesenterprise-client-call-designer#TipiDiBlocchetti]] **AudioRecordingManager**. Per creare un nuovo blocchetto, è sufficiente trascinare la voce **AudioRecordingManager** della [[tool-box del Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer#Tool-box]] nel [[workspace del Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer#Workspace]] nel modo descritto in [[Creare un servizio base del Messenger>>path:../input/hashphones.phonesenterprise-client-call-designer-howto#CreareServizio]].
21 21  
22 -Nell'immagine, evidenziato in rosso, è illustrato il comando posto all'interno della __[[tool-box del Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer#Tool-box]]__ che permette di creare un __[[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]]__ contenente il __[[blocchetto>>path:../input/hashphones.phonesenterprise-client-call-designer#TipiDiBlocchetti]]__ **AudioRecordingManager**. Per creare un nuovo blocchetto, è sufficiente trascinare la voce **AudioRecordingManager** della __[[tool-box del Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer#Tool-box]]__ nel __[[workspace del Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer#Workspace]]__ nel modo descritto in __[[Creare un servizio base del Messenger>>path:../input/hashphones.phonesenterprise-client-call-designer-howto#CreareServizio]]__.
23 -\\Infine, per comprendere il processo di creazione di un __[[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]]__ con il __[[Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer]]__, consultare __[[#phones Client: Call Designer tutorial>>path:../input/hashphones.phonesenterprise-client-call-designer-tutorial]]__.
24 -\\\\
26 +Infine, per comprendere il processo di creazione di un [[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]] con il [[Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer]], consultare [[#phones Client: Call Designer tutorial>>path:../input/hashphones.phonesenterprise-client-call-designer-tutorial]].
25 25  
26 -== Le operazioni consentite dall'AudioRecordingManager__[[ >>path:#Le_operazioni_consentite_dallAudioRecor]]__ ==
28 +=== Le operazioni consentite dall'AudioRecordingManager ===
27 27  
28 -|[[image:hashphones.la-registrazione-delle-chiamate.html_html_485565a5.png||height="159" width="168"]]
30 +[[image:hashphones.la-registrazione-delle-chiamate.html_html_485565a5.png||height="159" width="168"]]
29 29  
32 +Una volta creato il blocchetto, è necessario modificare le proprietà al fine di impiegarlo nel modo ritenuto coerente col proprio [[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]]. Per fare ciò è sufficiente premere col tasto destro del mouse nella parte superiore del blocchetto (raffigurato nell'immagine precedente) e selezionare la voce **Properties**.
30 30  
31 -Una volta creato il blocchetto, è necessario modificare le proprietà al fine di impiegarlo nel modo ritenuto coerente col proprio __[[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]]__. Per fare ciò è sufficiente premere col tasto destro del mouse nella parte superiore del blocchetto (raffigurato nell'immagine precedente) e selezionare la voce **Properties**.
34 +[[image:hashphones.la-registrazione-delle-chiamate.html_html_c340174.png||height="510" width="400"]]
32 32  
33 -|[[image:hashphones.la-registrazione-delle-chiamate.html_html_c340174.png||height="765" width="600"]]
36 +Come visibile nell'immagine precedente, le funzionalità messe a disposizione dal [[blocchetto>>path:../input/hashphones.phonesenterprise-client-call-designer#TipiDiBlocchetti]] **AudioRecordingManager** sono:
34 34  
38 +1. [[Start Recording>>||anchor="HStartrecording"]]
39 +1. [[Stop recording>>||anchor="HStoprecording"]]
40 +1. [[Set recording mute state>>||anchor="Setrecordingmutestate"]]
41 +1. [[Append cue sheet>>||anchor="HAappendcuesheet"]]
35 35  
36 -Come visibile nell'immagine precedente, le funzionalità messe a disposizione dal __[[blocchetto>>path:../input/hashphones.phonesenterprise-client-call-designer#TipiDiBlocchetti]]__ **AudioRecordingManager** sono:
43 +==== Start Recording ====
37 37  
38 -1. __[[Start Recording>>path:#start]]__
39 -1. __[[Stop recording>>path:#stop]]__
40 -1. __[[Set recording mute state>>path:#mute]]__
41 -1. __[[Append cue sheet>>path:#appendcue]]__
45 +Indica a [[LightHouse>>doc:Glossario.WebHome||anchor="HLightHouse"]] di attivare la registrazione per la chiamata in corso. Questo comando accetta solo un parametro che permette di specificare il nome, completo di path, del file wave nel quale salvare la nuova registrazione.
42 42  
43 -=== Start Recording__[[ >>path:#Start_Recording_0]]__ ===
47 +**Nota**: il path indicato viene valutato da LightHouse che esegue la registrazione, quindi deve essere raggiungibile dal LightHouse. Può essere un path relativo (al folder in cui si trova l'eseguibile di LightHouse), oppure assoluto (anche di rete).
44 44  
45 -Indica a __[[LightHouse>>path:../input/hashphones.glossario#LH]]__ di attivare la registrazione per la chiamata in corso. Questo comando accetta solo un parametro che permette di specificare il nome, completo di path, del file wave nel quale salvare la nuova registrazione.
49 +[[image:hashphones.la-registrazione-delle-chiamate.html_html_58f904d1.png||width="400"]]
46 46  
47 -**Nota**: il path indicato viene valutato da __[[LightHouse>>path:../input/hashphones.glossario#LH]]__ che esegue la registrazione, quindi deve essere raggiungibile dal __[[LightHouse>>path:../input/hashphones.glossario#LH]]__. Può essere un path relativo (al folder in cui si trova l'eseguibile di __[[LightHouse>>path:../input/hashphones.glossario#LH]]__), oppure assoluto (anche di rete).
48 -
49 -|[[image:hashphones.la-registrazione-delle-chiamate.html_html_58f904d1.png||height="745" width="584"]]
50 -
51 -
52 52  Nell'immagine, il nome del file deve essere inserito nel campo **File name**.
53 53  
54 -**ATTENZIONE!** il **primo blocchetto AudioRecordingManager di un **__[[**call flow**>>path:../input/hashphones.phonesenterprise-client-call-flow]]__**, deve essere sempre impostato su **__[[**Start Recording**>>path:#start]]__; se fosse scelta qualunque altra opzione, cioè __[[Stop recording>>path:#stop]]__, __[[Set recording mute state>>path:#mute]]__ o __[[Append cue sheet>>path:#appendcue]]__, **AudioRecordingManager** verrebbe posto in uno stato non valido.
53 +**ATTENZIONE!** il **primo blocchetto AudioRecordingManager di un **[[(% class="wikiinternallink wikiinternallink" %)**call flow**>>path:../input/hashphones.phonesenterprise-client-call-flow]](%%)**, deve essere sempre impostato su **[[(% class="wikiinternallink" %)**Start Recording**>>anchor="HStartrecording"]](%%); se fosse scelta qualunque altra opzione, cioè [[Stop recording>>||anchor="HStoprecording"]], [[Set recording mute state>>||anchor="Setrecordingmutestate"]] o [[Append cue sheet>>||anchor="HAappendcuesheet"]], **AudioRecordingManager** verrebbe posto in uno stato non valido.
55 55  
56 -=== Stop recording__[[ >>path:#Stop_recording_1]]__ ===
55 +==== Stop recording ====
57 57  
58 -Indica a __[[LightHouse>>path:../input/hashphones.glossario#LH]]__ di fermare la registrazione. Per questo comando è possibile specificare nei parametri il path in cui spostare il file wave registrato. Se tale parametro viene lasciato vuoto, allora il file wave viene lasciato nel luogo indicato nel comando **Start Recording**. In questo caso il path è relativo al server dove risiede il __[[Messenger>>path:../input/hashphones.messenger]]__.
57 +Indica a [[LightHouse>>path:../input/hashphones.glossario#LH]] di fermare la registrazione. Per questo comando è possibile specificare nei parametri il path in cui spostare il file wave registrato. Se tale parametro viene lasciato vuoto, allora il file wave viene lasciato nel luogo indicato nel comando **Start Recording**. In questo caso il path è relativo al server dove risiede il [[Messenger>>path:../input/hashphones.messenger]].
59 59  
60 -|[[image:hashphones.la-registrazione-delle-chiamate.html_html_2d71bd3f.png||height="745" width="584"]]
59 +[[image:hashphones.la-registrazione-delle-chiamate.html_html_2d71bd3f.png||width="400"]]
61 61  
62 -
63 63  Nell'immagine, il nome del file deve essere inserito nel campo **Destination folder**.
64 -\\\\
65 65  
66 -=== Set recording mute state__[[ >>path:#Set_recording_mute_state_2]]__ ===
63 +==== Set recording mute state ====
67 67  
68 68  Questo comando permette di escludere dalla registrazione:
69 69  
70 70  * il canale audio del chiamante (remoto)
71 -* il canale audio dell'__[[operatore>>path:../input/hashphones.agenti#Operatore]]__
68 +* il canale audio dell'[[operatore>>path:../input/hashphones.agenti#Operatore]]
72 72  * oppure entrambi.
73 73  
71 +Ciò può essere utile ad esempio per non registrare eventuali fasi in cui viene chiesta la password del chiamante. Oltre ad escludere dalla registrazione i canali audio, il blocchetto permette di specificare un [[cue sheet>>path:../input/hashphones.glossario#cue]], con testo configurabile, da appendere al file wave. Così è possibile individuare il punto della registrazione in fase di riascolto.
74 74  
75 -Ciò può essere utile ad esempio per non registrare eventuali fasi in cui viene chiesta la password del chiamante. Oltre ad escludere dalla registrazione i canali audio, il blocchetto permette di specificare un __[[cue sheet>>path:../input/hashphones.glossario#cue]]__, con testo configurabile, da appendere al file wave. Così è possibile individuare il punto della registrazione in fase di riascolto.
73 +[[image:hashphones.la-registrazione-delle-chiamate.html_html_m531a73e8.png||width="400"]]
76 76  
77 -|[[image:hashphones.la-registrazione-delle-chiamate.html_html_m531a73e8.png||height="745" width="584"]]
78 -
79 -
80 80  Nell'immagine:
81 81  
82 82  * **Mute Tx Channel (IVR)**: permette di escludere il canale IVR.
83 83  * **Mute Rx Channel (Remote Party)**: permette di escludere la voce del chiamante.
84 -* **Append cue sheet**: permette di specificare il testo del __[[cue sheet>>path:../input/hashphones.glossario#cue]]__ da applicare al file wavel
79 +* **Append cue sheet**: permette di specificare il testo del [[cue sheet>>path:../input/hashphones.glossario#cue]] da applicare al file wavel
85 85  
86 -=== Append cue sheet__[[ >>path:#Append_cue_sheet_3]]__ ===
81 +==== Append cue sheet ====
87 87  
88 -Indica a __[[LightHouse>>path:../input/hashphones.glossario#LH]]__ di aggiungere un __[[cue sheet>>path:../input/hashphones.glossario#cue]]__, al file wave, in corso di registrazione; il testo è configurabile.
83 +Indica a [[LightHouse>>path:../input/hashphones.glossario#LH]] di aggiungere un [[cue sheet>>path:../input/hashphones.glossario#cue]], al file wave, in corso di registrazione; il testo è configurabile.
89 89  
90 -|[[image:hashphones.la-registrazione-delle-chiamate.html_html_4f682014.png||height="745" width="584"]]
85 +[[image:hashphones.la-registrazione-delle-chiamate.html_html_4f682014.png||width="400"]]
91 91  
87 +Nell'immagine, il testo del [[cue sheet>>path:../input/hashphones.glossario#cue]] deve essere inserito nel campo **Cue sheet entry**.
92 92  
93 -Nell'immagine, il testo del __[[cue sheet>>path:../input/hashphones.glossario#cue]]__ deve essere inserito nel campo **Cue sheet entry**.
94 -\\\\
89 +== Il call flow ==
95 95  
96 -= Il call flow__[[ >>path:#Il_call_flow_11]]__ =
91 +Un blocchetto **AudioRecordingManager** può essere posto in qualunque punto del [[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]], tuttavia è opportuno ricordare che il primo blocchetto **AudioRecordingManager**, cioè quello che avvia la registrazione, ovunque esso sia, deve essere **sempre **impostato su [[Start Recording>>||anchor="HStartrecording"]]. In caso contrario verrebbe posto in uno stato non valido, le cui conseguenze sono descritte nel paragrafo [[Invalid state>>||anchor="HInvalidstate"]].
97 97  
98 -Un blocchetto **AudioRecordingManager** può essere posto in qualunque punto del __[[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]]__, tuttavia è opportuno ricordare che il primo blocchetto **AudioRecordingManager**, cioè quello che avvia la registrazione, ovunque esso sia, deve essere **sempre **impostato su __[[Start Recording>>path:#start]]__. In caso contrario verrebbe posto in uno stato non valido, le cui conseguenze sono descritte nel paragrafo __[[Invalid state>>path:#invalid]]__.
99 -\\Come tutti gli altri blocchetti del __[[Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer]]__, **AudioRecordingManager** possiede dei **port** che permettono di costruire un __[[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]]__; per maggiori dettagli consultare __[[Connessioni tra i blocchetti>>path:../input/hashphones.phonesenterprise-client-call-designer#BlockConnection]]__.
100 -\\Per tutte le 4 opzioni, indicate nel paragrafo __[[Le operazioni consentite dall'AudioRecordingManage>>path:#operations]]__, si possono configurare i seguenti port di uscita:
93 +Come tutti gli altri blocchetti del [[Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer]], **AudioRecordingManager** possiede dei **port** che permettono di costruire un [[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]]; per maggiori dettagli consultare [[Connessioni tra i blocchetti>>path:../input/hashphones.phonesenterprise-client-call-designer#BlockConnection]].
101 101  
102 -* **Success**: se la richiesta di avvio del comando __[[Start Recording>>path:#start]]__ viene eseguita con successo, viene invocato il blocchetto successivo.
103 -* **Failure**: se la richiesta di avvio del comando __[[Start Recording>>path:#start]]__ **non **viene ha successo, è invocato il blocchetto successivo.
104 -* **Invalid state**: se lo stato del servizio **AudioRecordingManager** non è valido, tipicamente a causa di un errore di configurazione oppure per le ragioni esposte nel paragrafo __[[Avvio di una registrazione all'inizio del call flow>>path:#startcallflow]]__, viene invocato il blocchetto successivo. Siccome questo port viene usato in alcune circostanze particolari, l'argomento Invalid state è stato approfondito nel paragrafo omonimo __[[Invalid state>>path:#invalid]]__.
95 +Per tutte le 4 opzioni, indicate nel paragrafo [[Le operazioni consentite dall'AudioRecordingManage>>||anchor="HLeoperazioniconsentite"]], si possono configurare i seguenti port di uscita:
105 105  
106 -|[[image:hashphones.la-registrazione-delle-chiamate.html_html_m2d1f281a.png||height="299" width="642"]]
97 +* **Success**: se la richiesta di avvio del comando [[Start Recording>>||anchor="HStartrecording"]] viene eseguita con successo, viene invocato il blocchetto successivo.
98 +* **Failure**: se la richiesta di avvio del comando [[Start Recording>>||anchor="HStartrecording"]] **non **viene ha successo, è invocato il blocchetto successivo.
99 +* **Invalid state**: se lo stato del servizio **AudioRecordingManager** non è valido, tipicamente a causa di un errore di configurazione oppure per le ragioni esposte nel paragrafo [[Avvio di una registrazione all'inizio del call flow>>||anchor="HAvviodiunaregistrazioneall27iniziodelcallflow"]], viene invocato il blocchetto successivo. Siccome questo port viene usato in alcune circostanze particolari, l'argomento Invalid state è stato approfondito nel paragrafo omonimo [[Invalid state>>||anchor="HInvalidstate"]].
107 107  
101 +[[image:hashphones.la-registrazione-delle-chiamate.html_html_m2d1f281a.png||width="400"]]
108 108  
109 -Nell'immagine precedente è raffigurato un ipotetico __[[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]]__, elaborato col __[[Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer]]__ in grado di registrare una chiamata a partire dal suo inizio; su di esso vanno fatte alcune importanti osservazioni.
103 +Nell'immagine precedente è raffigurato un ipotetico [[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]], elaborato col [[Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer]] in grado di registrare una chiamata a partire dal suo inizio; su di esso vanno fatte alcune importanti osservazioni.
110 110  
111 111  * Se la richiesta di avvio della registrazione viene eseguita con successo (port **Success**), il servizio successivo è costituito dal blocchetto **VoiceMenu**.
112 112  * Se la richiesta di avvio della registrazione **non **viene eseguita con successo (port **Failure**), allora il servizio successivo è costituito dal primo blocchetto **PlayMessage**.
113 -* Se per errore **AudioRecordingManager** fosse stato impostato su __[[Stop Recording>>path:#stop]]__, allora verrebbe invocato il port **Invalid state**, e con esso il secondo blocchetto **PlayMessage**.
114 -* Infine **AudioRecordingManager** è preceduto da un blocchetto **PlayMessage**: è necessario al fine di garantire una corretta gestione del ^messenger-configurator#IVR|canale IVR]; per maggiori dettagli consultare il paragrafo __[[Avvio di una registrazione all'inizio del call flow>>path:#startcallflow]]__.
107 +* Se per errore **AudioRecordingManager** fosse stato impostato su [[Stop recording>>||anchor="HStoprecording"]], allora verrebbe invocato il port **Invalid state**, e con esso il secondo blocchetto **PlayMessage**.
108 +* Infine **AudioRecordingManager** è preceduto da un blocchetto **PlayMessage**: è necessario al fine di garantire una corretta gestione del ^messenger-configurator#IVR|canale IVR]; per maggiori dettagli consultare il paragrafo [[Avvio di una registrazione all'inizio del call flow>>||anchor="HAvviodiunaregistrazioneall27iniziodelcallflow"]].
115 115  
110 +Il blocchetto **AudioRecordingManager** può essere inserito in qualunque punto di un [[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]], elaborato col [[Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer]]. Ma si ricorda che il suo comportamento dipende dalle impostazioni descritte in [[Le operazioni consentite dall'AudioRecordingManager>>||anchor="HLeoperazioniconsentite"]].
116 116  
117 -Il blocchetto **AudioRecordingManager** può essere inserito in qualunque punto di un __[[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]]__, elaborato col __[[Call Designer>>path:../input/hashphones.phonesenterprise-client-call-designer]]__. Ma si ricorda che il suo comportamento dipende dalle impostazioni descritte in __[[Le operazioni consentite dall'AudioRecordingManager>>path:#operations]]__.
112 +**ATTENZIONE:** quando di intende registrare una telefonata a partire dal suo inizio, **AudioRecordingManager**, [[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]], andrebbe collocato per primo; tuttavia ciò potrebbe avere delle conseguenze capaci di bloccare la registrazione, pertanto in queste circostanze devono essere seguite le indicazioni contenute nel paragrafo [[Avvio di una registrazione all'inizio del call flow>>||anchor="HAvviodiunaregistrazioneall27iniziodelcallflow"]].
118 118  
119 -**ATTENZIONE:** quando di intende registrare una telefonata a partire dal suo inizio, **AudioRecordingManager**, __[[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]]__, andrebbe collocato per primo; tuttavia ciò potrebbe avere delle conseguenze capaci di bloccare la registrazione, pertanto in queste circostanze devono essere seguite le indicazioni contenute nel paragrafo __[[Avvio di una registrazione all'inizio del call flow>>path:#startcallflow]]__.
114 +=== Avvio di una registrazione all'inizio del call flow ===
120 120  
121 -== Avvio di una registrazione all'inizio del call flow__[[ >>path:#Avvio_di_una_registrazione_allinizio_de]]__ ==
116 +Se si desiderasse registrare la chiamata a partire dal suo inizio, **AudioRecordingManager** andrebbe posto all'inizio del [[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]]. Tuttavia è opportuno sottolineare che tra il momento in cui il ^messenger-configurator#IVR|canale IVR] viene effettivamente impegnato dalla chiamata e il momento in cui [[LightHouse>>path:../input/hashphones.glossario#LH]] riceve la notifica dell'evento e pone il [[canale IVR>>path:../input/hashphones.messenger-configurator#IVR]] in [[stato di conversazione>>path:../input/hashphones.agenti#Stato]], possono trascorrere alcuni attimi di ritardo provocati dall'infrastruttura di rete. In linea di massima ciò non ha alcun effetto reale, ma nel caso di una registrazione con **AudioRecordingManager**, [[LightHouse>>path:../input/hashphones.glossario#LH]] potrebbe ricevere una richiesta ([[Start Recording>>||anchor="HStartrecording"]]) per un [[canale IVR>>path:../input/hashphones.messenger-configurator#IVR]] formalmente non ancora in conversazione. Per gestire questo caso, [[LightHouse>>path:../input/hashphones.glossario#LH]] non può far altro che rispondere con un messaggio che pone il blocchetto **AudioRecordingManager** in uno stato non valido [[Invalid state>>||anchor="HInvalidstate"]]. Quindi per prevenire ed eliminare del tutto la possibilità che ciò avvenga, è buona norma far precedere **AudioRecordingManager** da un altro blocchetto di tipo **PlayMessage** contenente un secondo di silenzio.
122 122  
123 -Se si desiderasse registrare la chiamata a partire dal suo inizio, **AudioRecordingManager** andrebbe posto all'inizio del __[[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]]__. Tuttavia è opportuno sottolineare che tra il momento in cui il ^messenger-configurator#IVR|canale IVR] viene effettivamente impegnato dalla chiamata e il momento in cui __[[LightHouse>>path:../input/hashphones.glossario#LH]]__ riceve la notifica dell'evento e pone il __[[canale IVR>>path:../input/hashphones.messenger-configurator#IVR]]__ in __[[stato di conversazione>>path:../input/hashphones.agenti#Stato]]__, possono trascorrere alcuni attimi di ritardo provocati dall'infrastruttura di rete. In linea di massima ciò non ha alcun effetto reale, ma nel caso di una registrazione con **AudioRecordingManager**, __[[LightHouse>>path:../input/hashphones.glossario#LH]]__ potrebbe ricevere una richiesta (__[[Start Recording>>path:#start]]__) per un __[[canale IVR>>path:../input/hashphones.messenger-configurator#IVR]]__ formalmente non ancora in conversazione. Per gestire questo caso, __[[LightHouse>>path:../input/hashphones.glossario#LH]]__ non può far altro che rispondere con un messaggio che pone il blocchetto **AudioRecordingManager** in uno stato non valido __[[Invalid state>>path:#invalid]]__. Quindi per prevenire ed eliminare del tutto la possibilità che ciò avvenga, è buona norma far precedere **AudioRecordingManager** da un altro blocchetto di tipo **PlayMessage** contenente un secondo di silenzio.
124 -\\\\
118 +=== Invalid state ===
125 125  
126 -== Invalid state__[[ >>path:#Invalid_state_6]]__ ==
120 +Un caso tipico di **Invalid state** è quello citato all'inizio del paragrafo [[Il call flow>>||anchor="Ilcallflow"]]. Infatti in un [[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]] il primo blocchetto **AudioRecordingManager** **deve **essere sempre impostato su [[Start Recording>>||anchor="HStartrecording"]]; in caso contrario si avrà un **Invalid state**. Ma la condizione **Invalid state** si può realizzare anche in altre circostanze; un esempio su tutti: la chiusura della registrazione può avvenire in due occasioni:
127 127  
128 -Un caso tipico di **Invalid state** è quello citato all'inizio del paragrafo __[[Il call flow>>path:#callflow]]__. Infatti in un __[[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]]__ il primo blocchetto **AudioRecordingManager** **deve **essere sempre impostato su __[[Start Recording>>path:#start]]__; in caso contrario si avrà un **Invalid state**. Ma la condizione **Invalid state** si può realizzare anche in altre circostanze; un esempio su tutti: la chiusura della registrazione può avvenire in due occasioni:
129 -
130 130  * conclusione della chiamata
131 -* inserimento di un secondo blocchetto **AudioRecordingManager** impostato su __[[StopRecording>>path:#stop]]__.
123 +* inserimento di un secondo blocchetto **AudioRecordingManager** impostato su [[Stop recording>>||anchor="HStoprecording"]].
132 132  
125 +Il secondo caso tipicamente si realizza all'interno di [[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]] complessi, ossia in presenza di servizi di vario genere. Ad esempio se il secondo blocchetto **AudioRecordingManager** fosse stato impostato per errore su [[Start Recording>>||anchor="HStartrecording"]] invece che su [[Stop recording>>||anchor="HStoprecording"]], [[LightHouse>>path:../input/hashphones.glossario#LH]] rileverebbe un'incoerenza nel dispositivo, di conseguenza il secondo blocchetto **AudioRecordingManager** verrebbe posto in **Invalid state**.
133 133  
134 -Il secondo caso tipicamente si realizza all'interno di __[[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]]__ complessi, ossia in presenza di servizi di vario genere. Ad esempio se il secondo blocchetto **AudioRecordingManager** fosse stato impostato per errore su __[[Start Recording>>path:#start]]__ invece che su __[[Stop Recording>>path:#stop]]__, __[[LightHouse>>path:../input/hashphones.glossario#LH]]__ rileverebbe un'incoerenza nel dispositivo, di conseguenza il secondo blocchetto **AudioRecordingManager** verrebbe posto in **Invalid state**.
135 -\\In altre parole, **Invalid state** è necessario al fine di "intercettare" e governare eventuali errori nella configurazione del __[[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]]__, oppure per gestire fallimenti che non rientrano tra quelli previsti da **Failure**. In ultima analisi, il port **Invalid state** è in grado di garantire un'uscita ordinata e controllata del __[[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]]__.
127 +In altre parole, **Invalid state** è necessario al fine di "intercettare" e governare eventuali errori nella configurazione del [[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]], oppure per gestire fallimenti che non rientrano tra quelli previsti da **Failure**. In ultima analisi, il port **Invalid state** è in grado di garantire un'uscita ordinata e controllata del [[call flow>>path:../input/hashphones.phonesenterprise-client-call-flow]].
136 136  
137 -= Configurazione di AudioRecordingManager in Compatibility Mode__[[ >>path:#Configurazione_di_AudioRecordingManager]]__ =
129 +== Configurazione di AudioRecordingManager in Compatibility Mode ==
138 138  
139 -Il __[[Compatibility Mode>>path:../input/hashphones.phonesenterprise-client#Compatibility]]__ prevede l'utilizzo del __[[Messenger Configurator>>path:../input/hashphones.messenger-configurator]]__ ed è un metodo considerato obsoleto. Per maggiori dettagli, consultare __[[Creazione e configurazione del call flow (obsoleto)>>path:../input/hashphones.messenger-configurator#CallFlow]]__. La configurazione del __[[servizio base del Messenger>>path:../input/hashphones.messenger-configurator-servizi#Base]]__ di tipo **AudioRecordingManager** prevede un wizard le cui finestre ripropongono quanto descritto in __[[Le operazioni consentite dall'AudioRecordingManager>>path:#operations]]__.
131 +Il [[Compatibility Mode>>path:../input/hashphones.phonesenterprise-client#Compatibility]] prevede l'utilizzo del [[Messenger Configurator>>path:../input/hashphones.messenger-configurator]] ed è un metodo considerato obsoleto. Per maggiori dettagli, consultare [[Creazione e configurazione del call flow (obsoleto)>>path:../input/hashphones.messenger-configurator#CallFlow]]. La configurazione del [[servizio base del Messenger>>path:../input/hashphones.messenger-configurator-servizi#Base]] di tipo **AudioRecordingManager** prevede un wizard le cui finestre ripropongono quanto descritto in [[Le operazioni consentite dall'AudioRecordingManager>>||anchor="HLeoperazioniconsentite"]].
140 140  
141 -== Il wizard__[[ >>path:#Il_wizard_7]]__ ==
133 +=== Il wizard ===
142 142  
143 -|[[image:hashphones.la-registrazione-delle-chiamate.html_html_m5688ee42.png||height="403" width="642"]]
135 +[[image:hashphones.la-registrazione-delle-chiamate.html_html_m5688ee42.png||width="400"]]
144 144  
137 +La prima finestra del wizard permette di impostare il comportamento del [[servizio base del Messenger>>path:../input/hashphones.messenger-configurator-servizi#Base]]:
145 145  
146 -La prima finestra del wizard permette di impostare il comportamento del __[[servizio base del Messenger>>path:../input/hashphones.messenger-configurator-servizi#Base]]__:
139 +* **Avvia registrazione**: corrisponde a [[Start Recording>>||anchor="HStartrecording"]];
140 +* **Interrompi registrazione**: corrisponde a [[Stop recording>>||anchor="HStoprecording"]];
141 +* **Imposta canale audio da registrare**: corrisponde a [[Set recording mute state>>||anchor="HSetrecordingmutestart"]];
142 +* **Aggiungi cue sheet**: corrisponde a [[Append cue sheet>>||anchor="HAppendcuesheet"]].
147 147  
148 -* **Avvia registrazione**: corrisponde a __[[Start Recording>>path:#start]]__;
149 -* **Interrompi registrazione**: corrisponde a __[[Stop recording>>path:#stop]]__;
150 -* **Imposta canale audio da registrare**: corrisponde a __[[Set recording mute state>>path:#mute]]__;
151 -* **Aggiungi cue sheet**: corrisponde a __[[Append cue sheet>>path:#appendcue]]__.
152 -
153 -
154 154  Le finestre successive dipendono dalla scelta fatta.
155 155  
156 -|[[image:hashphones.la-registrazione-delle-chiamate.html_html_m519e3a7f.png||height="405" width="642"]]
146 +[[image:hashphones.la-registrazione-delle-chiamate.html_html_m519e3a7f.png||width="400"]]
157 157  
148 +La finestra viene visualizzata soltanto se è stata selezionata l'opzione **Avvia registrazione**; come in [[Start Recording>>||anchor="HStartrecording"]], il nome del file deve essere inserito nel campo **Nome del file**.
158 158  
159 -La finestra viene visualizzata soltanto se è stata selezionata l'opzione **Avvia registrazione**; come in __[[Start Recording>>path:#start]]__, il nome del file deve essere inserito nel campo **Nome del file**.
150 +[[image:hashphones.la-registrazione-delle-chiamate.html_html_m7490bc75.png||width="400"]]
160 160  
161 -|[[image:hashphones.la-registrazione-delle-chiamate.html_html_m7490bc75.png||height="405" width="642"]]
152 +Questa finestra viene visualizzata soltanto se è stata selezionata l'opzione **Interrompi registrazione**; come in [[Stop recording>>||anchor="HStoprecording"]], deve essere indicato il folder di destinazione del file wave contenente la registrazione.
162 162  
154 +[[image:hashphones.la-registrazione-delle-chiamate.html_html_m5d1a1909.png||width="400"]]
163 163  
164 -Questa finestra viene visualizzata soltanto se è stata selezionata l'opzione **Interrompi registrazione**; come in __[[Stop recording>>path:#stop]]__, deve essere indicato il folder di destinazione del file wave contenente la registrazione.
156 +Questa finestra viene visualizzata soltanto se è stata selezionata l'opzione **Imposta canale audio da registrare**; come in [[Stop Set recording mute state>>||anchor="HSetrecordingmutestart"]], possono essere indicati i canali da escludere e il testo del [[cue sheet>>path:../input/hashphones.glossario#cue]] da associare al nuovo file.
165 165  
166 -|[[image:hashphones.la-registrazione-delle-chiamate.html_html_m5d1a1909.png||height="405" width="642"]]
158 +[[image:hashphones.la-registrazione-delle-chiamate.html_html_63060f75.png||width="400"]]
167 167  
160 +Questa finestra viene visualizzata soltanto se è stata selezionata l'opzione **Aggiungi cue sheet**; come in [[Append cue sheet>>||anchor="HAppendcuesheet"]], deve essere indicato il testo del [[cue sheet>>path:../input/hashphones.glossario#cue]] da associare al nuovo file.
168 168  
169 -Questa finestra viene visualizzata soltanto se è stata selezionata l'opzione **Imposta canale audio da registrare**; come in __[[Stop Set recording mute state>>path:#mute]]__, possono essere indicati i canali da escludere e il testo del __[[cue sheet>>path:../input/hashphones.glossario#cue]]__ da associare al nuovo file.
162 +[[image:hashphones.la-registrazione-delle-chiamate.html_html_371b358b.png||width="400"]]
170 170  
171 -|[[image:hashphones.la-registrazione-delle-chiamate.html_html_63060f75.png||height="405" width="642"]]
164 +Infine questa finestra viene visualizzata alla fine del ciclo di configurazione. Essa possiede le stesse funzioni descritte nel [[Il call flow>>||anchor="HIlcallflow"]] e permette di definire i servizi da attivare nelle diverse circostanze:
172 172  
166 +* **Servizio successivo se richiesta eseguita con successo**: se il comando **Avvia registrazione** viene eseguito con successo, viene invocato il blocchetto successivo.
167 +* **Servizio successivo se richiesta fallita**: se il comando **Avvia registrazione** fallisce, viene invocato il blocchetto successivo.
168 +* **Servizio successivo se richiesta non valida**: consultare il paragrafo [[Invalid state>>||anchor="HInvalidstate"]].
173 173  
174 -Questa finestra viene visualizzata soltanto se è stata selezionata l'opzione **Aggiungi cue sheet**; come in __[[Append cue sheet>>path:#appendcue]]__, deve essere indicato il testo del __[[cue sheet>>path:../input/hashphones.glossario#cue]]__ da associare al nuovo file.
170 +Soltanto se è stata selezionata l'opzione **Aggiungi cue sheet**, come in [[Append cue sheet>>||anchor="HAppendcuesheet"]], deve essere indicato il testo del [[cue sheet>>path:../input/hashphones.glossario#cue]] da associare al nuovo file.
175 175  
176 -|[[image:hashphones.la-registrazione-delle-chiamate.html_html_371b358b.png||height="405" width="642"]]
177 177  
178 178  
179 -Infine questa finestra viene visualizzata alla fine del ciclo di configurazione. Essa possiede le stesse funzioni descritte nel __[[Il call flow>>path:#callflow]]__ e permette di definire i servizi da attivare nelle diverse circostanze:
180 180  
181 -* **Servizio successivo se richiesta eseguita con successo**: se il comando **Avvia registrazione** viene eseguito con successo, viene invocato il blocchetto successivo.
182 -* **Servizio successivo se richiesta fallita**: se il comando **Avvia registrazione** fallisce, viene invocato il blocchetto successivo.
183 -* **Servizio successivo se richiesta non valida**: consultare il paragrafo __[[Invalid state>>path:#invalid]]__.
184 184  
185 185  
186 -Soltanto se è stata selezionata l'opzione **Aggiungi cue sheet**, come in __[[Append cue sheet>>path:#appendcue]]__, deve essere indicato il testo del __[[cue sheet>>path:../input/hashphones.glossario#cue]]__ da associare al nuovo file.
187 -\\\\\\
188 -
189 -__[[Top>>path:#PageTop]]__
177 +