Tooling ユーザーガイド

REST タブをクリックして、Rest DSL コンポーネントを表示します。

REST Configuration セクションには、次の設定オプションが表示されます。

REST 要素または REST 操作をクリックして、Properties ビューにそのプロパティーを表示します。

ルートエディターの Source タブをクリックして、コードを編集します。

必要に応じて、Window → Perspective → Open Perspective → Fuse Integration の順に選択して Fuse Integration パースペクティブに切り替えます。

Servers ビューで No servers are available. Click this link to create a new server… のリンクをクリックし、Define a New Server ウィザードを開きます。このリンクは、Servers ビューにサーバーエントリーが含まれない場合にのみ表示されます。

それ以外の場合は、Servers ビューを右クリックしてコンテキストメニューを開き、New → Server を選択して Define a New Server ウィザードを開きます。

Red Hat JBoss Middleware → Red Hat Container Development Kit 3.2+ を選択します。

次のデフォルト値を受け入れます。

クレデンシャルを次のように設定します。

OK をクリックして、Red Hat Container Development Environment ページに戻ります。このページにデータが入力されています。以下に例を示します。

Servers ビューで Container Development Environment 3 [stopped, Synchronized] を選択し、Servers メニューバーの をクリックします。

Console ビューが開き、起動プロセスのステータスが表示されます。

起動プロセスが終了すると、Servers ビューに次のように表示されます。

OpenShift Explorer ビューに切り替えます。

仮想 OpenShift サーバーインスタンス developer も実行されています。

https://192.168.99.100:8443 は、OpenShift 開発者 Web コンソールの URL の例です。インストールにより、インスタンスの URL が表示されます。詳細については 「OpenShift Web コンソールへのアクセス」 を参照してください。

新規プロジェクトのプロパティーを以下のように設定します。

Finish をクリックします。

新しい OpenShift プロジェクト (この例では New FIS Test newtest) は、OpenShift Explorer タブの、この例では developer https://192.168.99.100:8443 の下に表示されます。

OpenShift Explorer ビューで New FIS Test newtest を選択すると、Properties ビューにプロジェクトの詳細が表示されます。以下に例を示します。

Project Explorer ビューで右クリックしてコンテキストメニューを開き、New → Fuse Integration Project を選択してウィザードの Choose a project name ページを開きます。

Project Name フィールドに、使用しているワークスペースに固有の名前を入力します (例: myFISproject)。

他のオプションでデフォルト値を使用します。

Next をクリックして、Select a Target Runtime ページを開きます。

Target Runtime (No Runtime selected) および Camel Version はデフォルト値をそのまま使用します。

Next をクリックして Advanced Project Setup ページを開きます。

Simple log using Spring Boot - Spring DSL テンプレートを選択します。

Finish をクリックします。

サイドバーメニューで、Maven Build → Deploy <projectname> on OpenShift (この例では Deploy myFISproject on OpenShift) を選択し、プロジェクトのデフォルトラン設定を開きます。

Main タブのデフォルト設定をそのまま使用します。

JRE タブを開いて、VM 引数にアクセスします。

VM arguments ペインで、-Dkubernetes.namespace=test 引数の値を変更して、OpenShift プロジェクトの作成時に使用したプロジェクト名 (「新しい OpenShift プロジェクトの作成」の OpenShift のプロジェクト名) に一致させます。

この例では、デフォルト値の test を newtest に変更します。

OpenShift の設定によっては、それをサポートするために他の VM 引数を変更する必要がある場合があります。

Apply をクリックしてから、Run をクリックします。

ダウンロードする依存関係の数が多いため、初回の展開には時間がかかる場合があります。コンピューターの速度とインターネット接続が要因になっています。通常、初回の展開が完了するまでに 25〜35 分かかります。

Console ビューでは、デプロイプロセスの進行状況を追跡できます。以下の出力のエントリー Pushing image 172.30.1 … * は、プロジェクトが正常にビルドされ、アプリケーションイメージが OpenShift にプッシュされて Docker コンテナーのビルドに使用されることを示します。

デプロイメントが正常に完了すると、Console ビューに BUILD SUCCESS が表示されます。

OpenShift Explorer ビューに切り替えて、New FIS Test newtest を選択します。

Properties ビューの Details ページには、プロジェクトのプロパティー値がすべて表示されます。

他のタブ (Builds、Build Configs、Deployments …​) を開き、プロジェクトの他のプロパティーを表示します。Properties ビューには、OpenShift Web コンソールと同じ情報が表示されます。

OpenShift Explorer ビューで camel-ose-springboot-xml を選択し、Properties ビューでその詳細を表示します。

他のタブをスクロールして、デプロイメント設定の他のプロパティーを表示します。

OpenShift Explorer ビューで camel-ose-springboot-xml-1-mdmtd Pod Running を選択し、Properties ビューで実行中のインスタンスの詳細を表示します。

OpenShift Explorer ビューで camel-ose-springboot-xml-1-mdmtd Pod Running を右クリックし、続いてPod Logs…​ を選択します。

Console ビューが自動的に開き、実行中の Pod からのログが表示されます。

Console ビューのメニューバーの をクリックしてセッションを終了し、コンソールの出力をクリアします。

新規 Fuse Integration プロジェクトを作成します (File → New → Fuse Integration Project を選択します)。

ウィザードで次の情報を入力します。

<route id="_route1"/> を以下のコードに置き換えます。

<route id="_route1">
  <from id="_from1" uri="file:src/data?fileName=abc-order.xml&amp;noop=true"/>
  <setHeader headerName="approvalID" id="_setHeader1">
    <simple>AUTO_OK</simple>
  </setHeader>
  <to id="_to1" uri="file:target/messages?fileName=xyz-order.json"/>
</route>

Design タブをクリックして、ルートのグラフィカル表示に戻ります。

Data Transformation パターンをクリックし、キャンバスで SetHeader _setHeader1 と To_to1 ノード間の矢印をクリックします。

New Transformation ウィザードが開き、Dozer File Path フィールドが自動入力されます。

残りのフィールドに入力します。

Next をクリックします。

Source Type (XML) 定義ページが開き、XML Schema (デフォルト) または XML Instance Document の例を指定して、ソースデータのタイプ定義を指定します。

Source file での場合は、ソースデータの種類定義に使用する XML スキーマファイルまたは XML インスタンスファイルの場所を参照して、選択します (ここでは abc-order.xsd)。

XML Structure Preview ペインには、XML 構造のプレビューが表示されます。

Element root フィールドに ABCOrder を入力します。

ツールはこのテキストを使用して、マップするソースデータ項目を表示するペインにラベルを付けます。

Source Type (XML) 定義ページは以下のようになります。

Next をクリックして Target Type (JSON) 定義ページを開きます。ここで、ターゲットデータのタイプ定義を指定します。

JSON Instance Document をクリックします。

Target File フィールドに、xyz-order.json インスタンスドキュメントへのパスを入力します。または、このドキュメントを参照します。JSON Structure Preview ペインには、JSON データ構造のプレビューが表示されます。

Mappings パネルの左右にある Source パネルおよび Target パネルのすべての項目を展開します。

Source パネルからデータ項目をドラッグし、Target パネルの対応するデータ項目にドロップします。

たとえば、Source パネルから customerNum データ項目をドラッグし、Target パネルの custId データ項目にドロップします。

マッピングは Mappings パネルに表示され、Source と Target の両方のデータ項目の詳細が下の詳細ペインに表示されます。

すべての基本的なマッピングが完了するまで、ソースデータ項目を対応するターゲットデータ項目にドラッグアンドドロップします。

starter の例では、マッピングする残りのデータ項目は以下のようになります。

Source パネルと Target パネルの両方で をクリックし、すべてのデータ項目がマッピングされているかどうかを素早く判別します。

マッピングされていないデータ項目のみが Source および Target パネルに表示されます。

starter の例では、マッピングされていない残りの Target 属性は approvalCode および origin です。

blueprint.xml タブをクリックして、ルートのグラフィカル表示に戻ります。

New Transformation Test ウィザードで、以下の値を設定します。

以下のコードを transform メソッドに追加します。

startEndpoint.sendBodyAndHeader(readFile("src/data/abc-order.xml"), "approvalID", "AUTO_OK");

File → Save をクリックします。

これで、チュートリアルの任意の時点で、変換ファイルに対して JUnit テストを実行できます。

それを右クリックしてコンテキストメニューを開き、Run as JUnit Test を選択します。

JUnit Test ペインが開き、テストのステータスが表示されます。ワークスペースが乱雑になるのを防ぐには、Console ビューの近くにある下部パネルでペインをドラッグアンドドロップします。

Source パネルで Variables ビューをクリックします。

Variables ビューで をクリックし、Enter a new variable name ダイアログを開きます。

作成する変数の名前を入力します。

starter の例では、ORIGIN と入力します。

OK をクリックします。

新規作成された変数 ORIGIN は、Variables ビューの Name 列および Value 列のデフォルト値 ORIGIN に表示されます。

新しい変数 ORIGIN を Target パネルの origin データ項目にドラッグしてドロップします。

変数 $(ORIGIN) の新しいマッピングが Mappings パネルと、詳細ペインに表示されます。

TransformationTest.java ファイルで JUnit テストを実行します。詳細は、「変換テストファイルの作成と JUnit テストの実行」 を参照してください。

Console ビューには、JSON 形式の出力データが表示されます。

{"custId":"ACME-123","priority":"GOLD","orderId":"ORDER1","origin":"Web",
"approvalCode":"AUTO_OK","lineItems":[{"itemId":"PICKLE","amount":1000,"cost":2.25},
{"itemId":"BANANA","amount":400,"cost":1.25}]}

をクリックし、空の変換マッピングを Mappings パネルに追加します。

Target パネルから、approvalCode データ項目を Mappings パネルで新しく作成されたマッピングのターゲットフィールドにドラッグアンドドロップします。

詳細ペインのターゲットボックスにも、approvalCode データ項目が表示されます。

詳細ペインで、ABCOrder ソースボックスの をクリックして、ドロップダウンメニューを開きます。

メニューオプションは、選択したデータ項目のデータタイプによって異なります。利用可能なオプションは太字になっています。

Set expression を選択して、Expression ダイアログボックスを開きます。

Language で、利用可能な言語の一覧から使用する式言語を選択します。利用可能なオプションは、データ項目のデータタイプによって異なります。

starter の例では、Header を選択します。

詳細ペインで、使用する式のソースを選択します。

オプションは Value および Script です。

starter の例では、Value をクリックしてから ApprovalID を入力します。

OK をクリックします。

Mappings パネルと詳細ペインの両方に、ターゲットデータ項目 approvalCode の新しいマッピングが表示されます。

TransformationTest.java ファイルで JUnit テストを実行します。詳細は、「変換テストファイルの作成と JUnit テストの実行」 を参照してください。

Console ビューには、JSON 形式の出力データが表示されます。

{"custId":"ACME-123","priority":"GOLD","orderId":"ORDER1","origin":"Web",
"approvalCode":"AUTO_OK","lineItems":[{"itemId":"PICKLE","amount":1000,"cost":2.25},
{"itemId":"BANANA","amount":400,"cost":1.25}]}

Mappings パネルで customerNum マッピングを選択し、詳細ペインに反映させます。

詳細ペインで、ABCOrder ソースボックスの をクリックして、ドロップダウンメニューを開きます。

Add custom transformation を選択して、Add Custom Transformation ページを開きます。

Class フィールドの横にある をクリックして、Create a New Java Class ウィザードを開きます。

以下のフィールドを変更します。

Finish をクリックします。

Add Custom Transformation ページが開き、Class および Method フィールドが自動的に入力されます。

OK をクリックして Java エディターで MyCustomMapper.java ファイルを開きます。

brackets メソッドを編集して、最後の行 return null; を以下のように変更します。

return "[" + input + "]";

transformation.xml タブをクリックし、変換エディターに戻ります。

詳細ペインは、brackets メソッドが customerNum のデータ項目に関連付けられていることを示しています。

この brackets メソッドは、ターゲットシステムに送信される前にソース入力で実行されます。

TransformationTest.java ファイルで JUnit テストを実行します。詳細は、「変換テストファイルの作成と JUnit テストの実行」 を参照してください。

Console ビューには、JSON 形式の出力データが表示されます。

{"custId":"[ACME-123]","priority":"GOLD","orderId":"ORDER1","origin":"Web",
"approvalCode":"AUTO_OK","lineItems":[{"itemId":"PICKLE","amount":1000,"cost":2.25},
{"itemId":"BANANA","amount":400,"cost":1.25}]}

Mappings パネルでマッピング id - > itemId を選択し、詳細ペインにマッピングを表示します。

Source ボックスで をクリックし、ドロップダウンメニューを開き、Set property を選択します。

Select a property ページで header ノードを展開し、customerNum を選択します。OK をクリックして変更を保存します。

詳細ペインには、XyzOrder に lineItems フィールドがあることが表示されるようになりました。lineItems の横にあるトグルボタンをクリックして、その値を 1 に増やします。

詳細ペインには、lineItems コレクションの 2 番目の項目である itemId にマッピングされた customerNum が表示されます。

TransformationTest.java ファイルで JUnit テストを実行します。詳細は、「変換テストファイルの作成と JUnit テストの実行」 を参照してください。

Console ビューには、JSON 形式の出力データが表示されます。

{"custId":"[ACME-123]","priority":"GOLD","orderId":"ORDER1","origin":"Web",
"approvalCode":"AUTO_OK","lineItems":[{"amount":1000,"cost":2.25},
{"itemId":"ACME-123","amount":400,"cost":1.25}]}

Transformations パネルで status から priority へのマッピングを選択し、詳細ペインに反映させます。

Source ボックスで をクリックし、ドロップダウンメニューを開き、Add transformation を選択します。

Transformations ペインで append を選択し、Arguments ペイン で suffix の値に -level を入力します。

この append 関数は、status 文字列をターゲットの priority データ項目にマッピングする前に、指定された接尾辞を文字列の最後に追加します。

OK をクリックします。

デフォルトでは、詳細ペインには、append 関数を status データ項目に追加した結果がユーザーフレンドリーな形式で表示されます。このフォーマットを変更するには、Source ボックスの右端の をクリックし、Show standard format を選択します。

TransformationTest.java ファイルで JUnit テストを実行します。詳細は、「変換テストファイルの作成と JUnit テストの実行」 を参照してください。

Console ビューには、JSON 形式の出力データが表示されます。

{"custId":"[ACME-123]","priority":"GOLD-level","orderId":"ORDER1","origin":"Web",
"approvalCode":"AUTO_OK","lineItems":[{"amount":1000,"cost":2.25},{"itemId":"ACME-123",
"amount":400,"cost":1.25}]}

必要な camel- 関数ごとに、JBossFuse:admin@root> のプロンプトで以下を入力します。

features:install camel-<featureName>

ここで、featureName は、dozer、jackson、または jaxb のいずれかです。

各機能が正常にインストールされていることを確認するには、JBossFuse:admin@root> のプロンプトで以下のコマンドを入力します。

features:list --ordered --installed

出力一覧に先ほどインストールした camel 機能が表示されるはずです。

エクステンションのタイプに応じて、エクステンションのコードを記述します。

Project Explorer ビューでターゲットフォルダーを開き、生成された .jar ファイルを確認します。

.jar ファイルの名前は Maven のデフォルト ${artifactId}-${version}.jar に従います。

例: custom:step-camel-1.0.0.jar

この .jar ファイルは、エクステンション、必要な依存関係、そのメタデータ (Extension Id、Name、Version、Tags、および Description) を定義します。以下に例を示します。

{
    "schemaVersion" : "v1",
    "name" : "Example Fuse Online Extension",
    "description" : "Logs a message body with a prefix",
    "extensionId" : "fuse.online.extension.example",
    "version" : "1.0.0",
    "actions" : [ {
        "id" : "Log-body",
        "name" : "Log Body",
        "description" : "A simple xml Body Log with a prefix",
        "descriptor" : {
            "kind" : "ENDPOINT",
            "entrypoint" : "direct:log-xml",
            "resource" : "classpath:META-INF/syndesis/extensions/log-body-action.xml",
            "inputDataShape" : {
                "kind" : "any"
            },
            "outputDataShape" : {
                "kind" : "any"
            },
            "propertyDefinitionSteps" : [ {
                "description" : "Define your Log message",
                "name" : "Log Body",
                "properties" : {
                    "prefix" : {
                        "componentProperty" : false,
                        "deprecated" : false,
                        "description" : "The Log body prefix message",
                        "displayName" : "Log Prefix",
                        "javaType" : "String",
                        "kind" : "parameter",
                        "required" : false,
                        "secret" : false,
                        "type" : "string"
                    }
                }
            } ]
        },
        "tags" : [ "xml" ],
        "actionType" : "step"
    } ],
    "dependencies" : [ {
        "type" : "MAVEN",
        "id" : "io.syndesis.extension:extension-api:jar:1.3.0.fuse-000014"
    } ],
    "extensionType" : "Steps"
}