Partager via

Configurer l’expérience de lancement par défaut pour vos fichiers Office

  • Article

Configurer le mode lancement des clients Office

Lors de la récupération d’un DriveItem à partir de Microsoft API Graph avec :

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

La webUrl propriété dans la réponse peut être un lien vers WOPI (Web Application Open Platform Interface) pour le rendu des types de fichiers Office pris en charge. L’URL se présente comme suit :

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

WoPI webUrl s’ouvre en mode par défaut (action=default). Si vous souhaitez remplacer le mode par défaut pour forcer un mode spécifique (par exemple, Afficher pour lecture seule et Modifier pour l’éditeur), vous pouvez augmenter le webUrl comme suit :

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();

Conseil

Pour en savoir plus sur les actions WOPI, consultez : Découverte WOPI - Actions WOPI.

Ouvrir des fichiers Office directement dans les clients de bureau

Pour ouvrir vos fichiers directement dans les clients de bureau Office, vous devez créer un schéma d’URI Office. Le format est le suivant :

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

Utilisez le tableau suivant pour remplacer les segments précédents :

  • scheme-name : nom de l’application, par exemple : ms-excel
  • command-name :
    • ofv pour ouvrir l’affichage de fichiers
    • ofe pour Ouvrir un fichier Modifier
    • nft pour nouveau modèle à partir de
  • command-argument-descriptor et command-argument :
    • |u|{file url}
    • |s|{save location}
      • uniquement pour nouveau modèle à partir de

Remarque

Le nouveau modèle à partir de peut ne pas fonctionner comme prévu pour l’emplacement d’enregistrement, car le schéma des autorisations est différent des sites SharePoint.

Voici un exemple d’utilisation du schéma d’URI Office :

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

Étant donné que la webUrl propriété pointe vers des documents Office Online pour Office, vous devez obtenir le lien réel en deux étapes :

  1. Obtention du WebUrl du dossier parent
  2. Ajout du nom du fichier

Par exemple, le schéma suivant :

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

... entraîne le schéma suivant :

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

Pour en savoir plus sur les schémas d’URI Office, consultez Schémas d’URI Office.

Remarque

L’URI doit être ouvert dans une fenêtre vide ou un nouvel onglet.