<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kmyapplication "<application
>SSC</application
>">
  <!ENTITY kappname "&kmyapplication;">
  <!ENTITY package "kde-module">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE">

]>
<book id="ssc" lang="&language;">

<bookinfo>

<othercredit role="translator"
><firstname
>Innocenzo</firstname
><surname
>Ventre</surname
><affiliation
><address
><email
>innocenzo.ventre@gmail.com</email
></address
></affiliation
><contrib
>Traduzione italiana</contrib
></othercredit
> 


<date
>2012-12-14</date>
<releaseinfo
>0.4</releaseinfo>

<abstract>
<para
>&kmyapplication; è uno strumento di acquisizione di campioni. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeutils</keyword>
<keyword
>Kapp</keyword>
<keyword
>Simon</keyword>
<keyword
>campione</keyword>
<keyword
>acquisizione</keyword>
<keyword
>allenamento</keyword>
<keyword
>collezione</keyword>
<keyword
>raccolta</keyword>
<keyword
>modello</keyword>
<keyword
>SSC</keyword>
<keyword
>strumenti</keyword>
</keywordset>

<legalnotice
>&FDLNotice;</legalnotice>

<copyright>
<year
>2009-2012</year>
<holder
>Peter Grasch</holder>
</copyright>

<authorgroup>
<author
><personname
> <firstname
>Peter</firstname
> <othername
>H.</othername
> <surname
>Grasch</surname
> </personname
> <email
>peter.grasch@bedahr.org</email
> </author>
</authorgroup>


<title
>Manuale di &kmyapplication;</title>
</bookinfo>

<chapter id="introduction">
<title
>Introduzione</title>

<para
>&kmyapplication; è uno strumento per l'acquisizione di campioni su larga scala.</para>

<para
>Using &kmyapplication; multiple teams can gather training data from potential end users or professional speakers and collect them on the central SSCd server.</para>

<para
>Like Simon / Simond, &kmyapplication; is a client to the SSCd server.</para>

<para
>&kmyapplication; will collect samples through training procedures and send them to the SSCd server.</para>

<para
>The system also collects useful metadata to the samples like names (or aliases) of the recorded people, their speaking niveau, possible impairments, etc. Information about the used recording equipment is also stored. This and other information is stored on the server side in a database. Please refer to the <ulink url="help:/sscd"
>SSCd manual</ulink
> for more information.</para>

<para
>For more information on the architecture of the Simon suite please see the <ulink url="help:/Simon/overview.html#architecture"
>Simon manual</ulink
>.</para>

</chapter>

<chapter id="using-kapp">
<title
>Uso di &kmyapplication;</title>

<para
>&kmyapplication; fornisce una semplice interfaccia grafica per collezionare campioni di allenamento e per gestire i lettori.</para>

<para>
<screenshot>
<screeninfo
>Finestra principale</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="main.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Finestra principale</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>

<para
>To use SSC connect to the SSCd by pressing <guibutton
>Connect</guibutton
>. As soon as you are connected, the user interface will allow you to manage users and institutions and record new samples.</para>
<para
>To proceed without connecting to the SSCd, you may use the <link linkend="offline_mode"
>offline mode</link
>. </para>

<para
>To collect samples for a user, simply enter the id of the user in the <guilabel
>User ID</guilabel
> input field and press <guibutton
>Select</guibutton
>. The user information will be fetched from the database (SSCd) and the name of the user displayed.</para>

<sect1 id="manage_users">
  <title
>Gestione degli utenti</title>
  <para
>Prima di poter registrare i campioni per un lettore devi aggiungere un nuovo utente al sistema.</para>

  <para
>Per aggiungere, modificare e rimuovere utenti, seleziona l'opzione <guibutton
>Gestione utenti</guibutton
> dalla barra degli strumenti.</para>

  <para>
  <screenshot>
  <screeninfo
>Gestione utenti</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="users.png" format="PNG"/>
      </imageobject>
      <textobject>
        <phrase
>Gestione utenti</phrase>
      </textobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>Qui puoi vedere una lista di tutti i lettori esistenti nella banca dati. Per motivi di prestazioni <emphasis
>l'elenco potrebbe non essere completo</emphasis
>. Per una distribuzione di grandi dimensioni di utenti è possibile applicare filtri per il set di risultati compilando la maschera di cui sopra e premendo <guibutton
>Applica filtri</guibutton
>. Il valore predefinito è senza filtro. I campi vuoti vengono ignorati durante il filtraggio.</para>

  <para
>Per filtrare per una specifica istituzione immettere l'id istituzione nel campo <guilabel
>Istituzione</guilabel
>. Se non conosci l'id dell'istituzione è possibile utilizzare il menu <guibutton
>Ricerca</guibutton
>.</para>

  <para
>Per aggiungere, modificare o rimuovere utenti, usa rispettivamente i pulsanti <guibutton
>Aggiungi</guibutton
>, <guibutton
>Modifica</guibutton
> e <guibutton
>Rimuovi</guibutton
>.</para>

  <sect2 id="add_users">
    <title
>Aggiungi utente</title>

    <para
>Per aggiungere un utente usa <guibutton
>Aggiungi</guibutton
> e compila il modulo.</para>

    <para>
    <screenshot>
    <screeninfo
>Aggiungi utente</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="user.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Aggiungi utente</phrase>
        </textobject>
      </mediaobject>
    </screenshot>
    </para>


    <sect3 id="institution_association">
      <title
>Associazione con una istituzione</title>
      <para
>Often institutions give unique ids to each patient to reference them in their computer system. &kmyapplication; can be configured to use those institution ids instead of the internal SSCd identifiers. To connect a SSC user to the institution id add a new institution connection to the user by pressing <guibutton
>Add</guibutton
> below <guilabel
>Institution(s):</guilabel
>.</para>

      <para>
      <screenshot>
      <screeninfo
>Nuova associazione per l'istituzione</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="add_institution_association.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase
>Nuova associazione per l'istituzione</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
      </para>

      <para
>Basta inserire l'id dell'istituzione dell'identificatore da cui proviene e l'id che identifica l'utente in tale istituzione (puoi usare <guibutton
>Ricerca</guibutton
> per cercare gli id dell'istituzione).</para>

      <para
>For example: The speaker "Jack Jones" is currently a patient in institution #1. There he is patient "#520f". You can then add an institution association associating the speaker "Jack Jones" (internal SSCd id "7") with the institution "1" and institution id "520f". If &kmyapplication; is the configured to use institution specific ids of institution "1" you can refer to "Jack Jones" by using the id "520f" instead of "7".</para>
    </sect3>

    <sect3 id="user_capabilities">
      <title
>Funzionalità</title>
      <para
>Se il lettore non è in grado di rispondere alle domande o ripetere le parole pronunciate dall'interlocutore, allora puoi farlo sapere a &kmyapplication; deselezionando <guibutton
>Intervista possibile</guibutton
> e / o <guibutton
>Ripetizione possibile</guibutton
>. Le modalità di allenamento non controllate (ripetizione e intervista), quindi non saranno più disponibili per questo lettore.</para>
    </sect3>
  </sect2>

  <sect2 id="edit_user">
    <title
>Modifica utente</title>
    <para
>Per modificare un utente, seleziona l'utente dall'elenco nella finestra di dialogo <link linkend="manage_users"
>gestione utenti</link
> e fai clic su <guibutton
>Modifica</guibutton
>.</para>
    <para
>L'interfaccia per modificare l'utente è identica alla interfaccia per <link linkend="add_users"
>l'aggiunta di un nuovo utente</link
>.</para>
  </sect2>

  <sect2 id="remove_user">
    <title
>Rimuovi utente</title>
    <para
>Per rimuovere un utente, seleziona <guibutton
>Rimuovi</guibutton
> dopo aver selezionato l'utente dall'elenco nella <link linkend="manage_users"
>finestra di dialogo di gestione utenti</link
>.</para>

    <warning
><para
>Quando rimuovi un utente, tutti i campioni associati a questo lettore verranno persi.</para
></warning>
  </sect2>
</sect1>

<sect1 id="manage_institutions">
  <title
>Gestione istituzioni</title>
  <para
>&kmyapplication; è in grado di organizzare i lettori in "istituzioni". Potrebbero essere istituzioni virtuali come i gruppi, ma è stato originariamente progettato per tenere traccia di ospedali e centri di riabilitazione dei pazienti. Un utente può essere pari a zero, una o molte istituzioni.</para>
  <para
>Per aggiungere, modificare e rimuovere istituzioni, seleziona <guibutton
>Gestione istituzioni</guibutton
> dalla barra degli strumenti.</para>

    <para>
    <screenshot>
    <screeninfo
>Gestione istituzioni</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="institutions.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Gestione istituzioni</phrase>
        </textobject>
      </mediaobject>
    </screenshot>
    </para>
    <para
>Durante la rimozione delle istituzioni, le <link linkend="institution_association"
>associazioni con gli utenti</link
> verranno perse, l'utente comunque non verrà rimosso.</para>
</sect1>

<sect1 id="collecting_samples">
  <title
>Raccolta dei campioni</title>
  <para
>Per raccogliere i campioni di un utente, ci sono tre tipi di allenamento: <itemizedlist>
      <listitem
><para
>Ripetizione</para>
        <para
>Durante la ripetizione, l'interlocutore legge una parola che l'utente tenta di ripetere.</para>
      </listitem>
      <listitem>
        <para
>Allenamento</para>
        <para
>L'utente legge il testo dallo schermo. In pratica l'interlocutore può leggere per l'utente per ripetere al meglio.</para>
      </listitem>
      <listitem>
        <para
>Intervista</para>
        <para
>Durante il colloquio l'interlocutore pone all'utente un paio di domande e ne registra le risposte.</para>
      </listitem>
    </itemizedlist>
  </para>

  <sect2 id="files">
    <title
>Impostazione del materiale di formazione</title>
    <para
>Before you can use SSC you will likely want to adjust the training prompts for the recordings.</para>
    <para
>Sono tre, uno per ogni tipo di di allenamento, semplici file di testo che contengono ognuno una riga. La codifica è in UTF-8.</para>
    <para
>La loro posizione dipende dal sistema operativo in uso: <table frame='all'
><title
>File dei dati di allenamento</title>
      <tgroup cols='2' align='left' colsep='1' rowsep='1'>
      <colspec colname='c1'/>
      <colspec colname='c2'/>
      <thead>
      <row>
        <entry
>Microsoft Windows</entry>
        <entry
>GNU/Linux</entry>
      </row>
      </thead>
      <tbody>
      <row>
        <entry
><filename
>%installation folder%\texts\</filename
></entry>
        <entry
><filename
>`kde4-config --install data`/ssc/texts/</filename
></entry>
      </row>
      </tbody>
      </tgroup>
      </table>
    </para>
    <para
>Il percorso per GNU / Linux utilizza un comando in linea per risolvere la cartella d'installazione. Puoi anche usare <command
>kde4-config --install data</command
> in una shell per trovare il percorso esatto. In Microsoft Windows è necessario inserire la cartella di installazione. Di solito è qualcosa di simile a <filename
>C:\Program files\simon 0.3\</filename
>. </para>
    <para
>La cartella <filename
>texts</filename
> conterrà tre cartelle contenenti le istruzioni: <itemizedlist>
        <listitem
><para
><filename
>ripeti</filename
></para
></listitem>
        <listitem
><para
><filename
>allenamento</filename
></para
></listitem>
        <listitem
><para
><filename
>Intervista</filename
></para
></listitem>
      </itemizedlist>
    </para>
  </sect2>
  <sect2 id="trainingprocess">
    <title
>Allenamento</title>

    <para
>To launch a training session, simply press the appropriate button for your training type in the SSC main window.</para>

    <para>
    <screenshot>
    <screeninfo
>Finestra principale</screeninfo>
      <mediaobject>
        <imageobject>
          <imagedata fileref="main.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Finestra principale</phrase>
        </textobject>
      </mediaobject>
    </screenshot>
    </para>

    <para
>Per far ciò, devi essere connesso al server o usare la <link linkend="offline_mode"
>modalità non in linea</link
>.</para>

    <sect3 id="training_intro">
      <title
>Introduzione</title>

      <para
>All'avvio dell'allenamento, avrai la possibilità di utilizzare la modalità di allenamento potenziata.</para>

      <para>
      <screenshot>
      <screeninfo
>Allenamento: Introduzione</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="training_intro.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase
>Allenamento: Introduzione</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
      </para>
      <para
>In modalità di allenamento potenziato, i campioni inizieranno ad essere registrati non appena il messaggio associato viene visualizzato. Puoi quindi passare alla pagina successiva, semplicemente premendo <guibutton
>Avanti</guibutton
> nella procedura guidata. In questo caso la registrazione corrente viene memorizzata, scritta e avrà inizio la registrazione per il campione successivo.</para>
      <para
>Utilizzando l'opzione di allenamento potenziata un lettore mediamente esperto può completare il processo di allenamento molto più velocemente. Tuttavia, poiché non si dispone di una pausa tra le singole richieste potrebbe essere più gravoso per il lettore.</para>
      <para
>Naturalmente l'allenamento potenziato non è un'opzione quando lasci il lettore ripetere ciò che dice l'interlocutore in quanto quest'ultimo verrà sempre ascoltato sulle registrazioni create.</para>
    </sect3>
    <sect3>
      <title
>Informazioni sul dispositivo</title>
      <para
>In questa pagina della procedura guidata è possibile fornire informazioni sui dispositivi hardware utilizzati (scheda audio e microfono).</para>
      <para>
      <screenshot>
      <screeninfo
>Allenamento: informazioni sul dispositivo</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="training_device_information.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase
>Allenamento: informazioni sul dispositivo</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
      </para>
      <para
>Inserisci il modello e la scheda audio nei campi <guilabel
>Modello</guilabel
> e <guilabel
>Tipo</guilabel
>. Inserisci le informazioni per il microfono nei due campi in basso.</para>
      <para
>I menu a tendina sono riempiti con l'elenco corrente di marche e modelli di campioni già registrati. Prima di inserire un nuovo dispositivo per favore assicurati che il dispositivo stesso, forse dal nome diverso, non esista già per evitare duplicati.</para>
    </sect3>

    <sect3>
      <title
>Calibrazione del volume</title>

      <para
>Prima che la registrazione inizi, &kmyapplication; proverà ad assicurarsi che il volume del microfono sia correttamente configurato.</para>

      <para>
      <screenshot>
      <screeninfo
>Allenamento: volume</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="training_volume.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase
>Allenamento: volume</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
      </para>

      <para
>Per la calibrazione leggi il testo visualizzato.</para>

      <para
>La calibrazione controllerà il volume corrente e ti dirà di alzare o abbassare il volume, ma bisogna farlo manualmente nel mixer del sistema audio. Una volta modificato il volume (mentre la taratura è in esecuzione), premi il pulsante <guibutton
>Volume cambiato</guibutton
> accanto al dispositivo interessato. Questo resetta lo stato del volume. </para>

      <para
>Durante la calibrazione, prova a parlare normalmente. Non urlare, ma non essere neanche troppo tranquillo. Tieni conto che  in genere dovresti utilizzare la stessa impostazione del volume per tutti gli allenamenti e anche per il riconoscimento. Puoi parlare più forte (inconsciamente) quando sei agitato o in un altro momento della giornata in modo da cercare di alzare la voce e prevenire tutto ciò. È molto meglio avere un po' di campioni più tranquilli per avviare il ritaglio.</para>

      <para
>Dalle impostazioni di &kmyapplication;, puoi cambiare sia il testo visualizzato che i livelli considerati corretti. Se lasci vuoto il testo, verrà visualizzato il testo predefinito. Nelle opzioni è anche possibile disattivare completamente la calibrazione. Consulta la <link linkend="configuring_ssc"
>sezione configurazione</link
> per maggiori dettagli.</para>
    </sect3>
    <sect3>
      <title
>Registrazione dei dati</title>
      <para
>Per ogni riga nel <link linkend="files"
>file di istruzioni</link
> otterrai una pagina che ti chiede di registrare un campione.</para>
      <para>
      <screenshot>
      <screeninfo
>Allenamento: registrazione</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="training_sample.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase
>Allenamento: registrazione</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
      </para>
    </sect3>
    <sect3>
      <title
>Memorizzazione o trasmissione dei dati</title>
      <para
>Dopo aver registrato le istruzioni (puoi saltare la richiesta in qualsiasi momento), puoi caricare i campioni raccolti sul server o memorizzarli in locale per inviarli in seguito.</para>
      <para>
      <screenshot>
      <screeninfo
>Allenamento: trasmissione</screeninfo>
        <mediaobject>
          <imageobject>
            <imagedata fileref="training_transmit.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase
>Allenamento: trasmissione</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
      </para>
      <para
>Per caricare i campioni memorizzati, fai riferimento alla<link linkend="stored_samples"
>prossima sezione</link
>.</para>
    </sect3>
  </sect2>
</sect1>

<sect1 id="stored_samples">
  <title
>Campioni memorizzati</title>
  <para
>Se non disponi di una connessione al server o semplicemente non desideri caricare i campioni subito, hai la possibilità di conservare i campioni a livello locale, invece di inviarli.</para>
  <para
>Ciò non va inteso come memoria permanente, ma piuttosto come una posizione intermedia prima di poter caricare i campioni sul server.</para>

  <para
>Per accedere (e caricare) i campioni memorizzati, seleziona <guibutton
>Carica i dati memorizzati</guibutton
> dalla barra degli strumenti.</para>

  <para>
  <screenshot>
  <screeninfo
>Campioni memorizzati</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="upload_stored.png" format="PNG"/>
      </imageobject>
      <textobject>
        <phrase
>Campioni memorizzati</phrase>
      </textobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>L'elenco contiene tutti gli allenamenti memorizzati localmente. Ogni sessione è identificato da un id utente (primo) e la data e l'ora esatta della registrazione (secondo). </para>
  <para
>Quando registri in <link linkend="offline_mode"
>modalità non in linea</link
> il sistema non sa quali user id esistono. Per questo è necessario conoscere l'id utente corretto o indovinare.</para>

  <para
>Prima di caricare il campione, puoi cambiare l'user id selezionato in precedenza facendo clic su <guibutton
>Modifica utente</guibutton
>.</para>

  <para
>Se fai clic su <guibutton
>Carica</guibutton
>, la sessione di allenamento verrà ripristinata e avrai la possibilità di ascoltare / registrare di nuovo tutti i campioni di allenamento prima di caricarli sul server.</para>

  <para
>Una volta caricati, i campioni vengono rimossi dal computer locale.</para>

</sect1>


<sect1 id="offline_mode">
  <title
>Modalità non in linea</title>
  <para
>&kmyapplication; è una <link linkend="introduction"
>soluzione client / server</link
>.</para>

  <para
>Il più delle volte quando lavori con &kmyapplication;, potresti voler connetterti al server per accedere alla banca dati in remoto contenente gli utenti archiviati, le istituzioni, ecc. Durante la registrazione di campioni, nella maggior parte dei casi potrai anche trasferirli sul server direttamente.</para>

  <para
>Sometimes, though, you might not have a (trusted) internet connection available and still need to record samples with &kmyapplication;. For this purpose &kmyapplication; contains an offline mode allowing you to gather speech data without a connection to the SSCd server.</para>

  <para
>Nella modalità non in linea non è possibile aggiungere, modificare o visualizzare gli utenti o le istituzioni. Puoi solo raccogliere nuovi campioni da inviare al server successivamente attraverso la funzione <link linkend="stored_samples"
>campioni memorizzati</link
>.</para>

  <para
>La registrazione funziona allo stesso modo in modalità non in linea, così come quando si è connessi al server, ma alcune funzioni potrebbero non essere disponibili (come la risoluzione del nome o la validità della user id immessa).</para>
</sect1>

<sect1 id="configuring_ssc">
  <title
>Configurare &kmyapplication;</title>
  <para
>Nella configurazione di &kmyapplication; è possibile configurare il server a cui connettersi e impostare alcuni parametri di base. La configurazione audio per le registrazioni può anche essere modificata qui.</para>

  <para>
  <screenshot>
  <screeninfo
>configurazione di &kmyapplication;</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="ssc_settings.png" format="PNG"/>
      </imageobject>
      <textobject>
        <phrase
>configurazione di &kmyapplication;</phrase>
      </textobject>
    </mediaobject>
  </screenshot>
  </para>

  <para
>When you set up &kmyapplication; for a specific institution you might want to bind it directly to this institution. The user can then use the institution specific ids of the users (instead of the internal SSC ids) when referencing the users. To set up the bound institution, use the <guilabel
>Use institution specific ids instead of SSC ids</guilabel
> checkbox. For more information see the <link linkend="institution_association"
>section about institution associations</link
>.</para>

  <para
>The sound configuration is shared with the whole of the Simon application suite. Read more about it in <ulink url="help:/simon/configuration.html#soundconfiguration"
>Simon manual</ulink
>.</para>
</sect1>

 </chapter>


<chapter id="faq">
<title
>Domande e risposte</title>

<para
>In an effort to keep this section always up-to-date it is available at our <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Troubleshooting_Guide"
>online wiki</ulink
>. </para>

</chapter>

<chapter id="credits">
<title
>Riconoscimenti e licenza</title>

<para
>&kmyapplication; </para>
<para
>Program copyright 2008-2010 Peter Grasch <email
>peter.grasch@bedahr.org</email
> </para>

<para
>Documentation Copyright &copy; 2009-2010 Peter Grasch <email
>peter.grasch@bedahr.org</email
> </para>

<para
>Innocenzo Ventre<email
>innocenzo.ventre@gmail.com</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Installazione</title>
<para
>Please see our <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Installation"
>wiki</ulink
> for install instructions.</para>
</appendix>

&documentation.index;
</book>

<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab
kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
-->
