52 lines
3.7 KiB
Plaintext
52 lines
3.7 KiB
Plaintext
<%@ Control Language="C#" Inherits="BaseContentUserControls" %>
|
|
<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %>
|
|
<script runat="server">
|
|
protected override void Init()
|
|
{
|
|
PageTitle = PageCaption = "Opening File";
|
|
MetaDescription = "Статьи документации по API сервера документов.";
|
|
}
|
|
</script>
|
|
<div class="MainHelpCenter">
|
|
<h1 class="subHeaderFeaturesCaption Guides_Video_Captions">Opening File</h1>
|
|
<p class="dscr">The reference figure and the steps below explain the process of opening the document in ONLYOFFICE Document Server.</p>
|
|
<img alt="Opening File" src="<%=VirtualPathUtility.ToAbsolute("~/content/img/editor/opening.jpg")%>" />
|
|
<ol>
|
|
<li>The user uses the <b>document manager</b> (found in his/her browser) to open the document for viewing or editing.
|
|
<div class="note">The browser <b>document manager</b> receives the list of all documents available to the user from the <b>document storage service</b>.</div>
|
|
</li>
|
|
<li>The document identifier and the link to it at the <b>document storage service</b> are sent using the <a href="<%=VirtualPathUtility.ToAbsolute("~/api/editors/basic.aspx")%>">JavaScript API</a> to the <b>document editor</b>.</li>
|
|
<li>The <b>document editor</b> forms a request to the <b>document editing service</b> for document opening. The <b>document editor</b> uses the document identifier and its link received from the <b>document manager</b> (at step 2).</li>
|
|
<li>The <b>document editing service</b> downloads the document file from the <b>document storage service</b> using the ID and link provided. At this step the <a href="<%=VirtualPathUtility.ToAbsolute("~/api/editors/conversion.aspx")%>">conversion</a> of the file into Office Open XML format is also performed for the <b>document editor</b> better performance and formats compatibility.</li>
|
|
<li>When ready the <b>document editing service</b> transfers the document file to the browser-based <b>document editor</b>.</li>
|
|
<li>The <b>document editor</b> displays the document file and/or (in case the appropriate rights are provided) allows its editing.</li>
|
|
</ol>
|
|
<p>After the editing is finished, the <a href="<%=VirtualPathUtility.ToAbsolute("~/api/editors/save.aspx")%>">document saving</a> process takes place.</p>
|
|
|
|
<h2 id="apply" class="copy-link">How this can be done in practice</h2>
|
|
<ol>
|
|
<li>Create an empty <em>html</em> file.</li>
|
|
<li>Add the <em>div</em> element as shown below.
|
|
<pre><div id="placeholder"></div></pre>
|
|
</li>
|
|
<li>Specify your ONLYOFFICE Document Server link with the JavaScript API that will be used for your website.
|
|
<pre><script type="text/javascript" src="https://documentserver/web-apps/apps/api/documents/api.js"></script></pre>
|
|
Where the <b>documentserver</b> is the name of the server with the ONLYOFFICE Document Server installed.
|
|
</li>
|
|
<li>Add the script initializing the <b>Document Editor</b> for the <em>div</em> element with the configuration for the document you want to open.
|
|
<pre>
|
|
new DocsAPI.DocEditor("placeholder", {
|
|
"document": {
|
|
"fileType": "docx",
|
|
"key": "Khirz6zTPdfd7",
|
|
"title": "Example Document Title.docx",
|
|
"url": "https://example.com/url-to-example-document.docx"
|
|
},
|
|
"documentType": "text"
|
|
});
|
|
</pre>
|
|
Where the <b>example.com</b> is the name of the the server where <b>document manager</b> and <b>document storage service</b> are installed.
|
|
</li>
|
|
<li>Open your <em>html</em> file in the browser.</li>
|
|
</ol>
|
|
</div> |