1. Homepage
  2. Anypoint Code Builder

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

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

logo cloud IDE Cloud IDE

logo desktop IDE Desktop IDE

これは進行中のベータリリースです。ベータ状態での Anypoint Code Builder の使用には、該当するベータサービス契約条件が適用されます。

基本インテグレーションを作成し、ビジネスロジックを処理する Mule アプリケーションにコネクタと他のコンポーネントを追加し、属性を設定します。

  1. 新しいインテグレーションプロジェクトを作成します​。

  2. プロジェクトにコンポーネントを追加します​。

  3. Exchange からコネクタをインポートします​。

  4. コンポーネントの属性を設定します​。

  5. HTTP リスナー接続をテストします​。

  6. 新しい XML 設定ファイルを作成します​。

始める前に

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

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

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

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

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

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

    項目名 Field Value (項目値)

    Project Name (プロジェクト名)

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

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

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

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

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

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

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

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

リスナーの目的はフローをトリガーすることです。Set Payload でインテグレーション用の一部のテストデータを提供します。

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

    Mule フローと Mule 設定ファイルを視覚的に表現しているキャンバス
    1 キャンバスでは、Mule フローまたはサブフローを視覚的に表現する領域が提供されます。
    2 設定 XML エディターには、Mule アプリケーションの設定ファイルが表示されます。

  2. キャンバスで ​[Flow (フロー)]​ を選択して、空のフローを作成します。

  3. 設定 XML で、フローの名前 (​name1​) を目的のフロー名 (​getFlights​ など) に置き換えます。

  4. キャンバスでコンポーネントをプロジェクトに追加します。たとえば、HTTP Listener コンポーネントを追加します。

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

    2. [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>

  5. 別のコンポーネントを追加します。今回は XML 設定メニューを使用します。 たとえば、スニペットから ​<http:listener-config/>​ コンポーネントを追加します。

    スニペットについての詳細は、コードスニペットの操作を参照してください。

    1. 設定 XML で、​<flow/>​ 要素の前にカーソルを置いて​「http」​と入力します。

      カーソルが ​<flow/>​ 要素の内側にないことを確認します。

    2. 「http」​と入力し、​http:listener-config​ スニペットを選択します。

      設定 XML メニューで強調表示されている http:listener-config スニペット

      このスニペットでは次のコードが追加されます。

      <http:listener-config name="HTTP_Listener_config" >
  <http:listener-connection host="0.0.0.0" port="8081" />
</http:listener-config>

  6. 別のコンポーネントをフローに追加します。

    たとえば、Set Payload コンポーネントを HTTP Listener 操作に追加します。

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

    2. [Add Component (コンポーネントを追加)]​ パネルで、​[Transformer]​ の検索結果から ​[Set payload]​ を選択します。

設定 XML ファイルは、次のようになります。

  <http:listener-config name="HTTP_Listener_config" >
    <http:listener-connection host="0.0.0.0" port="8081" />
  </http:listener-config>

  <flow name="getFlights" >
    <http:listener path="" config-ref="" doc:name="Listener" doc:id="uvapcx" />
    <set-payload value="" doc:name="Set payload" doc:id="hnxirg" />

  </flow>

キャンバス内の Listener コンポーネントにエラーが表示されています。

キャンバス内の Listener エラー

エラーの場所を特定するには、キャンバス内でプロセッサーを選択します。 Anypoint Code Builder では、設定 XML 内でこの場所が強調表示されます。次に例を示します。

フローと XML コード内で強調表示されている HTTP リスナー

エラーを修正するには、属性を設定します。

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

Exchange からコネクタをインポートする

Anypoint Connector では、システムからのデータの取得、データの変更、システムへのデータの送信を行うための操作が提供されます。 Anypoint Code Builder で提供される​組み込みコネクタ​に加えて、ユーザーは Anypoint Exchange から他の多くのコネクタをダウンロードできます。

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

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

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

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

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

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

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

      Anypoint MQ Connector での [Add Publish] 操作

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

      [Search in Exchange (Exchange 内を検索)] 切り替え
      1 Search locally (ローカルで検索)
      2 Search in Exchange (Exchange 内を検索)

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

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

後でプロジェクトで使用するコネクタを Exchange からインポートする手順は、次のとおりです。

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

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

  3. コマンドパレットを開きます。

    手順を表示

    • キーボードショートカットを使用する。

      • Mac: Cmd+Shift+p

      • Windows: Ctrl+Shift+p

    • デスクトップ IDE で、​[View (表示)]​ > ​[Command Palette (コマンドパレット)]​ を選択する。

    • クラウド IDE で、​​ (メニュー) アイコンをクリックし、​[View (表示)]​ > ​[Command Palette (コマンドパレット)]​ を選択する。

  4. 次のコマンドを選択します。

    MuleSoft: Import Asset from Exchange

  5. [Connector]​ を選択します。

  6. インポートするコネクタ名 (「MQ」など) を検索します。

    "Exchange から MQ Connector をインポート

  7. コネクタを選択します。

  8. プロンプトで、インポートするコネクタのバージョン (​v4.0.3​ など) を選択します。

    Anypoint Code Builder によりコネクタがインポートされ、コンポーネントリストで使用可能になります。

Exchange で利用できるコネクタについての詳細は、コネクタを参照してください。 Exchange についての詳細は、 Exchange (US)​ または Exchange (EU)​ とAnypoint Exchange の概要を参照してください。

コンポーネントの属性の設定

コンポーネントをプロジェクトに追加したら、属性を設定します。

たとえば、​<http:listener-config/>​、​<http:listener/>​、および ​<set-payload/>​ 要素の次の属性を設定します。

<http:listener-config name="inbound-request" doc:name="Listener Config" doc:id="b5c62f-a84a3a">
  <http:listener-connection host="0.0.0.0" port="8081"/>
</http:listener-config>

<flow name="getFlights">
    <http:listener path="flights" config-ref="inbound-request" doc:name="HTTP /flights" doc:id="htprur" />
    <set-payload value="Flight info" doc:name="Set Response" doc:id="e43e98-1a9a01"/>
</flow>

HTTP リスナー接続のテスト

HTTP リスナー接続をテストするには、設定 XML で ​[Test Connection (接続をテスト)]​ をクリックします。

設定 XML 内の HTTP リスナーの [Test Connection (接続をテスト)] リンク

ステータスバーに進行状況が表示されます。

  • Verifying connection inbound-request (接続のインバウンド要求を検証中)​: テストが進行中であることを示します。

  • Connection is valid (接続は有効)​: 正常に接続されていることを示します。

  • Invalid Connection Got status code: 500 when trying to resolve a Mule Runtime operation (Mule Runtime 操作を解決しようとしているときに無効な接続で状況コード 500 を取得)​: 接続エラーを示します。

    一般的なコード ​500​ エラーは、​[port 8081: Address already in use (ポート 8081: アドレスはすでに使用中)]​ です。ポート競合の場合、別のポート (​8082​ など) を設定して設定をリセットします。

パブリッシュする前にアプリケーションをデバッグモードで実行します。

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

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

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

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

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

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

    手順を表示

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

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

    • クラウド 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>

関連情報