Freigeben über

Konfigurieren der Standardstartumgebung für Ihre Office-Dateien

  • Artikel

Konfigurieren des Startmodus von Office-Clients

Beim Abrufen eines DriveItem aus dem Microsoft-Graph-API mit:

/graph/api/driveitem-get?view=graph-rest-1.0

Die webUrl -Eigenschaft in der Antwort kann ein Link zu WoPI (Web Application Open Platform Interface) sein, um unterstützte Office-Dateitypen zu rendern. Die URL sieht wie folgt aus:

https://host/:w:r/contentstorage/sitecollection/_layouts/15/doc2.aspx?sourcedoc=guid&file=filename.docx&action=default&mobileredirect=true

Dadurch webUrl wird WOPI im Standardmodus (action=default) geöffnet. Wenn Sie den Standardmodus außer Kraft setzen möchten, um einen bestimmten Modus zu erzwingen (z. B. Ansicht für schreibgeschützt und Bearbeiten für Editor), können Sie die webUrl wie folgt erweitern:

string webUrl = https://host/:w:r/contentstorage/sitecollection/_layouts/15/doc2.aspx?sourcedoc=guid&file=filename.docx&action=default&mobileredirect=true;

System.UriBuilder builder = new System.UriBuilder(webUrl);
System.Collections.Specialized.NameValueCollection queryDictionary = System.Web.HttpUtility.ParseQueryString(builder.Query);
queryDictionary["action"] = "view";
//queryDictionary["action"] = "edit";
builder.Query = queryDictionary.ToString();
string modifiedWebUrl = builder.ToString();

Tipp

Weitere Informationen zu WOPI-Aktionen finden Sie unter WOPI-Ermittlung – WOPI-Aktionen.

Office-Dateien direkt in Desktopclients öffnen

Um Ihre Dateien direkt in den Office-Desktopclients zu öffnen, müssen Sie ein Office-URI-Schema erstellen. Das Format lautet wie folgt:

<scheme-name>:<command-name>"|"<command-argument-descriptor>"|"<command-argument>

Verwenden Sie die folgende Tabelle, um die vorherigen Segmente zu ersetzen:

  • scheme-name: Der Name der Anwendung, z. B.: ms-excel
  • Befehlsname:
    • ofv für Dateiansicht öffnen
    • ofe for Open File Edit
    • nft for New From Template
  • command-argument-descriptor und command-argument:
    • |u|{file url}
    • |s|{save location}
      • nur für neue Aus-Vorlage

Hinweis

Die Neue Aus-Vorlage funktioniert für den Speicherort möglicherweise nicht wie erwartet, da sich das Berechtigungsschema von SharePoint-Websites unterscheidet.

Im Folgenden finden Sie ein Beispiel für die Verwendung des Office-URI-Schemas:

ms-word:ofv|u|https://contoso.com/document.docx
ms-powerpoint:ofe|u|https://contoso.com/presentation.pptx

Da die webUrl -Eigenschaft auf Office Online für Office-Dokumente verweist, müssen Sie den eigentlichen Link in zwei Schritten abrufen:

  1. Abrufen der WebUrl des übergeordneten Ordners
  2. Anfügen des Namens der Datei

Beispiel: das folgende Schema:

ms-word:ofe|u|{folder.WebUrl]/{item.Name}

... führt zu folgendem Schema:

ms-word:ofe|u|https://contoso.sharepoint.com/contentstorage/CSP_1234765465/Document%20Library/MyDocument.docx

Weitere Informationen zu Office-URI-Schemas finden Sie unter Office-URI-Schemas.

Hinweis

Der URI muss in einem leeren Fenster oder einer neuen Registerkarte geöffnet werden.