Flex Gateway新着情報
Governance新着情報
Monitoring API ManagerAnypoint Code Builder を使用してコネクタまたはモジュールを設定するには、Anypoint Code Builder で基本インテグレーションプロジェクトを作成し、ビジネスロジックを処理する Mule アプリケーションにコネクタと他のコンポーネントを追加し、属性を設定します。
インテグレーションプロジェクトを作成する前に、次の作業を行う必要があります。
コネクタの API にアクセスするためのログイン情報を用意します。
Visual Studio Code Extension Pack for Java がインストールされていることを確認します。
このコネクタを使用するには、以下に精通している必要があります。
コネクタの API
Anypoint Connector
Mule Runtime Engine (Mule)
新しいインテグレーションプロジェクトを作成する手順は、次のとおりです。
IDE のアクティビティバーで、 (Anypoint Code Builder) アイコンをクリックします。
[Quick Actions (クイックアクション)] から [Develop an Integration (インテグレーションを開発)] をクリックします。
セクション内で強調表示されている [Develop an Integration (インテグレーションを開発)]リンク"]
[Develop an Integration (インテグレーションを開発)] フォームに以下を入力します。
属性 | 値 |
---|---|
Project Name (プロジェクト名) |
プロジェクトの一意の名前。 この名前はタイトルおよびインテグレーションプロジェクトファイルの名前として使用されます。
たとえば、プロジェクト名が「Salesforce Integration」 (Salesforce インテグレーション) の場合、プロジェクトファイル名は |
Project Location (プロジェクトの場所) |
ホームディレクトリまたは作成する別のディレクトリ。インテグレーションプロジェクト用の別のディレクトリを選択するには、[Browse (参照)] をクリックします。 別のプロジェクトディレクトリ内にプロジェクトを作成しないでください。 『ホームディレクトリへのフォルダーの追加』を参照してください。 |
[Empty Project (空のプロジェクト)] または [Template or Example (テンプレートまたはサンプル)] カードを選択して、作成するプロジェクトの種別を選択します。
アプリケーションの Mule Runtime および Java バージョンを選択します。
[Create Project (プロジェクトを作成)] をクリックします。
Anypoint Connector では、システムからのデータの取得、データの変更、システムへのデータの送信を行うための操作が提供されます。
Anypoint Code Builder で提供される「組み込みコネクタ」に加えて、ユーザーは Anypoint Exchange から他の多くのコネクタをダウンロードできます。
Exchange からコネクタをインポートして設定に追加する手順は、次のとおりです。
[Explorer] ビューで、目的のプロジェクトの設定 XML ファイル (my-project-name.xml
など) を開きます。
キャンバス UI が自動的に開かない場合は、アクティビティバーの (Show Mule graphical mode (Mule グラフィカルモードを表示)) アイコンをクリックしてキャンバス UI を開きます。
キャンバス UI から他のコンポーネントを追加した方法と同じ方法でコネクタを追加します。
キャンバス UI で アイコン",15,15] ([Add component (コンポーネントを追加)]) アイコンをクリックします。
[Add Component (コンポーネントを追加)] パネルで [Connectors (コネクタ)] をクリックします。
コネクタ名をクリックし、追加する操作 (Publish など) をクリックします。
操作"]
コネクタをローカルで使用できない場合、 アイコン",15,15] ([Search in Exchange (Exchange 内を検索)]) 切り替えをクリックします。
切り替え"]
1 | Search locally (ローカルで検索) |
2 | Search in Exchange (Exchange 内を検索) |
プロジェクトに追加するコネクタを選択します。
[Add Component (コンポーネントを追加)] パネルから操作を選択します。
コネクタをインテグレーションプロジェクトに追加しても、Anypoint Code Builder ワークスペースの他のプロジェクトはそのコネクタを使用できません。
トリガー (ソース) は、指定された条件が満たされたときにフローを開始します。コネクタに独自のソースが関連付けられている場合、コネクタ固有のトリガーを使用してフローを開始できます。各コネクタトリガーには、固有の設定があります。
このコネクタの以下のソースを設定できます。
[HTTP] > [Listener]
設定されたホストとポートで要求を受信するたびにフローを開始する
Scheduler
たとえば、HTTP Listener トリガーを設定する手順は、次のとおりです。
キャンバス UI で [Listener] コンポーネントをクリックします。
(省略可能) 編集アイコンをクリックして、[Listener] コンポーネントの名前を変更します。
(省略可能) コネクタの設定ファイルを作成した場合はそれを選択します。
[General (一般)] タブの [Path (パス)] 項目に、HTTP 設定要素で設定されたパスの相対パスを入力します。「パスの設定」を参照してください。
[Advanced (詳細)] タブを選択して、次の属性を設定します。
属性 | 説明 | 必須 |
---|---|---|
Allowed methods (許可されるメソッド) |
すべての HTTP メソッドを許可する (デフォルト) 場合は、この属性を定義しないでください。特定のメソッドを制限するには、許可するすべての HTTP メソッドを |
いいえ |
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 (状況コード) |
エラー応答の状況コード ( |
いいえ |
理由を示す語句 |
エラーの理由 ( |
いいえ |
XML で Mule アプリケーションを手動でコーディングすることもできますが、Anypoint Code Builder を使用した方が効率的です。
Anypoint Code Builder XML エディターから Mule Runtime Engine (Mule) アプリケーションを手動でコーディングする場合、参照ステートメントを XML Mule フローと Apache Maven pom.xml
ファイルの両方に追加することで、アプリケーションからコネクタにアクセスできます。
Anypoint Code Builder でコネクタを追加すると、Studio は自動的に XML コードにコネクタの名前空間およびスキーマの場所を入力し、pom.xml
ファイルに連動関係を追加します。
次の例は、<mule>
XML ブロック内に名前空間ステートメントが配置される方法を示しています。
<mule xmlns:{lc-connector-name}="http://www.mulesoft.org/schema/mule/{lc-connector-name}"
xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
xmlns:http="http://www.mulesoft.org/schema/mule/http"
xmlns:file="http://www.mulesoft.org/schema/mule/file"
xmlns="http://www.mulesoft.org/schema/mule/core"
xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
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/file
http://www.mulesoft.org/schema/mule/file/current/mule-file.xsd
http://www.mulesoft.org/schema/mule/http
http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/ee/core
http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd
http://www.mulesoft.org/schema/mule/{lc-connector-name}
http://www.mulesoft.org/schema/mule/{lc-connector-name}/current/mule-{lc-connector-name}.xsd">
xml
Apache Maven pom.xml
ファイルは Anypoint Code Builder によって生成され、Mule アプリケーションの連動関係が含まれます。Mule アプリケーションを手動でコーディングする場合、次の XML スニペットを pom.xml
ファイルに含めてこのコネクタにアクセスできるようにします:
<dependency>
<groupId>{group-id-exchange}</groupId>
<artifactId>{artifact-id-exchange}</artifactId>
<version>x.x.x</version>
<classifier>mule-plugin</classifier>
</dependency>
xml
x.x.x
を使用しているコネクタに対応するバージョンに置き換えます。
最新の pom.xml
ファイル情報を取得する手順は、次のとおりです。
Anypoint Exchange に移動します。
Exchange で、[Login (ログイン)] をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。
Exchange で、コネクタを検索します。
コネクタを選択します。
[Dependency Snippets (連動関係スニペット)] をクリックします。
コンポーネントをインテグレーションプロジェクトに追加してフローをビルドします。
[Explorer] ビューで、目的のプロジェクトの XML ファイル (my-project-name.xml
など) を開きます。
開始カードで [Build a Flow (フローをビルド)] を選択して、空のフローを作成します。
、[build a flow (フローをビルド)]、[build a subflow (サブフローをビルド)] オプションが表示されている開始カードが含まれる Anypoint Code Builder キャンバス"]
フローの名前を変更します。
[Flow (フロー)] をクリックします。
編集アイコンをクリックします。
フロー名を入力し、チェックマークをクリックします。
キャンバス UI で アイコン",15,15] ([Add component (コンポーネントを追加)]) アイコンをクリックします。
[Add Component (コンポーネントを追加)] パネルで、検索結果からコンポーネントを検索して選択します。次の例は、「HTTP」の検索結果の Listener コンポーネントを示しています。
セクション内で強調表示されている Listener コンポーネント"]
設定 XML ファイルで、HTTP リスナーの XML が <flow/>
要素に含まれるようになりました。次に例を示します。
<flow name="getFlights" >
<http:listener path="" config-ref="" doc:name="Listener" doc:id="ojzfry" />
</flow>
XML
別のコンポーネントを追加します。今回は 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>
xml
HTTP 用 Anypoint Connector (HTTP Connector) の Request 操作は、Mule クライアントアプリケーションと、次のいずれかの種別の認証が必要なサービスとの接続をサポートします。
基本認証
ダイジェスト認証
NTLM 認証
OAuth2 認証コード許可種別認証
XML エディターで HTTP Connector の認証を設定します。以下は、HTTP Connector の認証の XML 値です。
認証種別 | XML 値 |
---|---|
基本認証 |
|
NTLM Authentication |
|
ダイジェスト認証 |
|
OAuth 2.0 |
|
コンポーネントをインテグレーションプロジェクトに追加したら、コンポーネント UI で属性を設定するか、XML コードエディターで直接属性を設定します。
コネクタ XML タグは、名前空間で始まり操作が続く、構文 namespace:operation
に従います。たとえば、データベース用 Anypoint Connector (Database Connector) の Select 操作の場合、<db:select/>
となります。
コンポーネントの式 (fx) 項目のオートコンプリートを使用して、Core モジュールの DataWeave 関数やこの項目で使用できる他の値を選択できます。
HTTP 用 Anypoint Connector (HTTP Connector) の Listener コンポーネントでは、HTTP サーバーをセットアップして、HTTP 要求を受信したらフローをトリガーすることができます。
UI で HTTP の Listener 属性を設定するには、「フローのトリガーの設定」を参照してください。
Basic security filter コンポーネントは受信した HTTP 要求を認証します。このコンポーネントはインテグレーションフローの Listener コンポーネントの後で使用します。
キャンバスで [Basic security filter] コンポーネントをクリックします。
[General (一般)] タブで、次の属性を設定します。
UI 項目 | 説明 | 必須 |
---|---|---|
Realm (レルム) |
認証レルム。 |
はい |
Security Provider (セキュリティプロバイダー) |
この属性は現在設定 UI で有効になっていません。XML エディターで設定してください。「基本セキュリティ検索条件」を参照してください。 |
いいえ |
Attributes (属性) |
|
いいえ |
HTTP 用 Anypoint Connector (HTTP Connector) の Request 操作を使用すると、デフォルトの GET
メソッドを使用して外部 HTTP サービスをコンシュームできます。それ以外の場合は、操作が受け入れるメソッドを選択できます。
Anypoint Code Builder UI で HTTP Request の属性を設定する手順は、次のとおりです。
キャンバスで [Request] コンポーネントをクリックします。
[General (一般)] タブで、次の属性を設定します。
UI 項目 | 説明 | 必須 |
---|---|---|
Method (メソッド) |
すべての HTTP メソッドを許可する (デフォルト) 場合は、この属性を定義しないでください。特定のメソッドを制限するには、許可するすべての HTTP メソッドを |
いいえ |
URI Settings URL (URI 設定 URL) |
要求の送信先となる URL。 |
いいえ |
URI Settings Path (URI 設定パス) |
要求を送信するパス。 |
いいえ |
Request Body (リクエストボディ) |
要求応答メッセージの本文。 |
いいえ |
Request Headers (リクエストヘッダー) |
応答メッセージに含めるヘッダー。 |
いいえ |
URI パラメーター |
要求の作成に使用する URI パラメーター。 |
いいえ |
Query Parameters (クエリパラメーター) |
要求に含めるクエリパラメーター。 |
いいえ |
Correlations ID (相関 ID) |
要求にアウトバウンド相関 ID を含めるかどうかが定義されます。 |
いいえ |
[Advanced (詳細)] タブを選択して、次の属性を設定します。
UI 項目 | 説明 | 必須 |
---|---|---|
Output MIME type (出力 MIME タイプ) |
このコンポーネントで出力されるペイロードの MIME タイプ。 |
いいえ |
パラメーター |
リーダープロパティのキー-値ペアが出力 MIME 属性に追加されます。複数のキーと値のペアが許可されます。 |
いいえ |
Output encoding (出力エンコード) |
このコンポーネントで出力されるペイロードのエンコード。 |
いいえ |
Streaming Strategy (ストリーミング戦略) |
この属性は現在設定 UI で有効になっていません。XML エディターで設定してください。XML でのストリーミング戦略の設定 を参照してください。 |
いいえ |
Follow redirects (リダイレクトをフォロー) |
リダイレクトをフォローするかどうかを示します。 |
いいえ |
Send body mode (本文送信モード) |
要求に本文を含めるかどうかが指定されます。動作が定義済みの許可する HTTP メソッドによって決定されるように指定するには [Auto (自動)] を選択します ( |
いいえ |
Request streaming mode (要求ストリーミングモード) |
要求がストリーミングを使用して送信されるかどうかが定義されます。 |
いいえ |
Response timeout (応答タイムアウト) |
要求要素が HTTP 応答を待機中のフローの実行をブロックする最大時間 (ミリ秒) が指定されます。 |
いいえ |
Response validator (応答バリデーター) |
要求のデフォルトのエラー処理が設定されます。この属性は現在設定 UI で有効になっていません。XML エディターで設定してください。「Success Status Code Validator (成功状況コードバリデーター)」および「Failure Status Code Validator (失敗状況コードバリデーター)」を参照してください。 |
いいえ |
Target Variable (対象変数) |
操作の出力が配置される変数の名前。 |
いいえ |
Target Value (対象値) |
操作の出力に対して評価される式。この式の出力は対象変数に保存されます。 |
いいえ |
エラーのマッピング |
この属性は現在有効ではありません。 |
いいえ |
Reconnection Strategy (再接続戦略) |
この属性は現在設定 UI で有効になっていません。XML エディターで設定してください。「Reconnect (再接続)」、「Reconnect Forever (繰り返し再接続)」、およびXML での再接続戦略の設定を参照してください。 |
いいえ |
この静的リソースにより、HTTP で使用する静的コンテンツが提供されます。要求パスはリソースの検索に使用されます。
Anypoint Code Builder UI で HTTP Load static resource の属性を設定する手順は、次のとおりです。
キャンバスで [Load static resource] コンポーネントをクリックします。
[General (一般)] タブで、次の属性を設定します。
UI 項目 | 説明 | 必須 |
---|---|---|
Resource base path (リソースベースパス) |
コンテンツを提供するリソースのベースパス (例えば、 |
はい |
Default file (デフォルトファイル) |
ディレクトリが指定されたときに提供するデフォルトファイル。デフォルトは |
いいえ |
Attributes (属性) |
Authorization ヘッダーを確認するための HTTP Listener ソースで定義された HTTP 要求属性。 |
いいえ |
[Advanced (詳細)] タブを選択して、次の属性を設定します。
UI 項目 | 説明 | 必須 |
---|---|---|
Output MIME type (出力 MIME タイプ) |
このコンポーネントで出力されるペイロードの MIME タイプ。 |
いいえ |
パラメーター |
リーダープロパティのキー-値ペアが出力 MIME 属性に追加されます。複数のキーと値のペアが許可されます。 |
いいえ |
Output encoding (出力エンコード) |
このコンポーネントで出力されるペイロードのエンコード。 |
いいえ |
Target Variable (対象変数) |
操作の出力を保存する変数の名前。 |
いいえ |
Target Value (対象値) |
操作の出力を評価する式。式の結果は対象変数に保存されます。 |
いいえ |
エラーのマッピング |
この属性は現在有効ではありません。 |
いいえ |
標準再接続戦略の XML の例を次に示します。失敗までの再接続試行回数を 5
に設定し、接続テストが失敗した場合にはアプリケーションのデプロイメントも失敗するように failsDeployment
を true に設定します。頻度が指定されていないため、デフォルトの 2000 ms ごとに接続が再試行されます。
<db:config name="Database_Config" doc:name="Database Config" doc:id="79ae8d0f-e0af-4901-961d-b80befbf3f86" >
<db:data-source-connection >
<reconnection failsDeployment="true" >
<reconnect count="5"/>
</reconnection>
</db:data-source-connection>
</db:config>
xml
繰り返し再接続戦略の XML の例を次に示します。コネクタは、アプリケーションが実行されている限り、4000 ms ごとに接続を再試行します。
<db:config name="Database_Config1" doc:name="Database Config" doc:id="c0aaf1dd-ab6e-49ee-9e4d-8b5799945cc9">
<db:data-source-connection>
<reconnection failsDeployment="true">
<reconnection>
<reconnect-forever frequency="4000"/>
</reconnection>
</reconnection>
</db:data-source-connection>
</db:config>
xml
ストリーミング戦略を使用して、Mule によるストリームの処理方法を設定できます。
1 MB のバッファで設定されているファイルの読み取りの XML の例を次に示します。
<file:read path="bigFile.json">
<repeatable-file-store-stream
inMemorySize="1"
bufferUnit="MB"/>
</file:read>
xml
一貫して 10 KB 以下のファイルを処理する場合、inMemorySize
属性を減らしてメモリを節約できます。
<file:read path="smallFile.json">
<repeatable-file-store-stream
inMemorySize="10"
bufferUnit="KB"/>
</file:read>
xml
次の XML の例は、初期サイズが 512 KB、拡張単位が 256 KB、そしてメモリに読み込めるコンテンツの最大サイズが 2000 KB (2 MB) のメモリ内の反復可能ストリームを示しています。
<file:read path="exampleFile.json">
<repeatable-in-memory-stream
initialBufferSize="512"
bufferSizeIncrement="256"
maxInMemorySize="2000"
bufferUnit="KB"/>
</file:read>
xml
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 Mule Configuration File (新規 Mule 設定ファイル)] を選択します。
クラウド 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>
xml