--- schema_version: "1" id: 8f8300c86c2549a06e2fe78907e09106253199298adbd6dca9c1ed2534993a2c title: Validation Module 2.0 の例 collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/validation-connector/latest/validation-examples.md canonical_url: https://docs.mulesoft.com/jp/validation-connector/latest/validation-examples source_site: docs.mulesoft.com content_type: documentation content_hash: 508659cd1b75b97ec308f53453a51ac59991bfe20a1f3a57eb870a6a50b62271 description: MuleSoft Documentation Site release: "2.0" latest: true --- # Validation Module 2.0 の例 次の例は、Anypoint Studio と XML エディターの両方で Validation Module によってサポートされる操作を設定する方法を示しています。 ## [](#is-ip-操作を設定する)Is IP 操作を設定する **Is IP**​ 操作では、特定の IP アドレスが有効であることを検証します。IPV4 アドレスと IPV6 アドレスの両方がサポートされています。IPV6 の場合は、この操作では完全表記と省略表記の両方のアドレスがサポートされますが、ポートが含まれるアドレスはサポートされません。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Is IP\]**​ を選択します。 2. **\[Is IP\]**​ を Studio キャンバスにドラッグします。 3. **\[Is IP\]**​ 設定画面で、次のパラメーターを設定します。 - **Ip**​: `payload` - **Message**​: `The value provided is not a valid IP address.` ![Is IP の設定](/mulesoft/current/ja-jp/validation-connector/latest/_images/validation-isip.png) Figure 1. Is IP の設定 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#is-url-操作を設定する)Is URL 操作を設定する **Is URL**​ 操作では、特定の文字列が URL として解釈できることを検証します。検証は ​`java.net.URL`​ クラスの URL (文字列) コンストラクターを呼び出すことによって行われます。このコンストラクターで例外がスローされた場合、検証は失敗します。このコンストラクターが受け入れたすべての文字列は有効と見なされます。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Is URL\]**​ を選択します。 2. **\[Is URL\]**​ を Studio キャンバスにドラッグします。 3. **\[Is URL\]**​ 設定画面で、​**\[URL\]**​ 項目を ​`vars.callbackUrl`​ に設定します。 ![Is URL の設定](/mulesoft/current/ja-jp/validation-connector/latest/_images/validation-isurl.png) Figure 2. Is URL の設定 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#is-blank-string-操作を設定する)Is blank string 操作を設定する **Is blank string**​ 操作では、指定された値が空の文字列であることを検証します。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Is blank string\]**​ を選択します。 2. **\[Is blank string\]**​ を Studio キャンバスにドラッグします。 3. **\[Is blank string\]**​ 設定画面で、​**\[Value (値)\]**​ 項目を ​`payload`​ に設定します。 ![Is blank string の設定](/mulesoft/current/ja-jp/validation-connector/latest/_images/validation-isblankstring.png) Figure 3. Is blank string の設定 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#is-elapsed-操作を設定する)Is elapsed 操作を設定する **Is elapsed**​ 操作では、指定された初期時刻から特定の時間が経過していることを検証します。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Is elapsed\]**​ を選択します。 2. **\[Is elapsed\]**​ を Studio キャンバスにドラッグします。 3. **\[Is elapsed\]**​ 設定画面で、次のパラメーターを設定します。 - **Time**​: `20` - **Time unit (時間単位)**​: `SECONDS` - **Since**​: `vars.initialTime` ![Is elapsed の設定](/mulesoft/current/ja-jp/validation-connector/latest/_images/validation-iselapsed.png) Figure 4. Is elapsed の設定 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#is-email-操作を設定する)Is email 操作を設定する **Is email**​ 操作では、特定のメールが有効であることを検証します。値のデフォルトはメールペイロードです。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Is email\]**​ を選択します。 2. **\[Is email\]**​ を Studio キャンバスにドラッグします。 3. **\[Is email\]**​ 設定画面で、次のパラメーターを設定します。 - **Email**​: `vars.email` - **Message**​: `The value is not a valid email.` ![Is email の設定](/mulesoft/current/ja-jp/validation-connector/latest/_images/validation-isemail.png) Figure 5. Is email の設定 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#is-empty-collection-操作を設定する)Is empty collection 操作を設定する **Is empty collection**​ 操作では、指定された値が空のコレクションであることを検証します。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Is empty collection\]**​ を選択します。 2. **\[Is empty collection\]**​ を Studio キャンバスにドラッグします。 3. **\[Is empty collection\]**​ 設定画面で、​**\[Value (値)\]**​ 項目を ​`payload`​ に設定します。 ![Is empty collection の設定](/mulesoft/current/ja-jp/validation-connector/latest/_images/validation-isemptycollection.png) Figure 6. Is empty collection の設定 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#is-false-操作を設定する)Is false 操作を設定する **Is false**​ 操作では、式が ​`false`​ に評価されることを検証します。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Is false\]**​ を選択します。 2. **\[Is false\]**​ を Studio キャンバスにドラッグします。 3. **\[Is false\]**​ 設定画面で、​**\[Expression (式)\]**​ 項目に ​`Expression`​ を選択し、空の項目に ​`#[vars.withFailures]`​ を追加します。 ![Is false collection の設定](/mulesoft/current/ja-jp/validation-connector/latest/_images/validation-isfalse.png) Figure 7. Is false の設定 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#is-not-denied-ip-操作を設定する)Is Not Denied IP 操作を設定する **Is not denied ip**​ 操作では、特定の IP が拒否 IP リストに登録されていないことを検証します。IP 検索条件リストは、アプリケーション内でグローバルに定義することも、各バリデーターのインラインで定義することもできます。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Is not denied ip\]**​ を選択します。 2. **\[Is not denied ip\]**​ を Studio キャンバスにドラッグします。 3. **\[Is not denied ip\]**​ 設定画面で、次のパラメーターを設定します。 - **Ip address (IP アドレス)**​: `vars.ip` - **Deny list (拒否リスト)**​: `Edit inline` - **Ips**​: `Edit inline` 4. プラス記号 (​**+**​) をクリックして IP 値ウィンドウを開きます。 5. **\[Value (値)\]**​ 項目を ​`Valid IP`​ に設定します。 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#is-not-blank-string-操作を設定する)Is not blank string 操作を設定する **Is not blank string**​ では、指定された値が空の文字列でないことを検証します。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Is not blank string\]**​ を選択します。 2. **\[Is not blank string\]**​ を Studio キャンバスにドラッグします。 3. **\[Is not blank string\]**​ 設定画面で、次のパラメーターを設定します。 - **Value (値)**​: `payload` - **Message (メッセージ)**​: `The username cannot be blank` ![Is not blank string の設定](/mulesoft/current/ja-jp/validation-connector/latest/_images/validation-isnotblankstring.png) Figure 8. Is not blank string の設定 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#is-not-elapsed-time-操作を設定する)Is not elapsed time 操作を設定する **Is not elapsed**​ 操作では、指定された初期時刻から特定の時間が経過していないことを検証します。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Is not elapsed\]**​ を選択します。 2. **\[Is not elapsed\]**​ を Studio キャンバスにドラッグします。 3. **\[Is not elapsed\]**​ 設定画面で、次のパラメーターを設定します。 - **Time**​: `20` - **Time unit (時間単位)**​: `SECONDS` - **Since**​: `vars.time` ![Is not elapsed time の設定](/mulesoft/current/ja-jp/validation-connector/latest/_images/validation-isnotelapsed.png) Figure 9. Is not elapsed time の設定 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#is-not-empty-collection-操作を設定する)Is not empty collection 操作を設定する **Is not empty collection**​ パラメーターでは、値が空のコレクションでないことを検証します。この値のデフォルトはペイロードです。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Is not empty collection\]**​ を選択します。 2. **\[Is not empty collection\]**​ を Studio キャンバスにドラッグします。 3. **\[Is not empty collection\]**​ 設定画面で、​**\[Value (値)\]**​ 項目を ​`payload`​ に設定します。 ![Is not empty collection の設定](/mulesoft/current/ja-jp/validation-connector/latest/_images/validation-isnotemptycollection.png) Figure 10. Is not empty collection の設定 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#is-not-null-操作を設定する)Is not null 操作を設定する **Is not null**​ 操作では、指定された値が ​`null`​ でないことを検証します。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Is not null\]**​ を選択します。 2. **\[Is not null\]**​ を Studio キャンバスにドラッグします。 3. **\[Is not null\]**​ 設定画面で、次のパラメーターを設定します。 - **Value (値)**​: `payload` - **Message (メッセージ)**​: `Null is not a valid value` ![Is not null の設定](/mulesoft/current/ja-jp/validation-connector/latest/_images/validation-isnotnull.png) Figure 11. Is not null の設定 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#is-null-操作を設定する)Is null 操作を設定する **Is null**​ 操作では、指定された値が ​`null`​ であることを検証します。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Is null\]**​ を選択します。 2. **\[Is null\]**​ を Studio キャンバスにドラッグします。 3. **\[Is null\]**​ 設定画面で、​**\[Value (値)\]**​ 項目を ​`payload`​ に設定します。 ![Is null の設定](/mulesoft/current/ja-jp/validation-connector/latest/_images/validation-isnull.png) Figure 12. Is null の設定 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#is-number-操作を設定する)Is number 操作を設定する **Is number**​ 操作では、指定されたロケール (デフォルトはシステムロケール) とパターン (デフォルトはロケールパターン) を使用して、文字列を特定の数値型として解析できることを検証します。この検証には、​**Min value (最小値)**​ パラメーターと ​**Max Value (最大値)**​ パラメーターを使用して数値を検証する範囲を含めることができます。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Is number\]**​ を選択します。 2. **\[Is number\]**​ を Studio キャンバスにドラッグします。 3. **\[Is number\]**​ 設定画面で、次のパラメーターを設定します。 - **Value (値)**​: `payload` - **Locale**​: `US` - **Min value (最小値)**​: `vars.minValue` - **Max value (最大値)**​: `vars.maxValue` - **Number type (数値型)**​: `INTEGER` ![Is number の設定](/mulesoft/current/ja-jp/validation-connector/latest/_images/validation-isnumber.png) Figure 13. Is number の設定 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#is-time-操作を設定する)Is time 操作を設定する **Is time**​ 操作では、時刻が指定されたパターンとロケールに対して有効であることを検証します。パターンが指定されていない場合は、ロケールのデフォルトが使用されます。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Is time\]**​ を選択します。 2. **\[Is time\]**​ を Studio キャンバスにドラッグします。 3. **\[Is time\]**​ 設定画面で、次のパラメーターを設定します。 - **Time**​: `payload` - **Locale**​: `h:mm a` - **Pattern**​: `UK` ![Is time の設定](/mulesoft/current/ja-jp/validation-connector/latest/_images/validation-istime.png) Figure 14. Is time の設定 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#is-true-操作を設定する)Is true 操作を設定する **Is true**​ 操作では、式が ​`true`​ に評価されることを検証します。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Is true\]**​ を選択します。 2. **\[Is true\]**​ を Studio キャンバスにドラッグします。 3. **\[Is true\]**​ 設定画面で、​**\[Expression (式)\]**​ 項目に ​`Expression`​ を選択し、空の項目に ​`#[vars.doReply]`​ を追加します。 ![Is true の設定](/mulesoft/current/ja-jp/validation-connector/latest/_images/validation-istrue.png) Figure 15. Is true の設定 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#is-allowed-ip-操作を設定する)Is Allowed IP 操作を設定する **Is allowed ip**​ 操作では、特定の IP が許可リストに登録されていることを検証します。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Is allowed ip\]**​ を選択します。 2. **\[Is allowed ip\]**​ を Studio キャンバスにドラッグします。 3. **\[Is allowed ip\]**​ 設定画面で、次のパラメーターを設定します。 - **Ip address (IP アドレス)**​: `#[payload]` - **Allow List (許可リスト)**​: `Edit inline` - **Ips**​: `Edit inline` 4. プラス記号 (​**+**​) をクリックして IP 値ウィンドウを開きます。 5. **\[Value (値)\]**​ を ​`Valid IP`​ に設定します。 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#configure-the-matches-regex-operation)Matches regex 操作を設定する **Matches regex**​ 操作では、特定の式が Java の正規表現と一致することを検証します。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Matches regex\]**​ を選択します。 2. **\[Matches regex\]**​ を Studio キャンバスにドラッグします。 3. **\[Matches regex\]**​ 設定画面で、​**\[Expression (式)\]**​ 項目に ​`Expression`​ を選択し、空の項目に ​`#[vars.doReply]`​ を追加します。 ![Matches regex の設定](/mulesoft/current/ja-jp/validation-connector/latest/_images/validation-matchesregex.png) Figure 16. Matches regex の設定 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#validate-size-操作を設定する)Validate size 操作を設定する **Validate size**​ 操作では、入力サイズが指定された最小値と最大値の間であることを検証します。 文字列、コレクション、マップ、および配列の入力に対して有効です。文字列の場合、サイズは文字数を意味します。 次の例は、Anypoint Studio で操作を設定する方法を示しています。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[Validate size\]**​ を選択します。 2. **\[Validate size\]**​ を Studio キャンバスにドラッグします。 3. **\[Validate size\]**​ 設定画面で、次のパラメーターを設定します。 - **Value (値)**​: `payload` - **Min**​: `vars.minLength` - **Max**​: `vars.maxLength` ![Validate size の設定](/mulesoft/current/ja-jp/validation-connector/latest/_images/validation-validatesize.png) Figure 17. Validate size の設定 **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#all-すべて-スコープの設定)\[All (すべて)\] スコープの設定 **\[All (すべて)\]**​ スコープでは、ネストされた検証操作のリストを評価し、すべてのエラーを要約した ​`VALIDATION:MULTIPLE`​ エラーを 1 つだけ返すことができます。 複数の条件を評価する必要がある場合に、同時にいくつかの検証に失敗することもあります。こうした場合、すべての説明が含まれる 1 つのエラーを生成します。​**\[All (すべて)\]**​ スコープバリデーターには、次のような性質があります。 - すべてに失敗してもすべての検証が実行されます。 - 一部の検証に失敗すると、1 つのエラーがスローされます。例外には複数行のメッセージが含まれ、各行は失敗した検証に対応します。 - バリデーターはフローのスレッドを使用して順次実行されますが、バリデーターでは副作用が発生しないため、順序は重要ではありません。 - 他の検証操作とは異なり、​**\[All (すべて)\]**​ スコープバリデーターでは ​`validation:exception`​ または例外のファクトリー要素を使用して例外種別やメッセージをカスタマイズできません。ただし、検証内操作のメッセージはカスタマイズできます。
All​ および ​Any​ スコープは、ネストされた検証操作を評価するときに、ネストされた操作が ​VALIDATION​ 種別の操作でないと ​VALIDATION:MULTIPLE​ エラーを返します。​All​ または ​Any​ スコープ内でネストされた操作を使用する場合、​VALIDATION:MULTIPLE​ エラーが返されないように、スコープの ​[Error Mapping (エラーのマッピング)]​ 設定でエラーのマップ先を変更できます。
次の例は、Anypoint Studio で次の内容を同時に検証する ​**\[All (すべて)\]**​ スコープバリデーターを設定する方法を示しています。 - 名と姓が空の文字列でない。 - 年齢が 18 より大きい有効な整数である。 - メールアドレスが有効である。 - 社会保障番号の長さが適切で、正規表現と一致する。 Studio で ​**\[All (すべて)\]**​ スコープを設定する手順は、次のとおりです。 1. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Validation (検証)\] > \[All (すべて)\]**​ を選択します。 2. **\[All (すべて)\]**​ を Studio キャンバスにドラッグします。 3. **\[Is not empty collection\]**​ 操作をフローの ​**\[All (すべて)\]**​ スコープにドラッグします。 4. **\[Is not empty collection\]**​ 設定画面で、​**\[Value (値)\]**​ 項目を ​`#[payload.firstName]`​ に、​`Message`​ 項目を ​`First name cannot be empty`​ に設定します。 5. 別の ​**\[Is not empty collection\]**​ 操作を最初の ​**\[Is not empty collection\]**​ 操作の右にドラッグします。 6. **\[Is not empty collection\]**​ 設定画面で、​**\[Value (値)\]**​ 項目を ​`#[payload.lastName]`​ に、​`Message`​ 項目を ​`Last name cannot be empty`​ に設定します。 7. **\[Is number\]**​ 操作を 2 番目の ​**\[Is not empty collection\]**​ 操作の右にドラッグします。 8. **\[Is number\]**​ 設定画面で、次のパラメーターを設定します。 - **Value (値)**​: `payload.age` - **Min value (最小値)**​: `18` - **Number type (数値型)**​: `INTEGER` 9. **\[Message (メッセージ)\]**​ 項目を ​`Not an adult`​ に設定します。 10. **\[Is email\]**​ 操作を ​**\[Is number\]**​ 操作の右にドラッグします。 11. **\[Is email\]**​ 設定画面で、​**\[Email (メール)\]**​ 項目を ​`payload.email`​ に設定します。 12. **\[Matches regex\]**​ 操作を ​**\[Is email\]**​ 操作の右にドラッグします。 13. **\[Matches regex\]**​ 設定画面で、次のパラメーターを設定します。 - **Value (値)**​ `payload.ssn` - **Regex (正規表現)**​ `^(?!000|666)[0-8][0-9]{2}-(?!00)[0-9]{2}-(?!0000)[0-9]{4}$` 14. **\[Message (メッセージ)\]**​ 項目を ​`Invalid SSN`​ に設定します。 15. **\[Validate size\]**​ 操作を ​**\[Matches regex\]**​ 操作の右にドラッグします。 16. **\[Validate size\]**​ 設定画面で、次のパラメーターを設定します。 - **Value (値)**​: `payload.ssn` - **Min**​: `11` - **Max**​: `11` 17. **\[Message (メッセージ)\]**​ 項目を ​`SSN too short`​ に設定します。 ![「All (すべて)」 スコープのフロー](/mulesoft/current/ja-jp/validation-connector/latest/_images/validation-allscope.png) Figure 18. \[All (すべて)\] スコープのフロー **設定 XML**​ エディターでは、設定は次のように記述されます。 ```xml ``` ## [](#関連情報)関連情報 - [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors) - [MuleSoft ヘルプセンター](https://help.mulesoft.com)