Gewusst wie: Bereitstellen von UDFs mithilfe von SharePoint Foundation-Lösungen

Artikel
09/18/2014

Letzte Änderung: Freitag, 6. August 2010

Gilt für: SharePoint Server 2010

In diesem Beispiel wird veranschaulicht, wie Sie mithilfe des Microsoft SharePoint Foundation-Lösungsframeworks eine DLL für eine benutzerdefinierte Funktion (User-Defined Function, UDF) bereitstellen.

Mit dem SharePoint Foundation-Lösungsframework können Sie alle Komponenten für die Erweiterung von SharePoint Foundation in einer neuen Datei bündeln, einer so genannten Lösungsdatei. Diese liegt in einem auf CAB basierendem Format mit der Dateierweiterung WSP vor. Eine Lösung ist ein bereitstellbares, wiederverwendbares Paket, das einen Satz von Features, Websitedefinitionen und Assemblys enthalten kann, die Sie auf eine Website anwenden und einzeln aktivieren bzw. deaktivieren können. Darüber hinaus können Sie mithilfe der Lösungsdatei den Inhalt eines Webpartpakets bereitstellen, einschließlich Assemblys, Klassenressourcen, DWP-Dateien und anderen Paketkomponenten. Weitere Informationen zum SharePoint Foundation-Lösungsframework finden Sie unter dem Knoten SharePoint Foundation im Erste Schritte bei der Entwicklung für SharePoint Foundation (https://msdn.microsoft.com/de-de/library/ee539432(v=office.14).aspx).

Führen Sie das folgende Verfahren aus, um eine UDF-Assembly mithilfe des SharePoint Foundation-Lösungsframeworks zu erstellen und bereitzustellen:

Erstellen Sie die Lösungsmanifestdatei, Manifest.xml.

Das Lösungsmanifest (dieses heißt immer Manifest.xml) wird im Stamm einer Lösungsdatei gespeichert. Diese Datei definiert die Liste der zu verarbeitenden Features, Websitedefinitionen, Ressourcendateien, Webpartdateien und Assemblys. Sie definiert nicht die Dateistruktur. Wenn Dateien in einer Lösung enthalten sind, aber nicht in der XML-Manifestdatei aufgeführt sind, werden sie nicht verarbeitet.

Hinweis

Weitere Informationen zum Aufbau der XML-Manifestdatei finden Sie in der Dokumentation zu SharePoint Foundation.
Packen Sie die UDF-Assembly und die Datei Manifest.xml in eine CAB-Datei.
Stellen Sie sicher, dass auf dem Server der SharePoint Foundation-Verwaltungsdienst ausgeführt wird.
Fügen Sie dem Server mithilfe von Stsadm.exe die Lösung hinzu.
Stellen Sie die Lösung mithilfe von Stsadm.exe bereit.

Hinweis
Weitere Informationen zum Aufbau der XML-Manifestdatei finden Sie in der Dokumentation zu SharePoint Foundation.

Jeder vertrauenswürdige Excel Services-Speicherort hat ein AllowUdfs-Flag.

Hinweis
Das AllowUdfs-Flag wird durch die Option User-defined functions allowed auf der Excel Services-Seite Vertrauenswürdige Dateispeicherorte angegeben. Wie Sie zur Seite Vertrauenswürdige Dateispeicherorte navigieren, erfahren Sie unter Schritt 3: Bereitstellen und Aktivieren von UDF-Dateien.

Führen Sie folgende Schritte aus, um festzulegen, dass UDFs von einem bestimmten vertrauenswürdigen Speicherort aus aufgerufen werden können:

Legen Sie den AllowUdfs-Wert auf true fest. Der Standardwert lautet false.
Fügen Sie die UDF-Assembly der Liste der vertrauenswürdigen UDFs hinzu, damit die UDF von einer Arbeitsmappe aus aufgerufen werden kann.

Weitere Informationen zum Aktivieren von UDFs und Hinzufügen von UDFs zur Liste der vertrauenswürdigen UDFs finden Sie unter Gewusst wie: Aktivieren von UDFs.

Hinweis
Namenskonflikte vermeiden Sie, indem Sie den UDF-Assemblys und ihren Abhängigkeiten starke Namen geben und Namen wählen, die absolut eindeutig sind. Weitere Informationen finden Sie unter Bewährte Methoden für Excel Services und Bekannte Probleme und Tipps für Excel Services.

Verfahren

So erstellen Sie die Datei "Manifest.xml"

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Neues Element.
Wählen Sie XML-Datei aus, und geben Sie der Datei den Namen Manifest.xml.
Klicken Sie auf Hinzufügen.

Fügen Sie der Datei folgenden Inhalt hinzu:

<?xml version="1.0" encoding="utf-8" ?>
<Solution xmlns="https://schemas.microsoft.com/sharepoint/" SolutionId="{57568687-2CC0-45bf-B66A-2D50D57108CA}" DeploymentServerType="ApplicationServer">
  <Assemblies>
    <Assembly DeploymentTarget="GlobalAssemblyCache" Location="EcsUdfsCommonSet.dll"/>
  </Assemblies>
</Solution>

Hinweis
Generieren Sie für jede Lösung eine eindeutige GUID. Weitere Informationen zum Solution-Element finden Sie unter SharePoint FoundationSolutions and Web Part Packages (https://msdn.microsoft.com/de-de/library/ms413687.aspx).

So erstellen Sie ein Lösungspaket

Informationen zum Erstellen der Lösungsdatei finden Sie im Thema "Erstellen einer Lösung" unter dem Knoten "Lösungen und Webpartpakete" im SharePoint Foundation-SDK.

So überprüfen Sie, ob die SharePoint Foundation-Verwaltung ausgeführt wird

Zeigen Sie im Startmenü auf Verwaltung, und doppelklicken Sie dann auf Dienste.

Das Dialogfeld Dienste wird angezeigt.
Stellen Sie sicher, dass für den SharePoint Foundation-Verwaltungsdienst der Status Gestartet lautet. Ist dies nicht der Fall, klicken Sie mit der rechten Maustaste auf SharePoint Foundation-Verwaltung, und wählen Sie dann Starten aus.

So fügen Sie die Lösung hinzu

Klicken Sie im Startmenü auf Ausführen, und geben Sie dann cmd ein.

Die Befehlszeilenkonsole wird angezeigt.

Führen Sie das folgende Skript aus, um SharePoint Server die Lösung hinzuzufügen:

stsadm.exe -o addsolution -filename <PfadzurCAB>

Hinweis
Das Tool Stsadm.exe finden Sie in folgendem Verzeichnis: C:\Programme\Gemeinsame Dateien\Microsoft Shared\web server extensions\12\BIN.

Das Tool Stsadm.exe finden Sie in folgendem Verzeichnis:

C:\Programme\Gemeinsame Dateien\Microsoft Shared\web server extensions\12\BIN.

Hinweis
Weitere Informationen zu den Befehlszeilenoptionen für Stsadm.exe finden Sie unter Zuordnung zwischen Stsadm und Windows PowerShell (SharePoint Foundation 2010) (https://technet.microsoft.com/de-de/library/ff621081.aspx).

So stellen Sie die Lösung bereit

Klicken Sie im Startmenü auf Ausführen, und geben Sie dann cmd ein.

Die Befehlszeilenkonsole wird angezeigt.
Führen Sie das folgende Skript aus, um die Lösung in SharePoint Server bereitzustellen.

stsadm.exe -o deploysolution -name <Dateiname der CAB-Datei> -immediate -allowGacDeployment

Die UDF-DLL sollte jetzt im globalen Assemblycache angezeigt werden.