Liferay Talendコンポーネントのインストール

サポート対象外

注

Liferay Talend Connector は、Liferay DXP 2024.Q4/Portal GA129 の時点で 非推奨 となっており、将来のリリースで削除される予定です。

Liferay の Talend Open Studio 用コンポーネントは、Liferay DXP/Portal と MySQL、SAP、Salesforce などの外部システム、さらにはファイルとの間でデータをインポートおよびエクスポートできます。 これらのコンポーネントを使用するには、Talend Open Studio に追加する必要があります。

前提条件

Liferay コンポーネントをインストールするには、JDK 1.8 以上、Apache Maven 3.3 以上、および DXP/Portal コードのローカル コピーが必要です。 また、 Talend Open Studio 7.1.1 と Components API v0.25.3 がすでにインストールされている必要があります。

Talend Open Studio の設定

Talend Open Studio をインストールした後、 [TOS_ROOT]/configuration/config.ini ファイルで maven.repository=globalが設定されていないことを確認します。 存在する場合は、その行を削除するか、コメントアウトします。

Maven では最近、安全でないリポジトリ接続が非推奨になったため、次のスクリプトを [TOS_ROOT]/configuration/maven_user_setting.xml ファイルに追加します。

<?xml version="1.0" encoding="UTF-8"?>
<settings>
  <localRepository>DO_NOT_CHANGE_THIS</localRepository>
  <mirrors>
    <mirror>
      <id>secure-central-mirror</id>
      <name>Secure Central Mirror Repository</name>
      <url>https://repo.maven.apache.org/maven2</url>
      <mirrorOf>central</mirrorOf>
    </mirror>
  </mirrors>
</settings>

リポジトリミラーの場所により、m2m プラグインがリポジトリに安全に接続できるようになります。

Talendコンポーネントの構築

Talend コンポーネントをインストールする前に、ローカル liferay-portal リポジトリの modules/etl/talend フォルダーで mvn clean install を実行する必要があります。

これにより、次のディレクトリ/フォルダーに jar バンドル ファイルが生成されます。

• talend-definition/target/
• talend-common/target/
• talend-runtime/target/

JAR ファイルは、次のローカル Maven リポジトリ フォルダーにも公開されます。

• $USER_HOME/.m2/repository/com/liferay/com.liferay.talend
• $USER_HOME/.m2/repository/com/liferay/com.liferay.common
• $USER_HOME/.m2/repository/com/liferay/com.liferay.talend.definition
• $USER_HOME/.m2/repository/com/liferay/com.liferay.talend.runtime

注

すべてのテストに合格した場合にのみ、Maven ビルドは成功します。 エラーが発生した場合は、 talend-definition、 talend-common、および talend-runtime サブフォルダーで個別に mvn clean install -DskipTests を実行してください。 すべてのビルドが成功したら、 modules/etl/talend フォルダーに戻り、 mvn clean installを実行します。

Talend Studioでコンポーネントを登録する

Maven ビルドが成功したら、次の手順に従って Liferay コンポーネントを Talend Open Studio に登録します。

1. Talend Open Studio が開いている場合は閉じます。

2. 生成された com.liferay.talend.definition-xyz-SNAPSHOT.jar バンドルを liferay-portal/modules/etl/talend/talend-definition/target フォルダーから [TOS_ROOT]/plugins フォルダーにコピーします。

3. 新しく追加された定義バンドルを含めるように、 [TOS_ROOT]/configuration/config.ini ファイル内の osgi.bundles キーを更新します。

   osgi.bundles=org.eclipse.equinox.common@2:start,org.eclipse.update.configurator@3:start,
   org.eclipse.equinox.ds@2:start,org.eclipse.core.runtime@start,org.talend.maven.resolver@start,
   org.ops4j.pax.url.mvn@start,org.talend.components.api.service.osgi@start,
   com.liferay.talend.definition-x.y.z-SNAPSHOT.jar@start
   

4. org.eclipse* ファイルを [TOS_ROOT]/configuration/ フォルダから削除します。

5. com.liferay.talend、 com.liferay.talend.common、および com.liferay.talend.runtime フォルダーをローカルの $USER_HOME/.m2/repository/com/liferay/ フォルダーから $TOS_ROOT/configuration/.m2/repository/com/liferay/ フォルダーにコピーします。

6. Talend Open Studio を起動します。 Liferay コンポーネントは、 パレット タブの Business → Liferay の下に表示されます。

   

Liferayコンポーネントの更新

Liferay コンポーネントのコードベースに変更がある場合は、Talend コンポーネントの構築から始めて上記の手順を繰り返すことで、コンポーネントを最新バージョンに更新できます。

古いファイルとフォルダも削除して置き換える必要があります。

• [TOS_ROOT]/plugins フォルダにある古い .jar 定義ファイルを削除します。
• com.liferay.talend、 com.liferay.talend.common、および com.liferay.talend.runtime フォルダーを [TOS_ROOT]/configuration/.m2/repository/com/liferay/に置き換えます。

コンポーネントの更新が完了したら、古いコンポーネントを使用していた既存の Talend ジョブを更新する必要があります。 これには、ジョブから Liferay コンポーネントを削除し、再度追加することが含まれます。

注

コンポーネントを交換する前に、各コンポーネントの構成を必ず文書化してください。 これにより、ジョブが以前と同じ機能を維持できるようになります。

関連トピック

• Liferay Talend コンポーネントの概要