##-----------------------------------------------------------------------------
## phonebook.txt - fli4l Dokumentation                                  V 0.9
##
## Creation:                    09.02.2007 jk
## Version:                     2.7.4      jk
## Modifikation:                2.7.8      ms1958 (Anpassung an FLI4L V3.6.0)
## Neustart:                    2.8        ga (Webabfrage neu eingebunden, diverse kleine 
##                                         Fehler beseitigt)
##
##-----------------------------------------------------------------------------

======== Vorbemerkung: ============================================================
Ich lege hier eine sehr eingeschrnkte Version vor.
Das FLI4L-Team hat dankenswerterweise sich um die Versionschecks gekmmert.
Ich musste lediglich die Webabfrage bei dasoertliche.de neu einbinden.
Derzeit funktioniert die reine Anruferkennung, mehr nicht!


======= Allgemein =================================================================
Es gibt viele Mglichkeiten, das Phonebook zu nutzen und in den allgemeinen Workflow
zu integrieren. Es kann z.B. das Phonebook ein Auszug aus einer greren Adressenliste
sein, der regelmig zum Router bertragen wird. Man kann aber auch das Phonebook auf
dem Router fhren und per imonc auf dem einem (Desktop)Client aktualisieren lassen.
Man kann die Eintrge ins Phonebook von Hand machen oder von Scripten erledigen lassen.
Dieses Opt-Paket bietet fr einige Szenarien eine Hife, kann aber sicherlich nicht alle
Wnsche befriedigen.

------------------ Synchronisation per imonc -------------------
Der Imonc enthlt eine Funktion, um das Phonebook vom Router mit einem auf einem Desktop
zu synchronisieren. Mir ist berichtet worden, dass dabei zu lange Phonebook-Eintrge auf
eine bestimmte Lnge gekrzt werden. Fr Namen drfte das im Allgemeinen ausreichen,
mit Adressen kann es aber zu lang werden. Bitte also diese Funktion mit Vorsicht
einsetzen.

------------------ phonebookserv / sclient -------------------
Das Programm "phonebookserv.exe" wurde von Henry H. programmiert, der Quellcode ist in der
Datei "phonebookserv.au3" zu finden.
Zum Programm "sclient.exe" siehe "sclient_info.txt".
Welches der Programme auf welchem System berhaupt funktioniert oder in irgend einer Weise
fr Euer Netzwerk *besser* ist, msst Ihr selber ausprobieren. Falls jemand eine Linux-Variante
programmiert, nehme ich sie gerne in das OPT mit auf.

------------------ WebGui ------------------------------------
Die WebOberflche von OPT_PHONEBOOKWEBGUI ist nicht mehrbenutzerfhig. Wenn mehrere Nutzer
gleichzeitig auf das Script "phonebook.cgi" zugreifen, kann die Anzeige und eventuell der
Datenbestand durcheinandergeraten.
Die Suche im Phonebook (also Tab "Phonebook") unterscheidet zwischen Gro- und
kleinschreibung, es knnen auerdem regulre Ausdrcke (wie in grep) verwendet werden. Will
man z.B. alle Rufnummern mit der Vorwahl "069" so sollte man nach "^069" suchen, da sonst
auch nummern wie z.B. "01222069222" gefunden werden. Will man nach der PLZ "33333" suchen,
kann man mit "=.*33333" erreichen, da die Ziffernserie nicht in der Telephonnummer gesucht
wird.

------------------ Nummer zu Name ----------------------------
Manchmal liefert die Nummer-zu-Name-Auflsung ber www.dasOertliche.de keine oder komische
Resultate. Bevor man nun meine Scripte dafr verantwortlich macht, bitte erst schauen, was
passiert, wenn von Hand bei dasOertliche gesucht wird. Nur wenn genau ein Eintrag gefunden wird,
kann das Script sinvoll fortfahren. (Lest auch mal die Log-Datei.)

------------------ Problemanalyse ----------------------------
Bei Problemen: Lest diese Doku und die "/config/phonebook.txt"; lasst das OPT die Logdatei
erstellen und lest sie; schaut in den syslog (ein paar Fehler werden dort gemeldet)
Lt sich das Problem nicht klren, postet in "spline.fli4l.opt" einen mglichst genauen
Bericht.


====================== Schlubemerkung ====================================
Wem das zu wenig Erklrung ist, der kann mich ja nochmal auf die Punkte
aufmerksam machen, die ihm unklar sind.

Jakob Keller: (jk)
    Ich habe das Paket von Henry Haebel bernommen, von dem der folgende Dank stammt:
    DANKE an Manfred Schliesing (ms1958) Bugfixes,
    Marcus Roeckrath, Daniel Kubein und alle die ich jetzt vergessen habe

====================== Schlubemerkung 2 ==================================

Manfred Schliesing: (ms1958 , FLI4L Testteam)
    Da wir nun bei FLI4L V3.6 angelangt sind, und das Opt keiner mehr betreut,
    versuche ich hiermit, Das Opt erst mal soweit zu bekommen, das es unter 
    FLI4L 3,6,0 wieder luft. Mit Hilfe vom FLI4L Team knnte das auch gelingen :-)
    Manfred Schliesing /ms1958-at-web.de)

Gotthard Anger:
    Vielen Dank an das FLI4L-Team fr eine grossartige Idee und die Arbeit die Ihr da reinsteckt!
    Ebenso fr mancherlei Hilfe an die diversen Foren.
