レコードの作成要素
レコードコレクション変数を使用して、複数の Salesforce レコードを作成または更新します。1 つの Salesforce レコードのみを作成するには、レコード変数またはフローの他の値を使用します。
必要なエディション
| サポートされているエディションを表示する。 |
作成または更新するレコード数や項目値の設定方法によって、レコードの作成要素の残りの部分で入力する内容が決まります。
この動画では、データ要素を使用してフローでレコードを作成、更新、および削除する方法について説明します。
この動画は別のタブでご覧ください。
レコードのコレクションを作成する
複数のレコードを作成するには、レコードコレクション変数の値を使用する必要があります。フローの前半で、レコードコレクション変数に新しいレコードの項目値を入力します。ID 項目が空白であることを確認します。
コレクションの一部のレコードを動的に作成して他のレコードを更新するには、[Update Existing Records (既存のレコードを更新)] を有効にします。各レコードを一意に識別するレコードコレクション変数のレコードの項目を選択します。フローはこの項目を使用して、レコードが存在するかどうかを確認します。フローでレコードの作成または更新に失敗した場合の残りのレコードの処理方法を選択します。
レコードコレクション変数を使用して一度に複数のレコードを作成または更新する場合、フローの DML 要求の数を減らします。これにより、組織の制限を超える可能性が低くなります。詳細は、「トランザクションでのフローの一括処理」を参照してください。
1 つのレコードを作成する
レコード変数に新規レコードの項目値を入力している場合、レコード変数のすべての値を使用してレコード項目を設定します。次に、使用するレコード変数を選択します。ID 項目が空白であることを確認します。
レコードを動的に作成または更新するには、[Update Existing Records (既存のレコードを更新)] を有効にします。レコード変数で、レコードを一意に識別するレコードの項目を選択します。フローはこの項目を使用して、レコードが存在するかどうかを確認します。
フローのさまざまなリソースの値を手動で対応付けるには、個別の変数、リソース、リテラル値を使用してレコード項目を設定します。レコードを作成するオブジェクトを選択し、レコードの項目値を設定します。手動でテキスト変数を作成した場合は、必要に応じて、作成したレコードの ID をテキスト変数に保存します。たとえば、子レコードを作成したり、作成したレコードにリンクを提供したりするためにレコードの ID が必要になる場合があります。
更新または作成する重複レコードを動的にチェックするには、[Check for Matching Records (一致するレコードを確認)] を有効にします。
使用方法
フローがエラーになることを防止するには、次のことを確認します。
- すべての必須項目に値が入力されている。[レコードを作成] 要素では、必須項目が入力されます。表示される項目は、マスターレコードタイプで必須です。カスタムオブジェクトの場合、オブジェクト定義の必須項目を確認します。
- レコード変数の場合、ID 項目値は空白です。レコードが作成されると、フローで ID 項目が入力されます。
考慮事項
- [レコードを作成] 要素がレコードコレクションを使用し、障害パスがなく、フローが失敗すると、レコードは作成されず、フローは停止し、エラーが発生します。
- [レコードを作成] 要素でレコードコレクションが使用され、障害パスがある場合、成功したレコードのみが作成されます。フローのレコードコレクションのレコードでは、成功したレコードの ID は入力されません。ID は組織のレコードに入力されます。
- [レコードを作成] 要素では、編集がロックされている一致するレコードを更新できません。Flow Builder で一致するレコードが検出され、レコードの項目を更新しようとすると、警告が表示されます。
- [レコードを作成] 要素では、一致するレコードの参照のみの項目を更新できません。Flow Builder で一致するレコードが検出され、常に参照のみの項目または更新権限のない項目を更新しようとすると、警告が表示されます。
- [レコードを作成] 要素では、更新機能をサポートしていないオブジェクトの一致するレコードの項目を更新できません。Flow Builder で一致するレコードが検出され、更新機能をサポートしていないオブジェクトの項目を更新しようとすると、エラーが表示され、フローを有効化できません。オブジェクトを更新できるかどうかについては、「Object Reference for the Salesforce Platform (Salesforce Platform のオブジェクトリファレンス)」を参照してください。
- 重複レコードのチェック
レコードの重複を回避するには、一連の条件に一致するレコードを確認し、一致するレコードをフローで見つけた場合の処理を指定します。組織の一部の項目レベルの設定と入力規則は、[レコードを作成] 要素の設定を上書きします。
