- The document editing service informs the document storage service about the status of the document editing using the callbackUrl from ">JavaScript API. - The document editing service use the POST request with the information in body. -
+Сервис редактирования документов оповещает сервис хранения документов о статусе редактирования документа, используя callbackUrl из ">JavaScript API. Сервис редактирования документов использует POST запросы с параметрами в теле.
-| Parameter | -Description | -Type | -Presence | +Параметр | +Описание | +Тип | +Наличие |
| actions | -Defines the object received if the new user connected to the document co-editing or disconnected from it. In the first case the type field value is 1, in the other case - 0. The userid field value is the identifier of the user who connected to or disconnected from the document co-editing. | -array of object | -optional | +Определяет полученный объект, если новый пользователь, был подключен к совместному редактированию документа или отключен от него. В первом случае значение поля тип равно 1, во втором - 0. Значение поля userid является идентификатором пользователя, который был подключен к совместному редактированию документа, или отключен от него. | +массив объектов | +необязательный | |
| changeshistory | -Defines the array of objects with the document changes history. The object is present when the status value is equal to 2 or 3 only. Must be sent as a property changes of the object sent as the argument to the ">refreshHistory method. Deprecated since version 4.2, please use history instead. | -array of object | -optional | +Определяет массив объектов с историей изменения документа. Объект присутствует только если значение параметра status равно 2 или 3. Должен быть отправлен как свойство changes, объекта, который был передан методу ">refreshHistory в качестве аргумента. Удалено, начиная с версии 4.2, пожалуйста, используйте history. | +массив объектов | +необязательный | |
| changesurl | -Defines the link to the file with the document editing data used to track and display the document changes history. The link is present when the status value is equal to 2 or 3 only. The file must be saved and its address must be sent as changesUrl parameter using the ">setHistoryData method to show the changes corresponding to the specific document version. | -string | -optional | +Определяет ссылку на файл с данными об изменениях документа, используемый для отображения истории изменения этого документа. Ссылка присутствует только если значение параметра status равно 2 или 3. Файл должен быть сохранён, а его адрес должен быть отправлен как параметр changesUrl, используя метод ">setHistoryData, чтобы показать изменения, относящиеся к конкретной версии документа. | +строка | +необязательный | |
| forcesavetype | -Defines the type of initiator when the ">force saving request is performed. Can have the following values:
-
|
- integer | -optional | +Определяет тип инициатора запроса на выполнение ">принудительного сохранения. Может быть равным следующим значениям:
|
+ целочисленный | +необязательный | |
| history | -Defines the object with the document changes history. The object is present when the status value is equal to 2 or 3 only. It contains the object serverVersion and changes, which must be sent as properties serverVersion and changes of the object sent as the argument to the ">refreshHistory method. | -object | -optional | +Определяет объект с информацией об истории изменения документа. Объект присутствует только если значение параметра status равно 2 или 3. Содержит объекты serverVersion и changes, которые должны быть отправлены как свойства serverVersion и changes объекта, который был передан в качестве аргумента методу ">refreshHistory. | +объект | +необязательный | |
| key | -Defines the edited document identifier. | -string | -required | +Определяет идентификатор отредактированного документа. | +строка | +обязательный | |
| status | -Defines the status of the document. Can have the following values:
-
Определяет статус документа. Может быть равным следующим значениям: |
-
integer |
- required |
+ целочисленный |
+ обязательный |
| |
| url | -Defines the link to the edited document to be saved with the document storage service. The link is present when the status value is equal to 2 or 3 only. | -string | -optional | +Определяет ссылку на отредактированный документ, который будет сохранён сервисом хранения документов. Ссылка присутствует только если значение параметра status равно 2 или 3. | +строка | +необязательный | |
| userdata | -Defines the custom information sent to the ">command service in case it was present in the request. | -string | -optional | +Определяет пользовательскую информацию, отправляемую ">командному сервису в случае, если она была передана в запросе. | +строка | +необязательный | |
| users | -Defines the list of the identifiers of the users who opened the document for editing; when the document has been changed the users will return the identifier of the user who was the last to edit the document (for status 2 and status 6 replies). | -array of string | -optional | +Определяет список идентификаторов пользователей, который открыли документ для редактирования; когда документ был изменён, объект users вернёт идентификатор пользователя, который последним редактировал документ (для ответов со статусами 2 и 6). | +массив строк | +необязательный |
Status 1 is received every user connection to or disconnection from document co-editing.
-Status 2 (3) is received ">10 seconds after the document is closed for editing with the identifier of the user who was the last to send the changes to the document editing service.
-Status 4 is received after the document is closed for editing with no changes by the last user.
-Status 6 (7) is received when the force saving request is performed.
+Статус 1 будет получен каждый раз, когда пользователь подключается к совместному редактированию документа или отключается от него.
+Статус 2 (3) будет получен через ">10 секунд после закрытия документа, с идентификатором пользователя, от которого сервисом редактирования документов в последний раз были получены изменения.
+Статус 4 будет получен после закрытия документа, если пользователь не вносил в него никаких изменений.
+Статус 6 (7) будет получен при выполнении запроса на принудительное сохранение.
-
{
"actions": [{"type": 1, "userid": "78e1e841"}],
@@ -126,7 +117,7 @@
}
-
{
"actions": [{"type": 0, "userid": "78e1e841"}],
@@ -142,7 +133,7 @@
}
-
{
"key": "Khirz6zTPdfd7",
@@ -150,7 +141,7 @@
}
-
{
"changesurl": "https://documentserver/url-to-changes.zip",
@@ -167,18 +158,18 @@
}
- The document storage service must return the following response, otherwise the document editor will display an error message:
+Сервис хранения документов должен отправить следующий ответ, в противном случае, редактор документов покажет сообщение об ошибке:
{
"error": 0
}
- The document manager and document storage service are either included to Community Server or must be implemented by the software integrators who use ONLYOFFICE Document Server on their own server.
+Менеджер документов и сервис хранения документов включены в Сервер совместной работы или должны быть реализованы разработчиками, использующими Сервер документов на своих собственных серверах.
-
public class WebEditor : IHttpHandler
{
@@ -206,9 +197,9 @@ public class WebEditor : IHttpHandler
}
}
-
public class IndexServlet extends HttpServlet {
@Override
@@ -245,9 +236,9 @@ public class IndexServlet extends HttpServlet {
}
}
-
var fs = require("fs");
@@ -282,9 +273,9 @@ app.post("/track", function (req, res) {
}
});
-
<?php
@@ -307,9 +298,9 @@ echo "{\"error\":0}";
?>
-
class ApplicationController < ActionController::Base
def index
@@ -340,5 +331,5 @@ class ApplicationController < ActionController::Base
end
end
- The document permission section allows to change the permission for the document to be edited and downloaded or not.
+Раздел разрешений документа позволяет изменять права на его редактирование и скачивание.
-| Name | -Description | -Type | -Example | +Имя | +Описание | +Тип | +Пример |
| comment | -Defines if the document can be commented or not. In case the commenting permission is set to "true" the document side bar will contain the Comment menu option; the document commenting will only be available for the document editor if the ">mode parameter is set to edit. The default value coincides with the value of the edit parameter. | -boolean | +Определяет, можно ли оставлять комментарии к документу. В случае, если вышеописанный параметр установлен в значение "true", боковая панель в редакторе документов будет иметь пункт меню Комментирование; комментирование документа будет доступно в редакторе документов только если параметр ">mode установлен в значение edit. Значение по умолчанию совпадает со значением параметра edit. | +логический | true |
| download | -Defines if the document can be downloaded or only viewed or edited online. In case the downloading permission is set to "false" the Download as... menu option will be absent from the File menu. The default value is true. | -boolean | +скачать | +Определяет, может ли документ быть скачан, или лишь может быть просмотрен и отредактирован онлайн. В случае если параметр разрешения на скачивание установлен в значение "false", пункт меню Скачать как... не будет отображён в меню Файл. Значением по умолчанию является true. | +логический | true |
| edit | -Defines if the document can be edited or only viewed. In case the editing permission is set to "true" the File menu will contain the Edit Document menu option; please note that if the editing permission is set to "false" the document will be opened in viewer and you will not be able to switch it to the editor even if the ">mode parameter is set to edit. The default value is true. | -boolean | +Определяет, может ли документ быть отредактирован или лишь просмотрен. В случае если параметр разрешения на редактирование установлен в значение "true", меню Файл будет содержать пункт Редактировать документ; учтите, пожалуйста, что, если параметр разрешения на редактирование установлен в значение "false", документ будет открыт в режиме просмотра, и вы не сможете переключиться в режим редактирования, даже если параметр ">mode установлен в значение edit. Значением по умолчанию является true. | +логический | true | |
| Defines if the document can be printed or not. In case the printing permission is set to "false" the Print menu option will be absent from the File menu. The default value is true. | -boolean | +Определяет, можно ли распечатать документ. В случае если параметр разрешения на печать установлен в значение "false", пункт меню Распечатать не будет отображён в меню Файл. Значением по умолчанию является true. | +логический | true | ||
| fillForms | -Defines if the forms can be filled. Filling in forms will only be available for the document editor if the ">mode parameter is set to edit. The default value coincides with the value of the edit or the review parameter. | -boolean | +Определяет, могут ли формы быть заполнены. Заполнение форм будет доступно в редакторе документов только если параметр ">mode установлен в значение edit. Значение по умолчанию совпадает со значением параметра edit или параметра review. | +логический | true |
| review | -Defines if the document can be reviewed or not. In case the reviewing permission is set to "true" the document status bar will contain the Review menu option; the document review will only be available for the document editor if the ">mode parameter is set to edit. The default value coincides with the value of the edit parameter. | -boolean | +Определяет, можно ли рецензировать документ. В случае, если параметр разрешения на рецензирование установлен в значение "true", строка состояния документа будет иметь пункт меню Рецензирование; рецензирование документа будет доступно лишь в случае, если параметр ">mode установлен в значение edit. Значение по умолчанию совпадает со значением параметра edit. | +логический | true |
var docEditor = new DocsAPI.DocEditor("placeholder", {
"document": {
diff --git a/helpcenter.r7-office.ru/Web/Controls/Help/APIEditors/Config/Editor.ascx b/helpcenter.r7-office.ru/Web/Controls/Help/APIEditors/Config/Editor.ascx
index 5cb30216f..4c1e624f9 100644
--- a/helpcenter.r7-office.ru/Web/Controls/Help/APIEditors/Config/Editor.ascx
+++ b/helpcenter.r7-office.ru/Web/Controls/Help/APIEditors/Config/Editor.ascx
@@ -1,6 +1,4 @@
-<%@ Control Language="C#" Inherits="BaseContentUserControls" %>
-<%@ Register Namespace="TeamLab.Controls" Assembly="__Code" TagPrefix="cc" %>
-
- Editor config
+ Конфигурация редактора
-Description
-The editorConfig section allows to change the parameters pertaining to the editor interface: opening mode (viewer or editor), interface language, additional buttons, etc.).
+Описание
+Раздел конфигурации редактора позволяет изменять параметры, относящиеся к интерфейсу редактора: режим открытия (просмотр или редактирование), язык интерфейса, дополнительные кнопки, и т.д.
-Parameters
+Параметры
- Name
- Description
- Type
- Example
+ Имя
+ Описание
+ Тип
+ Пример
callbackUrl*
- Specifies absolute URL to the document storage service (which ">must be implemented by the software integrators who use ONLYOFFICE Document Server on their own server).
- string
+ Определяет абсолютную ссылку на сервис хранения документов (который ">должнен быть разработан интеграторами, которые используют Сервер документов на своём собственном сервере).
+ строка
"https://example.com/url-to-callback.ashx"
createUrl
- Defines the absolute URL of the document where it will be created and available after creation. If not specified, there will be no creation button.
-
- string
+ Определяет абсолютную ссылку расположения, по которому документ будет доступен после создания. Если не указано, то кнопка создания не будет отображена.
+ строка
"https://example.com/url-to-create-document/"
lang
- Defines the editor interface language (if some other languages other than English are present). Is set using the two letter (de, ru, it, etc.) or four letter (en-US, fr-FR, etc.) language codes. The default value is "en-US".
- string
- "en-US"
+ Определяет язык интерфейса редактора (если доступны какие-либо другие языки, кроме русского), Устанавливается при помощи двух букв (de, ru, it, и т.д.) или четырёхсимвольных языкрвых кодов (en-US, fr-FR, и т.д.). Значением по умолчанию является "ru-RU".
+ строка
+ "ru-RU"
mode
- Defines the editor opening mode. Can be either view to open the document for viewing, or edit to open the document in the editing mode allowing to apply changes to the document data. The default value is "edit".
- string
+ Определяет режим открытия редактора документов. Может быть равным view, для открытия документа для просмотра, или edit - для открытия на редактирование. Значением по умолчанию является "edit".
+ строка
"edit"
recent
- Defines the presence or absence of the documents in the Open Recent... menu option where the following document parameters can be set:
-
- -
- folder - the folder where the document is stored (can be empty in case the document is stored in the root folder),
-
- type: string,
-
- example: "Example Files";
-
- -
- title - the document title that will be displayed in the Open Recent... menu option,
-
- type: string,
-
- example: "exampledocument1.docx";
-
- -
- url - the absolute URL to the document where it is stored,
-
- type: string,
-
- example: "https://example.com/exampledocument1.docx".
-
+ Определяет наличие или отсутствие документов в пункте меню Открыть последние..., значение которого может быть задано следующим образом:
+ - folder - папка, в которой хранится документ (может быть пустым, в случае, если документ хранится в корневой директории),
тип: строка,
пример: "Примеры файлов";
+ - Title - зголовок документа, который будет отображён в пункте меню Открыть последние...,
тип: строка,
пример: "exampledocument1.docx";
+ - url - абсолютная ссылка на место расположения файла документа,
тип: строка,
пример: "https://example.com/exampledocument1.docx".
- array of object
+ массив объектов
user
- Defines the user currently viewing or editing the document:
-
- -
- firstname - the first name of the user. Deprecated since version 4.2, please use name instead,
-
- type: string,
-
- example: "John";
-
- -
- id - the identification of the user,
-
- type: string,
-
- example: "78e1e841";
-
- -
- lastname - the last name of the user. Deprecated since version 4.2, please use name instead,
-
- type: string,
-
- example: "Smith";
-
- -
- name - the full name of the user. Used since version 4.2,
-
- type: string,
-
- example: "John Smith".
-
+ Определяет пользователя, который в данный момент просматривает или редактирует документ:
+ - firstname - имя пользователя. Удалено, начиная с версии 4.2, пожалуйста, используйте параметр name,
тип: строка,
пример: "Иван";
+ - Id - идентификатор пользователя,
тип: строка,
пример: "78e1e841";
+ - lastname - фамилия пользователя. Удалено, начиная с версии 4.2, пожалуйста, используйте параметр name,
тип: строка,
пример: "Smith";
+ - name - полное имя пользователя. Используется, начиная с версии 4.2,
тип: строка,
пример: "John Smith".
- object
+ объект
-
-
-* - required field
-Example
+* - обязательное полеПример
var docEditor = new DocsAPI.DocEditor("placeholder", {
"editorConfig": {
"callbackUrl": "https://example.com/url-to-callback.ashx",
"createUrl": "https://example.com/url-to-create-document/",
- "lang": "en-US",
+ "lang": "ru-RU",
"mode": "edit",
"recent": [
{
- "folder": "Example Files",
+ "folder": "Примеры файлов",
"title": "exampledocument1.docx",
"url": "https://example.com/exampledocument1.docx"
},
{
- "folder": "Example Files",
+ "folder": "Примеры файлов",
"title": "exampledocument2.docx",
"url": "https://example.com/exampledocument2.docx"
},
@@ -149,12 +99,12 @@ var docEditor = new DocsAPI.DocEditor("placeholder", {
],
"user": {
"id": "78e1e841",
- "name": "John Smith"
+ "name": "Иван Петров"
}
},
...
});
-Where the example.com is the name of the the server where document manager and document storage service are installed. See the ">How it works section to find out more on Document Server service client-server interactions.
+Где example.com - имя сервера, на котором установлены менеджер документов и сервис хранения документов. Смотрите раздел ">Как это работает, чтобы узнать больше о клиент-серверных взаимодействиях Сервера документов.
\ No newline at end of file
diff --git a/helpcenter.r7-office.ru/Web/Controls/Help/APIEditors/Config/Editor/Customization.ascx b/helpcenter.r7-office.ru/Web/Controls/Help/APIEditors/Config/Editor/Customization.ascx
index fa61b8a37..ed35d262c 100644
--- a/helpcenter.r7-office.ru/Web/Controls/Help/APIEditors/Config/Editor/Customization.ascx
+++ b/helpcenter.r7-office.ru/Web/Controls/Help/APIEditors/Config/Editor/Customization.ascx
@@ -169,6 +169,4 @@ var docEditor = new DocsAPI.DocEditor("placeholder", {
});
Где example.com - имя сервера, на котором установлены менеджер документов и сервис хранения документов. Смотрите раздел ">Как это работает, чтобы узнать больше о клиент-серверных взаимодействиях Сервера документов.
- -Если у вас есть дополнительные вопросы, пожалуйста, свяжитесь с нами по адресу integration@onlyoffice.com.
Где example.com - имя сервера, на котором расположены плагины, а также установлены менеджер документов и сервис хранения документов. Смотрите раздел ">Как это работает, чтобы узнать больше о клиент-серверных взаимодействиях Сервера документов.
-Если у вас есть дополнительные вопросы, пожалуйста, свяжитесь с нами по адресу integration@onlyoffice.com.
- \ No newline at end of file