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

IFrameクライアント拡張機能の使用

Liferay 7.4以降

IFrame クライアント拡張機能は、Liferay のフロントエンドインフラストラクチャを使用して、外部アプリケーションを <iframe> HTML 要素として登録します。それらはウィジェットとしてLiferayのページに追加されます。他のフロントエンドクライアント拡張機能とは異なり、IFrameは静的なリソースを提供しません。

サンプルワークスペースのクライアント拡張機能から始めましょう。

前提条件

クライアント拡張機能の開発を開始するには、

  1. サポートされているバージョンのJavaをインストールしてください。

    注記

    サポートされているJDK、データベース、および環境については、互換性マトリックスを確認してください。推奨されるJVM設定については、 「JVM構成」を参照してください。

  2. サンプルワークスペースをダウンロードして解凍してください。

    curl -o com.liferay.sample.workspace-latest.zip https://repository.liferay.com/nexus/service/local/artifact/maven/content\?r\=liferay-public-releases\&g\=com.liferay.workspace\&a\=com.liferay.sample.workspace\&\v\=LATEST\&p\=zip
    
    unzip com.liferay.sample.workspace-latest.zip
    

これで、IFrameクライアント拡張機能をデプロイするためのツールが揃いました。

IFrameクライアント拡張機能を読み込むためのURLを指定してください。

client-extensions/liferay-sample-iframe-1/client-extension.yamlファイルは、サンプルワークスペース内の IFrame クライアント拡張プロジェクトを定義します。

liferay-sample-iframe-1-counter-app:
    name: Counter App
    type: iframe
    url: https://arnab-datta.github.io/counter-app

このクライアント拡張機能のIDはliferay-sample-iframe-1で、IFrameクライアント拡張機能の主要な設定が含まれています。これには、IFrameとして取り込むアプリのname 、 type 、URLなどが含まれます。例のURLで実行されているカウンターアプリは、ショッピングカートに商品を追加することをシミュレートする基本的なReactアプリです。クライアント拡張機能をデプロイした後、他のウィジェットと同様に、Liferayのページにアプリを追加できます。

利用可能なプロパティの詳細については、 IFrame YAML設定リファレンスを参照してください。

IFrameクライアント拡張機能をデプロイする

注記

クライアント拡張機能を Liferay SaaS にデプロイするには、Liferay Cloudコマンドラインツールを使用してlcp deploy実行します。

Liferay の新しいインスタンスを起動するには、次のコマンドを実行します。

docker run -it -m 8g -p 8080:8080 liferay/portal:7.4.3.132-ga132

http://localhost:8080で Liferay にサインインしてください。メールアドレスはtest@liferay.com 、パスワードはtest を使用してください。プロンプトが表示されたら、パスワードをlearnに変更してください。

次に、サンプルワークスペース内のクライアント拡張機能のフォルダーに移動して、

../../gradlew clean deploy -Ddeploy.docker.container.id=$(docker ps -lq)

これによりクライアント拡張機能がビルドされ、zipファイルがLiferayの/deployフォルダにデプロイされます。

ヒント

ワークスペース内のすべてのクライアント拡張機能を同時にデプロイするには、 /client-extensionsフォルダーからコマンドを実行します。

Liferayインスタンスのコンソールでデプロイメントを確認します。

STARTED liferay-sample-iframe-1_1.0.0 [1592]

クライアント拡張機能がデプロイされたので、Liferayがそれを使用するように設定してください。

IFrameクライアント拡張機能をウィジェットとして追加する

iFrameはウィジェットとしてページに追加されます。

  1. どのページの上部にもある「編集」 (Edit)をクリックしてください。

  2. ウィジェットをページに追加します。コンポーネントサイドバー(Components)で、ウィジェットをクリックします。

  3. 「クライアント拡張機能」→「カウンターアプリ」ウィジェットを見つけて、ページにドラッグします。「公開」をクリックしてください。

    カウンターアプリをページにドラッグしてください。

カウンターアプリが正しく動作していることを確認するために、いくつかアイテムを追加してみてください。