LiferayのREST Connector to SharePointの有効化
DXPサブスクリプションが必要です。 SharePoint 2016およびSharePoint Onlineと互換性があります。
LiferayのREST Connector to SharePointを使用すると、ドキュメントとメディアをSharePointライブラリと統合できます。 これを使用すると、SharePointライブラリをマウントするためのドキュメントとメディアリポジトリを作成できます。 その後、SharePointドキュメントとフォルダの読み取り/書き込み、ドキュメントのチェックイン/チェックアウトの実行、ドキュメントのダウンロードなどを行うことができます。 一方のコンテキストで実行された各アクションは、もう一方のコンテキストにプロパゲートされます。
統合の制限
このアプリケーションはSharePointのAPIを使用し、次の制限があります。
- 最初にチェックアウトせずにファイルを移動または名前変更すると、バージョン履歴が失われます。
- ファイル拡張子を変更することはできません。変更できるのはファイル名のみです。
- ファイルの現在の名前は、以前のすべてのバージョンにプロパゲートされます。
- ファイルをチェックアウトするユーザーは、そのファイルの作業コピーのバージョン番号を確認できる唯一のユーザーです。
- サフィックスまたは中間ワイルドカードのクエリは、包含のクエリに変換されます。
- コメント、評価、およびSharePointフォルダをドキュメントとメディアのルートフォルダとして使用することはサポートされていません。
RESTコネクターの動作の詳細は、 javadocs API reference を参照してください。
REST コネクターのインストール
次の手順に従って、Liferay REST Connector to SharePointをインストールします。
-
Liferayマーケットプレイスから Liferay REST Connector to SharePoint をLPKGファイルとしてダウンロードします。
-
ファイルをインスタンスの
[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
-
サーバーを再起動してインストールを完了します。
コネクターが正常にデプロイおよびインストールされたら、SharePoint OAuth2設定エントリーを追加してセットアップを完了できます。 必要に応じて、カスタム検索ソースを定義して、SharePoint検索結果を制限および微調整することもできます。
RESTコネクターはOAuth2によるSharePointサーバー認証を行うAzure ACSを使用するため、サーバーでHTTPSサポートが有効になっていることを確認してください。
最新バージョンへの更新
以前は、Liferay REST Connector to SharePointはLiferay Connector for SharePointと呼ばれていました。 古いバージョンのアプリケーションがLiferayサーバーにインストールされている場合は、次の手順に従って最新バージョンをインストールしてください。
-
Liferayマーケットプレイスから Liferay REST Connector to SharePoint をLPKGファイルとしてダウンロードします。
-
Liferay DXPサーバーを停止します。
-
[LIFERAY_HOME]/osgi/marketplace
フォルダに移動し、古いLPKGファイルを新しいファイルに置き換えます。 -
Liferay DXPサーバーを再起動します。
サーバーの再起動が完了すると、アプリケーションを使用できるようになります。
Sharepoint OAuth2設定の追加
以下の手順に従って、Liferayコントロールパネルから新しいSharePoint OAuth2設定を追加します。
-
グローバルメニュー()を開き、 [コントロールパネル] タブをクリックして、 [System Settings] → [Documents & Media] → [SharePoint OAuth2] に移動します。
-
追加 をクリックして、新しいSharePoint OAuth2設定エントリーを作成します。
-
フォームに記入します(以下を参照)。
-
完了したら、 [保存] をクリックします。
Name :設定の名前
認証許可エンドポイント : 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検索設定の追加
SharePointを使用すると、カスタムソースIDを定義して、検索結果を制限および微調整できます。 デフォルトでは、コネクターはドキュメントのソースIDを使用します。
次の手順に従って、別のソースIDでSharePoint検索設定を作成します。
-
グローバルメニュー()を開き、 [コントロールパネル] タブをクリックして、 [System Settings] → [Documents & Media] → [Sharepoint Search] に移動します。
-
追加 をクリックして、新しいSharePoint検索設定エントリーを作成します。
-
新しいエントリーのカスタムSharepoint 検索結果の SourceIDを入力します。
-
完了したら、 [保存] をクリックします。