Инструкция по установке: плагин «Поиск в выделенном диапазоне»

1. Общие сведения

Инструкция устанавливает порядок установки плагина «Поиск в выделенном диапазоне» версии 1.0.2 в «P7-Офис. Табличный редактор». Плагин является фоновым системным компонентом и не создает собственного окна или кнопки.

2. Установка в настольный Р7-Офис

2.1. Установка через управление плагинами

1. Сохранить открытые документы и закрыть все окна Р7-Офис;
2. Запустить Р7-Офис и открыть раздел управления плагинами;
3. Выбрать команду ручной установки плагина;
4. Указать файл r7-range-search_v1.0.2.plugin и подтвердить установку;
5. После завершения установки закрыть и повторно запустить Р7-Офис;
6. Открыть табличный документ и выполнить проверку по разделу 4 настоящей инструкции.

Отсутствие отдельной карточки, кнопки или окна плагина после установки является штатным поведением: компонент запускается автоматически и использует стандартную панель «Поиск и замена».

2.2. Административная установка в профиль

Способ применяется, если ручная установка через интерфейс недоступна.

1. Сохранить открытые документы и закрыть все процессы Р7-Офис;
2. Создать каталог %LOCALAPPDATA%\R7-Office\Editors\data\sdkjs-plugins\{E7A1C8D4-6B2F-4F75-9D13-8C5E20A4B917};
3. Извлечь содержимое файла r7-range-search_v1.0.2.plugin в созданный каталог, не создавая дополнительного уровня вложенности;
4. Проверить наличие файлов config.json, index.html и scripts\code.js непосредственно в каталоге плагина;
5. Запустить Р7-Офис и выполнить функциональную проверку.

2.3. Установка на локальный сервер документов

1. Скопировать поставочный файл в служебный каталог контейнера сервера документов;
2. Извлечь содержимое плагина в каталог /var/www/r7-office/documentserver/sdkjs-plugins/r7-range-search;
3. Запустить installer/register_plugin.py для регистрации системного плагина;
4. Перезапустить службу ds:docservice;
5. Открыть тестовый табличный документ и выполнить функциональную проверку.

3. Проверка контрольной суммы

1. Вычислить MD5 поставочного файла перед установкой;
2. Сравнить результат со значением в паспорте контрольной суммы;
3. Продолжить установку только при полном совпадении значений.

4. Проверка установки

1. Открыть табличный документ P7-Офис;
2. Выделить непрерывный диапазон из нескольких ячеек;
3. Нажать штатную кнопку поиска и раскрыть параметры поиска, если они свернуты;
4. Убедиться, что поле «Искать» установлено в значение «В указанном диапазоне» и содержит адрес выделения;
5. Выбрать одну ячейку, повторно открыть поиск и убедиться в возврате области на «На листе».

5. Удаление и откат

1. Сохранить открытые документы и закрыть все процессы Р7-Офис;
2. При установке через управление плагинами использовать предусмотренную команду удаления;
3. При административной установке удалить каталог {E7A1C8D4-6B2F-4F75-9D13-8C5E20A4B917} либо заменить его содержимое файлами ранее принятой версии;
4. Для серверной установки восстановить предыдущую версию каталога плагина и перезапустить ds:docservice;
5. После отката повторить проверку установленной версии.

6. Возможные ошибки и способы устранения

Таблица «Диагностика установки и работы».