====== Der Telefonnummern Parser ======


  * Das Programm konvertiert alle Telefonnummern ins DIN- oder Outlook-Format mit Landesvorwahl

  * Das Ausgabeformat kann in der Eingabemaske gewählt werden

 

==== Ausgabeformate ====

+Landesvorwahl Ortsvorwahl Rufnummer-Durchwahl ZusatzTXT [VorTXT] --> DIN (Std.)

+Landesvorwahl(Ortsvorwahl)Rufnummer-Durchwahl ZusatzTXT [VorTXT] --> Outlook
\\  \\  


Der 'Telefonnummern-Parser' wandelt folgende Felder in ein einheitliches Ausgabeformat um:\\  

**Firmenebene**
\\  [Telefon] "Tlf" (Eb 16, 17)\\  [Telefax] "Tfx" (Eb 16)

**Personenebene**
\\  [Telefon-Durchwahl] "Tdw" (Eb 17)

**Kommentarfelder**
\\  [Telefon] "Ktl"\\  [Telefax] "Kfx"

 

 

==== So arbeitet der Telefon Parser ====


  * Rufnummern mit einem Fragezeichen ? am Anfang werden grundsätzlich übersprungen
 
  * Wenn die Rufnummer nicht mit "**0**", "**+**" oder "**?**" beginnt, wird von einer normalen Rufnummer ausgegangen und die in der Eingabemaske definierte Orts- und Landesvorwahl vor diese Nummer geschrieben

  *  Falls keine Orts- und Landesvorwahl angegeben ist, wird die Nummer nicht geparst und mit einem ? versehen (=fehlerhafte Rufnummer)
 
  * Telefonnummern außerhalb Deutschlands, die keinen Trenner zwischen Landes-, Ortsvorwahl und Hauptnummer besitzen, werden folgendermaßen umgewandelt: "00123456789" ------> "+1 234 56789"\\ Die Auslandsortsvorwahl wird auf 3 Stellen gekürzt, die verbleibenden Ziffern als Hauptnummer verwendet
 
  * Telefonnummern innerhalb Deutschlands //können// einen Trenner zwischen Landes- und Ortsvorwahl besitzen, //müssen// aber nicht
 
  * Durchwahlen in einer Nummer sind ausschließlich durch ein "-" zu trennen!
 
  * Nummern mit ungültiger Landesvorwahl werden berichtigt.\\ Im Beispiel ist die Landesvorwahl fälschlicherweise +12. Sie wird in +1 umgewandelt, die 2 wird der Ortsvorwahl angefügt.\\ Beispiel: "+12/132/456" ------> "+1 2132 456"
 
  * Nummern mit ungültiger deutscher Ortsvorwahl werden berichtigt.\\ Im Beispiel ist die Ortsvorwahl fälschlicherweise '346715'. Sie wird in '34671' umgewandelt, die '5' wird der Rufnummer angefügt.\\ Beispiel: "+49346715/5-3238" ------> "+49 34671 55-3238"
 
  * Sonderbehandlung der Buchstaben "O" und "o":\\ Umwandlung des Buchstabens in Null wird nur vorgenommen, wenn das O von einer Zahl umschlossen ist, bzw. ein O-o folgt.\\  Sobald eine Abbruchbedingung in der Nummer zutrifft, wird der restliche String (=NachTxt) nicht mehr umgewandelt.\\  Falls //hinter// der Nummer ein Text stand, wird dieser wieder hinter die geparste Nummer geschrieben.\\  Falls //vor// der Nummer ein Text stand, wird dieser hinter dem Zusatztext, falls vorhanden, in eckigen Klammern geschrieben.\\ Beispiel: "KI GmbH: 034671/55551 Hauptnummer" ------> "+49 34671 55551 Hauptnummer [KI GmbH:]" 


**Gut zu wissen**
\\  Nummern, welche durch unkorrekte Schreibweise nicht erfolgreich geparst werden konnten,\\  werden mit einem Fragezeichen ? vor der Nummer versehen und gespeichert.\\  
\\  
==== Sonderbehandlung des Feldes Telefondurchwahl [Tdw] in der Personenebene ====


  * Alle durch Komma getrennten Nummern werden geparst 
  * Faxnummern sind ausschließlich mit einem "F" am Ende der Nummer zu kennzeichnen! 
  * Wenn in der Eingabemaske die Option [Telefondurchwahl auflösen] aktiviert ist, wird die erste Telefonnummer\\ in [Tdw] beibehalten und die restlichen Telefonnummern werden in das Kommentarfeld zu [Ktl] bzw. Faxnummern zu [Kfx] gespeichert 
  * Ist die Option nicht aktiviert, wird die Telefondurchwahl der Personenebene nicht geparst (keine Änderungen). 

 

===== Installation =====

  * PlugIns müssen immer über Setup.exe von der Installations-CD installiert werden 
  * Starten Sie den RemoteAdmin 
  * Klicken Sie den Button [PHP-Projekte] 
  * Importieren Sie über [Import File] die Datei //Telefonnummern-Parser-de.pjz// und schließen den Dialog mit [OK] 
  * Wechseln Sie in das Menü [User] 
  * Klicken Sie den Anwender doppelt, zu dem das eingecheckte Projekt aktiviert werden soll 
  * Durch Klick auf [PHP-Projekte] und anschließender Zuordnung wird das Projekt für den User freigeschaltet 
  * Die Kundenverwaltung muß neu gestartet werden, damit die Änderungen greifen\\ \\   

===== Telefon Parser einsetzen =====


**Gut zu wissen**
\\  Es wird dringend empfohlen, vor dem Durchlauf ein Backup der Datenbank zu machen!\\

  * Wählen Sie Menüpunkt [Tools] / [Telefon Parser] 
  * Nach Eingabe der eigenen Vorwahl und Landesvorwahl (optional) sowie Festlegung des Ausgabeformats\\ kann der Parsevorgang über [Start] aktiviert werden 
  * Falls die //Telefondurchwahl auf Personenebene// aufgelöst werden soll, aktivieren Sie die Funktion [Telefondurchwahl auflösen]\\ Dadurch wird die erste Telefonnummer in [Tdw] beibehalten und die restlichen Telefonnummern in das Kommentarfeld\\ zu [Ktl] bzw. Faxnummern zu [Kfx] gespeichert.\\ Ist die Option nicht aktiviert, wird die Telefondurchwahl der Personenebene nicht geparst (keine Änderungen) 
  * Es wird eine Log-Datei im Datenbankverzeichnis der Kundenverwaltung im Ordner [Output] erstellt,\\ wo alle geänderten Rufnummern eingetragen werden (Quellnummer und geparste Nummer mit Fehlercodes) 

 

==== Fehlercodes - alle Felder außer 'Tdw' ====


| 0 | - | ok |
| 1 | - | Telefonnummer nicht komplett |
| 2 | - | keine Telefonnummer gefunden |
| 3 | - | Ländervorwahl ungültg |
| 4 | - | keine Ortsvorwahl gefunden |
| 5 | - |  Rufnummer nach Auslandsvorwahl zu kurz |
| 6 | - | Ortsvorwahl ungültig |
| 7 | - | keine Rufnummer nach Ortsvorwahl gefunden |
| 8 | - | Länder- und Ortsvorwahl OK, aber keine Rufnummer vorhanden |
| 9 | - | eigene Vorwahl bei dieser Rufnummer erwartet, aber nicht vorhanden |
| 10 | - | Nummer wurde bereits geparst (Fragezeichen am Anfang) |
| 11 | - |  Nummer zu lang (mehr als 15 Ziffern -> LndVW + OrtVW + TelNR + TelDW) |

 

==== Fehlercodes - Feld 'Tdw' der Person ====

| 0 | - | ok |
| 1bis 11 | - | n u r komplette Nummern - Fehlercode von allen Feldern (siehe oben) |
| 20 | - | Nummer wurde bereits geparst - (Fragezeichen am Anfang) |
| 21 | - | keine Firmennummer vorhanden |
| 22 | - | Firmennummer fehlerhaft |
| 23 | - | Firmennummer ist keine Durchwahl |
| 24 | - | Nummer zu lang |

 

   

==== Mögliche Eingabeformate für Telefon- / Faxnummern ====


  * Nachstehende Eingabeformen werden vom 'Telefon Parser' berücksichtigt

  * Sollte das Programm die Telefonnummern schon einmal in ein anderes Ausgabeformat konvertiert haben,\\ werden diese Nummern natürlich auch wieder berücksichtigt, obwohl keine "falsche" Eingabe vorliegt

  * Sie können alle Telefonnummern vom DIN-Format in das Outlook-Format umwandeln lassen und umgekehrt


| 55-3238 | Wenn die Rufnummer __nicht__ mit "0", "+" oder "?" beginnt, wird von einer normalen Rufnummer ausgegangen und die in der Eingabemaske definierte Orts-und Landesvorwahl vor diese Nummer geschrieben.\\ Falls keine Orts- und Landesvorwahl angegeben ist, wird die Nummer nicht geparst und mit einem ? versehen =fehlerhafte Rufnummer |
| 001-34671/55-551Zusatztext |   |
| 00493467155551 |   |
| 0001-34671/55-551 Zusatztext | 3-fache Null Ausland |
| 00049-34671/55-551 Zusatztex | 3-fache Null DTL |
| +01/34671/55551 | + und Null Ausland |
| +049/34671/55551 | + und Null DTL |
| +O49/3631/4250 | o-O-0 |
| +49/36o31/4250 | o-O-0 |
| bla OoO1 3631/4250 | o-O-0 wird nicht umgewandelt |
| bla oo1 3631/4250 | o-O-0 wird nicht umgewandelt |
| oo1 34671 55551 | o-O-0 |
| Ko+49 34671 55551 | o-O-0 wird nicht umgewandelt |
| +6o34671/55551 | o-O-0, Buchstabe o der Landesvorwahl wird in Null umgewandelt |
| 034671/5o1-51 | o-O-0 Buchstabe o INNERHALB der Nummer wird nur in Null umgewandelt |
| 034671/55551o Ost | o-O-0 |
| 034671/55oo1-O | o-O-0 |
| 034671/55oo1-O Txt | o-O-0 |
| 034671/55oo1-O Ost | o-O-0 |
|  / 034671 55551 | Slash als Vortext wird ignoriert |
| +493467155551 |   |
| +493467155-551 |   |
| +49/34671/55-551 |   |
| +49/34671-55-551 |   |
| +49-34671-55-551 |   |
| +49-34671/55-551 |   |
| 03467155551 |   |
| Fax | 034671/77-008 Nachtext |