Часто задаваемые вопросы

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

1. выделить требуемый диапазон
2. в поле ввода формулы ввести формулу
3. одновременно нажать Shift Ctrl Enter

Нет, исходный макрос остается неизменным

Нет, не будет - так как в Linux и в веб VBA запустить нельзя, но их можно переписать на языке JavaScript

Нет, в случае если требуется новая установка портала взамен установленного лицензию можно перенести без запроса новой лицензии. Место хранение лицензии указано в инструкциях по установке.

В режиме дебага (уровень логирования)

• В логе /var/log/r7-office/documentserver/converter/out.log

Будет лог такого типа, при первом открытии за сутки:

nodeJS - output (data={"

где будет информация userID, docID и ссылка на файл.

• В логе /var/log/r7-office/documentserver/docservice/out.log

Будет лог такого типа, при открытии документа:

[userId] nodeJS - checkJwt success: decoded = {"type"

Где будет информация из токена JWT, например, владелец документа, каталог, дата создания и загрузки, имя файла и ссылка на него.

По userID возможно в обоих логах получить информацию о действиях пользователя.

Данное описание может отличаться от Вашей реализации, т.к. jwt и другие параметры могут при интеграции различаться. Описание было взято при проверка КС24 + Сервер документов.

В случае если работа сервера подразумевается в инфраструктуре с использованием серого ip-адреса потребуется выполнить следующую настройку.

Добавьте в файле /etc/r7-office/documentserver/local.json конфигурацию следующую настройку

"services": {
    "CoAuthoring": {
        "request-filtering-agent" : {
            "allowPrivateIPAddress": true,
            "allowMetaIPAddress": true
        }
    }
}

После выполните перезапуск служб сервера документов командой:

systemctl restart ds-*

Так же в логировании по адресу /var/log/r7-office/documentserver/converter/out.log будет выдаваться сообщение с ошибкой "Because, It is private IP address".

Для создания ссылки на ячейку из другой таблицы потребуется выполнить следующие действия:

1. Открыть две таблицы для установки связи ячеек

2. Скопировать ячейку с помощью контекстного меню - Копировать (комбинация горячих клавиш не поддерживается):

3. Закрыть вкладку с открытой таблицей, откуда копировалась ячейка;

4. Перейти в необходимую таблицу и вставить с помощью комбинации клавиш Ctrl+V данные:

После вставки появится уведомление:

Информация об указанных связях будет доступна в разделе Данные - Внешние ссылки:

Демонстрация работы добавления ссылки на ячейки из таблиц

При появлении сообщения "Файл размером более 100 Мб нельзя редактировать"

Данные рекомендации помогут изменить конфигурационные файлы и открывать файлы большего объема. После внесения изменений нагрузка на сервер документов возрастёт.
Для определения необходимого размера потребуется открыть файл архиватором (к примеру, 7zip) и распаковать содержимое файла в любой каталог. После распаковки в свойствах каталога проверьте размер этого каталога (в таком виде распаковывается файл на сервере для редактирования).
Для возможности открыть файл на редактирование применяется значение описанные далее в статье.
Измените параметры в файле /etc/r7-office/documentserver/default.json или в C:\Program Files (x86)\R7-OFFICE\DocumentServer\config\default.json:

"converter": {
"maxDownloadBytes": 1048576000,
...
"inputLimits": [
                                {
                                "type": "docx;dotx;docm;dotm",
                                "zip": {
                                        "uncompressed": "1000MB",
                                        "template": "*.xml" 
                                }
                                },
                                {
                                "type": "xlsx;xltx;xlsm;xltm",
                                "zip": {
                                        "uncompressed": "1000MB",
                                        "template": "*.xml" 
                                }
                                },
                                {
                                "type": "pptx;ppsx;potx;pptm;ppsm;potm",
                                "zip": {
                                        "uncompressed": "1000MB",
                                        "template": "*.xml" 
                                }
                                }
                        ]

В случае использования версии сервера документов ниже версии 7.2 потребуется правка конфигурации для production-linux.json (расположен в той же директории DocumentServer\config\). Для проверки версии используйте команды в зависимости от используемой ОС:

rpm -qa | grep r7-office
apt list | grep r7-office
или
ControlPanel-Programs and componets для Windows

Добавьте в конфиг web.appsettings.config находящийся по пути /var/www/r7-office/WebStudio/web.appsettings.config или C:\Program Files (x86)\R7-OFFICE\CommunityServer\WebStudio\web.appsettings.config ключ до закрытия части конфигурации:

<add key="web.available-file-size" value="1048576000" />

Пример в конфигурации:

<add key="web.removed-profile-name" value="Профиль удален" />
<add key="web.tfaapp.backup.title" value="r7-office" />
<add key="web.available-file-size" value="1048576000" />
</appSettings>

В value указывается значение в байтах 1048576000 - (1000 МБ)

Данный параметр установит ограничение в 1000Мб после распаковки файла на сервере. Для определения размера файла после распаковки Вы можете открыть файл архиватором (к примеру, 7-zip) и распаковать, в таком случае возможно узнать действительный размер файла при конвертации.
После установки параметра выполните команды:

supervisorctl restart all
systemctl restart monoserve r7-office*

Или перезапустить сервер и в случае с Windows.
Перед перезагрузкой сервера выполните скрипт bash /usr/bin/documentserver-prepare4shutdown.sh или C:\Program Files (x86)\R7-OFFICE\DocumentServer\bin\documentserver-prepare4shutdown.ps1 Скрипт сохранит все открытые файлы на редактирование и принудительно сохранит в хранилище.

Для корректного открытия файла потребуется повторная загрузка файла на портал для корректного сохранения параметров применяемых в конфигурационном файле или потребуется дождаться сброса кеша сервера документов. Сброс кеша производится раз в сутки по каждому файлу.

Для включения расширенного логирования/отладки необходимо скорректировать файл конфигурации

/etc/r7-office/documentserver/log4js/production.json

Измените уровень логирования:

"default": { "appenders": [ "default" ], "level": "WARN" }

Измените значение с WARN на DEBUG.

Для применения изменений необходимо перезапустить сервисы:

supervisorctl restart all

Перед перезапуском сервисов рекомендуем выполнить скрипт documentserver-prepare4shutdown.sh.
Скрипт завершает все сессии редактирования документов, собирает их версии и отправляет запросы для сохранения документов в хранилище, что позволит избежать потери информации.

bash /usr/bin/documentserver-prepare4shutdown.sh

Ошибки в процессе редактирования документов записываются в лог:

/var/log/r7-office/documentserver/docservice/out.log

Ошибки загрузки документов из Вашего хранилища, их конвертации и отправки запросов в хранилище на сохранение, после сборки отредактированного файла, записываются в лог:

/var/log/r7-office/documentserver/converter/out.log

Иногда вам может потребоваться добавить дополнительные шрифты, чтобы улучшить работу с редакторами. Это довольно легко.

Основные инструкции

По умолчанию используются встроенные бесплатные шрифты (только шрифты TrueType в формате .ttf) операционной системы, на которой установлен Р7-офис. Если вы хотите использовать дополнительные шрифты, можно сделать следующее:

1. Установите шрифт, скопировав его в папку /usr/share/fonts/ (на компьютере, где установлен Р7-офис).
2. Откройте папку /usr/bin.
3. Запустите файл documentserver-generate-allfonts.sh.
4. Очистите кэш браузера и переоткройте страницу.

Полезные подсказки

В Р7-офис всегда есть определенный набор шрифтов. После установки Р7-офис выполняется проверка наличия в системе следующих файлов шрифтов: arial.ttf, calibri.ttf, cour.ttf, symbol.ttf, times.ttf, wingding.ttf.

При первом открытии документа выполняется проверка того, какие шрифты есть в документе, и их загрузка с компьютера, на котором установлен Р7-офис. Если в документе содержатся шрифты, которых нет на компьютере с Р7-офис, будет загружен ближайший аналог шрифта (структура и отображение документа могут пострадать от такой подстановки шрифтов).

Если вы хотите ограничить количество шрифтов, загружаемых из системы, можно сделать следующее:

• удалить шрифты из системы и запустить файл /usr/bin/documentserver-generate-allfonts.sh, затем очистить кэш браузера и переоткрыть страницу (это может испортить структуру и отображение исходных документов);
• ограничить количество шрифтов, используемых в документах (используя только самые распространенные шрифты: Times New Roman, Verdana, Tahoma и т.д.);
• использовать сжатие (динамическое и статическое).

Задержка сохранения изменений

После завершения редактирования документа служба редактирования документов информирует об этом службу хранения документов. Время до этого рассчитывается с использованием времени конвертации редактируемого файла в формат Office Open XML (которое зависит от размера файла, сложности документа, мощности сервера и может выполняться довольно долго) и установленной задержки начала конвертации (которое по умолчанию равно 5 секундам). В большинстве распространенных случаев время составляет около 10 секунд после завершения редактирования.

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

Для Linux:/etc/r7-office/documentserver/default.json.

Для Windows: %ProgramFiles%\R7OFFICE\DocumentServer\config\default.json.

Если вы хотите изменить его, вы можете использовать файл local.json, где должны храниться все отредактированные параметры. Этот файл находится в той же директории, что и файл default.json, и вся структура объекта для необходимого параметра должна быть сохранена (см. примеры ниже).

Пожалуйста, не редактируйте содержимое файла default.json напрямую. Значения по умолчанию будут восстанавливаться каждый раз, когда вы перезапускаете контейнер Docker или обновляете Сервер документов до новой версии, и все ваши изменения будут потеряны.

Параметры

Пример конфигурационного файла local.json

{

"services": {

"CoAuthoring": {

"server": {

"savetimeoutdelay": 5000

}

}

}

}