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

未対応

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

note

Mavenのビルドは、すべてのテストがパスした場合にのみ成功する。エラーが発生した場合は、talend-definition、talend-common、talend-runtime のサブフォルダでそれぞれ mvn clean install -DskipTests を実行してほしい。すべてのビルドが成功したら、modules/etl/talend フォルダに戻り、mvn clean install を実行する。

Talend Studioへのコンポーネントの登録

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

Talend Open Studioが開いている場合は閉じます。
生成された com.liferay.talend.definition-x.y.z-SNAPSHOT.jar バンドルを liferay-portal/modules/etl/talend/talend-definition/target フォルダから [TOS_ROOT]/plugins フォルダにコピーします。

[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

[TOS_ROOT]/configuration/ フォルダから org.eclipse* ファイルをすべて削除します。
com.liferay.talend, com.liferay.talend.common, and com.liferay.talend.runtime フォルダーをローカルの $USER_HOME/.m2/repository/com/liferay/ フォルダーから $TOS_ROOT/configuration/.m2/repository/com/liferay/ フォルダーにコピーします。
Talend Open Studioを起動します。 Liferay コンポーネントは Business → Liferay Palette タブの下に表示されます。

Liferay コンポーネントのアップデート

Liferayコンポーネントのコードベースに変更があった場合は、Talendコンポーネントのビルドから上記の手順を繰り返すことで、コンポーネントを最新バージョンにアップデートすることができます。

また、古いファイルやフォルダを削除して置き換える必要があります：

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

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