Продукты Р7
Корпоративный сервер 2024
Корпоративный сервер 2024
Сервер документов
Сервер документов
Редакторы документов
Редакторы документов
Корпоративный сервер 2019
Корпоративный сервер 2019
Графика
Графика
ВКС и мессенджер
ВКС и мессенджер
Мобильные редакторы
Мобильные редакторы
Почтовый сервер
Почтовый сервер
Органайзер
Органайзер
Сервер лицензирования
Сервер лицензирования
Файл-Экспресс
Файл-Экспресс
Аналитика
Аналитика
Дополнительно
Часто задаваемые вопросы
Разработчикам
Интеграции
Новые возможности

StartAction

Обновлено: 18.11.26

Инструкция актуальна для версий продукта: 2026.3.1.3296 – 2026.3.1.3906

Описание. Сообщает редактору, что плагин начал длительную операцию. В информационном режиме редактор показывает текст описания в строке состояния. В блокирующем режиме редактор запрещает ввод в документ, пока плагин не вызовет EndAction.

Редакторы: документы, таблицы, презентации.

Параметры

ПараметрТипОписание
typeстрока"Block" — блокирующий режим: пользователь не может вводить текст в документ. Любое другое значение, например «Information», — информационный режим: текст описания появляется в строке состояния, работа с документом не блокируется
descriptionстрокаТекст операции, например «Загрузка данных…»

Числа 0 и 1 в параметре type не работают как типы: с любым из них редактор включает информационный режим.

Возвращаемое значение

Метод ничего не возвращает.

Пример

window.Asc.plugin.executeMethod("StartAction", ["Block", "Загрузка данных..."]);

fetch("https://example.com/data.json")
    .then(function (response) { return response.json(); })
    .then(function (data) {
        // работа с данными
    })
    .finally(function () {
        window.Asc.plugin.executeMethod("EndAction", ["Block", "Загрузка данных..."]);
    });

Всегда вызывайте EndAction, в том числе при ошибке: иначе блокировка останется и пользователь не сможет работать с документом.

Важно

Пока действует блокировка "Block", редактор не выполняет код из callCommand: функция обратного вызова сработает, но документ не изменится и ошибки не будет. Сначала вызовите EndAction, а уже потом изменяйте документ. Пример — в статье «Пример плагина: индикатор долгой операции» ↗.

Используется в примерах

Была ли эта статья полезной?

Поделитесь пожалуйста своим мнением

      В статье есть ошибкиРекомендации не помоглиТекст трудно понятьСодержание статьи не соответствует заголовкуДругое