この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

FlowTest

フローテストに関連付けられたメタデータを表します。レコードトリガーフローを有効化する前に、フローをテストして、予期される結果を確認してフローの実行時エラーを特定することができます。

親種別

Metadata メタデータ型を拡張し、その fullName 項目を継承します。

ファイルのサフィックスおよびディレクトリの場所

FlowTest コンポーネントのサフィックスは .flowtest で、flowtests フォルダーに保存されます。

バージョン

FlowTest コンポーネントは、API バージョン 55.0 以降で使用できます。

特別なアクセスルール

この種別に固有のアクセス要件は他にありません。

項目

項目名	説明
description	項目の型 string 説明フローテストで何が行われるのか、フローテストはどのように機能するのかといったフローテストの説明。
flowApiName	項目の型 string 説明必須。フローテストに関連付けられたフローの API 参照名。
label	項目の型 string 説明必須。フローテストの表示ラベル。
testPoints	項目の型 FlowTestPoint[] 説明テスト用のテストポイントの配列。

FlowTestPoint

フローテストの実行時に評価されるフローテストポイントを定義します。各テストポイントは、リストの順序で評価されます。

項目名	説明
assertions	項目の型 FlowTestAssertion[] 説明テスト用のアサーションの配列。
elementApiName	項目の型 string 説明必須。フロー開始時およびフロー終了時の要素の API 参照名。可能な値は次のとおりです。 `Start` `Finish`
parameters	項目の型 FlowTestParameter[] 説明テスト用のパラメーターの配列。

FlowTestAssertion

フローテストの実行時に評価されるテストポイントのアサーションを定義します。1 つのアサーションが false に評価されると、テスト実行は失敗します。

項目名	説明
conditions	項目の型 FlowTestCondition[] 説明アサーションの条件の配列。
errorMessage	項目の型 string 説明関連する条件が false に評価された場合に Flow Builder に表示されるカスタムメッセージ。

FlowTestCondition

フローテストの実行時に評価されるアサーションの条件を定義します。1 つの条件が false に評価されると、アサーションは失敗します。

項目名	説明
leftValueReference	項目の型 string 説明必須。指定した演算子が適用されるフローのリソースへの参照。
operator	項目の型 FlowComparisonOperator (string 型の列挙) 説明必須。 leftValueReference 項目のリソースの参照に適用される操作。可能な値は次のとおりです。 `Contains` `EndsWith` `EqualTo` `GreaterThan` `GreaterThanOrEqualTo` `IsChanged` `IsNull` `LessThan` `LessThanOrEqualTo` `NotEqualTo` `StartsWith` `WasSelected` `WasSet` `WasVisited` `In` — この値は API バージョン 56.0 以降で使用できます。 `NotIn` — この値は API バージョン 56.0 以降で使用できます。
rightValue	項目の型 FlowTestReferenceOrValue 説明演算子によって leftValueReference 項目のリソースの参照に適用される値。

FlowTestReferenceOrValue

演算子によってフローテストアサーションおよび条件のリソースの参照に適用される特定の値を定義します。

項目名	説明
booleanValue	項目の型 boolean 説明 Boolean 値を指定します。
dateTimeValue	項目の型 dateTime 説明 dateTime 値を指定します。
dateValue	項目の型 date 説明 dateValue 値を指定します。
numberValue	項目の型 double 説明数値を指定します。
sobjectValue	項目の型 string 説明 sObject 値を指定します。
stringValue	項目の型 string 説明文字列値を指定します。

FlowTestParameter

開始テストポイントのトリガーレコードのパラメーターを定義します。

項目名	説明
leftValueReference	項目の型 string 説明必須。パラメーターの名前。type が `InputTriggeringRecordInitial` または `InputTriggeringRecordUpdated` の場合、leftValueReference の値は `$Record` でなければなりません。type が `ScheduledPath` の場合、leftValueReference の値は `ScheduledPathApiName` でなければなりません。
type	項目の型 FlowTestParameterType (string 型の列挙) 説明必須。パラメーターの種別。可能な値は次のとおりです。 `InputTriggeringRecordInitial` `InputTriggeringRecordUpdated` `ScheduledPath` — API バージョン 56.0 以降で使用できます。
value	項目の型 FlowTestReferenceOrValue 説明必須。演算子によって leftValueReference 項目のリソースの参照に適用される値。

宣言的なメタデータの定義のサンプル

FlowTest コンポーネントの例を次に示します。

1<?xml version="1.0" encoding="UTF-8"?>
2<FlowTest xmlns="http://soap.sforce.com/2006/04/metadata">
3    <flowApiName>Example_Test</flowApiName>
4    <label>Test Two</label>
5    <testPoints>
6        <elementApiName>Start</elementApiName>
7        <parameters>
8            <leftValueReference>$Record</leftValueReference>
9            <type>InputTriggeringRecordInitial</type>
10            <value>
11                <sobjectValue>{&quot;AnnualRevenue&quot;:100000,&quot;BillingCity&quot;:&quot;New York&quot;}}</sobjectValue>
12            </value>
13        </parameters>
14        <parameters>
15            <leftValueReference>ScheduledPathApiName</leftValueReference>
16            <type>ScheduledPath</type>
17            <value>Every_Monday</value>
18        </parameters>
19        <parameters>
20            <leftValueReference>$Record</leftValueReference>
21            <type>InputTriggeringRecordUpdated</type>
22            <value>
23                <sobjectValue>{&quot;AnnualRevenue&quot;:100000,&quot;BillingCity&quot;:&quot;New York&quot;}</sobjectValue>
24            </value>
25        </parameters>
26    </testPoints>
27    <testPoints>
28        <assertions>
29            <conditions>
30                <leftValueReference>$Record.Industry</leftValueReference>
31                <operator>EqualTo</operator>
32                <rightValue>
33                    <stringValue>Other</stringValue>
34                </rightValue>
35            </conditions>
36            <errorMessage>Industry was not set.</errorMessage>
37        </assertions>
38        <elementApiName>Finish</elementApiName>
39    </testPoints>
40</FlowTest>

前の定義を参照する package.xml の例を次に示します。

1<?xml version="1.0" encoding="UTF-8"?>
2<Package xmlns="http://soap.sforce.com/2006/04/metadata">
3<types>
4<members>Test_Two</members>
5<name>FlowTest</name>
6</types>
7<version>55.0</version>
8</Package>

マニフェストファイル内のワイルドカードのサポート

このメタデータ型では、package.xml マニフェストファイル内のワイルドカード文字 * (アスタリスク) がサポートされます。マニフェストファイルの使用についての詳細は、「zip ファイルを使用したメタデータのリリースと取得」を参照してください。

メタデータ API 開発者ガイド