4.3 Viewing a Document

In this scenario, a user of a WOPI server is able to view a .docx file through a WOPI client.

A user of a WOPI server identifies the .docx file to be viewed in a browser. The WOPI server exposes UI that allows the user to do this through the WOPI client that the WOPI server has already learned about via Discovery XML.

The user clicks the UI. The WOPI server navigates the user’s browser to a new web page. On that web page, the WOPI server creates an iframe HTML element that navigates to the URI for viewing .docx files. This URI was constructed using the urlsrc that the WOPI server learned about through Discovery XML.

The WOPI client uses the id and token provided by the WOPI server to access the .docx file on the WOPI server. The WOPI client renders uses GetFile operation to get this file and then a view of this file inside the iframe created by the WOPI server. The WOPI server returns the file to user.

When implementing a WOPI client page it is important to set up the page such that it is not cached. Caching the page could introduce undesirable behaviors.

GetFile request from WOPI client:

 GET http://WOPIClient/wv/ResReader.ashx?n=p_1_10.xml&WOPIsrc=http%3A%2F%2FWOPIServer%2F%5Fvti%5Fbin%2Fwopi%2Eashx%2Ffiles%2Fcc8e6af1e0554661b71faeaa0d45fdd7&access_token=eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIng1dCI6IlpDdVJLUGlHSU1DNThhZW9QOS1Eb1Y1M0VJOCJ9%2EeyJhdWQiOiJ3b3BpL3N1dG8xNTMxQDAxNjVmYjU3LWQzMTYtNDQxOS04ODE5LTE5ZDRiMzdiY2JlMSIsImlzcyI6IjAwMDAwMDAzLTAwMDAtMGZmMS1jZTAwLTAwMDAwMDAwMDAwMEAwMTY1ZmI1Ny1kMzE2LTQ0MTktODgxOS0xOWQ0YjM3YmNiZTEiLCJuYmYiOiIxMzQzODcyOTg5IiwiZXhwIjoiMTM0MzkwODk4OSIsIm5hbWVpZCI6IjAjLnd8ZmFyZWFzdFxccGV0dGVzdCIsIm5paSI6Im1pY3Jvc29mdC5zaGFyZXBvaW50IiwiaXN1c2VyIjoidHJ1ZSIsImNhY2hla2V5IjoiMCkud3xzLTEtNS0yMS0yMTQ2NzczMDg1LTkwMzM2MzI4NS03MTkzNDQ3MDctNjkyMTU2IiwiaXNsb29wYmFjayI6IlRydWUiLCJhcHBjdHgiOiJjYzhlNmFmMWUwNTU0NjYxYjcxZmFlYWEwZDQ1ZmRkNzt2SUtMTktTa0tBU21nYTJNR1ZKUUw2Q21wTUU9O0RlZmF1bHQ7OzdGRkZGRkZGRkZGRkZGRkY7VHJ1ZSJ9%2EFuxDXJ4Wk1rTrSSDuFbbM%5F61BGW%2DXBz5JBHdpG64GiLTSe9VRhxOaS3%2DbJDuHDJaqzsbSOa6UoVnVKtGe9Mift2fMuF4nxcXoDZx3QxcJncs%5FTbcUKQLDN6Z4ZHIZJeM455ms53Mfs1JoIwwmvWaTm76YJYwbawEyIIxI7dPSbxUaN1102EVmmT6lYSZNK0xaUaoFXP1yHhgbSJFgqENfSCC1M%5Fc%2Da19DTPE9www1hRwWWep5eDS1bwRYIJIETXBVF6vtmLWBk7rT53S%5FEsQF4VV0pPjMmULWZ0yEarXOa8bKslJ%5FO00U%5F7LpmEJK7GvQ5A3yPP40gfpLrKi6KTCWQ&access_token_ttl=1343908989210&z=%2522%257BCC8E6AF1%252DE055%252D4661%252DB71F%252DAEAA0D45FDD7%257D%252C4%2522&v=00000000-0000-0000-0000-000000000602&usid=4cd12455-fd24-4bf9-a5a6-647994930a60 HTTP/1.1
  
 GetFile response from WOPI server:
 <?xml version="1.0"?>
 <Pages>
   <Page id="1">
     <Header>
       <P storyId="2" id="6C2D515C">
       <CN/>
       <T id="0" l="96.1" t="49.4" w="9" h="15" b="1" cw=",7;"> </T>
       </P>
     </Header>
     <Footer>
       <P storyId="3" id="4F36214B">
       <CN/>
       <T id="1" l="96.1" t="992.2" w="9" h="15" b="1" cw=",7;"> </T>
       </P>
     </Footer>
     <P storyId="1" id="4F75DE7D">
     <T id="2" l="96.1" t="97.4" w="33" h="15" b="1" cw="410,4;286,6;400,5;410,3;,7;">test </T>
     </P>
   </Page>
 </Pages>