メインコンテンツまでスキップ

Alfresco Content App

ONLYOFFICE と Alfresco Content App の統合について​

ONLYOFFICE は、ドキュメントの編集とコラボレーションを Alfresco Content App（ACA）に直接もたらす公式統合を提供しています。ACA は Alfresco Content Services 向けの Angular ベースのモダンなインターフェースです。統合パッケージは npm レジストリまたは ONLYOFFICE の GitHub ページからダウンロードできます。

注記

この統合は Alfresco Content App 専用です。Alfresco Share をご利用の場合は、代わりに Alfresco Share 用 ONLYOFFICE コネクタの記事を参照してください。

主な機能​

  • テキスト文書、スプレッドシート、プレゼンテーションの作成、編集、表示。
  • 入力可能な PDF フォームの作成と入力。
  • ドキュメントのリアルタイム共同編集：2 つの共同編集モード（高速と厳密）、変更履歴モード、コメント、組み込みチャット。
  • エディタのインターフェースから直接ドキュメントのバージョン履歴を追跡。
  • OOXML 形式へのファイル変換と、さまざまな形式へのエクスポート。
  • 編集インターフェース内でのドキュメント権限の管理。
  • 高度なエディタ操作：Alfresco からの画像の挿入、差し込み印刷用ファイルの添付、比較するドキュメントの選択、プラグインの使用、外部リンクからのデータの挿入、現在のファイルのフォルダへの移動、エディタ内からの新規ドキュメントの作成。
  • JWT のサポートにより、適切な権限を持つユーザー以外はドキュメントにアクセスできないようトラフィックを保護します。

サポートされる形式​

  • 編集：DOCX、XLSX、PPTX
  • 表示：DOCX、XLSX、PPTX、PDF、その他の Office 形式
  • 作成：DOCX、XLSX、PPTX、PDF フォーム
  • 変換：Office 形式から OOXML へ
  • エクスポート：バックエンドの構成に応じたさまざまな形式
注記

編集、表示、変換、エクスポートに使用できる形式の正確な一覧は、インストールされているバージョンやバックエンドの構成によって異なる場合があります。

バージョン 1.0.0 の新機能​

Alfresco Content App 向け ONLYOFFICE 統合の最初のリリース。

完全な変更履歴はこちらでご覧いただけます。

ONLYOFFICE Docs を Alfresco Content App に接続する​

要件​

  • Alfresco Content Services — Alfresco リポジトリのバックエンド。

  • Alfresco Content App（ACA）— ホストとなる Angular アプリケーション。

  • ACA とすべてのエンドクライアントの両方から名前解決および接続できる ONLYOFFICE Docs（サーバー版またはクラウド版）。

    ONLYOFFICE Docs のインストールの詳細については、公式のドキュメントページを参照してください。

  • Alfresco バージョン 8.3.0 以降用の ONLYOFFICE モジュールパッケージ。

  • Alfresco Content App 用 ONLYOFFICE 統合 v1.0.0 以降。

Alfresco Content App 用 ONLYOFFICE 統合をインストールする​

  1. 拡張機能パッケージをインストールします。

    npm install @onlyoffice/alfresco-extension

  2. ACA プロジェクトに拡張機能を登録します。

  3. アプリケーションを実行します。

    npm run start

インストールと設定の詳細については、プロジェクトのドキュメントを参照してください。

ONLYOFFICE と Alfresco Content App の統合で JWT を有効にする​

不正アクセスからドキュメントを保護するために、ONLYOFFICE エディタは JSON Web Token（JWT）を使用します。トークンは、ドキュメントエディタの初期化時、および内部の ONLYOFFICE Docs サービス間でコマンドを交換する際に、構成に追加されます。シークレットキーは、JSON Web トークンの署名と、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 の場合 — docker exec -it <containerID> bash コマンドで ONLYOFFICE Docs コンテナに入り、/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. 3 つのセクションで true 値が指定されている場合、トークンの検証が有効になっています。

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

  3. 自動生成されたシークレットキーは 3 つのセクションで指定されています。デフォルトのシークレット値を独自の値に置き換えることができます。シークレットキーは 3 つのセクションすべてで同じである必要があります。

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

  4. 変更を行った場合は、保存してサービスを再起動し、構成の変更を反映させます。

    supervisorctl restart all

手順 2：統合の設定で同じシークレットキーを指定する

統合の設定のシークレットキーフィールドに同じシークレットを指定し、設定を保存します。

Alfresco Content App で ONLYOFFICE Docs を使い始める​

インストール後、新しい ONLYOFFICE の操作が Alfresco Content App のインターフェースで直接利用できるようになります。

ドキュメントを編集するには：

  1. ACA インターフェースでサポートされているファイルを右クリックします。
  2. ONLYOFFICE で編集を選択して、エディタでファイルを開きます。

ドキュメントを表示するには：

  1. ファイルを右クリックします。
  2. ONLYOFFICE で表示を選択すると、ファイルをダウンロードせずに読み取り専用のプレビューが開きます。

新しいファイルを作成するには：

  1. ACA インターフェースの ONLYOFFICE で作成オプションを使用します。
  2. 作成するファイルの種類を選択します：ドキュメント、スプレッドシート、プレゼンテーション、または PDF フォーム。
  3. 新しいファイルがすぐに編集用に開きます。

ファイルを OOXML 形式に変換するには：

  1. ACA でファイルを選択します。
  2. ONLYOFFICE で変換をクリックします。

ファイルを別の形式でエクスポートするには：

  1. ACA でファイルを選択します。
  2. 名前を付けてダウンロードを使用し、Alfresco Content App を離れることなく目的の形式を選択します。

フォームの詳細については、フォームの作成と入力に関する記事をお読みください。