CardDAV Contact Import Module

  • ACHTUNG: Das CardDAV Contact Import Module wird nicht weiterentwickelt. Details finden Sie unter https://wiki.fluxpunkt.de/disp…W/CardDAV+Adressen+Import


    [TABLE='align: left']

    [tr]


    [td]

    ENGLISCH:
    Today I want to present the first public beta version of a contact import module capable of importing single or multiple contacts formatted as vCard, xCard or hCard from sources such as


    • Local files
    • Webserver files
    • Network Share files (coming soon)
    • CardDAV Servers


    into a STARFACE address book (either a private one or the shared address book). The module also supports deleting the content of an address book — something that could previously only be accomplished by manually accessing STARFACE's internal database. Imports can be triggered manually or at given intervals, which enables continuous synchronization between the import source and the STARFACE address book. Multiple module instances can be configured for multiple sources. This way it is possible to synchronize multiple sources into the address book. Also multiple users can import their private address books into their own private STARFACE folder.



    The module has successfully imported contacts from Google Mail, Kerio Connect 8.0.0, Apple OSX Address book. Tests with Exchange/OWA, OSX Server and iCloud are currently being conducted. In its unlicensed state the module only shows the contacts it would have successfully imported if it was licensed. However deleting the content of an address book is supported without license. This is quite handy if, for example, the address book contains lots of malformed or duplicate entries.


    The module is currently available in English and German.


    AddressImportConfiguration.jpg


    Module Configuration

    • Flush an addressbook[INDENT]Import Source: No Import
      Folder: <folder to flush>
      Private folder of user: <user of whom to flush the address book>
      Clear address book prior to import: yes
      [/INDENT]


    • Google Mail[INDENT]Import Source: CardDAV-URL
      Format: vCard (Plaintext)
      URL: https://www.google.com/.well-known/carddav
      Username: <Google Username>
      Password: <Google Password>
      Strict HTTPS: yes
      HTTP Compression: yes
      Preemptive Authentication: no
      Ignore CardDAV Sync Tags: no[/INDENT]


    • Kerio Connect[INDENT]Import Source: CardDAV-URL
      Format: vCard (Plaintext)
      URL: http(s)://<kerio-host>/calendars/<kerio-domain>/<kerio-user>/Contacts/
      Username: <Kerio Username>
      Password: <Kerio Password>
      Strict HTTPS: no
      HTTP Compression: yes
      Preemptive Authentication: no
      Ignore CardDAV Sync Tags: yes[/INDENT]


    • Exchange/OWA (untested)[INDENT]Import Source: CardDAV-URL
      Format: vCard (Plaintext)
      URL: https://<exchange-host>/owa/
      Username: <Exchange Username>
      Password: <Exchange Password>
      Strict HTTPS: no
      HTTP Compression: yes
      Preemptive Authentication: yes
      Ignore CardDAV Sync Tags: yes[/INDENT]


    • ownCloud[INDENT]Import Source: CardDAV-URL
      Format: vCard (Plaintext)
      URL: https://<owncloud-host>/owncloud/remote.php/carddav/addressbooks/<username>/contacts
      Username: <ownCloud Username>
      Password: <ownCloud Password>
      Strict HTTPS: no
      HTTP Compression: yes
      Preemptive Authentication: no
      Ignore CardDAV Sync Tags: no[/INDENT]


    If you use HTTPS to securely access your CardDAV server, the server needs a valid non-self-signed certificate or else the connection will fail. If all you have is a self-signed certificate or the contained hostname does not fully match the actual hostname you may use the configuration switch "Strict HTTPS" to turn off these strict checks.



    Licenses are available for 349 Euro (plus VAT if applicable.) per appliance or virtual instance.


    To purchase a license, please download and import the attached module. Then follow the steps outlined in the module configuration.


    IMPORTANT: Licenses are bound to the Hardware ID of an appliance. If you use a virtual Appliance, the virtual Hardware (such as the processor(s)) must not change! Otherwise the license becomes invalid.


    HARDWARE REQUIREMENTS:
    Maximum number of addresses to be imported:
    STARFACE PRO: 2.500
    STARFACE Advanced: 6.000
    STARFACE Enterprise: 23.000
    STARFACE Platinum: 100.000

    [/td]


    [td]

    DEUTSCH:
    Gerne möchte ich heute die erste öffentliche Beta Version eines Adress-Import-Moduls vorstellen, welches den Import einer oder mehrerer Kontakte in den Formaten vCard, xCard oder hCard aus den folgenden Quellen in ein (privates oder öffentliches) STARFACE Adressbuch ermöglicht:

    • Lokale Adressbuch Datei
    • Dateien auf Webservern
    • Netzwerkfreigaben (bald verfügbar)
    • CardDAV Server


    Das Modul unterstützt außerdem das Leeren von Adressbüchern — etwas, das bisher nur über einen manuellen Eingriff in die interne STARFACE Datenbank möglich war. Adressbuch-Importe können manuell oder zeitgesteuert (auch in Intervallen) ausgeführt werden. STARFACE Adressbücher können so dauerhaft mit Adressbuchservern synchronisiert werden. Mehrere Instanzen des Moduls können für unterschiedliche Quellen und/oder unterschiedliche Benutzer konfiguriert werden. Auf diese Weise können verschiedene Adressbuchserver parallel in das STARFACE Adressbuch synchronisiert werden und Benutzer können jeweils eigene Adressbücher (beispielsweise aus ihrem Google Mail Account) in ihr privates STARFACE Adressbuch importieren.


    Mit dem Modul wurden erfolgreich Kontakte von Google Mail, Kerio Connect 8.0.0 und dem Apple OSX Address book importiert. Tests mit Exchange/OWA, OSX Server und iCloud laufen momentan. Im unlizensierten Zustand zeigt das Modul nur an, welche Kontakte importiert würden, wenn eine Lizenz vorhanden wäre. Das Leeren von Adressbüchern ist jedoch ohne Lizenz möglich, was sehr hilfreich sein kann, wenn beispielsweise durch einen CSV Import falsch formatierte oder doppelte Einträge in das Adressbuch übernommen wurden.


    Das Modul ist momentan in den Sprachen Deutsch und Englisch verfügbar.


    AddressImportConfiguration.jpg


    Modul Konfiguration

    • Adressbuch leeren[INDENT]Import von: No Import
      Verzeichnis: <zu leerendes Adressbuch>
      Benutzer des Privat-Verzeichnisses: <Benutzer dessen Adressbuch geleert werden soll>
      STARFACE Adressbuch vor dem Import leeren: ja
      [/INDENT]


    • Google Mail[INDENT]Import von: CardDAV-URL
      Format: vCard (Plaintext)
      URL: https://www.google.com/.well-known/carddav
      Benutzername: <Google Benutzername>
      Kennwort: <Google Kennwort>
      Striktes HTTPS: ja
      HTTP Kompression: yes
      Vorzeitige HTTP-Anmeldung: nein
      CardDAV Sync Tag ignorieren: nein[/INDENT]


    • Kerio Connect[INDENT]Import von: CardDAV-URL
      Format: vCard (Plaintext)
      URL: http(s)://<kerio-host>/calendars/<kerio-domain>/<kerio-user>/Contacts/
      Benutzername: <Kerio Benutzername>
      Kennwort: <Kerio Kennwort>
      Striktes HTTPS: nein
      HTTP Kompression: ja
      Vorzeitige HTTP-Anmeldung: nein
      CardDAV Sync Tag ignorieren: ja[/INDENT]


    • Exchange/OWA (untested)[INDENT]Import von: CardDAV-URL
      Format: vCard (Plaintext)
      URL: https://<exchange-host>/owa/
      Benutzername: <Exchange Benutzername>
      Kennwort: <Exchange Kennwort>
      Striktes HTTPS: nein
      HTTP Kompression: ja
      Vorzeitige HTTP-Anmeldung: ja
      CardDAV Sync Tag ignorieren: ja[/INDENT]


    • ownCloud[INDENT]Import von: CardDAV-URL
      Format: vCard (Plaintext)
      URL: https://<owncloud-host>/owncloud/remote.php/carddav/addressbooks/<username>/contacts
      Benutzername: <ownCloud Benutzername>
      Kennwort: <ownCloud Kennwort>
      Striktes HTTPS: nein
      HTTP Kompression: ja
      Vorzeitige HTTP-Anmeldung: nein
      CardDAV Sync Tag ignorieren: nein[/INDENT]


    Wenn für die Kommunikation mit dem CardDAV Server HTTPS eingesetzt werden soll, sind gültige, nicht-selbstsignierte Zertifikate auf Seiten des Servers erforderlich. Falls nur selbstsignierte Zertifikate zur Verfügung stehen oder der enthaltene Namen nicht dem tatsächlichen Hostname entspricht, kann durch Deaktivieren der Option "Striktes HTTPS" dieses Verhalten abgeschaltet werden.


    Der Preis für eine Lizenz beträgt 349 Euro (zzgl. USt.) pro Appliance oder virtueller Instanz.


    Um eine Lizenz zu erwerben, laden Sie bitte das im Anhang befindliche Modul herunter, importieren es in Ihre STARFACE und folgen den Informationen in der Modulkonfiguration.


    WICHTIG: Lizenzen sind an die Hardware ID einer Appliance geknüpft. Bei virtualisierten Appliances dürfen sich die Hardware-Parameter (wie z.B. der/die Prozessor(en)) nicht verändern. Ansonsten wird die Lizenz ungültig.


    HARDWAREANFORDERUNGEN:
    Maximale Anzahl zu importierender Adressen:
    STARFACE PRO: 2.500
    STARFACE Advanced: 6.000
    STARFACE Enterprise: 23.000
    STARFACE Platinum: 100.000

    [/td]


    [/tr]


    [/TABLE]

  • Sehr klasse!


    hab das Teil gleich mal in den Testbetrieb genommen um damit meinen Kerio zu triggern (wenn schon LDAP nach wie vor nicht geht :-/).


    Offensichtlich scheint der Connect zu g


    Code
    [VcardImport] If I was licensed I would have added Name -> null ID ->null ###Contact Properties### ###Addons Properties### ###Bean Properties#### Deleteable -> false Editable -> false Folder -> 4 LocationName -> null to the address book.


    Was muß ich tun um eine Betatester Lizenz zu bekommen?


    Allerdings, gemäss o.g. Anleitung »nur« auf mein pers. Adressbuch, welches aber nur eine handvoll Testeinträge hält. Wie wäre der Pfad zum Öffentlichen Kontakte Ordner zu legen. In meinem Mac OS X Adressbuch ist's


    https://<kerio-host>:<portno>/carddav/users/<kerio-domain>/.public/


    aber damit komme ich bei dem Modul leider nicht weiter …


    Gruß Stefan

  • Ich habe ein ähnliches Problem. Leider ist bei Kerio die CardDav Schnittstelle nicht genügend Dokumentiert.


    Probiere es mal aus mit
    http(s)://<kerio-host>:<portno>/public-contacts/f-id.com/addressbook/



    Gruß Marvin

  • Ok, danke für die Info. Das finde ich prinzipiell nicht schlimm, wollte nur wissen dass ich wohl doch nicht zu doof bin das Teil einzubinden. Genau sowas hab ich nämlich gesucht!

  • funktioniert die Version 210 auch auf einer starface 6.1 in der Cloud?
    Falls nicht: Gibt es eine andere Lösung, wie ich das komplette Adressbuch löschen kann?

  • Bei mir scheitert immer der Login bei Star.place habt ihr das gleiche Problem? Oder könnte jemand das Modul zuschicken? (ist kostenfrei oder?)

  • Der Login bei star.place ist nur Starface Partnern vorbestimmt.


    Am besten Kontaktierst du kurz die o-Byte direkt per E-Mail oder Telefon bezgl. des Adressbuch Reset Moduls, da es ja gratis ist sollte das keine grossen Probleme geben


    MfG


    Fabian

  • Wenn man die Lizenz kauft und dann später eine neue VM Version benutzt muss man die Lizenz erneut kaufen, oder wird dann der alte Code deaktiviert und man erhält einen neuen für die neue VM?


    Doppelt zahlen möchte ich den Preis definitiv nicht.

Jetzt mitmachen!

Sie haben noch kein Benutzerkonto auf unserer Seite? Registrieren Sie sich kostenlos und nehmen Sie an unserer Community teil!