--- schema_version: "1" id: d3b46cf84325d5679c958a6a4731e30d6bacf64bc15d65cb57b7894d977ec216 title: XML SDK collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/mule-sdk/1.1/xml-sdk.md canonical_url: https://docs.mulesoft.com/jp/mule-sdk/1.1/xml-sdk source_site: docs.mulesoft.com content_type: documentation content_hash: deca6a4e17041561bf313b3fed9ec5017cd33b328f4c67dd6def9ed571de157e description: MuleSoft Documentation Site release: "1.1" latest: false --- # XML SDK XML SDK は、より高度な Java ベースの Mule SDK に代わるものです。XML SDK を使用して、Mule アプリケーションを作成する方法と同様にカスタムモジュールを作成します。実際にモジュール内で既存の Mule コンポーネントを使用できます。このフレームワークでは、モジュールの主要部分 (``、``、`` 要素など) を囲む XML 要素としていくつかの構文的なイディオムを追加するだけです。たとえば、次のスニペットでは `Hello XML SDK` 内で 1 つの操作を定義します。 ```xml

``` 他のコンポーネントの使用方法と同じ方法で、Mule SDK コンポーネントを Mule フローで使用します。この例では、操作 `` で定義されているとおりに、フロー `"random-flow"` の実行によりペイロードが `"Hello World!"` に設定されます。 ```xml

``` XML SDK は強く型付けされているため、すべての操作の定義済みパラメーターのデータ型は、入力および出力の両方で静的に設定されます。 ## [](#必須ソフトウェアのインストール)必須ソフトウェアのインストールローカル環境に以下のツールをインストールして、正しく動作することを確認します。 - Java コードをコンパイルして構築するための Java Development Kit 8 (JDK 8)。

サポートされる XML SDK の最上位バージョンは JDK 11 ですが、JDK 11 はアプリケーションの実行にのみ使用できます。XML SDK でのコンパイルは JDK 8 で行う必要があります。

- プロジェクトの構築を管理するための Apache Maven 3.3.9 以降。 ## [](#xml-sdk-の基礎)XML SDK の基礎 XML SDK コンポーネントは、その動作と、Runtime がコンポーネントとやり取りする方法を示す主要な要素で構成されます。 - 操作 - プロパティ - 囲んでいるモジュール ### [](#操作)操作 `` 要素は一連の入力パラメーターと 1 つの出力を定義します。関数と同様に、入力パラメーターがあり、(本文に記述されている) アクションを実行し、1 つの出力があります。関数と異なり、操作に値が保存されている場合や、操作で外部ソースを参照する場合、操作の動作は変わる可能性があります。 - 入力パラメーター (``): 操作をコールするときに入力する型を宣言します。このパラメーターは、`` スコープ内のメッセージプロセッサーがアクセスできる唯一のデータです。 - 本文 (``): 実行するコンポーネントのチェーンを定義します。フローに似ています。 - 出力 (``): XML SDK Module の出力データ型を宣言します。これは、`` で処理された後のペイロードの型です。 - エラー: `` 内で XML SDK が発生させる (またはマップする) ことができるエラー種別を宣言します。次の XML SDK Module では、2 つの数値をパラメーターとして取得し、それらを合計する 1 つの操作を実行します。 ```xml ...

``` XML SDK Module を Mule アプリケーションで使用するには、XML SDK Module を Mule フローに追加するだけです。次に例を示します。 ```xml

```

Table 1. <parameter> の属性
名前	使用	デフォルト値	説明
`name`	必須	なし	`<parameter>` の名前
`defaultValue`	省略可能	なし	別の値を提供しない場合、`<operation>` はデフォルト値を使用します。
`use`	必須	`AUTO`	可能な値: `REQUIRED`: パラメーターが存在する必要があります。パラメーターに `defaultValue` がある場合、これを REQUIRED にすることはできません。 `OPTIONAL`: パラメーターは必須ではありません。 `AUTO`: `defaultValue` がない場合、ランタイム時にデフォルトの `REQUIRED` になります。それ以外の場合、`OPTIONAL` としてマークされます。
`type`	必須	なし	`<parameter>` のデータ型を定義します。`string`、`boolean`、`datetime`、`date`、`number`、`time` などのプリミティブ型を使用できます。また、カタログで定義された任意の型に依存することもできます。
`password`	省略可能	`false`	UI 内では `<parameter>` を `****` でマークします。
`role`	必須	`behavior`	現在の `<parameter>` に対して生成された XSD を変更する特定のパラメーターに対する定義済みのロールのセット。 `behavior` は属性を表示します。 `CONTENT` は、子要素として DataWeave のサポートがあることを意味します。 `PRIMARY` は `CONTENT` のように機能しますが、デフォルトではペイロードにマップします。ロールについての詳細を参照してください。
`summary`	省略可能	なし	簡単なツールチップを `<parameter>` に追加します。
`example`	省略可能	なし	このパラメーターのデータ型の短い例を追加します。
`displayName`	省略可能	なし	UI 表示ラベルを提供します。`displayName` がない場合、デフォルト値は、`name` 属性のハイフン付きバージョンになります。
`order`	省略可能	なし	各要素を UI に表示する順序を定義します。
`tab`	省略可能	なし	UI 内で `<parameter>` が属する必要があるグループ (またはタブ) を定義します。
`visibility`	省略可能	`PUBLIC`	バージョン 1.2 以降で使用可能次のように、操作の表示を `PUBLIC` (誰でも表示して使用可能) または `PRIVATE` (現在のモジュールのみにアクセス可能で、外部からは表示不可能) とマークします。 `<operation name="example" visibility="PRIVATE"> <parameters> <parameter name="errorTopic" type="string" />`
`doc:description`	省略可能	なし	`<parameter>` のドキュメント。

Table 2. <output> の属性
名前	使用	デフォルト値	説明
`type`	省略可能		出力ペイロードのデータ型。要素を削除して、これを `void` に設定することができます。これにより、動作にペイロードの変更が伴う場合でも、`<operation>` が Mule イベントを変更することが回避されます。

`` 要素を使用する場合、属性型の定義は `` 要素によってサポートされます。

Table 3. <output-attributes> の属性
名前	使用	デフォルト値	説明
`type`	省略可能		出力属性のデータ型。要素を削除して、これを `void` に設定することができます。これにより、動作にペイロードの変更が伴う場合でも、`<operation>` が Mule イベントを変更することが回避されます。

両方の出力 (`` と ``) は、制御が呼び出し元に戻った時に作成される `MuleMessage` の一部になります。

Table 4. **<error>** の属性
名前	使用	デフォルト値	説明
`type`	必須		`<body>` 内でスロー (または再マップ) するエラーコードの型。Mule エラーの概念を参照してください。

### [](#プロパティ)プロパティ `` は、XML SDK コンポーネントのエンドユーザーにより定義された項目を対象とします。これは、これを使用する Mule プロジェクト全体のグローバル設定として機能します。プロパティは、操作により公開されるパラメーターに似ていますが、特定の操作ではなく、プロジェクト内の XML SDK コンポーネントのすべてのインスタンスに影響するレベルで機能します。操作のパラメーターと同様に、プロパティは、通常は、デフォルト値を持つ単純型です。

XML SDK Module のエンドユーザーが混乱しないように、エンドユーザーが編集する必要があると思われるプロパティのみを公開します。たとえば、エンドユーザーが変更できないまたは変更してはならない内部値は公開しないでください。

次の XML SDK Module は要求を [GitHub API V3](https://developer.github.com/v3/users/#get-the-authenticated-user) に送信し、認証済みユーザーを取得します。 ```xml

``` この例では、次のようにモジュール内で定義されている `` を参照します。 - グローバル要素内で `request-config` の値として。 - 操作内で `http-request` 内の `config-ref` 属性に対する値として。次の Mule アプリケーションは XML SDK Module を使用します。`github` プレフィックス (`github:get-user` など) はモジュールの `name` から派生します。 ```xml

``` `"test-github-flow"` の実行のたびに、認証済みユーザーの GitHub 情報が返されます。 ```json { "login": "fernandezlautaro", "id": 4719511, "avatar_url": "https://avatars1.githubusercontent.com/u/4719511?v=3", "gravatar_id": "", "url": "https://api.github.com/users/fernandezlautaro", ... } ``` ログイン情報が正しくない場合、GitHub から次のエラー応答が返されます。 ```json { "message": "Requires authentication", "documentation_url": "https://developer.github.com/v3" } ```

Table 5. <property> 属性
名前	使用	デフォルト値	説明
`name`	必須	なし	`<property>` の名前。
`defaultValue`	省略可能	なし	別の値を提供しない場合、`<property>` はデフォルト値を使用します。
`use`	必須	`AUTO`	可能な値: `REQUIRED`: プロパティが存在する必要があります。パラメーターに `defaultValue` がある場合、これを REQUIRED にすることはできません。 `OPTIONAL`: プロパティは必須ではありません。 `AUTO`: `defaultValue` がない場合、ランタイム時にデフォルトの `REQUIRED` になります。それ以外の場合、`OPTIONAL` としてマークされます。
`type`	必須	なし	`<property>` のデータ型を定義します。`string`、`boolean`、`datetime`、`date`、`number`、`time` などのプリミティブ型を使用できます。また、カタログで定義された任意の型に依存することもできます。
`password`	省略可能	`false`	入力時に UI 内のプロパティの値が非表示になります (`****` が使用されます)。
`summary`	省略可能	なし	簡単なツールチップを `<property>` に追加します。
`example`	`optional`	なし	このプロパティのデータ型の短い例を追加します。
`displayName`	省略可能	なし	UI 表示ラベルを提供します。`displayName` がない場合、デフォルト値は、`name` 属性のハイフン付きバージョンになります。
`order`	省略可能	なし	各要素を UI に表示する順序を定義します。
`tab`	省略可能	なし	UI 内で `<property>` が属する必要があるグループ (またはタブ) を定義します。
`doc:description`	省略可能	なし	`<property>` のドキュメント。

XML SDK を使用して行われた拡張では、暗黙的な設定はサポートされません。つまり、拡張で定義されたすべてのプロパティが省略可能であっても、すべての操作には設定が必要です。そのパラメーターの値を指定せずに設定を作成できるため、デフォルト値を使用できます。

### [](#module-モジュール)Module (モジュール) `` 要素は XML SDK Module のルートです。これには、モジュールに属するすべてのプロパティと操作が含まれます。

Table 6. <module> 属性
名前	使用	デフォルト値	説明
`name`	必須	なし	`<module>` の名前。
`vendor`	省略可能	`"MuleSoft"`	XML SDK Module のベンダー。
`prefix`	省略可能	なし	スキーマを生成するときに使用するモジュールのプレフィックス。空の場合、モジュールでは `name` 属性のハイフン付きバージョンが使用されます。プレフィックス属性を参照してください。
`namespace`	省略可能	なし	スキーマの生成時にモジュールで使用する名前空間。それ以外の場合、デフォルトは `http://www.mulesoft.org/schema/mule/<prefix>` です (`<prefix>` は `prefix` 属性値)。
`doc:description`	省略可能	なし	`<module>` のドキュメント。

XML SDK スキーマを Mule アプリケーションにインポートするには、`namespace` 属性を使用します。XML スキーマは動的に生成されます。`namespace`、`prefix`、および `name` 属性がどのように連携するかを次の表で示します。

Table 7. <module> で `name`、`prefix`、および `namespace` を提供する
提供された値	生成された値
`name="hello with spaces"`	`name="hello with spaces"`
`prefix="hello-prefix"`	`prefix="hello-prefix"`
`namespace="http://www.mulesoft.org/schema/a/different/path/mule/hello"`	`namespace="http://www.mulesoft.org/schema/a/different/path/mule/hello"`

生成されたスキーマの場所: `http://www.mulesoft.org/schema/a/different/path/mule/hello/current/mule-hello-prefix.xsd`

Table 8. <module> で `name` と `prefix` を提供する
提供された値	生成された値
`name="hello with spaces"`	`name="hello with spaces"`
`prefix="hello-prefix"`	`prefix="hello-prefix"`
なし	`namespace=http://www.mulesoft.org/schema/mule/hello-prefix`

生成されたスキーマの場所: `http://www.mulesoft.org/schema/mule/hello-prefix/current/mule-hello-prefix.xsd`

Table 9. <module> で `name` のみを提供する
提供された値	生成された値
`name="hello with spaces"`	`name="hello with spaces"`
なし	`prefix="hello-with-spaces"`
なし	`namespace=http://www.mulesoft.org/schema/mule/hello-with-spaces`

生成されたスキーマの場所は `http://www.mulesoft.org/schema/mule/hello-with-spaces/current/mule-hello-with-spaces.xsd` です。 ### [](#prefix-attribute)プレフィックス属性 `prefix` 属性は、スキーマを生成するときに使用するモジュールのプレフィックスです。空の場合、モジュールでは XML SDK `name` 属性のハイフン付きバージョンが使用されます。 `prefix` 属性の値は、リソースファイルを含むフォルダーの名前と相関関係があります。そのため、この値を設定するかどうかは、リソースフォルダーの名前に影響します。カスタム名でプレフィックスを設定する場合は、カスタムプレフィックス名と一致するようにリソースフォルダーの名前を変更する必要があります。次のモジュールには `name` 属性 `name="hello with spaces"` のみがあります。つまり、その `prefix` は `hello-with-spaces` として動的に生成され、その `namespace` は `http://www.mulesoft.org/schema/mule/hello-with-spaces/current/mule-hello-with-spaces.xsd` として動的に生成されます。また、Mule アプリケーションには該当の値に一致する参照をポイントするスキーマの場所 (`schemaLocation`) が必要であることも意味します。 ```xml ``` 上記のこの `hello with spaces` モジュールを Mule アプリケーションで使用できます。次に例を示します。 ```xml

``` ## [](#xml-sdk-プロジェクトの作成およびテスト)XML SDK プロジェクトの作成およびテスト XML SDK Module を作成する手順は、次のとおりです。 1. MuleSoft リポジトリを自分の Maven (`mvn`) 設定ファイルに追加します。 ```text Mule true mulesoft-releases MuleSoft Repository http://repository.mulesoft.org/releases/ default ``` 2. Maven (`mvn`) を使用して、次のコマンドを実行します。 ```text mvn archetype:generate \ -DarchetypeGroupId=org.mule.extensions \ -DarchetypeArtifactId=mule-extensions-xml-archetype \ -DarchetypeVersion=1.2.0 \ -DgroupId=org.mule.extension \ -DartifactId=hello-mule-extension \ -DmuleConnectorName=Hello ```

上記のコネクタ名は Hello のため、モジュールの名前空間は、prefix 属性で設定されているように module-hello に自動的に設定されます。

3. 値が正しいかどうかを示すように要求するメッセージが表示されたら、`enter` を押して続行します。 Maven アーキタイプでは、XML SDK Module の最小限のコードと、それを実行するための機能テストを含むスタブプロジェクトが作成されます。このプロジェクトの構造は次のようになります。 ```text ➜ hello-mule-extension tree . . ├── pom.xml └── src ├── main │ └── resources │ └── org │ └── mule │ └── yourdomain │ └── module-Hello.xml (1) └── test └── munit └── assertion-munit-test.xml (2) 8 directories, 3 files ``` (1) `hello-mule-extension/src/main/resources/org/mule/yourdomain/module-Hello.xml`: XML SDK ルート要素を定義します。 (2) `hello-mule-extension/src/test/munit/assertion-munit-test.xml`: XML SDK 操作をコールするアサーション操作。 4. `/hello-mule-extension` 内で `mvn clean install` を実行し、`Hello XML SDK` モジュール用のプラグインを作成します。このコマンドでは、親プロジェクトに加えてその子プロジェクトもインストールされます。また、モジュールで定義された操作の MUnit を介してスイートも実行されます。 ```text ➜ hello-mule-extension mvn clean install ... .. . ================================================================================== Number of tests run: 2 - Failed: 0 - Errors: 0 - Skipped: 0 - Time elapsed: 2246ms ================================================================================== [INFO] ==================================================================================== [INFO] MUnit Run Summary - Product: MULE, Version: 4.1.1 [INFO] ==================================================================================== [INFO] >> assertion-munit-test.xml test result: Tests: 2, Errors: 0, Failures: 0, Skipped: 0 [INFO] [INFO] ==================================================================================== [INFO] > Tests: 2 [INFO] > Errors: 0 [INFO] > Failures: 0 [INFO] > Skipped: 0 [INFO] ==================================================================================== .... ... .. [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 39.166 s [INFO] Finished at: 2017-06-14T22:07:42-03:00 [INFO] Final Memory: 61M/928M [INFO] ------------------------------------------------------------------------ ➜ hello-smart-connector ``` (3) このコネクタをテストのためにローカルの Maven リポジトリからプロジェクトに追加する場合、次の連動関係を追加します。 org.mule.extension hello-mule-extension 1.0.0-SNAPSHOT mule-plugin \+ これで、このコネクタを Studio パレットから使用できるようになりました。 + ## [](#set-custom-icon)コネクタへのカスタムアイコンの追加コネクタアイコンは .svg 形式のファイルです。コネクタのアイコンをカスタマイズするには、カスタムアイコンが含まれる `icon.svg` ファイルをコネクタツリーのルートにある `icon` フォルダーの下に追加します。次の画像はアイコンのフォルダー構造の例を示しています。 ![コネクタのルートディレクトリには、icon.svg ファイルが含まれる icon という名前のフォルダーがあります。](/mulesoft/current/ja-jp/mule-sdk/1.1/_images/icon-svg-change.png) カスタムアイコンをコネクタに追加したら、アイコンは Anypoint Exchange と Anypoint Studio に表示されます。 ## [](#xml-sdk-module-からの-mule-プラグインのコンシューム)XML SDK Module からの Mule プラグインのコンシューム XML SDK Module 内から Mule プラグインをコンシュームする手順は、次のとおりです。 1. 連動関係を XML SDK Module の POM ファイルに追加します。たとえば、XML SDK Module で HTTP Connector と OAuth Module を使用するには、POM に次の連動関係を含める必要があります。 ```xml org.mule.connectors mule-http-connector 1.2.1 mule-plugin compile org.mule.modules mule-oauth-module 1.1.2 mule-plugin compile ``` 2. スキーマの場所を `` ルート要素に追加します。次に例を示します。 ```xml ... ``` ## [](#操作の再利用)操作の再利用場合によって、繰り返されるメッセージプロセッサーが操作に含まれることがあります。このメッセージプロセッサーが新しい操作でカプセル化され、他の場所からコールされている場合、このメッセージプロセッサーに依存できます。操作に循環連動関係がない場合、`` で定義された各 `` を_同じ_ `` 内で再利用できます。たとえば、挿入や更新を実行する前に `` で入力パラメーターを検証するとします。次の例では、検証が操作 `validate-and-insert` および `validate-and-update` 内で繰り返されています。 ```xml INSERT INTO PLANET(NAME) VALUES (:name)

#[{ 'name' : vars.name }]

update PLANET set NAME= :newName where NAME=':originalName'

#[{'originalName' : vars.originalName, 'newName' : vars.newName}]

``` 前述の例のこのプロセスを簡素化するには、他の操作からコールする `validate` 操作を追加することができます。次に例を示します。 ```xml ``` `` 内から他の操作をコンシュームする手順は、次のとおりです。 1. XML 名前空間の `xmlns:tns` 属性と `schemaLocation` の新しい値を `` に追加します。値は現在のモジュールの対象の名前空間をマップする必要があります。 2. 操作の名前の前に `tns` プレフィックスを付けて操作をコールします。完全なモジュールは次のようになります。 ```xml INSERT INTO PLANET(NAME) VALUES (:name)

#[{ 'name' : vars.name }]

update PLANET set NAME= :newName where NAME=':originalName'

#[{'originalName' : vars.originalName, 'newName' : vars.newName}]

``` `config-ref` は_同じ_モジュールへの参照であるために含まれていません。つまり、すべてのグローバルインスタンスが操作間で共有されることを意味します。 ## [](#操作内の操作の再利用)操作内の操作の再利用 `use=CONTENT` [コンテンツパラメーター](https://docs.mulesoft.com/jp/mule-sdk/1.1/content-parameters)を使用して別の操作内の操作を再利用するには、内部タグ名の `use=CONTENT` パラメーターを参照します。 `use=CONTENT` を使用してその `requiredParameter` パラメーターを定義する `shared-operation` 操作があるとします。別の操作 `sample-operation` は、次のように独自の定義内で `shared-operation` を再利用します。 ```xml

#[vars.required-Parameter]

```

パラメーターである requiredParameter はキャメルケースの命名規則を使用していますが、参照である vars.required-Parameter はケバブケースの命名規則を使用しています。パラメーターや操作に名前を付けるときは、ケバブケースの命名規則を使用してプロジェクトの一貫性を維持します。XML SDK の制限事項を参照してください。

`requiredParameter` 値は、`sample-operation` の内部タグとして参照される必要があります。それ以外の場合、プロジェクトは `Attribute 'required-parameter' is not allowed to appear in element 'tns:shared-operation'.` などのビルドエラーをスローします。コネクタの XML 定義は、内部タグとして `use=CONTENT` を使用して設定されたパラメーターを生成します。`content` というパラメーターが内部タグ `` として `use=CONTENT` に設定されている [File Connector](https://docs.mulesoft.com/jp/mule-sdk/1.1/content-parameters#content-param) を参照してください。 ## [](#テスト接続の提供)テスト接続の提供設計時には、グローバル要素の属性に間違った値 (間違ったユーザー名やパスワード、不適切な URL など) が提供された場合にフィードバックを提供すると便利です。このフィードバックを提供するには、接続テストをサポートするグローバル要素をモジュールに組み込む必要があります。たとえば、`file:connection` 要素をモジュールに組み込むことで、XML SDK Module `` で File Connector からの接続テスト機能を使用できます。デフォルトでは、モジュールはファイル設定から接続テスト機能を取得し、サポートします。 ```xml ``` 接続テストは、UI から、`fileConfig` でカプセル化されたグローバル要素に委任されます。テスト接続を提供する 2 つ以上のグローバル要素がモジュールに含まれる場合、使用するグローバル要素を `xmlns:connection="true"` 属性でマークしていないと、モジュールを作成したときにエラーが発生します。次に例を示します。 ```xml ```

xmlns:connection="true" を使用して複数のグローバル要素をマークすると、1 つしか許容されないため、コンパイルに失敗します。

## [](#エラーの処理)エラーの処理場合によって、`` 内の操作により、そのままの形で伝播すべきでないエラーコードがスローされることがあります。この場合、エンドユーザーにとってわかりやすいものにコードを再マップする必要があります。また、問題が `` 内の条件に関連する場合があります。前者の場合、XML SDK は[エラーマッピング](#4.1@mule-runtime::mule-error-concept.adoc#about-error-mappings)を使用します。後者の場合、[Raise Error コンポーネント](#4.1@mule-runtime::raise-error-component-reference.adoc)が使用されます。次の例は、2 つの数値を除算する操作でエラーマッピングを実行します。 ```xml ...

``` 除数 `numberB` がゼロの場合、`div` 操作は `MULE:EXPRESSION` ランタイムエラーになりますが、エラーの詳細が十分に説明されていません。より詳細なエラーを作成するには、エラーマッピングを使用して、`div` 操作で `MATH-XML-SDK:DIVISION_BY_ZERO` エラーを生成することができます。次に例を示します。 ```xml ...

``` 式 `#[vars.numberA / vars.numberB]` の評価の前に検証を実行することで、同じエラーを生成できます。式が失敗した場合、`MATH-XML-SDK:DIVISION_BY_ZERO` エラーが発生します。次に例を示します。 ```xml ...

``` ## [](#xml_sdk_catalog)XML SDK カタログ `` と `` の標準データ型はプリミティブ型 (`string`、`boolean`、`number`、`date`、`datetime`、`localdatetime`、`time`、`localtime`、`timezone`、`binary`、`any`、`regex`) です。プリミティブ型よりも複雑な構造の型を定義するには、モジュールに挿入するデータ型のカタログを作成します。この例では、次のコンテンツのカタログファイル (`hello-smart-connector/smart-connector/src/main/resources/module-Hello-catalog.xml`) を作成します。 ```xml ``` このカタログファイルは XSD および JSON スキーマファイルを参照します。 - `person-schema.xsd`。次のコンテンツが含まれます。 ```xml ``` - `person-schema.json`。次のコンテンツが含まれます。 ```json { "type": "object", "properties": { "age": { "type": "integer" }, "name": { "type": "string" }, "lastname": { "type": "string" } }, "additionalProperties": false } ``` `tree hello-smart-connector/smart-connector` フォルダーの構造は次のようになります。 ```text ➜ ~ tree hello-smart-connector/smart-connector hello-smart-connector/smart-connector ├── pom.xml └── src └── main └── resources ├── module-Hello-catalog.xml ├── module-Hello.xml ├── person-schema.json └── person-schema.xsd ``` スキーマの準備ができたら、関連付けられたカタログ (`PersonXsdType` および `PersonJsonType`) を参照することで、定義された型を使用します。次に例を示します。 ```xml ...

``` JSON スキーマの `type` 属性の値が、そのスキーマ (`PersonJsonType`) を含むカタログの名前になっています。ただし、XML スキーマの場合、`type` 属性の値では 2 つのコロン `::` と qname (修飾名) 参照が `Person` 要素に付加されます (`PersonXsdType::{http://uri}Person`)。 JSON から XML への DataWeave 変換 (`` 内で示されている) を実行するには、モジュールで必須スキーマ (`mule-ee.xsd`) を見つけることができるように次の連動関係を POM ファイルに追加する必要があります。 ```xml com.mulesoft.mule.runtime.modules mule-module-spring-config-ee ${mule.version} provided ``` 上記の[例](#example)の操作を Mule アプリケーションで使用するには、値を操作に提供する必要があります。次に例を示します。 ```xml

``` プリミティブ型ではない値をパラメーター化すると、定義済みの `` で値を `role="CONTENT"` として宣言できるため、`` 内で追加のプロセッサーを使用して操作をコールする必要がなくなります。この例の `person-xml-to-json` 操作でこの属性を `content` パラメーターに追加します。 ```xml ...

... ``` 上記の[例](#example2)の操作を Mule アプリケーションで使用するには、値を操作に提供する必要があります。次に例を示します。 ```xml

.. ``` ## [](#xml-sdk-module-の稼働サンプル)XML SDK Module の稼働サンプル [https://github.com/mulesoft-labs/smart-connectors-integration-tests](https://github.com/mulesoft-labs/smart-connectors-integration-tests) には、次のディレクトリが含まれます。 - `apps-using-smart-connectors`: XML SDK Module を使用する Mule アプリケーション。 - `smart-connectors`: DataWeave、HTTP Connector、File Connector、Validation Module などを組み込む XML SDK Module。このいくつかの例を以下のサブセクションで説明します。 ### [](#module-using-core)例: コアコンポーネントの使用この例では、Set Payload (`mule:set-payload`) などのコアコンポーネントを組み込みます。 GitHub の場所: [smart-connectors/smart-connector-using-core](https://github.com/mulesoft-labs/smart-connectors-integration-tests/tree/master/smart-connectors/smart-connector-using-core) ```xml

``` ### [](#例-json-カスタム型の使用)例: JSON カスタム型の使用この例では JSON 型を組み込みます。 GitHub の場所: [smart-connectors/smart-connector-using-custom-types-json](https://github.com/mulesoft-labs/smart-connectors-integration-tests/tree/master/smart-connectors/smart-connector-using-custom-types-json) ```xml

``` カタログ ```xml ``` スキーマ ```json { "type": "object", "properties": { "number": { "type": "number" }, "street_name": { "type": "string" }, "street_type": { "type": "string", "enum": [ "Street", "Avenue", "Boulevard" ] } }, "additionalProperties": false } ``` ### [](#例-カスタム-xml-型の使用)例: カスタム XML 型の使用この例ではカスタム XML 型を組み込みます。 GitHub の場所: [smart-connectors/smart-connector-using-custom-types-xsd](https://github.com/mulesoft-labs/smart-connectors-integration-tests/tree/master/smart-connectors/smart-connector-using-custom-types-xsd) ```xml

``` カタログ ```xml ``` スキーマ 1 ```xml A user with all the information ``` ### [](#例-リソースのエクスポート)例: リソースのエクスポートこの例では、リソースがコネクタと共にエクスポートされてパッケージ化されるように、リソースをプロジェクトに追加する方法を説明します。 GitHub の場所: [smart-connectors/smart-connector-exporting-resources](https://github.com/mulesoft-labs/smart-connectors-integration-tests/tree/master/smart-connectors/smart-connector-exporting-resources) 目的はリソースをエクスポートして主要な Mule アプリケーションで使用できるようにすることです。このため、モジュールファイル `module-exporting-resources.xml` に機能は含まれません。 module-exporting-resources.xml ```xml ``` 次のリソースファイルがエクスポートされます。 myMappings.dwl ```text %dw 2.0 /****************************************************************************************************************************** NOTICE: This file, `dwModule.dwl`, must be referenced in the META-INF/mule-artifact/mule-artifact.json file to properly export the resource so that the the functions being consumed (`five()`, `echo(String)`, `toUpper(Person)`, `toUpper(Array): Array = persons map toUpper($) ``` リソースファイルは、モジュールの名前 ([メインモジュールファイル](#module-exporting-resources)で定義) にちなんだ名前が付けられた新しいフォルダー内に配置する**必要**があります。この例では、モジュールの名前は `module-exporting-resources` のため、フォルダーの名前は `module_exporting_resources` である必要があります。ハイフンはアンダースコアに置き換えられます。この新しいフォルダーまたはそのサブフォルダーに含まれるすべてのファイルが XML SDK により自動的にエクスポートされます。この例では、フォルダー構造は次のようになります。 ```text smart-connector-exporting-resources ├── pom.xml └── src └── main └── resources ├── module-exporting-resources.xml └── module_exporting_resources └── weirdFolder └── myMappings.dwl ``` 最終的に、エクスポートされたファイルを Mule フローで使用できます。この最初の例は、エクスポートされたファイルで定義されている dataweave 関数を使用する方法を示しています。 ```xml

``` この 2 番目の例は、たとえば、 [Parse Template](https://docs.mulesoft.com/mule-runtime/4.3/parse-template-reference) コンポーネントで使用される場所を介してファイルにアクセスする方法を示しています。 ```xml

``` ### [](#例-dataweave-の使用)例: DataWeave の使用この例では、Transform (`ee:transform`) コンポーネントを使用して DataWeave を組み込みます。 GitHub の場所: [smart-connectors/smart-connector-using-dw](https://github.com/mulesoft-labs/smart-connectors-integration-tests/tree/master/smart-connectors/smart-connector-using-dw) ```xml

``` ### [](#例-file-connector-の使用)例: File Connector の使用場所 `[smart-connectors/smart-connector-using-file](https://github.com/mulesoft-labs/smart-connectors-integration-tests/tree/master/smart-connectors/smart-connector-using-file)`: File Connector により異なる (`file:list` など) ```xml ``` ### [](#http-connector-の使用)HTTP Connector の使用この例では、HTTP 要求 (`http:requester`) を使用して HTTP Connector を組み込みます。 GitHub の場所: [smart-connectors/smart-connector-using-http](https://github.com/mulesoft-labs/smart-connectors-integration-tests/tree/master/smart-connectors/smart-connector-using-http) ```xml

``` ### [](#例-別の-xml-sdk-の使用)例: 別の XML SDK の使用この例は、XML SDK Module `module-using-core` (「[例: コアコンポーネントの使用](#module-using-core)」を参照) を使用する 1 つの XML SDK Module (`module-using-smart-connector`) を示しています。 GitHub の場所: [smart-connectors/smart-connector-using-smart-connector](https://github.com/mulesoft-labs/smart-connectors-integration-tests/tree/master/smart-connectors/smart-connector-using-smart-connector) ```xml

``` ### [](#validation-module-の使用)Validation Module の使用この例では、Validation Module、具体的には `validation:is-email` を使用します。 GitHub の場所: [smart-connectors/smart-connector-using-validation](https://github.com/mulesoft-labs/smart-connectors-integration-tests/tree/master/smart-connectors/smart-connector-using-validation) ```xml

``` ## [](#xml-sdk-limitations)XML SDK の制限事項現在、SDK には次の制限事項があります。 - XML SDK では、ソース (`` など) やルーターではなくアウトバウンド操作のみが提供されます。 - 操作では、再帰的コールはサポートされません。 - `name` や `config-ref` は予約済みのキーワードであるため、操作ではこれらの名前のパラメーターを使用できません。 - ケバブケースの命名規則を使用すると、名前値の変換時に単語間にハイフンが挿入されるため、XML SDK プロジェクトでパラメーターや操作に名前を付けるときにケバブケースの命名規則を使用すると、XML タグの生成中にエラーが生じることがありません。