Compartilhar via

Configurar a experiência de inicialização padrão para seus Arquivos do Office

  • Artigo

Configurar o modo de inicialização de clientes do Office

Ao recuperar um DriveItem do Microsoft API do Graph com:

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

A webUrl propriedade na resposta pode ser um link para WOPI (Web Application Open Platform Interface) para renderizar tipos de arquivo do office com suporte. A URL será semelhante a:

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

Isso webUrl abrirá a WOPI no modo padrão (action=default). Se você quiser substituir o modo padrão para forçar um modo específico (por exemplo, Exibir somente leitura e Editar para editor), você poderá aumentar assim webUrl :

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

Dica

Para saber mais sobre ações de WOPI, confira: Descoberta de WOPI – Ações DE WOPI.

Abrir arquivos do Office diretamente em clientes da Área de Trabalho

Para abrir seus arquivos diretamente nos clientes da área de trabalho do Office, você precisa criar um esquema de URI do Office. O formato é o seguinte:

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

Use a tabela a seguir para substituir os segmentos anteriores:

  • nome do esquema: o nome do aplicativo, por exemplo: ms-excel
  • nome do comando:
    • ofv para Modo de Exibição de Arquivo Aberto
    • ofe para Abrir Edição de Arquivo
    • nft para Novo Modelo de
  • command-argument-descriptor e command-argument:
    • |u|{file url}
    • |s|{save location}
      • somente para Novo Modelo de

Observação

O Novo Modelo do Modelo pode não funcionar como seria de esperar para salvar o local, pois o esquema de permissões é diferente dos Sites do SharePoint.

O seguinte contém um exemplo de uso do esquema de URI do Office:

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

Como a webUrl propriedade aponta para documentos do Office Online para Office, você deve obter o link real em duas etapas:

  1. Obtendo o WebUrl da pasta pai
  2. Acrescentando o nome do arquivo

Por exemplo, o seguinte esquema:

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

... resultará no seguinte esquema:

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

Para saber mais sobre esquemas de URI do Office, consulte Esquemas de URI do Office.

Observação

O Uri deve ser aberto em uma janela em branco ou em uma nova guia.