Configurar a Experiência de Iniciação Predefinida para os seus Ficheiros do Office

Configurar o modo de Iniciação dos Clientes do Office

Ao obter um DriveItem do Microsoft API do Graph com:

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

A webUrl propriedade na resposta pode ser uma ligação para Web Application Open Platform Interface (WOPI) para compor tipos de ficheiros do Office suportados. O URL terá o seguinte aspeto:

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

Esta webUrl ação irá abrir o WOPI no modo predefinido (action=default). Se quiser substituir o modo predefinido para forçar um modo específico (por exemplo, Ver só de leitura e Editar para editor), pode aumentar o webUrl seguinte:

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

Abrir ficheiros do Office diretamente nos clientes de Ambiente de Trabalho

Para abrir os seus ficheiros diretamente nos clientes de ambiente de trabalho do Office, tem de criar um esquema de URI do Office. O formato é o seguinte:

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

Utilize a tabela seguinte para substituir os segmentos anteriores:

• scheme-name: o nome da aplicação, por exemplo: ms-excel
• command-name:
  • ofv para Abrir Vista de Ficheiro
  • ofe para Abrir Edição de Ficheiro
  • nft para Novo a Partir do Modelo
• command-argument-descriptor e command-argument:
  • |u|{file url}
  • |s|{save location}
    • apenas para Novo A Partir do Modelo

Segue-se um exemplo de utilização do esquema URI do Office:

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

Uma vez que a webUrl propriedade aponta para documentos do Office Online para o Office, tem de obter a ligação real em dois passos:

1. Obter o WebUrl da pasta principal
2. Acrescentar o nome do ficheiro

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 os esquemas de URI do Office, consulte Esquemas de URI do Office.