##---------------------------------------------------------------------------
## 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,
##                                         luft ab 3.6.0 aufwrts)
##                              2.8.1      ga (Webabfrage auf 
##                                         www.telefonbuch.de umgestellt,
##                                         "Doku" Fli4L-standardgem
##                                         eingebunden - nur PDF) 
##
##---------------------------------------------------------------------------

======== Vorbemerkung: ======================================================
Ich lege hier eine sehr eingeschrnkte Version vor.
Das FLI4L-Team hat sich dankenswerterweise 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 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 Hilfe, 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, dass 
die Ziffernserie nicht in der Telefonnummer gesucht wird.

------------------ Nummer zu Name ----------------------------
Manchmal liefert die Nummer-zu-Name-Auflsung ber www.dastelefonbuch.de keine 
oder komische Resultate. Bevor man nun meine Scripte dafr verantwortlich 
macht, bitte erst schauen, was passiert, wenn von Hand bei 
www.dastelefonbuch.de gesucht wird. Nur wenn genau ein Eintrag gefunden wird, 
kann das Script sinnvoll 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 das syslog (ein paar Fehler 
werden dort gemeldet). Lsst 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.

