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

  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,
        ...
    },
    ...
});
Точно так же формируется ссылка при упоминании пользователей в комментариях.