Enabling Liferay's REST Connector to SharePoint
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、 こちら までご連絡ください。

Azure Access Control Service を介した SharePoint の構成 (従来方式)

DXPサブスクリプションが必要です。 SharePoint 2016およびSharePoint Onlineと互換性があります。

LiferayのSharePoint用RESTコネクタは、ドキュメントとメディアをSharePointライブラリと統合します。 SharePointライブラリをマウントしたり、ドキュメントやフォルダーを管理したり、ファイルのチェックインとチェックアウトを行ったり、コンテンツをダウンロードしたりするためのリポジトリを作成できます。 一方のシステムの変化は、もう一方のシステムにも伝播する。

Liferay 2026 より前のバージョンでは、以下の手順に従って Liferay の SharePoint 用 REST コネクタを有効にする必要があります。

統合の制限

このアプリケーションはSharePointのAPIを使用しており、いくつかの制限事項があります。

  • ファイルをチェックアウトせずに移動または名前変更すると、バージョン履歴が削除されます。
  • ファイル拡張子を変更することはできません。変更できるのはファイル名のみです。
  • ファイル名は、以前のすべてのバージョンにわたって更新されます。
  • ファイルをチェックアウトしたユーザーのみが、そのファイルの作業コピーのバージョン番号を確認できます。
  • 接尾辞または中間ワイルドカードを使用したクエリは、包含クエリとして機能します。
  • コメント、評価、およびSharePointフォルダをドキュメントとメディアのルートフォルダとして使用することはサポートされていません。

RESTコネクタの動作の詳細については、 javadocs APIリファレンスを参照してください。

以前のインストールを確認する

SharePoint RESTコネクタをインストールする前に、競合を避けるため、既にLiferayバンドルに含まれているかどうかを確認してください。 App ManagerまたはGogo Shellで確認できます。

警告

既存のコネクタの上に新しいコネクタを再デプロイすると、 ClassCastException エラーなどの競合が発生する可能性があります。

アプリマネージャーを使用する

  1. グローバルメニュー (Global Menu) を開き、 コントロール パネルアプリケーション マネージャー のシステム の下に移動します。

  2. 検索バーに「 sharepoint」と入力します。

  3. Liferay SharePoint RESTリポジトリが「アクティブ」ステータスで表示されている場合、コネクタは既にインストールされているため、インストール手順はスキップできます。

    アプリマネージャーにインストールされているSharePointモジュールが表示されます。

Gogo Shellを使用する

  1. グローバルメニュー (Global Menu) を開き、 コントロールパネルGogo Shell のシステムに移動します。

  2. コマンドに lb | grep Sharepoint と入力します。

    これは、SharePoint に関連するインストール済みのすべての OSGi バンドルを表示します。

  3. テキスト認証を完了し、 をクリックして を実行します。

    Liferay SharePoint RESTリポジトリモジュールのステータスが「アクティブ」になっている場合は、コネクタは既にインストールされているため、インストール手順をスキップできます。

    Gogo ShellでアクティブなSharePointバンドルを表示しています。

REST コネクターのインストール

  1. Liferay Marketplace から LPKG ファイルとして Liferay REST Connector to SharePoint をダウンロードしてください。

  2. そのファイルをインスタンスの [LIFERAY_HOME]/deploy フォルダにコピーしてデプロイしてください

    コンソールログに以下のメッセージが表示されます。

    Processing Liferay REST Connector to SharePoint.lpkg
    The portal instance needs to be restarted to complete the installation of file:/opt/liferay/osgi/marketplace/Liferay%20REST%20Connector%20to%20SharePoint%20-%20API.lpkg
    
  3. サーバーを再起動してインストールを完了します。

インストール後、SharePoint OAuth2を設定してセットアップを完了してください。 SharePoint の検索結果を絞り込むために、 個のカスタム検索ソース を定義することもできます。

重要

RESTコネクタは、SharePointサーバーの認証にAzure ACSとOAuth2を使用します。 サーバーでHTTPSが有効になっていることを確認してください。

最新バージョンへの更新

以前は、Liferay REST Connector to SharePointはLiferay Connector for SharePointと呼ばれていました。 古いバージョンのアプリケーションがインストールされている場合は、以下の手順に従って最新バージョンにアップデートしてください。

  1. Liferay Marketplace から LPKG ファイルとして Liferay REST Connector to SharePoint をダウンロードしてください。

  2. Liferay DXPサーバーを停止します。

  3. [LIFERAY_HOME]/osgi/marketplace フォルダーに移動し、古い LPKG ファイルを新しいファイルに置き換えます。

  4. Liferay DXPサーバーを再起動します。

サーバーが再起動すると、アプリケーションは使用可能になります。

Sharepoint OAuth2設定の追加

  1. グローバルメニュー (Global Menu) を開き、 コントロール パネル タブをクリックし、 システム設定ドキュメント & メディアSharePoint OAuth 2 に移動します。

    コントロール パネルのシステム設定 > ドキュメント & メディア > SharePoint OAuth 2 に移動します。

  2. 追加をクリックして、新しいSharePoint OAuth2設定エントリーを作成します。

  3. フォームに記入します(以下を参照)。

  4. 完了したら、 をクリックして保存 をクリックしてください。

名前: 設定の名前

認証グラントエンドポイント: OAuth2 認証グラントを要求するために使用される URL (例: https://[your-site-name].sharepoint.com/_layouts/oauthauthorize.aspx SharePoint Online の場合)

認証トークンエンドポイント:ACSのURL(例:SharePoint Onlineの場合はhttps://accounts.accesscontrol.windows.net/[App ID]/tokens/OAuth/2

クライアントID: クライアントID

クライアントシークレット: クライアントシークレット

スコープ:トークンに必要な権限セット。有効なスコープは、RESTコネクターの登録中に構成されます。

テナントID: テナントID

サイトドメイン: アプリケーションに登録されているサイトドメイン

リソース:この値は、使用するACSサービスに依存します(例:SharePoint Onlineの場合は00000003-0000-0ff1-ce00-000000000000/[your-site-name].sharepoint.com@[tenant ID]

保存すると、SharePoint設定を使用して、SharePointライブラリにマウントされるドキュメントとメディアにリポジトリを作成できます。

Sharepoint検索設定の追加

この設定は Liferay DXP 2023.Q4/Portal GA102 で削除され、新しいバージョンには適用されません。

SharePointを使用すると、カスタムソースIDを定義して、検索結果を制限および微調整できます。 デフォルトでは、コネクターはドキュメントのソースIDを使用します。

別のソース ID を使用して SharePoint 検索構成を作成するには、

  1. グローバルメニュー (Global Menu) を開き、 コントロール パネル タブをクリックし、 システム設定ドキュメント & メディアSharePoint 検索 に移動します。

    コントロール パネルのシステム設定 > ドキュメント & メディア > SharePoint OAuth 2 に移動します。

  2. 追加をクリックして、新しいSharePoint検索設定エントリーを作成します。

    追加をクリックして、新しいSharePoint検索設定エントリーを作成します。

  3. 新しいエントリーのカスタムSharepoint 検索結果の SourceIDを入力します。

  4. 完了したら、 をクリックして保存 をクリックしてください。