<?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
>Peter</firstname
><surname
>Grasch</surname
><affiliation
><address
><email
>peter.grasch@bedahr.org</email
></address
></affiliation
><contrib
>Übersetzung</contrib
></othercredit
> 

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

<abstract>
<para
>&kmyapplication; ist die Serverkomponente für das Programm „SSC“ zum Erfassen von Aufnahmen. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeutils</keyword>
<keyword
>Kapp</keyword>
<keyword
>Simon</keyword>
<keyword
>Beispiel</keyword>
<keyword
>Sprache</keyword>
<keyword
>Sprache</keyword>
<keyword
>Erfassen</keyword>
<keyword
>Aufnahme</keyword>
<keyword
>Zugangshilfe</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
>Das Handbuch zu &kmyapplication;</title>
</bookinfo>

<chapter id="introduction">
<title
>Einführung</title>

<para
>&kmyapplication; ist die Serverkomponente für das Programm „SSC“ zum Erfassen von Aufnahmen. </para>
<para
>sscd verwaltet Sprecherdaten (Benutzer, Institutionen) sowie die Metadaten der Aufnahmen in einer Datenbank. Außerdem speichert es die Aufnahmen. </para>
<para
>SSCd erhält Daten von den SSC-Programmen, die sich über TCP/IP zum Server verbinden. </para>

<para
>Für mehr Information über die Architektur der Simon-Programme lesen Sie bitte das <ulink url="help:/simon/overview.html#architecture"
>Handbuch zu Simon</ulink
>. Für Informationen über den SSC-Programm lesen Sie bitte das <ulink url="help:/ssc"
>Handbuch zu SSC</ulink
>.</para>
</chapter>

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

<para
>&kmyapplication; ist ein Befehlszeilenprogramm ohne Benutzerschnittstelle. Es gibt auch keine speziellen Befehlszeilenparameter.</para>


<sect1 id="sscd_folder">
  <title
>ssc-Basisordner</title>
  <para
>Der Basisordner von &kmyapplication; beinhaltet die Einrichtungsdatei <filename
>sscd.conf</filename
> und ein Fehlerprotokoll, falls Probleme auftreten. Der Ordner beinhaltet auch den Unterordner <filename
>samples</filename
>, der die gesamten Sprachdaten enthält.</para>

<para
>Der Pfad zum SSCd-Ordner hängt von Ihrem Betriebssystem ab: <table frame='all'
><title
>SSC-Basisordner</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
>Installationsordner von sscd.exe (normalerweise: C:\Programme\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
>Einrichtung</title>

  <para
>Es existiert keine grafische Einrichtung für SSCd, aber es gibt eine Einrichtungsdatei (<filename
>sscd.conf</filename
>), die im <link linkend="sscd_folder"
>SSCd-Basisordner</link
> gespeichert ist.</para>

  <para
>Die Standardeinrichtungsdatei ist gut dokumentiert und sollte selbstklärend sein.</para>

  <para
>Bevor Sie SSCd starten, werden Sie vermutlich zumindest den Eintrag „DatabaseUser“ und „DatabasePassword“ in der Einrichtungsdatei anpassen wollen. Lesen Sie den Abschnitt <link linkend="database"
>Datenbank</link
> für weitere Informationen.</para>

  <screen
>; Dies ist ein Beispiel einer Einrichtungsdatei und zeigt die Standardeinstellungen
; SSCd sucht nach dieser Datei in:
; Linux:
;    /usr/share/sscd/sscd.conf
; Windows:
;    &lt;sscd-installations-pfad&gt;\sscd.conf

[General]
; Ändern Sie diese Einstellung, um eine andere Datenbank zu verwenden.Da SSCd datenbankspezifische
; Befehle verwendet, wird zur Zeit nur QMYSQL unterstützt.
; Unterstützung für andere Datenbankverwaltungssysteme (DBMS) kann sehr leicht hinzugefügt werden,
; daher fragen Sie auf der Mailingliste kde-accessibility@kde.org danach
DatabaseType=QMYSQL

; Der Rechner des DBMS
DatabaseHost=127.0.0.1

; Der Port des DBMS; 3306 ist der Standardport für MySQL
DatabasePort=3306

; Die zu benutzende Datenbank. Stellen Sie sicher, dass das mitgelieferte Erstellungsskript ausgeführt wird
; ehe Sie SSCd verwenden
DatabaseName=ssc

; Der Benutzername für die Verbindung mit dem DBMS
DatabaseUser=sscuser

; Datenbankpasswort. Die Standardeinstellung funktioniert offensichtlich in den meisten Fällen nicht
DatabasePassword=CHANGE ME NOW

; Datenbankoptionen. In der Qt-Dokumentation für QSqlDatabase finden Sie weitere Informationen
DatabaseOptions=MYSQL_OPT_RECONNECT=1

; Der Port auf dem Server, Standardwert: 4440
Port=4440

; Bindet den Server an eine bestimmte IP des Client. Ist dieser Wert „true“, ignoriert der Server
; alle Anfragen außer vom „BindHost“ (siehe nächste Einstellung)
Bind=false

; IP des „BindHost“, wenn die Einstellung „Bind“ aktiviert ist
BindHost=127.0.0.1
  </screen>
</sect1>

<sect1 id="database">
  <title
>Datenbank</title>

  <para
>&kmyapplication; speichert die Sprecher und die Aufnahmedaten (aber nicht die Aufnahmen selbst) in einer Datenbank. Derzeit werden nur MySQL-Datenbanken voll unterstützt. Es ist aber leicht, die Unterstützung für eine neue Datenbank hinzuzufügen. Kontaktieren Sie das <ulink url="mailto:kde-accessibility@kde.org"
>Simon-Team</ulink
>, falls Sie dabei helfen möchten.</para>

  <para
>Um die notwendigen Tabellen einzurichten, liefert &kmyapplication; ein entsprechendes Skript <filename
>mysql_create_script.sql</filename
> mit aus, das im <link linkend="sscd_folder"
>Basisordner</link
> von &kmyapplication; liegt.</para>


  <para
>Datenbankfehler können in der Fehlerprotokolldatei <filename
>error.log</filename
> gefunden werden, die ebenfalls im Basisordner liegt.</para>

</sect1>

<sect1 id="locked_mode">
  <title
>Sperrmodus</title>


  <para
>SSCd kann optional mit dem Befehlszeilenargument <option
>-l</option
> oder <option
>--locked</option
> gestartet werden, um den als Standard abgeschalteten Sperrmodus einzuschalten.</para>

  <para
>Im Sperrmodus können sich Clients immer noch mit dem Server verbinden und auch neue Mikrofone und Soundkarten erstellen, haben aber keinen Schreib- oder Lesezugriff auf irgendwelche Personen- oder Institutsdaten außer dem Benutzernamen und der -kennung. Damit kann die Anzeige von persönlichen Daten der Patienten für Aufnahmeteams eingeschränkt werden.</para>

  <para
>Im Sperrmodus können außerdem auch keine Benutzer gesucht werden, daher sollten die Aufnahmeteams vorher eine Liste der Benutzerkennungen erhalten.</para>
</sect1>

<sect1 id="extracting_samples">
  <title
>Gesammelte Aufnahmen extrahieren</title>

  <para
>Um Modelle aus den Aufnahmen zu erstellen, die in &kmyapplication; gesammelt wurden, müssen Sie diese zuerst aus der Datenbank extrahieren.</para>

  <warning>
    <para
>Weil &kmyapplication; für große Installationen gedacht ist, ist dieser Prozess derzeit noch nicht Endanwenderfreundlich. Die Dokumentation hier ist hauptsächlich für technisch versierte Profis gedacht. </para>
    <para
>Die meisten Skripte hier benötigen die GNU Tools (normalerweise standardmäßig installiert auf GNU/Linux). </para>
  </warning>

  <para
>Sie können die folgende Abfrage (kleine Anpassungen sind je nach dem welche Aufnahmen Sie extrahieren wollen eventuell notwendig) verwenden: <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
>Diese Abfrage wird eine Liste aller Sample von Institution 3 holen, die mit Mikrofon 1 aufgenommen wurden.</para>

  <para
>Sie können diese Liste zum Beispiel verwenden um, eine Prompts-Datei zu erzeugen. <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
>Diese Prompts-Datei kann dann <ulink url="help:/simon/training.html#import_training-data"
>in Simon importiert</ulink
> werden. </para>

  <para
>Um das entsprechende Wörterbuch für das Kompilieren des Modells zu erstellen, benötigen Sie eventuell eine Liste aller Sätze, die in der Prompts-Datei enthalten sind. Sie können diese Liste mit dem folgenden Skript erstellen: <screen
>#!/bin/bash
      cat $1 | sed -e 's/[0-9\/]* //' | sort | uniq
    </screen>
  </para>
</sect1>
</chapter>


<chapter id="faq">
<title
>Fragen und Antworten</title>

<para
>Um diesen Abschnitt immer aktuell zu halten, wird dieser Teil des Handbuchs in unserem <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Troubleshooting_Guide"
>Wiki</ulink
> veröffentlicht. </para>

</chapter>

<chapter id="credits">
<title
>Danksagungen und Lizenz</title>

<para
>&kmyapplication; </para>
<para
>Copyright des Programms 2008-2010 Peter Grasch <email
>peter.grasch@bedahr.org</email
> </para>

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

<para
>Peter Grasch<email
>grasch@simon-listens.org</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Installation</title>
<para
>Im <ulink url="http://userbase.kde.org/Special:myLanguage/Simon/Installation"
>Wiki</ulink
> finden Sie eine detaillierte Installationsanleitung.</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;
-->
