SharePointへのLiferayのRESTコネクタの有効化

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

Liferay の SharePoint への REST コネクタは、ドキュメントとメディアを SharePoint ライブラリと統合します。 リポジトリを作成して、SharePoint ライブラリのマウント、ドキュメントとフォルダーの管理、ファイルのチェックインとチェックアウト、コンテンツのダウンロードなどを実行します。 一方のシステムの変更は他方のシステムに伝播します。

統合の制限

このアプリケーションは SharePoint の API を使用するため、いくつかの制限があります。

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

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

以前のインストールの確認

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

警告

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

アプリマネージャーの使用

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

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

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

   

Gogo Shellの使用

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

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

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

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

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

   

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

1. Liferay Marketplace から、 Liferay REST Connector to SharePoint を LPKG ファイルとしてダウンロードします。

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 サーバーの認証に OAuth2 を備えた Azure ACS を使用します。 サーバーで HTTPS サポートが有効になっていることを確認してください。

最新バージョンへの更新

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

1. Liferay Marketplace から、 Liferay REST Connector to SharePoint を LPKG ファイルとしてダウンロードします。

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

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

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

サーバーが再起動すると、アプリケーションが使用できるようになります。

Sharepoint OAuth2設定の追加

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

   

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

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

4. 完了したら、 「保存」 をクリックします。

名前: 設定の名前

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

認証トークンエンドポイント：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. グローバル メニュー () を開き、 コントロール パネル タブをクリックして、 システム設定 → ドキュメント & メディア → SharePoint 検索の順に移動します。

   

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

   

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

4. 完了したら、 「保存」 をクリックします。

関連トピック

• アプリのインストール
• ドキュメントとメディアでのSharePointリポジトリの作成