Перейти к основному содержимому

Alfresco Content App

Об интеграции ONLYOFFICE и Alfresco Content App​

ONLYOFFICE предлагает официальную интеграцию, которая добавляет редактирование документов и совместную работу прямо в Alfresco Content App (ACA) — современный интерфейс Alfresco Content Services на основе Angular. Пакет интеграции можно скачать из реестра npm или со страницы ONLYOFFICE на GitHub.

Обратите внимание

Эта интеграция предназначена именно для Alfresco Content App. Если вы используете Alfresco Share, обратитесь к статье Коннектор ONLYOFFICE для Alfresco Share.

Основные возможности​

  • Создание, редактирование и просмотр текстовых документов, таблиц и презентаций.
  • Создание и заполнение заполняемых PDF-форм.
  • Совместное редактирование документов в реальном времени: два режима совместного редактирования (Быстрый и Строгий), режим Отслеживание изменений, комментарии и встроенный чат.
  • Отслеживание истории версий документа прямо в интерфейсе редактора.
  • Конвертация файлов в форматы OOXML и экспорт в различные форматы.
  • Управление правами доступа к документу в интерфейсе редактирования.
  • Расширенные действия в редакторе: вставка изображений из Alfresco, прикрепление файлов для слияния почты, выбор документов для сравнения, использование плагинов, вставка данных по внешним ссылкам, переход в папку текущего файла и создание новых документов прямо из редактора.
  • Поддержка JWT для защиты передаваемых данных: доступ к документам есть только у пользователей с соответствующими правами.

Поддерживаемые форматы​

  • Для редактирования: DOCX, XLSX, PPTX
  • Для просмотра: DOCX, XLSX, PPTX, PDF и другие офисные форматы
  • Для создания: DOCX, XLSX, PPTX, PDF-формы
  • Для конвертации: офисные форматы в OOXML
  • Для экспорта: различные форматы в зависимости от конфигурации серверной части
Обратите внимание

Точный список форматов, доступных для редактирования, просмотра, конвертации и экспорта, может отличаться в зависимости от установленной версии и конфигурации серверной части.

Что нового в версии 1.0.0​

Первый выпуск интеграции ONLYOFFICE для Alfresco Content App.

Полный список изменений доступен здесь.

Подключение ONLYOFFICE Docs к Alfresco Content App​

Требования​

Установка интеграции ONLYOFFICE для Alfresco Content App​

  1. Установите пакет расширения:

    npm install @onlyoffice/alfresco-extension

  2. Зарегистрируйте расширение в вашем проекте ACA.

  3. Запустите приложение:

    npm run start

Подробные инструкции по установке и настройке см. в документации проекта.

Включение JWT для интеграции ONLYOFFICE и Alfresco Content App​

Чтобы защитить документы от несанкционированного доступа, редакторы ONLYOFFICE используют JSON Web Token (JWT). Токен добавляется в конфигурацию при инициализации редактора документов и при обмене командами между внутренними службами ONLYOFFICE Docs. Секретный ключ используется для подписи JSON Web Token и проверки токена при запросе к ONLYOFFICE Docs.

Начиная с ONLYOFFICE Docs v7.2, JWT включен по умолчанию, а секретный ключ генерируется автоматически. Вам нужно найти секретный ключ в файле конфигурации ONLYOFFICE Docs, а затем указать тот же ключ в настройках интеграции.

Шаг 1: найдите секретный ключ в файле конфигурации ONLYOFFICE Docs

  1. Откройте файл local.json в любом текстовом редакторе.

    • Для Linux — /etc/onlyoffice/documentserver/local.json
    • Для Windows — %ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json
    • Для Docker — войдите в контейнер ONLYOFFICE Docs с помощью команды docker exec -it <containerID> bash и откройте /etc/onlyoffice/documentserver/local.json

    Файл local.json должен выглядеть так:

    {
      "services": {
        "CoAuthoring": {
          "token": {
            "enable": {
              "request": {
                "inbox": true,
                "outbox": true
              },
              "browser": true
            }
          },
          "secret": {
            "inbox": {
              "string": "yoursecret"
            },
            "outbox": {
              "string": "yoursecret"
            },
            "session": {
              "string": "yoursecret"
            }
          }
        }
      }
    }

  2. Значение true указано в трех разделах, что означает, что проверка токена включена:

    • services.CoAuthoring.token.enable.browser
    • services.CoAuthoring.token.enable.request.inbox
    • services.CoAuthoring.token.enable.request.outbox

  3. Автоматически сгенерированный секретный ключ указан в трех разделах. Вы можете заменить секретное значение по умолчанию на собственный ключ. Ключ должен быть одинаковым во всех трех разделах:

    • services.CoAuthoring.secret.inbox.string
    • services.CoAuthoring.secret.outbox.string
    • services.CoAuthoring.secret.session.string

  4. Если вы вносите изменения, сохраните их и перезапустите службы, чтобы изменения конфигурации вступили в силу:

    supervisorctl restart all

Шаг 2: укажите тот же секретный ключ в настройках интеграции

В настройках интеграции укажите тот же секретный ключ в поле Secret key и сохраните настройки.

Начало работы с ONLYOFFICE Docs в Alfresco Content App​

После установки новые действия ONLYOFFICE становятся доступны прямо в интерфейсе Alfresco Content App.

Чтобы изменить документ:

  1. Щелкните правой кнопкой мыши поддерживаемый файл в интерфейсе ACA.
  2. Выберите Edit in ONLYOFFICE, чтобы открыть файл в редакторе.

Чтобы просмотреть документ:

  1. Щелкните файл правой кнопкой мыши.
  2. Выберите View in ONLYOFFICE, чтобы открыть предварительный просмотр только для чтения без скачивания файла.

Чтобы создать новый файл:

  1. Используйте параметр Create in ONLYOFFICE в интерфейсе ACA.
  2. Выберите тип файла, который нужно создать: Document, Spreadsheet, Presentation или PDF Form.
  3. Новый файл сразу откроется для редактирования.

Чтобы конвертировать файл в формат OOXML:

  1. Выберите файл в ACA.
  2. Нажмите Convert in ONLYOFFICE.

Чтобы экспортировать файл в другой формат:

  1. Выберите файл в ACA.
  2. Используйте Download As и выберите нужный формат, не выходя из Alfresco Content App.

Подробнее о формах см. в соответствующих статьях о создании и заполнении форм.