Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

Kaoto

Red Hat build of Apache Camel 4.10

Kaoto を使用した Apache Camel ベースのインテグレーションの作成と編集

概要

このガイドでは、Apache Camel インテグレーションの作成向けにカスタマイズされたビジュアルデザインツールである Kaoto の包括的な概要を説明します。開発ライフサイクルを迅速化する Kaoto のインストールプロセスと利用の両方を説明します。

第1章 Kaoto の概要
リンクのコピー

Kaoto は、Kamel Orchestration Tool の略語です。これは、Apache Camel に基づいてインテグレーションを作成および編集するための、ローコードおよびノーコードのインテグレーションデザイナーです。Kaoto は拡張可能で柔軟性があり、さまざまなユースケースに適応できます。

Kaoto は、グラフィカルデザインで使用するための豊富なビルディングブロックのカタログを提供します。デフォルトでは、Kaoto は公式のアップストリーム Camel Catalog および Kamelet Catalog をロードしますが、Red Hat がサポートするカタログも提供します。

Kaoto は、開発プロセスを合理化するために特別に設計された、Apache Camel インテグレーションのための直感的なビジュアルプラットフォームとして際立っています。ローコード/ノーコード機能により、経験が少ないインテグレーションエンジニアがアクセスしやすいエントリーポイントが提供され、インテグレーション開発の初期ステップが簡単になります。さらに、Kaoto はより洗練された機能へのシームレスな移行をサポートしており、熟練した Camel 開発者が複雑なインテグレーションルートを効果的に開発および調整できます。

このガイドの対象読者は Apache Camel 開発者です。このガイドでは、Apache Camel と組織の処理要件をよく理解していることを前提としています。

Kaoto を使用する利点は次のとおりです。

  • 強化されたビジュアル開発エクスペリエンス

    Kaoto のビジュアル設計機能を活用することで、ユーザーはユーザーインターフェイスを通じて Camel インテグレーションを直感的に作成、表示、編集できます。このローコード/ノーコードアプローチにより、新しいユーザーの学習曲線が大幅に短縮され、熟練した開発者の開発プロセスが加速されます。

  • 包括的なコンポーネントカタログのアクセシビリティー

    Kaoto は、Camel コンポーネント、Enterprise Integration Pattern (EIP)、Kamelet の豊富なカタログにすぐにアクセスできるようにします。この広範なカタログにより、開発者はインテグレーションソリューションに必要なコンポーネントを簡単に見つけて実装できます。これらのリソースをすぐに利用できるようにすることで、開発者はさまざまなコンポーネントの検索や学習に時間を費やすのではなく、ビジネス上の問題の解決に集中できるようになります。

  • 合理化されたインテグレーション開発プロセス

    このプラットフォームは、効率的なユーザーエクスペリエンスを念頭に置いて設計されており、包括的なインテグレーションを作成するために必要な手順が最適化されています。この効率は、自動補完、設定フォーム、インタラクティブなフィードバックメカニズムなどの機能によって実現されます。その結果、開発者はインテグレーションを迅速に組み立てて設定することができ、全体的な開発時間を短縮できます。この合理化されたプロセスにより、さまざまなアプローチのプロトタイプ作成とテストが容易になり、実験と革新が促進されます。

第2章 Kaoto のインストール
リンクのコピー

2.1. 前提条件
リンクのコピー

2.1.1. Microsoft Visual Studio Code
リンクのコピー

Kaoto は Microsoft Visual Studio Code のエクステンションとして同梱されています。マシンに VS Code をまだインストールしていない場合は、今すぐインストールしてください。

ダウンロードページ にアクセスし、最適なインストール手順に従ってください。

2.1.2. Camel CLI
リンクのコピー

最高のユーザーエクスペリエンスを提供するために、Camel 開発者にさまざまな機能を提供する Camel CLI をインストールすることを推奨します。

インストールするには、以下の手順に従ってください。

  1. 以下の 手順 に従って JBang をインストールします。

  2. コマンドシェルから以下を実行して、JBang が動作していることを確認します。これにより、インストールされている JBang のバージョンが出力されます。 

    jbang version
    Copy to Clipboard Toggle word wrap

  3. Camel CLI をインストールするには、コマンドシェルから次のコマンドを実行します。 

    jbang app install camel@apache/camel
    Copy to Clipboard Toggle word wrap

  4. コマンドシェルから以下を実行して、Camel CLI が動作しているか確認します。これにより、インストールされている Camel CLI のバージョンが出力されます。 

    camel version
    Copy to Clipboard Toggle word wrap

2.1.3. Citrus のテスト
リンクのコピー

Citrus テストフレームワークを使用する場合は、Citrus JBang プラグインをインストールすることを強く推奨します。

インストールするには、以下の手順に従ってください。

  1. 以下の 手順 に従って JBang をインストールします。

  2. コマンドシェルから以下を実行して、JBang が動作していることを確認します。これにより、インストールされている JBang のバージョンが出力されます。 

    jbang version
    Copy to Clipboard Toggle word wrap

  3. Citrus JBang プラグイン をインストールするには、コマンドシェルから次のコマンドを実行します。 

    jbang app install citrus@citrusframework/citrus
    Copy to Clipboard Toggle word wrap

  4. コマンドシェルから以下を実行して、Citrus JBang プラグイン が動作しているか確認します。これにより、インストールされている Citrus JBang プラグイン のバージョンが出力されます。 

    citrus --version
    Copy to Clipboard Toggle word wrap

2.2. Kaoto Extension
リンクのコピー

  1. VS Code を開きます。
  2. 左側のパネルで Extensions ビューを開きます（または、Ctrl キーと Shift + Xキーを押します）。
  3. 検索フィールドに Kaoto と入力します。

  4. Install ボタンをクリックします。

    Kaoto 拡張機能のインストール
  5. インストールが完了すると、左側のパネルに新しいアイコンが表示されます。

第3章 Kaoto を使い始める
リンクのコピー

このセクションでは、以下を行う方法を説明します。

  • VS Code でワークスペースを設定する
  • インテグレーションを作成するための重要なコマンドにアクセスする
  • 最初の Camel Route を作成する
  • Camel Route をローカルで実行する
  • Camel Route のソースコードにアクセスする

3.1. ワークスペースの準備
リンクのコピー

Visual Studio Code では、環境のすべての機能にアクセスするには、プロジェクト用のワークスペースを作成する必要があります。

  1. まだ開いていない場合は、Visual Studio Code インスタンスを開きます。これは、コンピューター上で適切なランチャーを見つけるか、コマンドシェルを開いて code を実行することで開くことができます。

  2. すると、以下のようなウィンドウが表示されます。（以下の図では、すでに Kaoto ビューを選択しています - Kaoto Camel アイコンを参照してください）。

    empty vscode (1)
  3. 次に、プロジェクトファイルを保存するワークスペースフォルダーを選択する必要があります。
  4. Open Folder ボタンをクリックするか、File メニューに移動して Open Folder のエントリーを選択することもできます。

  5. 次の画面で、使用するフォルダーを探して選択します。

    フォルダーを開く

3.2. 最初の Camel Route の作成
リンクのコピー

  1. 左側のサイドバーの Kaoto view (Kaoto Camel アイコン)を使用すると、上部に Integration セクションが表示されます。
  2. マウスを インテグレーション ヘッドラインの右側に移動すると、いくつかの小さなアイコンが表示されます。1 つはプラス記号のファイルです。
  3. これをクリックし、New Camel Route を選択し、指示に従って最初の Camel Route を作成します。

  4. 完了すると、新しいファイルが作成され、Kaoto エディターが次のビデオのように表示されます。エディターが表示されない場合は、前の手順で再度表示して、すべての手順が正しく従っていることを確認してください。

    インテグレーションの作成

  5. この時点で、最初に機能する Camel Route が正常に作成されました。これはすぐにテストできます。

    注記

    実行が失敗した場合は、Camel CLI が正しくインストールされているか再確認する必要があります。Camel CLI セクションに記載されている手順に従ってください。

  6. 以下のような画面が表示されるはずです。

    新しいルート(1)

3.2.1. Camel Route の起動
リンクのコピー

統合のテストが簡単かつ直接対応できます。

  1. Integrations セクションで、インテグレーションのファイル名にカーソルを合わせると、便利なボタンがいくつか表示されます。これらのボタンの 1 つは、緑色の再生ボタンを持つ Camel アイコンです。
  2. クリックして、Camel JBang を使用して統合をローカルで起動します。

  3. インテグレーションを起動し、実行中のインテグレーションと対話する方法や、可能なアクションについては、以下のビデオを確認してください。

    インテグレーションの起動
  4. ビデオでわかるように、インテグレーションは Dev Mode で起動され、Kaoto エディターを介してインテグレーションへの変更によって変更されるか、保存するたびにソースコードが再読み込みされます。これにより、プロトタイプがより速くなります。

3.2.2. ソースコードへのアクセス
リンクのコピー

新しい Camel Route のソースがどういうものか疑問に思うかもしれません。Kaoto は、ソースコードの使用に伴うユーザーの負担を軽減しようとしていますが、デフォルトの Visual Studio Code テキストエディター経由で引き続きソースコードにアクセスできるようにしています。

これを行うには、以下の 2 つの方法があります。

  1. 1 つ目は、Kaoto エディターの右上にある Open Source Code トグルボタンを使用することです。これが最も便利な方法です。

  2. 2 つ目は、インテグレーションのファイル名が含まれるタブのコンテキストメニューを起動し、アイテムのある Reopen Editor を使用し ます。両方の方法を次の動画で示します。

    show source

第4章 Visual Designer
リンクのコピー

次の図は、Kaoto Visual Editor のさまざまな部分を示しています。

UI の概要
  1. 開いているファイルが選択された Explorer View。
  2. 現在表示されているインテグレーション。
  3. 選択したステップの設定を調整およびカスタマイズできる設定パネル。
  4. 現在選択されている統合タイプを表示するドロップダウン (ここでは Camel ルート)。
  5. 現在選択されている Camel Route を表示するドロップダウン。これは、ファイル内に複数の Camel Route が定義されている場合に便利です。ここでは、各 Camel Route の可視性の名前を変更、削除、選択、および切り替えることができます。
  6. ドロップダウンを使用すると、インテグレーションにルートやその他のグローバル要素を追加可能。Camel ルートにのみ表示されます !
  7. インテグレーションの完全なソースコードをクリップボードにコピー。
  8. 現在表示されているインテグレーションを PNG イメージとしてエクスポート。
  9. インテグレーションのドキュメントを生成し、Markdown 形式でダウンロードします。
  10. 利用可能な Camel バージョンを表示するドロップダウン。Camel Main、Springboot、Quarkus など、さまざまなランタイムが利用可能です。
  11. ステップの設定に問題があることを示す Error-Marker を含むインテグレーション内のステップ。
  12. 選択したステップのツールバー。現在の選択に対して利用可能なアクションを提供します。
  13. このボタンバーには、Zoom In/Out などの機能があり、ビューのリセット、水平と垂直間のレイアウトの方向の切り替え、および包括的な Camel カタログへのアクセスを許可します。これには、利用可能なすべてのコンポーネント/コネクター、エンタープライズ統合パターン、および Kamelets が含まれます。

4.1. Camel Route の使用
リンクのコピー

Apache Camel では、ルートとは、メッセージが送信元から宛先に移動する間に適用される一連の処理手順のことです。ルートは通常、リニアシーケンスで接続された一連の処理ステップで構成されます。

Camel Route は、インテグレーションフローが定義される場所です。たとえば、Camel Route を記述して、2 つのシステムを統合する方法を指定できます。システム間でデータを操作、ルーティング、仲介する方法も指定できます。

4.1.1. 新しい Camel Route の作成
リンクのコピー

「最初の Camel Route の作成」 の章で新しい Camel ルート YAML ファイルを作成する方法についてはすでに説明しました。

新しい Camel Route を作成する別の方法を使用しましょう。

  1. 他の章のルートがまだ開いている場合は、Route selection のドロップダウンをクリックし、ゴミ箱アイコンを使用してすべてのルートを削除します。

    ルートの削除

  2. すべてのルートの削除が確認されると、以下のような空の画面が表示されます。

    ルートなし
  3. キャンバスの中央にある + New ボタンをクリックするか、キャンバスの上部メニューバーの Route selection ドロップダウンの横にある同じボタンを使用して、新しい Camel Route を作成できるようになりました。どちらの場合も、Timer コンポーネントを使用して Log コンポーネントに毎秒メッセージを送信するテンプレートルートが配置されます。

4.1.2. ステップの追加
リンクのコピー

ここで、Timer と Log コンポーネントの間に新しいステップを追加して、メッセージ本文を変更します。

ルートにステップを追加する方法は 2 つあります。

  1. 前または後に挿入するステップを右クリックします。これにより、選択可能なアクションを含むコンテキストメニューが表示されます。
  2. もっと簡単な方法としては、挿入したい 2 つのステップ間の接続にマウスを移動し、表示される + ボタンをクリックする方法があります。

  3. Timer および Log ステップ間の接続にマウスを移動し、+ ボタンをクリックして Add step アクションを実行します。

    ステップアクション
    重要

    右クリックのコンテキストメニューを使用する場合、使用可能なアクションのセットは、選択したステップによって異なります。ステップの追加、先頭への追加、置換、削除のアクションや、さらに特殊なアクションもあります。

  4. これにより、Camel カタログが開き、追加するステップを検索できるようになります。

    catalog

  5. すでに述べたように、メッセージを ログ コンポーネントに送信する前に、メッセージ本文を変更する必要があります。これを実現するには、setBody という プロセッサー を追加する必要があります。この名前をカタログ上部のフィルターテキストフィールドに入力しましょう。

    カタログセットボディ

  6. これで、setBody タイルを選択してルートに追加できるようになりました。キャンバス上で新しく追加されたステップを選択すると、右側に設定フォームが開きます。

    setbody ステップ
  7. Expression テキストフィールドを Hello from Kaoto! に変更してみましょう。

  8. これで、Log コンポーネントは 1 秒ごとに Hello from Kaoto! メッセージを受信し、コンソールに記録するようになります。

    重要

    ステップの右クリックコンテキストメニューを使用する場合、新しいステップの追加は通常 2 つのアクションで実行されます。Prepend を使用すると、選択したステップの前にステップを追加でき、Append を使用すると、選択したステップの後に新しいステップが追加されます。

    ただし、フローの最初のステップと子を持つことができるステップでは、Add Step アクションが使用されます。

4.1.3. ステップの置き換え
リンクのコピー

  1. キャンバス上の任意のステップを置き換えるには、ステップにカーソルを合わせるか、ステップを選択します。これにより、Replace アクションのボタンを含むツールバーが生成されます。

    置き換えボタン
  2. または、ステップでコンテキストメニューを呼び出して Replace 項目を選択することでも置き換えできます。どちらの方法でも、Camel カタログが開き、そこから置換を選択できます。

4.1.4. ステップの削除
リンクのコピー

警告

子を持つステップ、または子を含むコンテナー要素で Delete アクションを呼び出すと、単一のステップまたはコンテナーだけでなく、含まれるすべての子も削除しようとするため、確認ダイアログが表示されます。注意してください!

  1. キャンバス上のステップを削除するには、ステップにマウスを合わせるか、ステップを選択します。これにより、Delete アクションのボタンを含むツールバーが生成されます。

    削除ボタン
  2. または、ステップのコンテキストメニューを呼び出して Delete 項目を選択することでも削除できます。これにより、インテグレーションからステップが削除されます。

4.1.5. ステップの有効化/無効化
リンクのコピー

  1. キャンバス上のステップを有効または無効にするには、ステップにマウスを合わせるか、ステップを選択します。これにより、Enable / Disable アクションのボタンを含むツールバーが生成されます。

    重要

    ステップを無効にすると、フローの実行時にステップを無視するように Apache Camel ランタイムに指示します。これは、新しいルートのプロトタイプを作成するときに便利です。

    ボタンの無効化

  2. または、ステップのコンテキストメニューを呼び出して Enable / Disable 項目を選択することで、ルート内の任意のステップを有効化/無効化することもできます。

    無効化されたステップ
  3. 上の図では、Log コンポーネントが無効になっています。アイコンはグレー表示され、ステップの右上に無効であることを示すマーカーアイコンが表示されます。

4.1.6. インテグレーションドキュメントの生成
リンクのコピー

  1. ビルトインのドキュメント生成機能を使用して、統合のすべてのステップと、これらのステップのすべての変更パラメーターと、統合のイメージを含む Markdown ファイルを作成できます。

    Generate docs ボタン

  2. ボタンをクリックすると、統合ドキュメントのプレビューを含むダイアログが開きます。

    ドキュメントの生成
  3. ダイアログの左上にある Visible Entities コントロールを使用して、ドキュメントに含まれるルートを制御できます。
  4. all （サブセット）のみ、または単一のルートのみを選択できます。選択が完了したら、右上でファイル名を指定してから Download ボタンをクリックし、ファイルを ZIP 形式で取得できます。

第5章 Kaoto DataMapper
リンクのコピー

注記

現在、Kaoto DataMapper は、テクニカルプレビュー機能として Visual Studio Code エクステンション内でのみサポートされています。将来的には、この機能を Kaoto の純粋な Web バージョンにも導入することを目指します。

注記

現時点では、DataMapper はデータ構造をレンダリングするための XML スキーマのみをサポートしており、ランタイムに設定されたデータマッピングを実行するために単一の XSLT ステップを内部的に生成します。XSLT パラメーターにマップされた Camel 変数やメッセージヘッダーを使用して複数の XML ドキュメントを使用できますが、出力は Camel メッセージ本文のみになります。

datamapper の完了

通常の Camel ステップに加えて、Kaoto では Camel Route に配置される Kaoto DataMapper ステップもサポートされるようになりました。Kaoto DataMapper ステップは、Camel Route 内でデータマッピングを作成するためのグラフィカルユーザーインターフェイスを提供します。

5.1. DataMapper ステップの追加
リンクのコピー

  1. Camel Route に Kaoto DataMapper ステップを追加します。Kaoto Design ビューでステップの Append、Prepend、または Replace を実行する場合、カタログで Kaoto DataMapper ステップを確認できます。

    カタログ datamapper タイル

  1. Kaoto Design に追加された Kaoto DataMapper ステップをクリックして、設定フォームを開きます。

    kaoto datamapper ステップ

  2. Kaoto DataMapper 設定フォームで、Configure ボタンをクリックします。

    datamapper 設定ボタン

  3. これにより、ビジュアル DataMapper エディターが開きます。

    datamapper の空白

5.2. ソースとターゲット
リンクのコピー

DataMapper キャンバスでは、左側に Source、右側に Target セクションが表示されます。

datamapper ソースターゲット

Source セクションは、DataMapper ステップがデータを読み取るマッピングの入力側を表します。これは、受信される Camel Message と、可能な Camel Variables にマッピングされます。

Target セクションは、DataMapper ステップがデータを書き込むマッピングの出力側を表します。これは、送信される Camel Message にマップされます。

5.3. パラメーター
リンクのコピー

Source 内の Parameters セクションは、受信される Camel Variables と Message Headers のいずれかにマップされます。たとえば、Camel 変数 orderSequence が入力されている場合は、DataMapper Source/Parameters セクションにパラメーター orderSequence を追加することで、それを使用できます。

パラメーターを追加するには、以下の手順に従ってください。

  1. Parameters タイトルの右側にあるプラス (+) ボタンをクリックします。

    datamapper パラメーターの追加

  2. パラメーター名を入力し、右側のチェックボタンをクリックします。

    datamapper パラメーター追加確認
注記

Camel Exchange Properties は、現在の camel-xslt-saxon 実装でもパラメーターにマップされていますが、Camel Variables が導入された後は、アプリケーションデータを Camel Exchange Properties に保存することは推奨されなくなりました。代わりに Camel Variables を使用することを推奨します。

5.4. ドキュメントスキーマファイルのアタッチ
リンクのコピー

Source Body、Target Body、Parameter(s) のいずれかが構造化データである場合は、スキーマファイルをアタッチして、データ構造をツリー形式のビューで視覚化できます。

注記

データが構造化されておらず、単なるプリミティブ値である場合は、スキーマファイルをアタッチする必要はありません。

スキーマファイルをアタッチするには、以下の手順に従います。

  1. スキーマファイルをワークスペースディレクトリー内に配置します。

  2. Source Body、Target Body、または Parameters セクションのいずれかで Attach a schema ボタンをクリックします。

    datamapper スキーマのアタッチ

  1. アタッチするスキーマファイルを選択します。

    datamapper スキーマの選択

  2. これで、ドキュメント構造がツリー内にレンダリングされます。

    datamapper スキーマがアタッチされている

5.5. シンプルなマッピングの作成
リンクのコピー

5.5.1. フィールドをドラッグアンドドロップしてマッピングを作成する
リンクのコピー

ソースとターゲットの間でドラッグアンドドロップを実行すると、マッピングが作成され、フィールド間に線が描画されます。

例: ソースの Name フィールドをターゲットの Name フィールドにドラッグアンドドロップして、Name フィールドをマッピングします。

マッピング前:

datamapper のドラッグ名

マッピング後:

datamapper ドロップ名

5.5.2. XPath 式を入力してマッピングを作成する
リンクのコピー

XPath 式を入力してマッピングを作成することもできます。

  1. 3 つのドットのコンテキストメニューをクリックし、ターゲットフィールドを選択してから、Add selector expression を選択します。

    datamapper セレクターの追加

  2. 次に XPath 式を入力します。

    datamapper タイプ xpath

5.6. 条件付きマッピングの作成
リンクのコピー

DataMapper は、次の 3 タイプの条件マッピングの作成をサポートしています。

  1. if - 指定された条件が満たされた場合にのみマッピングが作成されます。
  2. choose-when-otherwise - 条件が満たされる内容に応じてマッピングが作成されます。when ブランチ条件が満たされると、when ブランチマッピングが作成されます。when ブランチ条件が満たされない場合は、otherwise ブランチマッピングが作成されます。
  3. for-each - コレクション内の各項目に対してマッピングが作成されます。コレクションとは複数の出現を意味し、多くの場合、配列として表されます。

5.6.1. if マッピングの作成
リンクのコピー

  1. ターゲットセクションのフィールドにある 3 つのドットのコンテキストメニューをクリックします。次に、wrap with "if" を選択してマッピングを作成します。

    datamapper 3dots の場合
    datamapper if の場合

  2. if 条件を設定します。ソースフィールドをドラッグして入力フィールドにドロップし、条件を作成することも、すべてを手動で入力することもできます。

    datamapper の if 条件

  3. ドラッグアンドドロップを使用するか、手動で入力してマッピングを設定します。

    datamapper マッピングの場合

5.6.2. choose-when-otherwise マッピングの作成
リンクのコピー

  1. ターゲットセクションのフィールドにある 3 つのドットのコンテキストメニューをクリックします。次に、wrap with "choose-when-otherwise" を選択してマッピングを作成します。

    datamapper choose の選択

  2. when 条件を設定します。

    datamapper の when 条件の選択

  3. when ブランチのマッピングを設定します。

    datamapper の when マッピングの選択

  4. otherwise ブランチのマッピングを設定します。

    datamapper の otherwise マッピングの選択

  5. 必要に応じて、1 つ以上の when ブランチを追加できます。別の when ブランチを追加するには、Target セクションの choose フィールドにある 3 つのドットメニューをクリックし、Add "when" を選択します。

    datamapper の add when の選択
    datamapper の when added の選択

5.6.3. for-each マッピングの作成
リンクのコピー

フィールドがコレクションフィールド (複数回出現し、多くの場合配列として表される) である場合は、for-each マッピングを作成できます。フィールド上のレイヤーアイコンは、それがコレクションフィールドであることを示します。

datamapper コレクションフィールド

  1. ターゲットセクションのコレクションフィールドにある 3 つのドットのコンテキストメニューをクリックします。次に、"for-each" でラップを選択してマッピングを作成します。

    datamapper の for each の for each

  2. イテレートするソースコレクションフィールドを指定して、for-each 条件を設定します。

    datamapper の for each 条件

  3. 以下のマッピングを設定します。マッピングフィールドパスは、for-each 条件で指定されたコレクションフィールドからの相対パスになっている点に注意してください。

    datamapper の for each マッピング

5.7. XPath 式エディターの使用
リンクのコピー

注記

XPath エディターはまだ初期開発段階であり、現在は限定的なドラッグアンドドロップのみをサポートしています。今後のリリースでは、さらに多くの構文支援機能が追加される予定です。

フィールドパスだけでなく、XPath 式でさらに何かを記述したい場合は、XPath 式エディターを起動して使用できます。ターゲットフィールドには鉛筆アイコンがあり、それをクリックすると XPath 式エディターが起動します。

  1. マッピングがあるターゲットフィールドの鉛筆ボタンをクリックします。

    datamapper xpath の鉛筆

  2. これにより、XPath エディターが開きます。

    datamapper xpath エディター

  3. 次に、右側のエディターに入力するか、左側から Field をドラッグしてエディターにドロップします。

    datamapper xpath dnd フィールド

  4. 左側の Function タブから XPath 関数をドラッグアンドドロップすることもできます。

    datamapper xpath 関数

  5. 関数をドラッグしてエディターにドロップします。

    datamapper xpath 関数 dnd

  6. 完了したら、左下にある Close ボタンをクリックします。

    datamapper xpath を閉じる

  7. これで、ツリービューで新しいマッピングを確認できます。

    datamapper xpath の完了

5.8. マッピングの削除
リンクのコピー

  1. マッピングを削除するには、ターゲットフィールドの横にあるゴミ箱ボタンをクリックします。

    datamapper のマッピング削除ボタン

  2. 次に、Confirm ボタンをクリックして、削除を確認する必要があります。

    datamapper のマッピング削除の確認

  3. マッピングが削除されます。

    datamapper マッピング削除が完了

5.9. パラメーターの削除
リンクのコピー

  1. パラメーターを削除するには、パラメーターの横にあるゴミ箱ボタンをクリックします。

    datamapper のパラメーターを削除してゴミ箱へ

  2. 次に、Confirm ボタンをクリックして、削除を確認する必要があります。

    datamapper パラメーター削除の確認

  3. パラメーターが削除されました。

    datamapper パラメーター削除の完了

5.10. スキーマのデタッチ
リンクのコピー

スキーマのアタッチと同様に、スキーマを削除/デタッチすることもできます。

  1. Detach schema ボタンをクリックします。

    datamapper ボタンのデタッチ

  2. Confirm ボタンをクリックします。

    datamapper デタッチの確認

  3. これで、ドキュメントはプリミティブ値に戻りました。

    datamapper デタッチの完了

第6章 カタログの生成
リンクのコピー

6.1. 概要
リンクのコピー

デフォルトでは、すべての Kaoto リリースには、ビルド時に利用可能な最新の Camel バージョンが含まれますが、異なるカタログセットを生成することも可能です。

6.2. カタログジェネレーター CLI
リンクのコピー

Kaoto は、このプロセスを容易にするために Camel カタログジェネレーター CLI を提供しており、次のランタイムをサポートしています。

  1. Main
  2. Quarkus
  3. Springboot

6.2.1. Camel カタログの使用
リンクのコピー

  1. Kaoto プロジェクトのクローンを作成します。
  2. packages/catalog-generator ディレクトリーに移動します。

  3. プロジェクトの依存関係をインストールします。 

    ./mvnw install
    Copy to Clipboard Toggle word wrap

  4. 次のコマンドでプロジェクトを実行します。 

    ./mvnw package; java -jar ./target/catalog-generator-0.0.1-SNAPSHOT.jar -o ./dist/camel-catalog -k 4.10.3.redhat-00017 -m 4.10.3.redhat-00020 -n "My Catalog"
    Copy to Clipboard Toggle word wrap

  5. これにより、次の内容を含むカタログライブラリーが生成されます。

    1. Camel Main 4.6.0
    2. Camel Kamelets 4.6.0
  6. 作成されたファイルは packages/catalog-generator/dist/camel-catalog フォルダーに保存されます。
  7. そのフォルダーを http サーバー経由で提供すると、Kaoto で使用できるようになります。

6.2.2. 異なるランタイムを持つカタログライブラリーの作成
リンクのコピー

  1. カタログライブラリーに複数のランタイムを追加するには、次のフラグを使用して各ランタイムにバージョンを指定します。 

     -m,--main <version>               Camel Main version. If not specified,
                                   it will use the generator installed
                                   version
 -q,--quarkus <version>            Camel Extensions for Quarkus version
 -s,--springboot <version>         Camel SpringBoot version
    Copy to Clipboard Toggle word wrap

  2. たとえば、次のコマンドを実行すると、Camel Main 4.6.0 と Quarkus 3.8.0 用の Camel エクステンションを含むカタログライブラリーが作成されます。 

    ./mvnw package; java -jar ./target/catalog-generator-0.0.1-SNAPSHOT.jar -o ./dist/camel-catalog -k 4.6.0 -m 4.6.0 -q 3.8.0 -n "My Catalog"
    Copy to Clipboard Toggle word wrap

  3. 異なる Kamelets カタログバージョンの場合は、--kamelets or -k フラグを指定できます。 

    ./mvnw package; java -jar ./target/catalog-generator-0.0.1-SNAPSHOT.jar -o ./dist/camel-catalog -k 4.5.0 -m 4.6.0  -n "My Catalog"
    Copy to Clipboard Toggle word wrap

6.2.3. Kaoto に特定のカタログライブラリーを使用するように指示する
リンクのコピー

  1. VSCode で設定ページに移動し、“Kaoto” を探します。

    vscode kaoto 設定

  2. TextField に、後続のカタログの場所を指定する index.json ファイルの URL を指定します。たとえば、パブリック Kaoto カタログは以下のように使用できます。

    kaoto カタログ URL の設定

  3. 変更を有効にするには Kaoto を再起動してください

    kaoto ランタイムセレクター

法律上の通知
リンクのコピー

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hatトップに戻る