Flex Gateway新着情報
Governance新着情報
Monitoring API Manager
これは進行中のベータリリースです。ベータ状態での Anypoint Code Builder の使用には、該当するベータサービス契約条件が適用されます。 |
基本インテグレーションを作成し、ビジネスロジックを処理する Mule アプリケーションにコネクタと他のコンポーネントを追加し、属性を設定します。
新しいインテグレーションプロジェクトを作成する手順は、次のとおりです。
IDE のアクティビティバーで、 (Anypoint Code Builder) アイコンをクリックします。
[Quick Actions (クイックアクション)] から [Develop an Integration (インテグレーションを開発)] をクリックします。
[Develop an Integration (インテグレーションを開発)] フォームに入力します。
項目名 | Field Value (項目値) |
---|---|
Project Name (プロジェクト名) |
プロジェクトの一意の名前。 この名前はタイトルおよびインテグレーションプロジェクトファイルの名前として使用されます。
たとえば、プロジェクト名が「OAS Integration」 (OAS インテグレーション) の場合、プロジェクトファイル名は |
Project Location (プロジェクトの場所) |
ホームディレクトリまたは作成する別のディレクトリ。インテグレーション用の別のディレクトリを選択するには、[Browse (参照)] をクリックします。 「ホームディレクトリへのフォルダーの追加」を参照してください。 別のプロジェクトディレクトリ内にプロジェクトを作成しないでください。 |
[Create Project (プロジェクトを作成)] をクリックします。
リスナーの目的はフローをトリガーすることです。Set Payload でインテグレーション用の一部のテストデータを提供します。
[Explorer] ビューで、目的のプロジェクトの XML ファイル (my-project-name.xml
など) を選択します。
1 | キャンバスでは、Mule フローまたはサブフローを視覚的に表現する領域が提供されます。 |
2 | 設定 XML エディターには、Mule アプリケーションの設定ファイルが表示されます。 |
キャンバスで [Flow (フロー)] を選択して、空のフローを作成します。
設定 XML で、フローの名前 (name1
) を目的のフロー名 (getFlights
など) に置き換えます。
キャンバスでコンポーネントをプロジェクトに追加します。たとえば、HTTP Listener コンポーネントを追加します。
キャンバスで ([Add component (コンポーネントを追加)]) アイコンをクリックします。
[Add Component (コンポーネントを追加)] パネルで、[HTTP] の検索結果から [Listener] を選択します。
設定 XML ファイルで、HTTP リスナーの XML が <flow/>
要素に含まれるようになりました。次に例を示します。
<flow name="getFlights" >
<http:listener path="" config-ref="" doc:name="Listener" doc:id="ojzfry" />
</flow>
別のコンポーネントを追加します。今回は XML 設定メニューを使用します。
たとえば、スニペットから <http:listener-config/>
コンポーネントを追加します。
スニペットについての詳細は、コードスニペットの操作を参照してください。
設定 XML で、<flow/>
要素の前にカーソルを置いて「http」
と入力します。
カーソルが <flow/>
要素の内側にないことを確認します。
「http」
と入力し、http:listener-config
スニペットを選択します。
このスニペットでは次のコードが追加されます。
<http:listener-config name="HTTP_Listener_config" >
<http:listener-connection host="0.0.0.0" port="8081" />
</http:listener-config>
別のコンポーネントをフローに追加します。
たとえば、Set Payload コンポーネントを HTTP Listener 操作に追加します。
キャンバスで ([Add component (コンポーネントを追加)]) アイコンをクリックします。
[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 コンポーネントにエラーが表示されています。
エラーの場所を特定するには、キャンバス内でプロセッサーを選択します。 Anypoint Code Builder では、設定 XML 内でこの場所が強調表示されます。次に例を示します。
エラーを修正するには、属性を設定します。
デバッグについての詳細は、Mule アプリケーションのデバッグを参照してください。
Anypoint Connector では、システムからのデータの取得、データの変更、システムへのデータの送信を行うための操作が提供されます。 Anypoint Code Builder で提供される組み込みコネクタに加えて、ユーザーは Anypoint Exchange から他の多くのコネクタをダウンロードできます。
Exchange からコネクタをインポートして設定に追加する手順は、次のとおりです。
[Explorer] ビューで、目的のプロジェクトの設定 XML ファイル (my-project-name.xml
など) を開きます。
アクティビティバーの ([Show Mule graphical mode (Mule グラフィックモードを表示)]) アイコンをクリックして UI キャンバスを開きます (自動的に開いていない場合)。
キャンバスから他のコンポーネントを追加した方法と同じ方法でコネクタを追加します。
キャンバスで ([Add component (コンポーネントを追加)]) アイコンをクリックします。
[Add Component (コンポーネントを追加)] パネルで [Connectors (コネクタ)] をクリックします。
コネクタ名をクリックし、追加する操作 (Publish など) をクリックします。
コネクタをローカルで使用できない場合、 ([Search in Exchange (Exchange 内を検索)]) 切り替えをクリックします。
1 | Search locally (ローカルで検索) |
2 | Search in Exchange (Exchange 内を検索) |
プロジェクトに追加するコネクタを選択します。
[Add Component (コンポーネントを追加)] パネルから操作を選択します。
後でプロジェクトで使用するコネクタを Exchange からインポートする手順は、次のとおりです。
[Explorer] ビューで、目的のプロジェクトの設定 XML ファイル (my-project-name.xml
など) を開きます。
キャンバス UI が自動的に開かない場合は、アクティビティバーの (Show Mule graphical mode (Mule グラフィカルモードを表示)) アイコンをクリックしてキャンバス UI を開きます。
コマンドパレットを開きます。
キーボードショートカットを使用する。
Mac: Cmd+Shift+p
Windows: Ctrl+Shift+p
デスクトップ IDE で、[View (表示)] > [Command Palette (コマンドパレット)] を選択する。
クラウド IDE で、 (メニュー) アイコンをクリックし、[View (表示)] > [Command Palette (コマンドパレット)] を選択する。
次のコマンドを選択します。
MuleSoft: Import Asset from Exchange
[Connector] を選択します。
インポートするコネクタ名 (「MQ」など) を検索します。
コネクタを選択します。
プロンプトで、インポートするコネクタのバージョン (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 リスナー接続をテストするには、設定 XML で [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
など) を設定して設定をリセットします。
パブリッシュする前にアプリケーションをデバッグモードで実行します。
Anypoint Code Builder により、Mule プロジェクト内の src/main/mule
に初期 Mule 設定 XML ファイルが作成されます。
このファイルにはグローバル設定とフロー構造が含まれます。
追加の設定ファイルを作成して、たとえば、グローバル設定を保存することができます。
新しい XML 設定ファイルを作成する手順は、次のとおりです。
[Explorer] ビューで mule フォルダー (src/main/mule
) を右クリックして [New File (新規ファイル)] を選択します。
または、メニューを使用します。
mule
フォルダーを選択して、次の操作を実行します。
デスクトップ IDE では、[File (ファイル)] > [New File (新規ファイル)] を選択します。
クラウド IDE では、 (メニュー) アイコンをクリックして、[File (ファイル)] > [New File (新規ファイル)] を選択します。
新しいファイルの名前を .xml
拡張子付きで入力します。
新しいファイルのエディタービューで、Ctrl+Space を押して、使用可能なオプションを表示します。
[Empty mule configuration (空の 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>