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

<book id="SSCd" 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 della documentazione</contrib
></othercredit
> 

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

<abstract>
<para
>&kmyapplication; is the server component of the SSC sample acquisition tool. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeutils</keyword>
<keyword
>Kapp</keyword>
<keyword
>Simon</keyword>
<keyword
>campione</keyword>
<keyword
>pronuncia</keyword>
<keyword
>voce</keyword>
<keyword
>acquisizione</keyword>
<keyword
>registrazione</keyword>
<keyword
>accessibilità</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; is the server component of the SSC sample acquisition tool. </para>
<para
>Gestisce i dati degli altoparlanti (utenti, istituzioni) nonché i meta dati di esempio utilizzando una banca dati e ne memorizza i campioni. </para>
<para
>It receives input from the SSC client(s) which connect to the server using TCP/IP. </para>

<para
>For more information on the general architecture of the Simon suite please see the <ulink url="help:/simon/overview.html#architecture"
>Simon manual</ulink
>. For information about the SSC client, please refer to the <ulink url="help:/ssc"
>SSC manual</ulink
>.</para>
</chapter>

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

<para
>&kmyapplication; è un'applicazione a linea di comando che non è dotata di interfaccia grafica. Non esistono parametri speciali di avvio.</para>


<sect1 id="sscd_folder">
  <title
>Cartella principale:</title>
  <para
>La cartella principale di &kmyapplication; contiene il file di configurazione <filename
>sscd.conf</filename
> e un log degli errori, per eventuali errori del programma. Questa cartella contiene la cartella dei <filename
>campioni</filename
> dove gli stessi campioni vengono memorizzati.</para>

<para
>The location of the SSCd folder depends on your operating system: <table frame='all'
><title
>SSC base folder</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
>Percorso di installazione per sscd.exe (generalmente: C:\Program Files\simon 0.3\bin\sscd.exe</filename
>)</entry>
  <entry
><filename
>/usr/share/sscd</filename
></entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</sect1>

<sect1 id="configuration">
  <title
>Configurazione</title>

  <para
>There is no graphical configuration of SSCd, but there is a configuration file (<filename
>sscd.conf</filename
>) stored in the <link linkend="sscd_folder"
>SSCd folder</link
>.</para>

  <para
>Il file di configurazione è ampiamente commentato e dovrebbe essere abbastanza comprensibile.</para>

  <para
>Before running SSCd, you will want to at least change the DatabaseUser and DatabasePassword entry of the configuration file. See <link linkend="database"
>the database section</link
> for more information.</para>

  <screen
>; This is an example config file and displays the built-in defaults
; SSCd will look for this file in:
; Linux:
;    /usr/share/sscd/sscd.conf
; Windows:
;    &lt;sscd installation path&gt;\sscd.conf

[General]
; Change this to use a different database; Because SSCd uses db-specific
; commands in places, only QMYSQL is supported at the moment.
; Support for other DBMS can be added extremely easily, though so please
; feel free to request support through kde-accessibility@kde.org
DatabaseType=QMYSQL

; The host of the DBMS
DatabaseHost=127.0.0.1

; The port of the DBMS; 3306 is the default port of MySQL
DatabasePort=3306

; The database to use; Make sure that you run the supplied create script
; before you use SSCd
DatabaseName=ssc

; The username to use when connecting to the DBMS
DatabaseUser=sscuser

; Database password. The default one will obviously not work in most cases
DatabasePassword=CHANGE ME NOW

; Database options. Refer to Qts documentation of QSqlDatabase for details
DatabaseOptions=MYSQL_OPT_RECONNECT=1

; The port the server will listen to; Default: 4440
Port=4440

; Bind the server to a specific client IP; If this is true, the server
; will ignore requests from all but the BoundHost (see below)
Bind=false

; IP of the bound host (if Bind is active)
BindHost=127.0.0.1
  </screen>
</sect1>

<sect1 id="database">
  <title
>Banca dati</title>

  <para
>&kmyapplication; stores the speaker and sample data (but not the samples themselves) in a database. At the moment, only MySQL databases are fully supported. Adding support for a new database is trivial, though. Contact the <ulink url="mailto:kde-accessibility@kde.org"
>Simon team</ulink
> if you want to help.</para>

  <para
>Per creare le tabelle necessarie, in &kmyapplication; esiste uno script appropriato <filename
>mysql_create_script.sql</filename
> installato nella <link linkend="sscd_folder"
>cartella principale</link
> di &kmyapplication;.</para>


  <para
>Gli errori della banca dati puoi trovarli nel file <filename
>error.log</filename
> presente anche lui nella cartella principale.</para>

</sect1>

<sect1 id="locked_mode">
  <title
>Locked mode</title>


  <para
>SSCd optionally takes the command line argument "-l" (or "--locked") to turn on "locked" mode (off by default).</para>

  <para
>In locked mode, clients can still connect and upload samples as well as create new microphones and sound cards but do not have any access (read or write) to any personal- or institutional data besides the users name and id. This can be helpful to limit the amount of private patient information shown to recording teams.</para>

  <para
>While locked mode is active, there is also no search of users so make sure your recording team is provided with a list of user ids beforehand.</para>
</sect1>

<sect1 id="extracting_samples">
  <title
>Estrazione dei campioni raccolti</title>

  <para
>Per costruire modelli utilizzando i campioni prelevati con &kmyapplication; devi prima estrarli dalla banca dati.</para>

  <warning>
    <para
>Dato che &kmyapplication; è stato progettato per l'acquisizione di campioni su larga scala, non è facile da usare. La documentazione di seguito è principalmente prevista per professionisti tecnicamente qualificati. </para>
    <para
>La maggior parte degli script di seguito, richiedono strumenti GNU (di solito disponibili per impostazione predefinita su GNU / Linux). </para>
  </warning>

  <para
>Puoi usare la query qui di seguito (sono necessari piccoli aggiustamenti in funzione dei campioni di cui hai precisamente bisogno): <screen
>use ssc;

select s.Path, s.Prompt
  from Sample s inner join User u
    on s.UserId = u.UserId inner join UserInInstitution uii
      on u.UserId = uii.UserId inner join SampleType st
        on s.TypeId = st.SampleTypeId inner join Microphone m
          on m.MicrophoneId = s.MicrophoneId
  WHERE st.ExactlyRepeated=1 and uii.InstitutionId = 3
    and (m.MicrophoneId = 1);
    </screen>
  </para>

  <para
>Questa query elencherà tutti i campioni dell'istituzione 3 che sono stati registrati con il microfono 1.</para>

  <para
>È quindi possibile ad esempio utilizzare questo script per creare un file di istruzioni: <screen
>#!/bin/bash
      sed '1d' $1 
> temp_out
      sed -e 's/\\\\/\//g' -e 's/.*Samples\///g' -e 's/\.wav\t/ /' temp_out 
> $1
      rm temp_out
    </screen>
  </para>

  <para
>This prompts file can then be <ulink url="help:/simon/training.html#import_training-data"
>imported in Simon</ulink
>. </para>

  <para
>Per costruire il dizionario appropriato per compilare il modello, potresti anche voler elencare tutte le frasi contenute nel file di istruzioni. È possibile farlo con questo script: <screen
>#!/bin/bash
      cat $1 | sed -e 's/[0-9\/]* //' | sort | uniq
    </screen>
  </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
>Traduzione italiana di 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;
-->
