Metainformationen zur Seite
  •  

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
adhandbuch:benutzer_gruppen:gruppen:telefonbuch_csv [19.05.2025 11:00] – Falscher Header in Beispieldatei korrigiert arvid.grimmadhandbuch:benutzer_gruppen:gruppen:telefonbuch_csv [26.06.2025 13:46] (aktuell) – richard.neubert
Zeile 1: Zeile 1:
-<WRAP hide>{{tag>red:newgui red:proof}}</WRAP> +<WRAP tabs> 
-<WRAP>{{tag>gui:Admin-Client func:Berechtigungen func:Telefonbuch func:Kontakte}}</WRAP> +  * [[:adhandbuch:benutzer_gruppen:gruppen:telefonbuch_csv             |Aktuell seit 6.3  ]] 
-<WRAP 1050px>+  * [[:archiv:6_2:adhandbuch:benutzer_gruppen:gruppen:telefonbuch_csv  |< 6.2             ]] 
 +  * [[:archiv:6_1:adhandbuch:benutzer_gruppen:gruppen:telefonbuch_csv  |< 5.x             ]] 
 +</WRAP>
  
-<WRAP info>**Versionshinweis:**\\ Dieser Artikel wurde für [[:release:ucware6|UCware 6.2]] überarbeitet. Die Vorgängerversion finden Sie [[:archiv:6_1:adhandbuch:benutzer_gruppen:gruppen:telefonbuch_csv|hier]].</WRAP>+<WRAP hide>{{tag>red:newgui red:proof}}</WRAP> 
 +<WRAP>{{tag>vers:v.6.3 gui:Admin-Client func:Berechtigungen func:Telefonbuch func:Kontakte}}</WRAP> 
 +<WRAP 1150px>
  
  
Zeile 18: Zeile 22:
 <WRAP tip> <WRAP tip>
 **Hinweis:**\\ **Hinweis:**\\
-Importierte Telefonbucheinträge sind für die Bearbeitung im UCC-Client gesperrt. Aktualisierungen erfordern daher Zugriff auf die Datenquelle und werden erst nach einem erneuten Import wirksam.+Importierte Telefonbucheinträge sind für die Bearbeitung im UCC-Client gesperrt. Aktualisierungen erfordern daher Zugriff auf die Datenquelle und werden erst nach dem nächsten Import wirksam.
 </WRAP> </WRAP>
  
Zeile 28: Zeile 32:
 ==== Einfacher Import ==== ==== Einfacher Import ====
  
-Mit dieser Methode können Sie ausschließlich die Kontaktattribute **Vorname**, **Name** und eine einzelne **Telefonnummer** importieren.+Mit dieser Methode können Sie ausschließlich die Kontaktattribute //Vorname//, //Name// und eine einzelne //Telefonnummer// importieren.
  
 Strukturieren Sie die CSV-Datei dazu wie folgt: Strukturieren Sie die CSV-Datei dazu wie folgt:
 <code>VORNAME,NACHNAME,TELEFONNUMMER</code> <code>VORNAME,NACHNAME,TELEFONNUMMER</code>
  
-**Beispiel:** +== Beispiel: == 
-<WRAP indent>+
 <file csv pb_28.csv> <file csv pb_28.csv>
 Vorname,Nachname,Telefonnummer Vorname,Nachname,Telefonnummer
Zeile 44: Zeile 48:
 Florian,"Fröhlich, M. Sc.",04066969135 Florian,"Fröhlich, M. Sc.",04066969135
 </file> </file>
-</WRAP> 
  
-**Erläuterungen:**+== Erläuterungen: == 
 + 
 +  * Pro Datensatz ist genau //eine// Telefonnummer zulässig. 
 + 
 +  * Die oberste Zeile wird beim Import übersprungen. Daher darf Sie //keine Telefonbucheinträge// enthalten.
  
-  * Pro Datensatz ist genau **eine** Telefonnummer zulässig. 
-  * Die oberste Zeile wird beim Import übersprungen. Daher darf Sie **keine Telefonbucheinträge** enthalten. 
   * Datenfelder müssen mit '','' getrennt sein, können aber leer bleiben (vgl. vorletzte Zeile).   * Datenfelder müssen mit '','' getrennt sein, können aber leer bleiben (vgl. vorletzte Zeile).
 +
   * Datenfelder, die inhaltliche Kommas enthalten, müssen mit ''%%" "%%'' umschlossen sein (vgl. letzte Zeile).   * Datenfelder, die inhaltliche Kommas enthalten, müssen mit ''%%" "%%'' umschlossen sein (vgl. letzte Zeile).
  
-**Darstellung im UCC-Client:**+== Darstellung im UCC-Client: ==
  
-<WRAP group indent> +<WRAP group> 
-<WRAP column 450px>{{:adhandbuch:benutzer_gruppen:uccc_csv_import_einfach_ergebnis.png?direct|}}</WRAP> +<WRAP column half>{{:adhandbuch:benutzer_gruppen:uccc_csv_import_einfach_ergebnis.png?direct|}}</WRAP> 
-<WRAP column 500px>Beim einfachen Import werden alle Kontakte **derselben Gruppe** zugewiesen. Diese trägt standardmäßig den Namen des übergeordneten Telefonbuchs.+<WRAP column half>Beim einfachen Import werden alle Kontakte //derselben Gruppe// zugewiesen. Diese trägt standardmäßig den Namen des übergeordneten Telefonbuchs.
  
 Benutzer des UCC-Clients können das Telefonbuch und/oder die Gruppe bei Bedarf nachträglich [[benutzerhandbuch:hauptseite:telefonbuecher:sitemap|umbenennen]]. Benutzer des UCC-Clients können das Telefonbuch und/oder die Gruppe bei Bedarf nachträglich [[benutzerhandbuch:hauptseite:telefonbuecher:sitemap|umbenennen]].
Zeile 68: Zeile 74:
 Mit dieser Methode können Sie die folgenden Kontaktattribute importieren: Mit dieser Methode können Sie die folgenden Kontaktattribute importieren:
  
-<WRAP col4 lo>+<WRAP col4 900px lo>
   * Namenspräfix   * Namenspräfix
   * Name   * Name
Zeile 92: Zeile 98:
 <code>VORNAME,NACHNAME,PRÄFIX,SUFFIX,GRUPPE,HAUPTNUMMER,[OPTION:]ATTRIBUT 7,[OPTION:]ATTRIBUT 8,[OPTION:]ATTRIBUT 9,...</code> <code>VORNAME,NACHNAME,PRÄFIX,SUFFIX,GRUPPE,HAUPTNUMMER,[OPTION:]ATTRIBUT 7,[OPTION:]ATTRIBUT 8,[OPTION:]ATTRIBUT 9,...</code>
  
-**Beispiel:** +== Beispiel: == 
-<WRAP indent>+
 <file csv pb_28.csv> <file csv pb_28.csv>
-Vorname,Nachname,Präfix,Suffix,Gruppe,Hauptnummer,pri:Handy,fax:Fax,mail:Mail,link:Web,comp:Firma,dep:Abteilung,func:Funktion,Branche,Stadt  +Vorname, Nachname,     Präfix, Suffix,  Gruppe, Hauptnummer,   pri:Handy,     fax:Fax,             mail:Mail,                         link:Web,                comp:Firma,     dep:Abteilung,  func:Funktion,   Branche,           Stadt, id:ID 
-Raffael,Ramsauer,,M. Sc.,Partner,03023125246,01729980752,,raffael@ramsauer.com,https://www.raffael-ramsauer.com,Ramsauer Consultants GmbH,Leitung,CEO,IT,Berlin +Raffael, Ramsauer,           , M. Sc., Partner, 03023125246, 01729980752,            ,  raffael@ramsauer.com, https://www.raffael-ramsauer.com, Ramsauer Consultants GmbH,           Leitung,            CEO,        IT,          Berlin,    21 
-Hartmut,Hohlbein,Dipl.-Ing.,M. Sc.,Partner,02214710321,01749091317,,hartmut@hohlbein.com,https://www.hartmut-hohlbein.com,Hohlbein Entwicklung GmbH,Leitung,COO,E-Technik,Köln +Hartmut, Hohlbein, Dipl.-Ing., M. Sc., Partner, 02214710321, 01749091317,            ,  hartmut@hohlbein.com, https://www.hartmut-hohlbein.com, Hohlbein Entwicklung GmbH,           Leitung,            COO, E-Technik,            Köln,    22 
-Giesela,Graumann,,StB,Kunden,06990009007,01749464308,06990009007,giesela@graumann.de,,Steuerberatung Graumann,,Inhaberin,Finanzen,Frankfurt a. M. +Giesela, Graumann,           ,    StB,  Kunden, 06990009007, 01749464308, 06990009007,   giesela@graumann.de,                                 ,   Steuerberatung Graumann,                  ,      Inhaberin,  Finanzen, Frankfurt a. M.,    23 
-Pamella,Petersen,Dr.,MdL,Kunden,08999998759,01729973186,08999998758,pamella@petersen.de,,Landtag,Verkehrsausschuss,Vorsitzende,Politik,München +Pamella, Petersen,        Dr.,    MdL,  Kunden, 08999998759, 01729973186, 08999998758,   pamella@petersen.de,                                 ,                   Landtag, Verkehrsausschuss,    Vorsitzende,   Politik,         München,    24 
-Florian,Fröhlich,,M. Sc.,Partner,04066969135,01729925904,,florian@froehlich.com,http://www.florian-froehlich.com,,,Freier Berater,E-Technik,Hamburg+Florian, Fröhlich,           , M. Sc., Partner, 04066969135, 01729925904,            , florian@froehlich.com, http://www.florian-froehlich.com,                          ,                  , Freier Berater, E-Technik,         Hamburg,    25
 </file> </file>
-</WRAP> 
  
-**Erläuterungen:**+ 
 +== Erläuterungen: ==
  
   * Die ersten sechs Felder jedes Datensatzes werden automatisch als //Vorname//, //Nachname//, //Namenspräfix//, //Namenssuffix//, //Gruppe// und //Hauptnummer// des jeweiligen Kontakts importiert. Sie müssen daher in der genannten Reihenfolge vorliegen.   * Die ersten sechs Felder jedes Datensatzes werden automatisch als //Vorname//, //Nachname//, //Namenspräfix//, //Namenssuffix//, //Gruppe// und //Hauptnummer// des jeweiligen Kontakts importiert. Sie müssen daher in der genannten Reihenfolge vorliegen.
-  * **Dahinter** können weitere Kontaktdaten folgen. Anzahl und Reihenfolge der zugehörigen Attribute sind dabei freigestellt. 
-  * Die Darstellung der Kontaktdaten im UCC-Client kann funktional angepasst werden. Stellen Sie dem Namen des jeweiligen Attributs dazu die entsprechende Option voran. Alternativ können Sie Zuordnungsziffern verwenden:\\ \\ <WRAP> 
  
-|< 650px 150px 150px - >| +  * //Dahinter// können weitere Kontaktdaten folgen. Anzahl und Reihenfolge der zugehörigen Attribute sind dabei freigestellt.
-^  Option         ^  Zuordnungs-ziffer  ^  Inhalt                             ^ +
-| ''tel:''        |  ''1:''             | zusätzliche Telefonnummern          | +
-| ''fax:''        |  ''2:''             | Faxnummern                          | +
-| ''mail:''       |  ''3:''             | E-Mail-Adressen                     | +
-| ''link:''       |  ''4:''             | Weblinks\\ <wrap tip lo>Stets vollständige URL angeben.</wrap> | +
-| ''pri:''        |  ''5:''             | zusätzliche Telefonnummer, die anstelle der Hauptnummer als bevorzugt gelten soll | +
-| ''comp:''       |  ''6:''             | Unternehmen des Kontakts            | +
-| ''dep:''        |  ''7:''             | Abteilung des Kontakts              | +
-| ''func:''       |  ''8:''             | Funktion bzw. Position des Kontakts |+
  
-</WRAP><WRAP clear />+  * Die Darstellung der Kontaktdaten im UCC-Client kann funktional angepasst werden. Stellen Sie dem Namen des jeweiligen Attributs dazu die entsprechende Option voran. Alternativ können Sie Zuordnungsziffern verwenden:\\ \\ <WRAP lo> 
 + 
 +|< 750px 100px 100px - >| 
 +^  Option         ^  Zuordnungs- ziffer  ^  Inhalt                             ^ 
 +| ''tel:''        |  ''1:''              | Zusätzliche Telefonnummern          | 
 +| ''fax:''        |  ''2:''              | Faxnummern                          | 
 +| ''mail:''       |  ''3:''              | E-Mail-Adressen                     | 
 +| ''link:''       |  ''4:''              | Weblinks\\ \\ <wrap tip />Stets vollständige URL angeben. | 
 +| ''pri:''        |  ''5:''              | Zusätzliche Telefonnummer, die anstelle der Hauptnummer als bevorzugt gelten soll. | 
 +| ''comp:''       |  ''6:''              | Unternehmen des Kontakts            | 
 +| ''dep:''        |  ''7:''              | Abteilung des Kontakts              | 
 +| ''func:''       |  ''8:''              | Funktion bzw. Position des Kontakts | 
 +| ''id:''         |  ''9:''              | Eindeutige Kennung des Kontakts innerhalb des Telefonbuchs: Diese stellt sicher, dass Kontakte in den Favoriten des jeweiligen Benutzers erhalten bleiben, wenn sich beim nächsten Import ein zugehöriges Attribut ändert. Zulässig sind ganze Zahlen.  | 
 + 
 +</WRAP>
   * Ansonsten gelten die gleichen Regeln wie beim einfachen Import.   * Ansonsten gelten die gleichen Regeln wie beim einfachen Import.
  
-**Darstellung im UCC-Client:**+== Darstellung im UCC-Client: ==
  
-<WRAP group indent> +<WRAP group> 
-<WRAP column 450px>{{:adhandbuch:benutzer_gruppen:uccc_csv_import_erweitert_ergebnis.png?direct|}}</WRAP> +<WRAP column half>{{:adhandbuch:benutzer_gruppen:uccc_csv_import_erweitert_ergebnis.png?direct|}}</WRAP> 
-<WRAP column 500px>Beim erweiterten Import werden die Kontakte anhand des entsprechenden Attributs gruppiert.+<WRAP column half>Beim erweiterten Import werden die Kontakte anhand des entsprechenden Attributs gruppiert. 
 + 
 +Hauptnummern und mit ''tel:'' gekennzeichnete Daten werden mit Anruf-Button dargestellt. An erster Stelle steht dabei entweder die Hauptnummer oder die mit ''pri:'' markierte Nummer. 
 + 
 +Daten, die mit ''comp:'', ''dep:'', ''func:'', ''fax:'', ''mail:'' oder ''link:'' markiert sind, werden mit einem speziellen Icon angezeigt.
  
-Hauptnummern und mit ''tel:'' gekennzeichnete Daten werden mit Anruf-Button dargestellt. An erster Stelle steht dabei entweder die Hauptnummer oder die mit ''pri:'' markierte Nummer.\\ \\  
-Daten, die mit ''comp:'', ''dep:'', ''func func:'', ''fax:'', ''mail:'' oder ''link:'' markiert sind, werden mit einem speziellen Icon angezeigt.\\ \\ 
 Daten ohne Markierung werden als //Sonstiges// darunter angezeigt. Die Sortierung erfolgt in diesem Fall anhand des Attributnamens. Daten ohne Markierung werden als //Sonstiges// darunter angezeigt. Die Sortierung erfolgt in diesem Fall anhand des Attributnamens.
 +
 +Daten, die mit ''id:'' markiert sind, werden nicht angezeigt.
 </WRAP> </WRAP>
 </WRAP> </WRAP>
Zeile 139: Zeile 152:
 ==== Importdurchlauf ==== ==== Importdurchlauf ====
  
-Der UCware Server importiert neue Kontaktdaten automatisch einmal pro Nacht aus dem Verzeichnis ''/var/spool/ucware/import/''. Voraussetzung ist, dass der zugehörige Dateiname die **ID eines bereits vorhandenen Telefonbuchs** enthält:+Der UCware Server importiert neue Kontaktdaten automatisch einmal pro Nacht aus dem Verzeichnis ''/var/spool/ucware/import/''. Voraussetzung ist, dass der zugehörige Dateiname die //ID eines bereits vorhandenen Telefonbuchs// enthält:
  
 <code>pb_ID.csv</code> <code>pb_ID.csv</code>
Zeile 159: Zeile 172:
  
 <WRAP group> <WRAP group>
-<WRAP column 550px>{{:adhandbuch:benutzer_gruppen:telbuchgruppe_mitglieder_zuweisen_id_markiert.png?direct|}}</WRAP> +<WRAP column half>{{:adhandbuch:benutzer_gruppen:telbuchgruppe_mitglieder_zuweisen_id_markiert.png?direct|}}</WRAP> 
-<WRAP column 475px outdent> +<WRAP column half outdent> 
-  - [[benutzerhandbuch:hauptseite:telefonbuecher:tb_hinzufuegen|Erstellen]] Sie in Ihrem eigenen oder einem anderen **UCC-Client** ein Telefonbuch.\\ \\ +  - [[benutzerhandbuch:hauptseite:telefonbuecher:tb_hinzufuegen|Erstellen]] Sie in Ihrem eigenen oder einem anderen //UCC-Client// ein Telefonbuch.\\ \\ 
-  - [[adhandbuch:benutzer_gruppen:gruppen:allg#Gruppe erstellen|Erstellen]] Sie im **Admin-Client** eine Gruppe vom Typ **Telefonbuch**.\\ \\ +  - [[adhandbuch:benutzer_gruppen:gruppen:allg#Gruppe erstellen|Erstellen]] Sie im //Admin-Client// eine Gruppe vom Typ //Telefonbuch//.\\ \\ 
-  - [[adhandbuch:benutzer_gruppen:gruppen:allg#Mitglieder oder Inhalte zuweisen|Weisen]] Sie dieser Gruppe das neue Telefonbuch zu.\\ \\ <wrap tip>Notieren Sie die **ID** des Telefonbuchs.</wrap>\\ \\ +  - [[adhandbuch:benutzer_gruppen:gruppen:allg#Mitglieder oder Inhalte zuweisen|Weisen]] Sie dieser Gruppe das neue Telefonbuch zu.\\ \\ <wrap tip />Notieren Sie die //ID// des Telefonbuchs.\\ \\ 
-  - [[adhandbuch:benutzer_gruppen:gruppen:allg#Gruppe erstellen|Erstellen]] Sie bei Bedarf eine neue Gruppe vom Typ **Benutzer** und [[adhandbuch:benutzer_gruppen:gruppen:allg#Mitglieder oder Inhalte zuweisen|weisen]] Sie ihr Mitglieder zu.\\ \\+  - [[adhandbuch:benutzer_gruppen:gruppen:allg#Gruppe erstellen|Erstellen]] Sie bei Bedarf eine neue Gruppe vom Typ //Benutzer// und [[adhandbuch:benutzer_gruppen:gruppen:allg#Mitglieder oder Inhalte zuweisen|weisen]] Sie ihr Mitglieder zu.\\ \\
   - [[adhandbuch:benutzer_gruppen:gruppen:allg#Berechtigung erteilen|Erteilen]] Sie der gewünschten Benutzergruppe die Berechtigung ''view_phonebook'' für die neue Telefonbuch-Gruppe.\\ \\   - [[adhandbuch:benutzer_gruppen:gruppen:allg#Berechtigung erteilen|Erteilen]] Sie der gewünschten Benutzergruppe die Berechtigung ''view_phonebook'' für die neue Telefonbuch-Gruppe.\\ \\
   - Übernehmen Sie die Einstellungen mit {{:adhandbuch:ac_button_speichern.png?nolink|}}.   - Übernehmen Sie die Einstellungen mit {{:adhandbuch:ac_button_speichern.png?nolink|}}.
Zeile 175: Zeile 188:
 Stellen Sie anschließend die CSV-Datei mit den Importdaten auf dem UCware Server bereit. Beachten Sie dabei die folgenden Hinweise: Stellen Sie anschließend die CSV-Datei mit den Importdaten auf dem UCware Server bereit. Beachten Sie dabei die folgenden Hinweise:
  
-  * Legen Sie als Zeichencodierung **UTF-8** fest. +  * Legen Sie als Zeichencodierung //UTF-8// fest. 
   * Benennen Sie die endgültige CSV-Datei nach dem folgenden Muster: <code>pb_ID.csv</code> Ersetzen Sie dabei die ''ID'' durch die notierte Telefonbuch-ID aus dem Admin-Client.    * Benennen Sie die endgültige CSV-Datei nach dem folgenden Muster: <code>pb_ID.csv</code> Ersetzen Sie dabei die ''ID'' durch die notierte Telefonbuch-ID aus dem Admin-Client. 
   * Stellen Sie die Datei im folgenden Verzeichnis des UCware Servers bereit: <code bash>/var/spool/ucware/import/</code>   * Stellen Sie die Datei im folgenden Verzeichnis des UCware Servers bereit: <code bash>/var/spool/ucware/import/</code>
  
-Der UCware Server importiert die Daten aus **allen** korrekt bereitgestellten CSV-Dateien automatisch einmal pro Nacht.+Der UCware Server importiert die Daten aus //allen// korrekt bereitgestellten CSV-Dateien automatisch einmal pro Nacht.
  
  
Zeile 187: Zeile 200:
  
   - Greifen Sie per SSH auf den UCware Server zu.   - Greifen Sie per SSH auf den UCware Server zu.
-  - Führen Sie den folgenden Befehl aus: <code bash>sudo systemctl start ucware-csvimport</code> Dadurch importiert der UCware Server die Daten aus **allen** korrekt benannten CSV-Dateien. +  - Führen Sie den folgenden Befehl aus: <code bash>sudo systemctl start ucware-csvimport</code> Dadurch importiert der UCware Server die Daten aus //allen// korrekt benannten CSV-Dateien. 
-  - Rufen Sie den UCC-Client auf und melden Sie sich mit den Daten eines **für das importierte Telefonbuch berechtigten Benutzers** an. +  - Rufen Sie den UCC-Client auf und melden Sie sich mit den Daten eines //für das importierte Telefonbuch berechtigten Benutzers// an. 
-  - Prüfen Sie im Hauptseiten-Widget **Kontakte** den korrekten Import der Namen und Rufnummern.+  - Prüfen Sie im Hauptseiten-Widget //Kontakte// den korrekten Import der Namen und Rufnummern.