Compartir a través de

Configuración de la experiencia de inicio predeterminada para los archivos de Office

  • Artículo

Configuración del modo de inicio de clientes de Office

Al recuperar un DriveItem de Microsoft Graph API con:

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

La webUrl propiedad de la respuesta puede ser un vínculo a Web Application Open Platform Interface (WOPI) para representar los tipos de archivo de office admitidos. La dirección URL tendrá el siguiente aspecto:

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

Se webUrl abrirá WOPI en el modo predeterminado (action=default). Si desea invalidar el modo predeterminado para forzar un modo específico (por ejemplo, Ver para solo lectura y Editar para editor), puede aumentar de webUrl esta manera:

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

Sugerencia

Para obtener más información sobre las acciones de WOPI, consulte: WOPI Discovery - WOPI Actions.

Abrir archivos de Office directamente en clientes de escritorio

Para abrir los archivos directamente en los clientes de escritorio de Office, debe crear un esquema de URI de Office. El formato es el siguiente:

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

Use la tabla siguiente para reemplazar los segmentos anteriores:

  • scheme-name: nombre de la aplicación, por ejemplo: ms-excel
  • command-name:
    • ofv para abrir la vista de archivo
    • ofe para abrir la edición de archivos
    • nft for New From Template
  • command-argument-descriptor y command-argument:
    • |u|{file url}
    • |s|{save location}
      • solo para la plantilla Nueva a partir

Nota:

Es posible que la plantilla Nueva a partir no funcione como cabría esperar para guardar la ubicación, ya que el esquema de permisos es diferente de los sitios de SharePoint.

A continuación se muestra un ejemplo de uso del esquema uri de Office:

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

Dado que la webUrl propiedad apunta a documentos de Office Online para Office, debe obtener el vínculo real en dos pasos:

  1. Obtención del WebUrl de la carpeta primaria
  2. Anexar el nombre del archivo

Por ejemplo, el siguiente esquema:

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

... dará como resultado el siguiente esquema:

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

Para obtener más información sobre los esquemas uri de Office, consulte Esquemas de URI de Office.

Nota:

El URI debe abrirse en una ventana en blanco o en una nueva pestaña.