Z-Push Public Folders | mars solutions GmbH (2024)

Um öffentliche Ordner auf das Smartphone zu synchronisieren gibt es folgende, wichtige Punkte zu beachten:

• Bisher funktioniert lediglich iOS (Stand 31.10.2012), Android 4 unterstützt dies (noch) nicht
• Die Konfiguration findet zentral via z-Push statt, die Clients bekommen die öffentlichen Ordner automatisch gepusht - Es muss kein Smartphone angefasst werden
• Die Zugriffsberechtigung wird via Ordnerberechtigungen geregelt (z.B. via Webaccess)
• Multiple öffentliche Ordner zu synchronisieren ist möglich, auch gemischt (z.B. zwei öffentliche Kalender und ein öffentliches Adressbuch)
• Es wird nichts auf dem Client überschrieben. Es wird ein zweiter Kalender angelegt und/oder eine weitere Adressbuchgruppe.

Die Zugriffsberechtigung eines Smartphones auf einen öffentlichen Ordner wird nicht auf dem Smartphone oder z-Push geregelt - es greifen die Zugriffsberechtigungen, die via Zarafa festgelegt sind. Die korrekte Berechtigungsstruktur einzurichten sollte der erste Schritt sein, bevor weitere Konfigurationsschritte unternommen werden. Damit ein Benutzer von seinem Smartphone einen Eintrag in den öffentlichen Ordner tätigen kann, benötigt dieser natürlich Schreibberechtigungen. Zarafa empfiehlt, das Berechtigungsprofil auf "Sekretär/in" zu stellen. Bitte passen Sie Ihre entsprechenden Berechtigungswünsche auf die Ordner an.

Hinweis! Wenn Sie einem Benutzer die Berechtigung später wieder entfernen, werden lediglich keine neuen Elemente synchronisiert, die alten Elemente verbleiben vorerst auf dem Smartphone. Falls Sie das nicht wünschen, sollten Sie zusätzlich noch einen Remote-Wipe via z-push-admin.php in Erwägung ziehen.

Die Datei, über die die Konfiguration angepasst wird befindet sich im z-Push Verzeichnis und lautet config.php. Öffnen Sie diese Datei zum editieren:

joe /var/www/z-push/config.php

Im untersten Teil der Datei befindet sich der Konfigurationsabschnitt für die öffentlichen Ordner. Dort gibt es ein komplett vorbereitetes (noch auskommentiertes) Gerüst, welches nur noch befüllt werden muss. Die Variable $additionalFolders enthält ein PHP-Array mit folgenden Eigenschaften:

'store' => "SYSTEM",'folderid' => "",'name' => "Public Folder",'type' => SYNC_FOLDER_TYPE_USER_CONTACT,

Eine kurze Erläuterung zu den einzelnen Punkten:

• store: Bezeichnet die Ressource. Bei öffentlichen Ordnern muss dieser Eintrag "SYSTEM" lauten.
• folderid: Die ID des zu synchronisierenden Ordners. Wie man an die ID kommt wird weiter unten erläutert.
• name: Der Name darf individuell vergeben werden. Dieser Name wird auf dem Smartphone angezeigt. Empfohlen ist aber die tatsächliche Bezeichnung des Ordners.
• type: Hier wird der Typ des zu synchronisierenden Ordners angegeben. Unterstützte Typen sind:

SYNC_FOLDER_TYPE_USER_CONTACTSYNC_FOLDER_TYPE_USER_APPOINTMENTSYNC_FOLDER_TYPE_USER_TASKSYNC_FOLDER_TYPE_USER_MAIL

Die Unterschiede sollten selbsterklärend sein. Es kann sich um diese vier Typen handeln: Kontakte, Kalender, Aufgaben, E-Mail.

Da Sie alles bis auf die Folder ID recht einfach eintragen können, benötigen Sie einen Weg, an diese zu kommen. Dazu gibt es bereits ein vorbereitetes Skript listfolders.php, welches sich im z-Push-Ordner unter ./backen/zarafa befindet. Führen Sie dieses Skript mit dem Parameter -l und SYSTEM aus, um öffentliche Ordner zu listen:

/var/www/z-push/backend/zarafa/listfolders.php -l SYSTEM

Als Ergebnis sollte in etwa so etwas herauskommen:

Available folders in store 'SYSTEM':--------------------------------------------------Folder name: UrlaubFolder ID: 464b81aa3b374af8a1c831203afa14803a8a03000000Type: SYNC_FOLDER_TYPE_USER_APPOINTMENTFolder name: KontakteFolder ID: 464b81aa3b374af8a1c831203afa1480508903000000Type: SYNC_FOLDER_TYPE_USER_CONTACT

Sie können nun die 21-stellige Folder ID aus diesem Output kopieren und in die config.php entsprechend eintragen.

Wenn Sie mit Ihrer Konfiguration fertig sind, benötigt es nur noch dem Entfernen der Kommentarzeichen ober- und unterhalb der array-Definition in der config.php. Bei der nächsten Clientanfrage werden die öffentlichen Ordner auf den Client synchronisiert. Es wird nichts auf dem Client überschrieben. Es wird ein zweiter Kalender angelegt und/oder eine weitere Adressbuchgruppe. Sie können nebenher das Log unter /var/log/z-push/ prüfen, ob eine Sync-Anfrage bearbeitet wird. Prüfen Sie natürlich auch den Client, ob dieser bereits korrekt synchronisiert wird.

Damit ist die Konfiguration öffentlicher Ordner abgeschlossen.

Um mehrere öffentliche Kalender auf ein Smartphone zu synchronisieren, bedarf es lediglich dem Kopieren des array-Blockes in der config.php. Das kann z.B. so aussehen:

$additionalFolders = array(// demo entry for the synchronization of contacts from the public folder.// uncomment (remove '/*' '*/') and fill in the folderidarray( 'store' => "SYSTEM", 'folderid' => "464b81aa3b374af8a1c831203afa148020c201000000", 'name' => "Terminakalender PMP", 'type' => SYNC_FOLDER_TYPE_USER_APPOINTMENT,),array( 'store' => "SYSTEM", 'folderid' => "464b81aa3b374af8a1c831203afa14802da901000000", 'name' => "Kontakte PMP", 'type' => SYNC_FOLDER_TYPE_USER_CONTACT,),

Wieder werden bei der nächsten Synchronisations-Anfrage des Clients die zusätzlichen Ordner auf das Smartphone synchronisiert.