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

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

REST 要素または REST オペレーションをクリックして、Properties ビューでそのプロパティーを表示します。

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

Fuse プロジェクトを右クリックし、New → Camel Rest DSL from WSDL の順に選択します。

Select Incoming WSDL and Project for Generated Output ページが表示されます。Destination Project フィールドに、Project Explorer で選択した Fuse プロジェクトが自動的に事前に反映されます。このプロジェクトは、ウィザードが生成するアーティファクトの宛先です。

Next をクリックします。Specify Advanced Options for WSDL-to-REST Processing ページが表示されます。

Finish をクリックして、出力として 2 つのファイルを作成します。

必要に応じて、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 Runtimeselected) および 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 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"
}