SPTools Extension Keys: sptools_fal_base sptools_fal_driver SPTools Version: 1 Extension Version: 1.0.2 Inhaltsverzeichnis... 1 1. Einleitung... 2 2. Systemanforderungen... 3 3. SPTools FAL Installation... 4 4. Einrichtung des Treibers... 5 5. Verwendung des Treibers... 8 6. Häufige Fehlerquellen... 9 7. Kontakt & Support... 9 Seite 1/9
1. Einleitung Ab der Version 6.x bietet TYPO3 den sog. File Abstraction Layer (FAL) und löst damit die reine fileadmin Dateiverwaltung bzw. das DAM (Digital Asset Management) der Version 4 ab. Die FAL-Technologie ermöglicht es, Dateiquellen außerhalb des klassischen TYPO3-Dateisystems ( fileadmin ) in den TYPO3-Dateibrowser einzubinden. Mögliche Anwendungen sind die Einbindung von WebDAV- oder Dropbox-Speicher-Systemen. Die fh-konzept GmbH hat auf Basis der SPTools den SPTools FAL entwickelt, um beliebige SharePoint Dokumenten- oder Bild-Bibliotheken in den Datei-Browser von TYPO3 einzubinden. Wenn Sie den SPTools FAL einsetzen, können TYPO3 Redakteure auf dafür freigegebene Ressourcen eines oder mehrerer SharePoint-Systeme und somit immer auf die aktuellsten Dokumente oder Bilder zugreifen, um diese im TYPO3 CMS zu nutzen. Seite 2/9
2. Systemanforderungen TYPO3 CMS System Webserver: Apache 2.0 + PHP: PHP 5.3.x + PHP-Extensions: SOAP, curl, XML-support TYPO3 Version: 6.1.x + Microsoft SharePoint System Sharepoint Version: WSS 3.0 / Foundation, MOSS 2007, SharePoint Server 2010 und 2013(Abwärtskompatibiltät) IIS Authentifizierung: NTLM TYPO3 CMS / Microsoft SharePoint Netzwerkverbindung HTTP(S) Verbindung vom TYPO3 Server zum SharePoint Server Seite 3/9
3. SPTools FAL Installation Der SPTools FAL besteht aus zwei aufeinanderbauenden Extensions: sptools_fal_base: Native PHP-Kernkomponenten zur Kommunikation mit dem SharePoint System sptools_fal_driver: TYPO3 FAL (File Abstraction Layer) Treiber für SPTools/SharePoint Seite 4/9
4. Einrichtung des Treibers Wenn die SPTools FAL Extensions installiert sind, können damit sog. Dateispeicher ( Storage ) angelegt werden. Standardmäßig legt TYPO3 6.x den fileadmin Dateispeicher an, der das Standard-Dateisystem von TYPO3 abbildet. Um auf einen SharePoint zuzugreifen, legt man einen neuen Dateispeicher an. Der erste Reiter ( Allgemein ) enthält allgemeine Dateispeichereinstellungen wie den Namen, eine Beschreibung und ob dieser Dateispeicher im Datei -Modul verborgen sein soll. Seite 5/9
Der eigentliche Zugriff auf einen SharePoint wird unter Configuration definiert. Folgende Felder stehen zur Verfügung: Treiber : Dort muss für den SharePoint-Zugriff der Treiber SPTools SharePoint Access ausgewählt werden. SharePoint Website URL : Dies ist die http(s) Adresse der SharePoint Website, in der die SharePoint Liste liegt, welche eingebunden werden soll. SharePoint Benutzername : Dies ist der Benutzername des SharePoint-Benutzerkontos, welches Zugriff auf die besagte Liste hat. SharePoint Passwort : Dies ist das Passwort des SharePoint-Benutzerkontos, welches Zugriff auf die besagte Liste hat. SharePoint Liste : Nachdem die URL und das Benutzerkonto eingegeben sind, muss der Dateispeicher gespeichert werden. Mit den eingegebenen Daten listet der Treiber die verfügbaren SharePoint Listen auf, die zwecks Einbindung zur Verfügung stehen. SharePoint Titelfeld : Nachdem die SharePoint Liste ausgewählt worden ist, muss der Dateispeicher gespeichert werden, damit die verfügbaren Felder der SharePoint Liste angeboten werden, von denen ein Feld optional als Titelfeld ausgewählt werden kann. SharePoint Beschreibungsfeld : Nachdem die SharePoint Liste ausgewählt worden ist, muss der Dateispeicher gespeichert werden, damit die verfügbaren Felder der SharePoint Liste angeboten werden, von denen ein Feld optional als Beschreibungsfeld ausgewählt werden kann. Seite 6/9
Unter dem Reiter Access werden die Optionen Ist öffentlich verfügbar und Ist beschreibbar deaktiviert. Dies liegt darin begründet, dass der SPTools FAL nicht der Verwaltung von Dateien im SharePoint dienen soll (deswegen nicht beschreibbar ) und zudem kein direkter Zugriff des TYPO3 Frontends auf den SharePoint stattfinden soll (deswegen nicht öffentlich verfügbar ). Der SPTools FAL ist dafür ausgelegt, SharePoint Listen innerhalb des TYPO3 Systems darzustellen und zu ermöglichen, benötigte SharePoint-Dateien in das eigene TYPO3-Dateisystem ( fileadmin ) zur weiteren Verwendung zu übertragen. Seite 7/9
5. Verwendung des Treibers Wenn ein Dateispeicher mit dem SPTools FAL angelegt worden ist, erscheint dieser unter dem angegebenen Namen in der Dateiliste (1) des TYPO3 Backends. Der Treiber bildet dabei die Ordnerstruktur (2) der SharePoint Liste ab und zeigt die Dokumente (3) des ausgewählten Ordners an. Die SPTools erzeugen dabei Vorschaubilder (3) für Bilddateien und PDFs (in Abhängigkeit der TYPO3 Bildverarbeitungs-Konfiguration). Einzeln oder mehrfach (über die TYPO3 Zwischenablage (4)) können SharePoint Dokumente und Bilder ausgewählt und in den gewünschten Zielordner im TYPO3 Dateisystem ( fileadmin ) kopiert werden. Seite 8/9
6. Häufige Fehlerquellen Folgend einige Fehlerquellen, welche häufig als Ursache bei fehlerhafter Kommunikation zwischen den SPTools und SharePoint auftreten. Der SharePoint Server ist über HTTP(S) vom TYPO3 Server nicht erreichbar, bspw. aufgrund einer Firewall-Regel. Der SharePoint Server wird über HTTPS angefragt, ist aber für HTTPS nicht konfiguriert. Die im SPTools FAL Treiber angegebene URL zur SharePoint Website ist nicht korrekt. Das SharePoint Benutzerkonto, welches in dem SPTools FAL Treiber angegeben worden ist, ist nicht im SharePoint eingetragen oder hat nicht die notwendigen Lese -Rechte auf den SharePoint oder die entsprechende SharePoint Liste oder Bibliothek. Die SharePoint Benutzeranmeldung verlangt einen Domänen-Präfix, welcher aber nicht im SPTools FAL Treiber angegeben worden ist. Der SharePoint Benutzername oder das Passwort, welche im SPTools FAL Treiber eingetragen worden sind, sind nicht korrekt. 7. Kontakt & Support Technischer Ansprechpartner: fh-konzept GmbH Konrad-Adenauer Straße 25 50996 Köln Frank Fischer fischer@fh-konzept.de 0221 29 20 92 11 Weitere Informationen und Kontakt: http://sptools.fh-konzept.de Seite 9/9