1. Homepage
  2. MuleSoft Vectors Connector (1.0)

  3. Anypoint Code Builder を使用した MuleSoft Vectors Connector の設定

All Connectors

Anypoint Code Builder を使用した MuleSoft Vectors Connector 1.0 の設定

進行中のベータリリース​: クラウド IDE は進行中のベータリリースです​。ベータ状態での Anypoint Code Builder の使用には、IDE で入手できる、該当するベータサービス契約条件が適用されます。

Anypoint Code Builder を使用してコネクタまたはモジュールを設定するには、Anypoint Code Builder で基本インテグレーションプロジェクトを作成し、ビジネスロジックを処理する Mule アプリケーションにコネクタと他のコンポーネントを追加し、属性を設定します。

始める前に

インテグレーションプロジェクトを作成する前に、次の作業を行う必要があります。

このコネクタを使用するには、以下に精通している必要があります。

  • コネクタの API

  • Anypoint Connector

  • Mule Runtime Engine (Mule)

新しいインテグレーションプロジェクトを作成する

新しいインテグレーションプロジェクトを作成する手順は、次のとおりです。

  1. IDE のアクティビティバーで、​Anypoint Code Builder アイコン​ (​Anypoint Code Builder​) アイコンをクリックします。

  2. [Quick Actions (クイックアクション)]​ から ​[Develop an Integration (インテグレーションを開発)]​ をクリックします。

    "[Getting started (使用開始) セクション内で強調表示されている [Develop an Integration (インテグレーションを開発)]リンク"]

  3. [Develop an Integration (インテグレーションを開発)]​ フォームに以下を入力します。

    属性 値

    Project Name (プロジェクト名)

    プロジェクトの一意の名前。

    この名前はタイトルおよびインテグレーションプロジェクトファイルの名前として使用されます。 たとえば、プロジェクト名が「Salesforce Integration」 (Salesforce インテグレーション) の場合、プロジェクトファイル名は ​salesforce-integration​ になります。

    Project Location (プロジェクトの場所)

    ホームディレクトリまたは作成する別のディレクトリ。インテグレーションプロジェクト用の別のディレクトリを選択するには、​[Browse (参照)]​ をクリックします。

    別のプロジェクトディレクトリ内にプロジェクトを作成しないでください。

    ホームディレクトリへのフォルダーの追加を参照してください。

  4. [Empty Project (空のプロジェクト)]​ または ​[Template or Example (テンプレートまたはサンプル)]​ カードを選択して、作成するプロジェクトの種別を選択します。

  5. アプリケーションの ​Mule Runtime​ および ​Java バージョン​を選択します。

  6. [Create Project (プロジェクトを作成)]​ をクリックします。

インテグレーションプロジェクトにコネクタを追加する

Anypoint Connector では、システムからのデータの取得、データの変更、システムへのデータの送信を行うための操作が提供されます。

Anypoint Code Builder で提供される​組み込みコネクタ​に加えて、ユーザーは Anypoint Exchange から他の多くのコネクタをダウンロードできます。

Exchange からコネクタをインポートして設定に追加する手順は、次のとおりです。

  1. [Explorer] ビューで、目的のプロジェクトの設定 XML ファイル (​my-project-name.xml​ など) を開きます。

  2. キャンバス UI が自動的に開かない場合は、アクティビティバーの ​Show Mule graphical mode (Mule グラフィカルモードを表示)​ (​Show Mule graphical mode (Mule グラフィカルモードを表示)​) アイコンをクリックしてキャンバス UI を開きます。

  3. キャンバス UI から他のコンポーネントを追加した方法と同じ方法でコネクタを追加します。

    1. キャンバス UI で ​"[Add component (コンポーネントを追加) アイコン",15,15]​ (​[Add component (コンポーネントを追加)]​) アイコンをクリックします。

    2. [Add Component (コンポーネントを追加)]​ パネルで ​[Connectors (コネクタ)]​ をクリックします。

    3. コネクタ名をクリックし、追加する操作 (​Publish​ など) をクリックします。

      "Anypoint MQ Connector での [Add Publish 操作"]

      コネクタをローカルで使用できない場合、​"[Search in Exchange (Exchange 内を検索) アイコン",15,15]​ (​[Search in Exchange (Exchange 内を検索)]​) 切り替えをクリックします。

      "[Search in Exchange (Exchange 内を検索) 切り替え"]

      1 Search locally (ローカルで検索)
      2 Search in Exchange (Exchange 内を検索)

    4. プロジェクトに追加するコネクタを選択します。

    5. [Add Component (コンポーネントを追加)]​ パネルから操作を選択します。

コネクタをインテグレーションプロジェクトに追加しても、Anypoint Code Builder ワークスペースの他のプロジェクトはそのコネクタを使用できません。

フローのソースを設定する

トリガー (ソース) は、指定された条件が満たされたときにフローを開始します。コネクタに独自のソースが関連付けられている場合、コネクタ固有のトリガーを使用してフローを開始できます。各コネクタトリガーには、固有の設定があります。

このコネクタの以下のソースを設定できます。

  • [HTTP] > [Listener]

    設定されたホストとポートで要求を受信するたびにフローを開始する

  • Scheduler

    たとえば、HTTP Listener トリガーを設定する手順は、次のとおりです。

    1. キャンバス UI で ​[Listener]​ コンポーネントをクリックします。

    2. (省略可能) 編集アイコンをクリックして、​[Listener]​ コンポーネントの名前を変更します。

    3. (省略可能) コネクタの設定ファイルを作成した場合はそれを選択します。

    4. [General (一般)]​ タブの ​[Path (パス)]​ 項目に、HTTP 設定要素で設定されたパスの相対パスを入力します。​「パスの設定」​を参照してください。

    5. [Advanced (詳細)]​ タブを選択して、次の属性を設定します。

      属性 説明 必須

      Allowed methods (許可されるメソッド)

      すべての HTTP メソッドを許可する (デフォルト) 場合は、この属性を定義しないでください。特定のメソッドを制限するには、許可するすべての HTTP メソッドを ​GET, POST​ のようにカンマ区切りリストとして指定してください。

      いいえ

      Response streaming mode (応答ストリーミングモード)

      応答の送信時にストリーミングを使用するかどうか。

      いいえ

      Output MIME type (出力 MIME タイプ)

      このコンポーネントで出力されるペイロードの MIME タイプ。

      いいえ

      パラメーター

      リーダープロパティのキー-値ペアが出力 MIME 属性に追加されます。複数のキーと値のペアが許可されます。

      いいえ

      Output encoding (出力エンコード)

      このコンポーネントで出力されるペイロードのエンコード。

      いいえ

      Streaming Strategy (ストリーミング戦略)

      Mule アプリケーションでのデータストリームのコンシューム方法を設定します。

      いいえ

      Primary node only (プライマリノードのみ)

      このオプションを選択すると、クラスターで実行されるときに ​Listener​ トリガーがプライマリノード上でのみ実行されます。

      いいえ

      Redelivery policy (再配信ポリシー)

      エラーを生成する要求を実行するための再配信ポリシーを設定します。再配信ポリシーは、フロー内のあらゆる提供元に追加できます。

      いいえ

      Reconnection strategy (再接続戦略)

      Mule アプリケーション内の操作が外部サーバーへの接続に失敗すると、デフォルト動作ではその操作は直ちに失敗し、接続エラーが返されます。デフォルト動作を変更するには、操作の再接続戦略を設定します。

      いいえ

      Response (応答)

      「HTTP Response Attributes (HTTP 応答属性)」​を参照してください。

      いいえ

      Error Response (エラー応答)

      HTTP エラー応答でエラーの状況コードが返されます。

      いいえ

      Body (本文)

      エラーメッセージの本文。

      いいえ

      Headers (ヘッダー)

      エラーメッセージに含めるヘッダー。

      いいえ

      Status code (状況コード)

      エラー応答の状況コード (​500​ など)。

      いいえ

      理由を示す語句

      エラーの理由 (​[Gateway Timeout (ゲートウェイがタイムアウトしました)]​ や ​Internal Server Error (内部サーバーエラー)​ など)。

      いいえ

プロジェクトにコンポーネントを追加する

コンポーネントをインテグレーションプロジェクトに追加してフローをビルドします。

  1. [Explorer]​ ビューで、目的のプロジェクトの XML ファイル (​my-project-name.xml​ など) を開きます。

  2. 開始カードで ​[Build a Flow (フローをビルド)]​ を選択して、空のフローを作成します。

    "[start from scratch (最初から開始)、[build a flow (フローをビルド)]、[build a subflow (サブフローをビルド)] オプションが表示されている開始カードが含まれる Anypoint Code Builder キャンバス"]

  3. フローの名前を変更します。

    1. [Flow (フロー)]​ をクリックします。

    2. 編集アイコンをクリックします。

      フロー名を編集する鉛筆アイコンを指し示している矢印

    3. フロー名を入力し、チェックマークをクリックします。

    4. キャンバス UI で ​"[Add component (コンポーネントを追加) アイコン",15,15]​ (​[Add component (コンポーネントを追加)]​) アイコンをクリックします。

    5. [Add Component (コンポーネントを追加)]​ パネルで、検索結果からコンポーネントを検索して選択します。次の例は、​「HTTP」​の検索結果の ​Listener​ コンポーネントを示しています。

      "[Add Component (コンポーネントを追加) セクション内で強調表示されている Listener コンポーネント"]

      設定 XML ファイルで、HTTP リスナーの XML が ​<flow/>​ 要素に含まれるようになりました。次に例を示します。

      <flow name="getFlights" >
  <http:listener path="" config-ref="" doc:name="Listener" doc:id="ojzfry" />
</flow>

コンポーネント属性を設定する

コンポーネントをインテグレーションプロジェクトに追加したら、コンポーネント UI で属性を設定するか、XML コードエディターで直接属性を設定します。

コネクタ XML タグは、名前空間で始まり操作が続く、構文 ​namespace:operation​ に従います。たとえば、データベース用 Anypoint Connector (Database Connector) の ​Select​ 操作の場合、​<db:select/>​ となります。

コンポーネントの式 (​fx​) 項目のオートコンプリートを使用して、Core モジュールの DataWeave 関数やこの項目で使用できる他の値を選択できます。

新しい設定 XML ファイルを作成する

Anypoint Code Builder により、Mule プロジェクト内の ​src/main/mule​ に初期 Mule 設定 XML ファイルが作成されます。 このファイルにはグローバル設定とフロー構造が含まれます。

追加の設定ファイルを作成して、たとえば、グローバル設定を保存することができます。

新しい XML 設定ファイルを作成する手順は、次のとおりです。

  1. [Explorer] ビューで ​mule​ フォルダー (​src/main/mule​) を右クリックして ​[New File (新規ファイル)]​ を選択します。

    または、メニューを使用します。

    手順を表示

    mule​ フォルダーを選択して、次の操作を実行します。

    • デスクトップ IDE では、​[File (ファイル)]​ > ​[New Mule Configuration File (新規 Mule 設定ファイル)]​ を選択します。

    • クラウド IDE では、​​ (メニュー) アイコンをクリックして、​[File (ファイル)]​ > ​[New File (新規ファイル)]​ を選択します。

  2. 新しいファイルの名前を ​.xml​ 拡張子付きで入力します。

  3. 新しいファイルのエディタービューで、Ctrl+Space を押して、使用可能なオプションを表示します。

  4. [Empty mule configuration (空の Mule 設定)]​ を選択します。

    自動修正内の新しい Mule 設定オプション

    このコマンドで次のコードがファイルに追加されます。

    <?xml version="1.0" encoding="UTF-8"?>
<mule xmlns="http://www.mulesoft.org/schema/mule/core" xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
    xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
    http://www.mulesoft.org/schema/mule/ee/core http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd">

</mule>

アプリケーションをデバッグする

Anypoint Code Builder の埋め込みデバッガーを使用して Mule アプリケーションをデバッグします。

Mule アプリケーションのデバッグを参照してください。

関連情報