Gewusst wie: Hinzufügen einer Dokumentvorlage, eines Dateityps und einer Bearbeitungsanwendung zu einer Websitedefinition
Letzte Änderung: Montag, 1. November 2010
Gilt für: SharePoint Foundation 2010
Inhalt dieses Artikels
Hinzufügen einer Dokumentvorlage
Hinzufügen einer Zuordnungsdefinition für einen Dateityp
Hinzufügen einer Bearbeitungsanwendung
Diese Programmieraufgabe beschreibt die Schritte zur Anpassung von Microsoft SharePoint Foundation, damit Dokumente in einer Drittanbieteranwendung erstellt oder bearbeitet werden können.
Die Aufgabe umfasst die folgenden Unteraufgaben:
Erstellen einer Dokumentvorlagendatei, mit der ein DocumentTemplate-Element zur Datei Onet.xml der Websitedefinition hinzugefügt wird
Hinzufügen eines Mapping-Elements zur Datei DocIcon.xml, um ein Symbol für den Dateityp sowie das Steuerelement anzugeben, das beim Öffnen der Datei verwendet werden soll
Erstellen einer DLL mit ähnlicher Funktionalität wie für das OpenDocuments-Steuerelement beschrieben, also mit der Fähigkeit zum Erstellen, Öffnen und Bearbeiten von Dokumenten dieses Dateityps
Damit Sie die in diesem Thema beschriebenen Anpassungen durchführen können, müssen Sie Administrator des Servers mit SharePoint Foundation sein.
.gif "Vorsicht") Vorsicht |
|---|
An den ursprünglich installierten Dateien vorgenommene Änderungen können überschrieben werden, wenn Sie Updates oder Service Packs für SharePoint Foundation installieren oder wenn Sie ein Upgrade einer Installation auf die nächste Produktversion ausführen. |
Hinzufügen einer Dokumentvorlage
Wenn Sie ein Anwendungsdokument als Vorlage hinzufügen möchten, die in Dokumentbibliotheken verwendet werden kann, können Sie entweder das DocumentTemplate-Element in einem Inhaltstypfeature (siehe Bereitstellen von Inhaltstypen) oder das DocumentTemplate-Element in der Datei Onet.xml einer benutzerdefinierten Websitedefinition (siehe Gewusst wie: Erstellen einer benutzerdefinierten Websitedefinition und -konfiguration) angeben.
Im folgenden Beispiel wird die Verwendung des DocumentTemplate-Elements in der Datei Onet.xml dargestellt.
<DocumentTemplates>
<DocumentTemplate DisplayName="Blank Document" Type="105"
Default="FALSE" Description="A blank document.">
<DocumentTemplateFiles>
<DocumentTemplateFile
Name="doctemp/Template_Folder/psdtmp1.psd"
TargetName="Forms/template.psd" Default="True"/>
</DocumentTemplateFiles>
</DocumentTemplate>
</DocumentTemplates>
Das DisplayName-Attribut des DocumentTemplate-Elements gibt den Text an, der in der Dropdownliste zur Auswahl eines Dokumentvorlagentyps angezeigt wird, wenn Sie eine neue Dokumentbibliothek erstellen. Das Type-Attribut ist ein eindeutiger Bezeichner für den Dokumenttyp und kann eine beliebige ganze Zahl sein, die noch nicht für eine andere Dokumentvorlage verwendet wird. Das Default-Attribut gibt an, ob die Vorlage in der Dropdownliste standardmäßig ausgewählt ist. Das Name-Attribut von DocumentTemplateFile gibt den physischen Pfad der Vorlagendatei auf dem Servercomputer an, und das TargetName-Attribut gibt die Adresse der Vorlage relativ zur Dokumentbibliothek an.
Setzen Sie die Internetinformationsdienste (Internet Information Services, IIS) zurück, damit die Änderungen wirksam werden.
Hinzufügen einer Zuordnungsdefinition für einen Dateityp
Um eine Dateinamenerweiterung einem Dokumenttyp hinzuzufügen und das Steuerelement anzugeben, das beim Öffnen eines Dokuments mit dieser Dateinamenerweiterung verwendet werden soll, fügen Sie der Datei DocIcon.xml ein Mapping-Element hinzu. DocIcon.xml befindet sich im Verzeichnis %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\XML.
Durch Hinzufügen der folgenden Zeile im ByExtension-Element in DocIcon.xml wird die Erweiterung PSD einer Bilddatei namens icpsd.gif zugeordnet, die das Symbol enthält, das in Dokumentbibliotheken für Dateien dieses Typs angezeigt wird:
<Mapping Key="psd" Value="icpsd.gif"/>
Um die Bearbeitung innerhalb einer Anwendung zu ermöglichen, muss das Mapping-Element wie in folgendem Beispiel zusätzlich die Attribute EditText und OpenControl umfassen:
<Mapping Key="psd" Value="icpsd.gif" EditText="Application" OpenControl="ProgID"/>
Das EditText-Attribut gibt den Anwendungsnamen an, der im Dropdownmenü erscheint, wenn ein Benutzer auf den Edit-Pfeil für ein Dokument klickt. Das OpenControl-Attribut gibt die ProgID des Steuerelements an, das zum Öffnen von Dateien des angegebenen Typs verwendet werden soll.
Die mit dem Value-Attribut angegebene Bilddatei muss sich im Verzeichnis %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\IMAGES befinden. Ist die angegebene Bilddatei nicht in diesem Verzeichnis vorhanden, wird das Symbol "Bild fehlt" neben dem Dokument angezeigt.
Damit Benutzer bei aktiviertem anonymem Zugriff nicht zur Eingabe von Anmeldeinformationen aufgefordert werden, um das Symbol zu sehen, müssen Sie vererbbare Berechtigungen für die Bilddatei festlegen.
So legen Sie vererbbare Berechtigungen für die Bilddatei fest
Klicken Sie mit der rechten Maustaste auf die Bilddatei im Ordner IMAGES, auf die verwiesen wurde, und klicken Sie dann auf Eigenschaften.
Klicken Sie im Dialogfeld Eigenschaften auf der Registerkarte Sicherheit auf Erweitert.
Stellen Sie im Dialogfeld Erweiterte Sicherheitseinstellungen auf der Registerkarte Berechtigungen sicher, dass das Kontrollkästchen Berechtigungen übergeordneter Objekte, sofern vererbbar, über alle untergeordneten Objekte verbreiten. Diese Objekte inklusive den hier definierten Einträgen mit einbeziehen aktiviert ist.
.gif "Hinweis") Hinweis |
|---|
Die Standardgröße für Symbole beträgt in SharePoint Foundation 16 x 16 Pixel. |
Setzen Sie IIS zurück, damit die Änderungen in Kraft treten.
Hinzufügen einer Bearbeitungsanwendung
Erstellen Sie eine DLL mit dem Steuerelement, das für ein Dokument des angegebenen Typs geladen werden soll; die ProgID muss das Steuerelement identifizieren, z. B. SharePoint.OpenDocuments. Das erstellte Steuerelement muss dieselben Methoden für das Erstellen, Öffnen und Anzeigen von Dokumenten bereitstellen wie für das OpenDocuments-Steuerelement beschrieben.