Действующая ссылка

Рисунок и приведенные ниже шаги объясняют процесс работы со ссылками в Р7 Сервер документов:

1. Пользователь отправляет запрос на получение ссылки на документ, содержащий закладку в редакторе документов.;
2. Редактор документов отправляет запрос менеджеру документов, где интеграторы программного обеспечения создают ссылку;
3. Менеджер документов отправляет ссылку обратно в редактор документов, где она отображается.

Как это можно сделать на практике

1. Создайте html-файл, чтобы открыть документ.
2. Укажите обработчик события, при котором кнопка Получить ссылку будет отображаться в меню редактирования закладок в сценарии конфигурации для инициализации Редактора документов. При вызове события onMakeActionLink пользовательский запрос отправляется интеграторам программного обеспечения, которые создают ссылку в службе хранения документов:
   

   

   var onMakeActionLink = function (event){
       var ACTION_DATA = event.data;
       ...
       var link = GENERATE_LINK(ACTION_DATA);
       docEditor.setActionLink(link);
   };
   
   var docEditor = new DocsAPI.DocEditor("placeholder", {
       "events": {
           "onMakeActionLink": onMakeActionLink,
           ...
       },
       ...
   });
   

3. Чтобы отправить пользователю ссылку на документ, содержащий закладку, программные интеграторы отправляют ссылку в метод setActionLink:

   docEditor.setActionLink(link);
   

   Параметр	Описание	Тип	Наличие
   link	Определяет ссылку, которая позволяет прокрутить до позиции закладки в документе.	строковый	обязательно

Открытие закладки

1. Пользователь переходит по ссылке в менеджер документов.;
2. Менеджер документов отправляет файл editorConfig инициализации редактору документов..
3. Редактор документов прокручивает документ до закладки.
   Когда пользователь переходит по ссылке, редактор документов отправляет файл editorConfig инициализации в службу редактирования документов. ACTION_DATA, полученные от события onMakeActionLink, указываются в параметре data.actionLink в editorConfig:

var docEditor = new DocsAPI.DocEditor("placeholder", {
    "editorConfig": {
        "actionLink": ACTION_DATA,
        ...
    },
    ...
});