Dokumentation contentXXL CMS Version 5.3

 

 
 

Allgemein

Das SharePoint-Modul dient zur nahtlosen Integration der Microsoft SharePoint Technologie in contentXXL. Das beinhaltet sowohl Microsoft Windows SharePoint Services als auch Microsoft Office SharePoint Server. Die Inhalte werden nicht in contentXXL importiert. Üblicherweise werden die betreffenden SharePoint-Daten live in contentXXL angezeigt. Es ist aber auch eine offline-Anbindung über STP-Dateien möglich.
Synonyme Bezeichnung: SharePoint-Connector.

Zum Import von Daten und Dokumenten aus SharePoint-Listen und -Bibliotheken kann die Import-Schnittstelle im Sitemanager verwendet werden. Eine Beschreibung finden Sie hier.

Nutzen

  • Integration von SharePoint (WSS/MOSS) überall da, wo diese Lösungen bereits eingesetzt werden.

Beschreibung

Die kostenfreien Microsoft Windows SharePoint Services stellen die Infrastruktur zur Erstellung von Webseiten zur Verfügung. Diese Webseiten dienen im Allgemeinen der Unternehmenskommunikation.  Zur Realisierung von bestimmten Anforderungen werden verschiedene zusätzliche Webparts angeboten. Für spezielle Anforderungen ist der kostenpflichtige Microsoft SharePoint Portal Server erforderlich.

Die Erstellung von Internet- bzw. Extranet-Auftritten ist jedoch nicht primäres Anliegen dieser Lösungen. Eine häufige Anforderung in solchen Projekten ist die einfache Veröffentlichung ausgewählter, im Intranet gepflegter Inhalte für den Internetauftritt ohne mehrfache Datenerfassung.

Das lässt sich mit dem SharePoint-Modul einfach realisieren. Das Modul ermöglicht die Adressierung beliebiger SharePoint-Listen und deren Darstellung über die üblichen contentXXL-Templates. Die Listen werden dabei zur Laufzeit über Webservices oder offline über STP-Dateien zur Verfügung gestellt.

Hinweis: Zahlreiche Informationen zur Konfiguration und Templating finden Sie im Partner- und Supportportal. Bitte beachten Sie insbesondere die Dokumentation für Entwickler und die Dokumentation zum offline-Betrieb

 

 
 

Spezielle Einstellungen

Folgende spezielle Einstellungen können getroffen werden:

Listenansicht

  • Überschrift Template: Wählen Sie hier ein Template für den Kopfbereich der Liste aus.
  • Element Template: Wählen Sie hier ein Template für ein Listenelement aus.
  • Alt. Element Template: Wählen Sie hier optional ein Template für eine alternierende Listenansicht aus.
  • Footer Template: Wählen Sie hier ein Template für den Fußbereich der Liste aus.

Templates - Einzelansicht

  • Detailansicht: Wählen Sie hier ein Template für die Einzelansicht eines Listenelementes aus.
  • Druckvorschau: Wählen Sie hier ein Template für die Druckansicht eines Listenelementes aus.

Verbindungsmodus

  • Verbindungsmodus: Wählen Sie einen der angebotenen Verbindungsmodi. Sie können SharePoint-Daten direkt per Webservice adressieren oder einen Offline-Ordner (STP-Datei) dazu verwenden.

STP Offline Konfiguration

Dieser Bereich ist nur sichtbar, wenn der Verbindungsmodus "Offline - STP Ordner" ausgewählt wurde.

  • Ordner mit entpackten STP-Daten: Geben Sie hier den Pfad zum Ordner an, der die entpackten STP-Daten enthält.
  • Liste: Wenn nach dem Speichern der Einstellungen die STP-Daten erfolgreich gelesen werden können, wählen Sie hier bitte die gewünschte Quell-Liste aus.

Quell-WebService

Dieser Bereich ist nur sichtbar, wenn der Verbindungsmodus "Webservice (live)" ausgewählt wurde.

  • URL: Geben Sie hier die URL ein, unter der die SharePoint-Applikation aufgerufen werden kann, und hängen /_vti_bin/lists.asmx an.
  • Listenname: Wenn nach dem Speichern der Einstellungen der Webservice erfolgreich aufgerufen werden kann, wählen Sie hier bitte die gewünschte Quell-Liste aus.
  • Sicht: Nach der Auswahl der Liste kann gegebenenfalls zwischen mehreren Sichten gewählt werden.

Anmeldung

Dieser Bereich ist nur sichtbar, wenn der Verbindungsmodus "Webservice (live)" ausgewählt wurde.

  • Benutzer: Geben Sie hier den Benutzernamen ein.
  • Passwort: Geben Sie hier das Passwort ein.
  • Domain: Geben Sie hier gegebenenfalls den Namen der Domäne ein,  in der das Benutzerkonto geführt wird.
  • Art der Anmeldung: Wählen Sie hier den zutreffenden Authentifizierungs-Typ aus.

Cache

  • Cache: Hier können Sie den Cache aktivieren, um ein zu häufiges Abfragen der Datenquelle zu vermeiden und einen Zwischenspeicher zu verwenden. Geben Sie dazu die Zeitdauer in Sekunden an, für die die Daten zwischengespeichert werden sollen.

Diagnose

  • Diagnose: In diesem Bereich werden Statusinformationen ausgegeben, die Ihnen die Diagnose möglicher Probleme erleichtern.

Abb.: Spezielle Einstellungen des SharePoint 2010 – Moduls.

 
 


Sowohl in den Templates der Listenansicht als auch in den Einzelansichts-Templates können die SharePoint-Felder mit dem Platzhalter

[val:ows_XXX]

angesprochen werden. XXX repräsentiert den SharePoint-Feldnamen. Beispiel: ows_UniqueId. Daneben gibt es folgende contentXXL-Platzhalter:

 

Template: Kopf- und Fußbereich

Platzhaltername

Typ

Platzhalterbeschreibung

[itemcount]

integer

Anzahl der Elemente in der SharePoint-Liste.

<TABLE style="PADDING-TOP: 10px" cellSpacing="0" cellPadding="0" border="0" [mvif:itemcount:eq:0]> 
<TBODY> <TR> <TD>No items found in this list</TD></TR></TBODY>
</TABLE>
<TABLE style="PADDING-TOP: 10px" cellSpacing="0" cellPadding="0" border="0" [mvifci:folder:neq:]>
 <TBODY> <TR> <TD><A href="javascript:history.go(-1)">back</A></TD></TR></TBODY>
</TABLE>

Dieses Template wird als Noresult-Template verwendet, wenn keine Einträge in der Liste gefunden werden. Im Kontext eines Unterordners wird ein Link zum Eltern-Ordner dargestellt.

 

Template: Elemente

Platzhaltername

Typ

Platzhalterbeschreibung

[attachedfilepath]

string

Absoluter Pfad zu Anhängen, in Dokument-Bibliotheken wird der Pfad zum Dokument zurückgegeben.

[isfolder]

string

Gibt "true" zurück, wenn es sich um einen Ordner handelt.

[morelink]

string

Link zur Detailansicht des Elements oder zum Inhalt eines Ordners.

<SPAN [mvif:isFolder:neq:true]>
<TABLE cellSpacing="0" cellPadding="0" width="100%" border="0">
<TBODY>
<TR>
<TD vAlign="top" colSpan="2"><A href="[val:morelink]">[val:ows_LinkTitle]</A> </TD></TR>
<TR style="PADDING-TOP: 10px">
<TD style="PADDING-RIGHT: 10px; WIDTH: 100px" [mvif:ows_XXLAttachementPreviewImage:neq:]><IMG alt="[val:ows_linktitle]" src="[val:attachedfilepath][val:ows_XXLAttachementPreviewImage]" width="100" border="0"></TD>
<TD vAlign="top">[val:ows_Previewtext] <A href="[val:morelink]">more</A></TD></TR></TBODY></TABLE><BR></SPAN><SPAN [mvif:isFolder:eq:true]>
<TABLE cellSpacing="0" cellPadding="0" width="100%" border="0">
<TBODY>
<TR>
<TD vAlign="top" width="20"><A href="[val:morelink]"><IMG src="images/folder.gif" border="0"></A></TD>
<TD><A href="[val:morelink]">[val:ows_LinkTitle]</A></TD></TR></TBODY></TABLE><BR></SPAN>

Dieses Beispiel dient zur Darstellung einer SharePoint-Listenansicht mit Unterordnern und Anhang als Vorschaubild.

 

<DIV><A href="[val:morelink]">[val:ows_LinkTitle]</A> </DIV>
<DIV style="PADDING-RIGHT: 10px; FLOAT: left; WIDTH: 100px; PADDING-TOP: 10px" [mvif:ows_XXLPreviewimage:neq:]><IMG alt="[val:ows_linktitle]" src="[val:ows_XXLPreviewimage]" width="100" border="0"> </DIV>
<DIV style="PADDING-TOP: 10px">[val:ows_Previewtext] <A href="[val:morelink]">more</A> </DIV><BR style="CLEAR: both">

Dieses Beispiel dient zur Darstellung einer SharePoint-Listenansicht mit einem Image-Lookup-Feld (ows_XXLPreviewImage) als Vorschaubild.

 

<SPAN [mvif:ows_FileSizeDisplay:neq:]><A href="[val:attachedfilepath]" target='_"blank"'>[val:ows_title]</A> <BR>Filesize: [val:ows_FileSizeDisplay]</SPAN>

Dieses Beispiel dient zur Darstellung einer SharePoint-Dokumentenbibliothek.

 

Template: Einzelansicht

Platzhaltername

Typ

Platzhalterbeschreibung

[attachedfilepath]

string

Absoluter Pfad zu Anhängen, in Dokument-Bibliotheken wird der Pfad zum Dokument zurückgegeben.

[printlink]

string

URL zur Druckansicht.

<TABLE cellSpacing="0" cellPadding="0" width="100%" border="0"> 
<TBODY> 
<TR> <TD vAlign="top">[val:ows_PreviewText]</TD> <TD></TD></TR> <TR> <TD vAlign="top">[val:ows_DetailRichText]</TD> <TD></TD></TR>
 <TR> <TD vAlign="top">[val:ows_DetailEnhancedRichText]</TD></TR> <TR> <TD vAlign="top"><BR><A href="javascript:history.go(-1);">back</A></TD> <TD align="right"><A href="[val:printlink]" target="_blank">print</A></TD></TR>
</TBODY>
</TABLE>

 

Hinweis: Wurde in der SharePoint-Liste eine Spalte "XXLLanguage" konfiguriert, werden in contentXXL nur die der aktuellen contentXXL-Sprache zugehörigen Zeilen angezeigt. Die SharePoint XXLLanguage-Spalte wird mit der contentXXL-Sprache über das Feld "subculture" in der Tabelle "languages" gemappt. Um beispielsweise nach deutschen Inhalten zu filtern, muss "de-de" in der SharePoint XXLLanguage-Spalte eingetragen werden, "en-en" oder "en-gb" für englische Inhalte. Dieser Mechanismus kann durch Abwählen des Klickfelds "Sprachfilter aktivieren" in den Allgemeinen Moduleinstellungen deaktiviert werden.

Bitte beachten Sie auch:
Wenn eine SharePoint-Spalte umbenannt wird, hat das keinen Einfluss auf die entsprechenden Platzhalter in contentXXL. Sie behalten den ursprünglichen Namen.
Ist eine SharePoint-Spalte innerhalb einer Listenansicht vollständig leer, ist der entsprechende Platzhalter in contentXXL nicht oder nicht mehr verfügbar. Der SharePoint-Webservice übermittelt leere Spalten nicht. Templates, die einen solchen Platzhalter enthalten, werden aber weiterhin dargestellt.

 
 

Unter dem Reiter "Objekte" wird eine Vorschau der konfigurierten SharePoint-Liste dargestellt. Die zu verwendenden Platzhalter [val:ows_xxx] können dieser Vorschau entnommen werden.