Entwickeln mobiler Dokumentviewer
Letzte Änderung: Mittwoch, 2. Februar 2011
Gilt für: SharePoint Foundation 2010
Dieses Thema beschreibt das Erstellen mobiler Seiten, die Dokumentviewer hosten, mit deren Hilfe Benutzer mobiler Geräte Dokumente im Format einer bestimmten Anwendung, z. B. einer Textverarbeitungs- oder Tabellenkalkulationsanwendung, anzeigen können. Auf diese Weise ist es mobilen Benutzern möglich, Dateien in Microsoft SharePoint Foundation-Dokumentbibliotheken auf ihrem mobilen Gerät zu öffnen. Einige mobile Geräte verfügen möglicherweise über integrierte Viewer für bestimmte Dokumenttypen. Sie können das Antwortsystem so konfigurieren, dass geprüft wird, ob das anfordernde Gerät über einen entsprechenden Viewer verfügt, und dass ggf. das Öffnen des angeforderten Dokuments im Gerätebrowser anstelle Ihres Browsers zugelassen wird.
.gif "Tipp") Tipp |
|---|
Produkte, die auf Microsoft SharePoint Foundation aufbauen, was auch Microsoft-Produkte wie Microsoft SharePoint Server einschließt, können bereits mobile Dokumentviewer und Hostingseiten enthalten und tun dies auch. Vergewissern Sie sich, welche Funktionalität bereits verfügbar ist, bevor Sie mit einem Dokumentviewerprojekt beginnen. |
Übersicht
Das Verfahren, um Benutzern Ihrer SharePoint Foundation-Lösung einen mobilen Dokumentviewer zur Verfügung zu stellen, besteht im Wesentlichen aus zwei Teilen:
Erstellen der Seite, die den Viewer hostet.
Registrieren der Viewerseite.
Erstellen der Hostingseite für den Viewer
Eine Hostingseite für einen mobilen Viewer ist normalerweise eine ASPX-Datei, die Sie auf jedem Front-End-Webserver im Ordner %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\Layouts\Mobile bereitstellen. Absolute Verallgemeinerungen zum Inhalt der Seite sind nicht möglich. Das Kernstück der Seite ist in der Regel ein Verweis auf ein Steuerelement, das ein Dokument des angegebenen Typs anzeigen kann. Es kann weiterhin Steuerelemente geben, die die Bearbeitung, die Paginierung oder andere, für den Dokumenttyp relevante Funktionalität unterstützen.
Registrieren der Seite
Zum Registrieren der Seite erstellen Sie eine XML-Datei mit dem Namen mdocview_*.xml; hierbei steht "*" für eine Zeichenfolge aus gültigen Zeichen für Dateinamen. Es empfiehlt sich, den Firmennamen oder eine andere Zeichenfolge zu verwenden, die höchstwahrscheinlich nicht einen Namen dupliziert, der von anderen Anbietern von Dokumentviewern verwendet wird. Die Seite wird unter %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\Config auf allen Front-End-Webservern bereitgestellt.
Der oberste Knoten der Datei ist ein MobileDocViewers-Element. Fügen Sie mindestens ein untergeordnetes MobileDocViewer-Element hinzu. Das folgende Fragment ist ein Beispiel für ein MobileDocViewer-Element:
<MobileDocViewers>
<MobileDocViewer Name=”xps” FilePath=”/_layouts/mobile/mxps.aspx” QueryId=”doc” AppendSourceUrl=”true” />
</MobileDocViewers>
Das Name-Attribut gibt die Dateinamenerweiterung des Dateityps an, den der Viewer anzeigen kann. Das FilePath-Attribut gibt den websiterelativen Pfad und den Dateinamen der Datei an, die Sie zum Hosten des Viewers erstellt haben. Das QueryId-Attribut gibt den Schlüssel der URL-Abfrage an; in diesem Fall wird "?doc=" am Ende der URL für die Viewer-Hostingseite angefügt. Das AppendSourceUrl-Attribut gibt an, ob die URL des Dokuments, das der Benutzer anzeigen möchte, am Ende der URL angefügt werden soll. In vorliegenden Fall wird, da der Wert true ist, die URL angefügt. Dementsprechend würde die vollständige websiterelative URL zum Anzeigen der Datei mit dem Namen File.xps in der Dokumentbibliothek unter http://MyServer/Shared Documents/File.xps folgendermaßen lauten: /_layouts/mobile/mxps.aspx?doc=http:%2F%2FMyServer%2FShared%20Documents%2FFile%2Exps.
Es wird empfohlen, die Seite als Feature zu kapseln, das auf Websitesammlungsebene aktiviert oder deaktiviert werden kann. In diesem Fall verfügt das MobileDocViewer-Element auch über ein FeatureId-Attribut, das das Feature anhand seiner GUID identifiziert. Folgendes Fragment ist ein Beispiel hierfür.
<MobileDocViewers>
<MobileDocViewer Name=”xps” FilePath=”/_layouts/mobile/mxps.aspx” QueryId=”doc” AppendSourceUrl=”true”
FeatureId=”XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX” />
</MobileDocViewers>
Wenn der Viewer Dokumente mit mehr als einer Art von Dateinamenerweiterung öffnen kann, müssen Sie für jede Erweiterung ein eigenes MobileDocViewer-Element hinzufügen.
Wenn das anfordernde Gerät über einen eigenen Viewer für den Dokumenttyp verfügt, den der von Ihnen definierte Viewer öffnet, kann die Datei compat.browser unter %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG\Browsers über einen Eintrag für den Browser verfügen, durch den diese Funktionalität angezeigt wird. Ein Telefon mit Windows Mobile 7.0 verfügt beispielsweise über einen Office Mobile-Client, der bestimmte Microsoft Office-Dokumenttypen auf dem Mobiltelefon öffnen kann. Der Eintrag für diesen Client in compat.browser wird im Folgenden gezeigt.
<browser id="OfficeMobileClient" parentID="default">
<identification>
<userAgent match="^Office Mobile Web Access$" />
</identification>
<capabilities>
<capability name="isMobileDevice" value="true" />
<capability name="overrideMobileDocViewerRedirection" value="true" />
</capabilities>
</browser>
Das capability-Element mit dem Namen overrideMobileDocViewerRedirection ist auf true festgelegt. Das bedeutet, dass dieser Browser bestimmte Microsoft Office-Dokumenttypen anzeigen kann.
Sie können festlegen, dass der Viewer eines Browsers Ihren Viewer außer Kraft setzen kann, indem Sie ein untergeordnetes BrowserCondition-Element zum MobileDocViewer-Element hinzufügen. Das BrowserCondition-Element prüft, ob das anfordernde Gerät über einen eigenen Browser verfügt. Wenn dies der Fall ist, wird die Anforderung von der Viewer-Hostingseite an einen anderen Anforderungshandler weitergeleitet. Das folgende MobileDocViewer-Element gibt beispielsweise an, dass DOCX-Dateien in der Datei mWord.aspx geöffnet werden. Falls der Browser jedoch über einen eigenen Viewer verfügt, wird die Anforderung stattdessen an MobileDocHandler.ashx umgeleitet.
<MobileDocViewer Name="docx" FilePath="/_layouts/mobile/mWord.aspx" FeatureId="8DFAF93D-E23C-4471-9347-07368668DDAF" QueryId="doc" AppendSourceUrl="true" >
<BrowserCondition Id="overrideMobileDocViewerRedirection" Value="true">
<Override FilePath="/_layouts/MobileDocHandler.ashx" AppendSourceUrl="false" />
</BrowserCondition>
</MobileDocViewer>
Sie dürfen den Begriff overrideMobileDocViewerRedirection nicht für den Funktionalitätsnamen wiederverwenden, da diese Funktionalität auf den Viewer des Office Mobile-Clients verweist. Legen Sie stattdessen einen neuen Begriff fest. Wenn ein Browser beispielsweise über einen XPS-Viewer verfügt, können Sie einen Eintrag für diesen Browser zur Datei compat.browser hinzufügen und dem Eintrag ein capability-Element mit CanViewXPS als Wert des name-Attributs hinzufügen. Fügen Sie dann ein untergeordnetes BrowserCondition-Element zum MobileDocViewer-Element hinzu, und verwenden Sie CanViewXPS als Wert des Id-Attributs.