view pdf winform c# : Add links to pdf in preview software application cloud windows winforms html class wopi3-part1329

Office Online Integration Documentation, Release 2016.01.27
Figure 1.6: WOPI validation application UI
Figure 1.7: Tests can pass, fail, orbe skipped
1.10. WOPI Validation application
Add links to pdf in preview - insert, remove PDF links in, ASP.NET, MVC, Ajax, WinForms, WPF
Free C# example code is offered for users to edit PDF document hyperlink (url), like inserting and deleting
pdf hyperlinks; adding hyperlinks to pdf files
Add links to pdf in preview - VB.NET PDF url edit library: insert, remove PDF links in, ASP.NET, MVC, Ajax, WinForms, WPF
Help to Insert a Hyperlink to Specified PDF Document Page
pdf hyperlink; add links to pdf in preview
Office Online Integration Documentation, Release 2016.01.27
Figure 1.8: Example WOPIvalidation results
Chapter 1. How to read this documentation
C# Create PDF Library SDK to convert PDF from other file formats
PDF with a blank page, bookmarks, links, signatures, etc. PDF document in C#.NET using this PDF document creating toolkit, if you need to add some text
adding a link to a pdf; pdf link
C# Image: Tutorial for Document Management Using C#.NET Imaging
navigate viewing document by generating a thumbnail preview. on each part by following the links respectively & profession imaging controls, PDF document, image
pdf edit hyperlink; add hyperlink pdf file
Office Online Integration Documentation, Release 2016.01.27
Tip: For ease of testing, we strongly recommend that hosts support the .wopitest file extension just like all other
file extensions supportedbyOffice Onlineand includedinWOPIdiscovery. This is especially important while testing,
since it provides anyuser a quick and easy way to execute the validation test suite.
1.10.2 Automated WOPI validation
The WOPI Validation Application exposes a second action,getinfo. Thegetinfo action is designed to be used
server-to-server. Instead of launching ahostpage, the host can simply do the following:
1. Issue aGETrequest to the getinfo action URL provided inWOPIdiscovery. TheWOPIsrc,accesstoken, and
Note: Thegetinfo action onlysupportsGETrequests, sotheaccesstoken,andaccess_token_ttlvalues must
be appended to the URL instead of being passed asPOST parameters.
2. Office Online will do some basic validation (e.g. confirm the file really has the .wopitest extension) and
then return a JSON-formatted array of test URLs.
3. Hosts should then make aGETrequest to each test URL. Office Online will run the specified test and return
results in a simple JSON object. No changes to the URL are needed; the necessary parameters are included
already on the URL returned fromthe validation application.
This is intended for automated use. For example, a host may wish to run this validation as part of rolling out new
versions of theirWOPI host.
1.11 Testing Office Online integration
Before starting the‘golive’process, you should do the following testing on your integration.
Important: You should do this testing only after theWOPIValidationapplicationtests are passing.
1.11.1 WOPI implementation verification
TheWOPIValidationapplicationis a very useful tool in testing your WOPIimplementation. However, it cannot find
all potential problems in yourimplementation. Check the following items in addition tothe results from the validator.
Non-standard CheckFileInfo properties
Hosts should avoid returning properties inCheckFileInfothatare not defined as part ofthe WOPIprotocol. Properties
may be added to CheckFileInfo in the future, and if hosts are already returning something for that property, then it
might not be the expected type, or the value might not be in the expected format, etc. Thus, hosts should not return
properties that aren’t in this documentation.
1.11. Testing Office Online integration
C# Word - Convert Word to PDF in C#.NET
of original Word file and maintains the original text style (including font, size, color, links and boldness C# Demo: Convert Word to PDF Document. Add references
add a link to a pdf; change link in pdf
C# powerpoint - Convert PowerPoint to PDF in C#.NET
PowerPoint file and maintains the original text style (including font, size, color, links and boldness C# Demo: Convert PowerPoint to PDF Document. Add references
add hyperlink in pdf; add url link to pdf
Office Online Integration Documentation, Release 2016.01.27
CheckFileInfo property return types
TheWOPIValidationapplicationtests do not currently check for the proper return types. For example, while the
versionvalueissupposedtobeastring,youcanreturnanintandthetestswillpass. Thiscancauseerrorsinthe
Office Online applications that are difficult to diagnose. For this reason, check that your return types are accurate.
Non-empty response body
Most WOPI operations do not return a response body. You should not return a response body unless the operation
specifically requires it. Forexample, successfulPutFileresponses should not have a body.
1.11.2 Office Online feature verification
Many Office Online features rely on a host’s WOPI implementation. You should test the following features to help
ensure your WOPI implementation is correct and that the Office Online integration is well-executed.
Downloaded files should have most recent document changes
If you are providing aDownloadUrl, you should ensure that a file downloaded using the Office Online Download a
Copy buttons contain the most recent edits. To test this:
1. Open a document in edit mode.
2. Make an edit to the document and wait for the Saved to <HostName> text to display.
3. Click the File → Save As →Download a Copy button.
4. Checkthat the downloaded file has the most recent edits you made to the document.
Download a Copy should not re-direct
As describe inDownloadUrl, Office Online expects that when directing users to the DownloadUrl, the file will be
immediately downloaded. This URL should not direct the user to some separate UIto download the file.
If you support renaming documents within Office Online (i.e. SupportsRename is true), you should check that the
rename operation behaves as expected. To test this:
1. Open a document in edit mode.
2. Click on the document name in the top title bar.
3. Rename the document.
4. Exit the Office Online application and check that the file was renamed.
If you are displaying the document name in the browser window/tab using the HTML title tag, you should check
that the document name is updated after the file is renamed. If it is not, check that you are properly handling the
Chapter 1. How to read this documentation
C# PDF: C# Code to Create Mobile PDF Viewer; C#.NET Mobile PDF
In Default.aspx, add a reference to the path in for Windows Forms application, please follow above links respectively. More Tutorials on .NET PDF Document SDK.
change link in pdf file; pdf link open in new window
C# powerpoint - Convert PowerPoint to HTML in C#.NET
The HTML document file, converted by C#.NET PowerPoint to HTML converter toolkit SDK, preserves all the original anchors, links, bookmarks and Add references:
add hyperlink to pdf; add links to pdf document
Office Online Integration Documentation, Release 2016.01.27
Save As in Excel Online
ExcelOnline supports saving anopendocument as a newcopy of that document using the File →Save As →Save As
button. This feature uses thePutRelativeFileWOPI operation. You should test that this feature works as expected.
Co-authoring support is a major boon to users, but it also provides a useful way to verify yourimplementation of file
IDs and lock-related WOPI operations.
Important: The Office Online applications eachhave unique behaviorwithrespect toco-authoring. Thus itis critical
to test co-authoring in all three applications.
To check that co-authoring behaves as expected, you’ll need at least two different user accounts. Then, follow these
1. As User A, share a document with User B.
2. Open the document in edit mode as User A.
3. Open that same document in edit mode as UserB.
4. Checkthat both instances of the Office Online application are participating in the co-authoring session.
5. Make edits to the document as both users and ensure that both instances of the application remain connected to
the co-authoring session.
6. Aftermaking some edits, leave the sessionand verify that the saved file contains the edits made by both UserA
and User B.
Common issues
1. If the users remain in different sessions (i.e. co-authoring does not occur) then it likely means your WOPI file
IDs are not consistent. SeefileID for more information.
2. If one of the users is ‘kicked out’ of the session while editing, then it likely means that you’re rejecting lock-
related requests that come from a different user than the one who originally took the lock. WOPI locks are not
user-owned. SeeLockfor more information.
Single-user co-authoring
While the typical co-authoring scenario is two or more users collaborating on a single document in real-time, the
feature also provides otherbenefits as outlined inBenefitsfromco-authoringsupport.
Important: The Office Online applications eachhave unique behaviorwithrespect toco-authoring. Thus itis critical
to test co-authoring in all three applications.
To check that single-user co-authoring behaves as expected:
1. Open a document in edit mode.
2. Open a document in edit mode using the same user account originally used,but in a different browser.
3. Checkthat both instances of the Office Online application are participating in the co-authoring session.
1.11. Testing Office Online integration
C# Word - Convert Word to HTML in C#.NET
VB.NET How-to, VB.NET PDF, VB.NET Word, VB.NET Excel, VB to HTML converter toolkit SDK, preserves all the original anchors, links, bookmarks and Add references:
pdf reader link; add links to pdf
How to C#: Basic SDK Concept of XDoc.PowerPoint
Conversely, conversion from PDF to PowerPoint (.PPTX) is also split PowerPoint file(s), and add, create, insert including editing PowerPoint url links and quick
clickable links in pdf from word; add hyperlinks to pdf
Office Online Integration Documentation, Release 2016.01.27
1.11.3 UI integration
Ensure you follow theUIguidelinesas well as the terms of the Cloud Storage PartnerProgramcontract.
1.12 UI guidelines
Important: The guidelines here are not exhaustive. Hosts are expected to follow the terms of the Cloud Storage
PartnerProgram contract with respect to Office Online integration.
1. Do not display any UI on or around the Office Online editor. The Office Online editors must always be
displayed ‘edge-to-edge’,with no surrounding UI. The editor cannotbe ‘light-boxed’or integrated as a compo-
nent in host UI. The editor is a standalone application. Note that the Office Online viewer can be ‘light-boxed’
or otherwise embedded in your application. However, if the user transitions to the editor, the editor must be
2. Use Microsoft-provided application and file type icons. SeeApplicationandfiletypeiconsfor more infor-
3. Provide favicons for the Office Online applications. Whenever the editor is displayed or the viewer is dis-
played full-window/full-tab, the favicon for the page should be set to the appropriate favicon. The preferred
method is to use the URLs provided in WOPI discovery. SeeFaviconURLsfor more information.
4. Use Office Online applicationnames in UI thatactivates Office Online. For example,ifyouhave UIin your
application that reads,Open, this UI shouldread Open in PowerPoint Online or Open in Office Online.
5. Provide support for sharing within Office Online. Office Online provides a mechanism to share documents
with other users directly within the Office Online applications. You should take advantage of this capability
so that users can access sharing controls directly within Office Online. SeeFileSharingPostMessageandFile-
6. Provide breadcrumband breadcrumb URL values. SeeBreadcrumbsfor more information.
7. Provide an in-app Edit inBrowser button. Ifyou are using the Office Online viewer and the current userhas
permissions to edit the document, you should always provide aHostEditUrlso that the Edit in Browser button
is always displayed. This helps provide a more seamless transition forusers.
1.12.1 Application and file type icons
As partoftheCloud Storage PartnerProgram,Microsoft will providea ‘branding toolkit’ that includes properfile type
and application icons in various sizes,as well as vector-based image formats for re-sizing.
Tip: The branding toolkit can be found in the Office 365 Cloud Storage Partner Program Yammer group, in the
Network Resources section in the right sidebar. All O365 Cloud Storage partners should have access to this Yammer
You shoulduse these icons as follows:
1. When displaying an Office file, either individually or as part of a list offiles,use the file type icons. Do not use
the application icons forthis purpose.
2. When displayinga button or otherUIelement that opens anOffice Onlineapplication, usethe application icons.
For example,if you display anOpen in Word Online button,you should use the Word application icon.
Chapter 1. How to read this documentation
How to C#: Basic SDK Concept of XDoc.Word
Conversely, conversion from PDF to Word (.docx) is also and split Word file(s), and add, create, insert document, including editing Word url links and quick
add links in pdf; add email link to pdf
Office Online Integration Documentation, Release 2016.01.27
Important: If you re-size or otherwise modify the provided icons, you must use the vector source files to maintain
the highimage quality of the icons.
1.12.2 Breadcrumbs
Breadcrumbs are an importantnavigationaltool forusers. They dramatically improvetheuserexperienceby providing
helpful ‘anchors’ so users can both understand where the document they are working on is located, as well as more
easily navigate in and out of the Office Online applications.
WOPI supportstwolevelsofbreadcrumbs only. Thus, the recommended use of these properties is as follows:
BreadcrumbBrandName/BreadcrumbBrandUrl You should set these properties to the ‘root’ of your navigational
hierarchy. A basic rule of thumb is that clicking this breadcrumb should take the user to their logical ‘home’
withinyour WOPIhost.
In some cases, you may have several different siloed hierarchies within your application. In such cases it may
make more sense to set these properties to the root of the particular hierarchy in which the current document is
Ultimately you should pick a location most appropriate for yourusers and application structure.
BreadcrumbFolderName/BreadcrumbFolderUrl You should setthese properties to the containerin which the cur-
rent documentis located. A basic rule ofthumb is that clicking this breadcrumb shouldtake the userbackto the
same location they were in prior to opening the document.
Tip: If you support multiple paths to get to a file, you may wish to expose different breadcrumb properties
depending on how the user navigated to the file. You can achieve this by using theSessioncontextparameterto
customize yourCheckFileInforesponse.
Considera logical hierarchy like this:
-- Reviews
-- Data
-- Aggregate Data.xlsx
-- Raw Data.xlsx
-- Monthly Review.pptx
-- Deals
-- Integration Plans.docx
-- Leads.xlsx
In this case, if the user opens Aggregate Data.xlsx, BreadcrumbBrandName/BreadcrumbBrandUrl should be
set to Documents, while the BreadcrumbFolderName/BreadcrumbFolderUrl should be set to Data.
Similarly, if the user opens Integration Plans.docx, BreadcrumbBrandName/BreadcrumbBrandUrl should
be set to Documents, while the BreadcrumbFolderName/BreadcrumbFolderUrl should be set to Deals.
1.12. UI guidelines
Office Online Integration Documentation, Release 2016.01.27
1.13 Troubleshooting interactions with Office Online
When integrating with Office Online, it may be necessary to work with Microsoft engineers to diagnose problems.
Following the steps below will helpboth you and Microsoft diagnose problems more quickly.
1.13.1 Before reporting issues
Before reportingany issues toMicrosoft, ensure that you have done the following:
1. Check that theWOPIValidationapplicationtests are passing. Most common issues are easily diagnosed using
the validator, and passing tests are a pre-requisite forany investigations into issues you’re encountering.
Tip: In cases where the validator tests are not consistent with the documentation, assume that the validator is
correct. Also pleasefileanissueso that we can address the gaps in the documentation.
2. ChecktheKnownIssuestosee ifwhatyou’reencountering is already known. When possible,workarounds will
be provided in the issue notes.
1.13.2 Fiddler traces
The most useful tool when troubleshooting Office Online integration issues isFiddler. When you run Fiddler while
reproducing an issue, it will record all HTTP requests and responses. You can then save the Fiddler trace and share it
with Microsoft engineers. Fiddler traces are an invaluable tool when troubleshooting problems because they provide
afull record of the HTTP traffic between the browser and Office Online. As a rule of thumb, hosts should always
provide a Fiddler trace when reporting Office Online integration issues to Microsoft.
Enabling HTTPS decryption in Fiddler
Because Office Online traffic is encrypted, Fiddler must be configured to decrypt the HTTPS traffic in order to be
useful. In order to enable HTTPS encryption in Fiddler,do the following:
1. FromFiddler, click Tools →Fiddler Options... to open the options dialog.
2. On the HTTPS tab, check the Capture HTTPS CONNECTs check box.
3. Check the Decrypt HTTPS traffic check box. When you do this Fiddler will display a dialog asking if you wish
to trust the Fiddler Root certificate. Click Yes. You may also see some security warnings from the operating
systemasking if you want to install the certificate. Click Yes to all ofthese prompts.
4. In the drop-down, select ...from browsers only.
5. Click OK inthe options dialog.
6. Close Fiddlerand restart it.
Fiddler is now configured to decrypt HTTPS traffic.
Using Fiddler to trace a session
Using Fiddler to trace HTTP activity is straightforward:
1. Open Fiddler.
Chapter 1. How to read this documentation
Office Online Integration Documentation, Release 2016.01.27
Figure 1.9: Fiddler must be configured todecrypt HTTPS traffic in orderto produce useful traces
2. If needed, begin capturing traffic (File → Capture Traffic). Note that Fiddler starts in capture mode when it is
opened,so this step may not be necessary.
3. Navigate to the host page URL while Fiddler is running, then reproduce the issue ifneeded.
4. Once the issue is reproduced, save the Fiddler session as an archive (File → Save → All sessions...). The
resulting file should have the file extension .saz.
Using Fiddler in Linux or OS X
Fiddler works very well in Windows, but can also be used in Linux and OS X using Mono.
1.13.3 Alternatives to Fiddler: HTTP Archives (HAR)
If you cannot use Fiddler to get session traces, you can also use the Chrome browser developer tools to save HTTP
Archive (HAR) files containing the HTTP requests made by the browser. To do this,do the following:
1. Open the Chrome developer tools and select the Network tab.
2. Check the Preserve log check box if you wish to retain the request log across multiple page navigations. This
makes the network tracing behave more like Fiddler, and makes it less likely that you’ll lose your request log
by accidentally refreshing the page or navigating away before you save the log. Office Online applications are
single-page applications, so you don’t need to check this if you’re only planning to trace a single session.
3. After you are done reproducing the issue, right-click in the network view and select the Save as HAR with
Content option.
1.13. Troubleshooting interactions with Office Online
Office Online Integration Documentation, Release 2016.01.27
Figure 1.10: Network tab in the Chrome developer tools
Figure 1.11: Save as HAR with Content option in the Chrome developertools
Chapter 1. How to read this documentation
Documents you may be interested
Documents you may be interested