Table of contents
TOC
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern
Zuletzt aktualisiert: 20.06.2018

Dateihandler in Office 365 erstellen

Gilt für: Office 365

Dieses Schritt-für-Schritt Beispiel zeigt die Erstellung eines einfachen Dateihandlers für einen benutzerdefinierten Dateityp unter Verwendung der Vorlage für die Dateihandleranwendung. Sie können die Vorlage für Visual Studio 2013 und Visual Studio 2015 von Dateihandleranwendungherunterladen oder im Abschnitt Online Vorlagen im Dialog Neues Projekt finden.

Erstellen und Anpassen der Office 365-Anwendung

Wie bereits erwähnt, basiert dieses Beispiel auf der Vorlage für die Dateihandleranwendung, daher müssen Sie ein neues Projekt mit dieser Vorlage erstellen. Sie können es entweder von Dateihandleranwendungherunterladen oder aus dem Abschnitt Online Vorlagen im Dialog Neues Projekt suchen.

So laden Sie die Vorlage herunter und erstellen das Projekt

  1. Klicken Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
  2. Wählen Sie im linken Bereich Onlineund in der Kategorie Visual C#Office.
  3. Dateihandleranwendung sollte als Option im mittleren Fenster erscheinen; wählen Sie es aus, geben Sie basicfilehandler für den Namen ein und klicken Sie OK, um das Projekt zu erstellen.

Wenn Sie die Vorlage noch nicht installiert haben, werden Sie aufgefordert, die Vorlage zu installieren.

Als nächstes registrieren Sie die App bei Azure AD und ändern sie sie dann, um die Dateihandler-Erweiterungsfunktionalität hinzuzufügen.

So registrieren und konfigurieren Sie die App bei Azure AD

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt und wählen Sie Hinzufügen > Verbundener Dienst.

  2. Wählen Sie Office 365 APIs, und klicken Sie auf Konfigurieren.

  3. Klicken Sie auf Anwendung registrieren.

    Hinweis Der Text im Dialog Verbundener Dienst hinzufügen kann sich je nach Visual Studio-Version unterscheiden. Wenn Anwendung registrieren nicht verfügbar ist, müssen Sie möglicherweise Platzhalterwerte für die ClientId und ClientSecret in der web.config entfernen. Suchen Sie dazu die folgenden Schlüssel und entfernen Sie sie aus der web.config:

    <add key="ida:ClientId" value="[ClientId placeholder]" />
    <add key="ida:ClientSecret" value="[ClientSecret placeholder]" />
    
  4. Melden Sie sich mit einem Mandantenadministrator-Konto für Ihre Office 365-Entwicklerorganisation an.

  5. Klicken Sie auf App Eigenschaften.

  6. Fügen Sie Folgendes zur Liste URIs umleiten hinzu:

    • http://basicfilehandler.azurewebsites.net

    • https://basicfilehandler.azurewebsites.net

      Hinweis Die Website basicfilehandler.azurewebsites.net ist der Ort, an dem die Dateihandleranwendung gehostet wird. Diese erstellen Sie, wenn Sie dieses Projekt in einem späteren Schritt in Azure veröffentlichen.

  7. Klicken Sie auf Anwenden, um den Dialog App Eigenschaften zu schließen, und dann auf OK, um den Dialog Dienst-Manager zu schließen.

An dieser Stelle fügt Visual Studio die erforderlichen NuGet-Pakete zum Projekt hinzu. Jetzt sind Sie bereit, die Berechtigungen für Ihre Anwendung zu konfigurieren, was im Azure AD-Verwaltungsportal geschehen muss.

  1. Melden Sie sich im Azure Verwaltungsportalan.

  2. Wählen Sie im linken Navigationsbereich Active Directory. Stellen Sie sicher, dass die Registerkarte Directory ausgewählt ist, und klicken Sie dann auf den Verzeichnisnamen.

  3. Wählen Sie auf der Verzeichnisseite Anwendungen. Sie sollten Ihre Dateihandleranwendung aufgelistet sehen. Wenn Sie es nicht in der Liste sehen, wählen Sie Anwendungen, die meine Firma besitzt in der Dropdown-Liste Anzeigen.

  4. Wählen Sie Ihre Anwendung und klicken Sie dann im oberen Menü auf Konfigurieren.

  5. Blättern Sie zum Ende der Seite und wählen Sie unter Berechtigungen für andere AnwendungenAnwendung hinzufügen.

  6. Wählen Sie Microsoft Graph, und klicken Sie dann auf das Häkchen-Symbol.

  7. Klicken Sie unter Berechtigungen für andere Anwendungen auf die Spalte Delegierte Berechtigungen und wählen Sie Lesen und Schreiben von Dateien, die der Benutzer auswählt.

  8. Klicken Sie in der unteren Navigationsleiste auf Speichern.

Fügen Sie den Code zu der Dateihandleranwendung

Jetzt sind Sie bereit, den Code für den Dateihandler der Anwendung hinzuzufügen. Wenn Sie zum Erstellen des Projekts die Dateihandleranwendung-Projektvorlage verwendet haben, ist ein Großteil dieser Arbeit bereits für Sie erledigt. Die wichtigsten verbleibenden Aufgaben sind das Hinzufügen von Code zu den Methoden Neue Datei, Öffnen und Vorschau, um festzulegen, was mit dem benutzerdefinierten Dateityp geschehen soll.

Sie finden diese Methoden in der Datei FileHandlerController.cs im Ordner Controllers der Projektlösung.

Für die Methode Vorschau suchen Sie nach der folgenden Methodendeklaration:

public async Task<ActionResult> Preview()

Für die Methode Öffnen suchen Sie nach der folgenden Methodendeklaration:

public async Task<ActionResult> Open()

Für die Methode Neue Datei suchen Sie nach der folgenden Methodendeklaration:

public async Task<ActionResult> NewFile()

Hinweis Der erste Teil des Codes in diesen Methoden lädt die Aktivierungsparameter. Aktivierungsparameter enthalten Informationen, die Office 365 als Teil der POST Anfrage an den Dateihandler enthält. Der in der Projektvorlage enthaltene Code greift auf diese Werte zu und speichert sie, sobald der Dateihandler aufgerufen wird. Weitere Informationen zu den verfügbaren Parametern finden Sie unter Aktivierungsparameter des Dateihandlers.

Anwendung veröffentlichen

Jetzt sind Sie bereit, die Anwendung in Azure zu veröffentlichen.

  1. Klicken Sie in Projektmappen-Explorermit der rechten Maustaste auf das Projekt und wählen Sie Veröffentlichen.

  2. Wählen Sie Microsoft Azure Websites.

  3. Wenn Sie zur Eingabe von Anmeldedaten aufgefordert werden, geben Sie die Anmeldedaten ein, die Sie zur Verwaltung Ihres Azure-Abonnements verwenden.

  4. Klicken Sie in Bestehende Websites auswählenauf Neu.

  5. Geben Sie basicfilehandler als Site-Nameein.

  6. Wenn Sie keinen Datenbankserver eingerichtet haben, geben Sie Neuen Server erstellenan; andernfalls wählen Sie den zu verwendenden Datenbankserver.

  7. Klicken Sie auf Erstellen.

  8. Sobald die Seite erstellt ist, klicken Sie auf Veröffentlichen.

Konfigurieren des Dateihandlers

Nach der Veröffentlichung der Dateihandleranwendung können Sie diese in Office 365 konfigurieren.

  1. Navigieren Sie zum AddIns Manager-Beispielwerkzeug, mit dem Sie die notwendigen Abfragen an die Azure AD Graph API zur Konfiguration des Dateihandlers durchführen können. Mit dem AddIns Manager wird die App-Konfiguration in Azure AD aktualisiert.

    Hinweis Das AddIns Manager-Beispielwerkzeug dient nur zu Demonstrations- und Testzwecken und sollte nicht in Produktionsumgebungen verwendet werden.

  2. Wenn die Seite im Browser geladen wird, klicken Sie oben rechts auf anmelden.

  3. Geben Sie die Zugangsdaten für den Mandanten-Administrator ein und klicken Sie auf anmelden.

  4. Wählen Sie in Meine Anwendungen in der linken Navigationsleiste den Namen Ihrer Dateihandler-App aus.

  5. Klicken Sie auf Add-In registrieren.

  6. Wählen Sie im Dialog Add-In registrierenDateihandler.

  7. Klicken Sie auf das Dropdown-Menü für Dateihandler Add-In.

  8. Geben Sie die Details für Ihren Dateihandler ein. Hinweis Das Protokoll muss https sein.

  9. Klicken Sie auf Add-In aktualisieren.

Testen des Dateihandlers

Um Ihre Anwendung zu testen, laden Sie einige Beispieldateien mit dem benutzerdefinierten Dateityp auf Ihre SharePoint-Website hoch. Wenn Sie die Dokumentbibliothek anzeigen, sollten diese Dateien mit dem Bild angezeigt werden, das Sie für das benutzerdefinierte Dateisymbol angegeben haben. Wenn Sie Add-In-Metadaten in Azure Active Directory ändern, können Sie die Änderungen in Office 365 sehen, indem Sie Ihren Browser aktualisieren.

© 2018 Microsoft