フィールド

Avonni Dynamic Components パッケージは、Salesforce のデータをアプリおよびレコードページ上で直接表示・操作する強力な方法を提供します。Dynamic Component 内でデータフィールドにアクセスするには、Fields タブで いずれか するため、これはあまり一般的ではありません)。 ターゲットオブジェクト API 名 設定 a レコード変数 適切なオブジェクトタイプの。

概要

Fields タブを使うと、Salesforce フィールドをコンポーネントに簡単に追加でき、データにバインドされた要素を作成できます コードを書かずに。 以下のことができます:

  • レコードデータの表示: 特定の Salesforce レコードからフィールド値を表示します。

  • データ入力/編集の有効化: ユーザーがフィールド値を入力または変更できます。

  • アクションのトリガー: (例:レコード ID をフローに渡すなど)対話でレコードデータを使用します。

Fields パネルの場所

仕組み: フィールドへのアクセス

Fields タブは、キャンバスにデータバインドされたコンポーネントを追加する便利な方法を提供します。Fields タブを表示するには、次の2つのオプションがあります:

オプション 1: ターゲットオブジェクトの API 名(レコードページおよび一般的なオブジェクトアクセス用)

  1. 設定アイコンをクリック (Component Builder の左上)。

  2. ターゲットオブジェクトの API 名を設定 操作したい Salesforce オブジェクトの API 名に(例: Account, 取引先責任者(Contact), My_Custom_Object__c)。これは 通常 コンポーネントを配置するレコードページのオブジェクトです。

  3. を開きます コンポーネントライブラリ (左パネル)で Fields タブをクリックします。選択したオブジェクトのフィールド一覧が表示されます。

  4. ここからフィールドをドラッグすると、作成されたコンポーネントは特別な $Component.record 変数に自動的にバインドされ、現在のレコードのデータで事前に入力されます。

オプション 2: レコード変数(特定のレコードやカスタムロジック用)

  1. レコード変数を作成: 計算された数式 リソース パネルで新しい 変数 リソースを作成し、その データ型 最小(Min) Recordに設定します。レコードタイプに適した Salesforce オブジェクトを選択してください。

  2. レコード変数のデータを設定: 通常は "読み込み時" のインタラクションで "Get Records" アクションを使い、特定のレコードを取得してレコード変数に格納します。(詳細は "On Load Interaction" のドキュメントを参照してください。.

  3. を開きます コンポーネントライブラリ (左パネル)で Fields タブ。ここに、Record Variable のオブジェクトタイプに対応するフィールド一覧が表示されます。

  4. フィールドをドラッグすると、作成されたコンポーネントはあなたのレコード変数にバインドされます。

The $Component.record 変数

ターゲットオブジェクトの API 名を設定すると、Avonni Dynamic Components は特別な変数を自動的に利用可能にします: $Component.record.

  • レコードページ上の場合: Dynamic Component が レコードページ, $Component.record 上に配置されている場合、 現在のレコードのデータを含みます。例えば、 $Component.record.Name アカウントの名前はアカウントレコードページ上に保持されます。

  • レコードページ上でない場合: コンポーネントが でない 場合(例: App ページ上)、 $Component.record は空または未定義である可能性があります。このような場合、データを取得するためにしばしば Query Data Source を使用し、その データを 代わりに操作します。 $Component.record.

フィールドデータの保存または削除: インタラクションの使用

Fields タブを使用してフィールドを Dynamic Component のキャンバスにドラッグすると、それらは通常データにバインドされます(レコードページの Fields グローバル変数か特定のレコード変数リソースのいずれか)。これにより、ユーザーはテキスト入力やピックリストなどのコンポーネント内でデータを表示および必要に応じて編集できます。 $Component.record 重要な情報

キャンバス上でフィールドを編集しても、その変更が自動的に Salesforce に保存されるわけではありません。表示または入力されたこれらのフィールドのデータに基づいて、更新の保存、新規レコードの作成、レコードの削除などのアクションを実行するために、別途インタラクションを構成する必要があります。これらのインタラクションは多くの場合、

フィールドを操作可能にするために使用する主要なインタラクションは次のとおりです:

ユースケース:

  • レコード変数から更新:

    • 次を使用します: レコード変数にデータをロードしている場合( 特定のレコード変数 (" " > "Get Records" アクションを使用、またはさまざまな入力フィールドをそのフィールドにバインドして)その変数からの変更を保存したいとき。読み込み時その変数 から対応する Salesforce レコードへ戻して変更を保存したい場合に使用します。 方法:

    • 「保存」または「更新」ボタンの "On Click" イベントにこれを追加し、インタラクションの設定で正しいレコード変数を選択してください。 レコード変数から作成

  • これを使用して、特定のレコード変数にバインドされた入力フィールドにユーザーが入力したデータを使って Salesforce レコードを作成します(カスタムフォームでよく使われます)。:

    • 次を使用します: レコード変数にデータをロードしている場合( 「作成」「送信」または「新規保存」ボタンの "On Click" イベントにこれを追加し、新しいレコードのデータを含むレコード変数を選択してください。 new レコード変数からのアップサート

    • 「保存」または「更新」ボタンの "On Click" イベントにこれを追加し、インタラクションの設定で正しいレコード変数を選択してください。 作成と更新のロジックを組み合わせます。レコード変数に ID が存在する場合は既存レコードを更新し、そうでなければ新規作成します。

  • Create/Update と同様に構成し、関連するレコード変数にリンクしてください。:

    • 次を使用します: レコード変数にデータをロードしている場合( レコード変数からの削除

    • 「保存」または「更新」ボタンの "On Click" イベントにこれを追加し、インタラクションの設定で正しいレコード変数を選択してください。 指定されたレコード変数に含まれる ID の Salesforce レコードを削除します。

  • これを「削除」ボタンの "On Click" イベントに追加してください。:

    • 次を使用します: レコード変数にデータをロードしている場合( 重要な点として、この操作を行う際には "Open Confirm" インタラクションを使用して

    • 「保存」または「更新」ボタンの "On Click" イベントにこれを追加し、インタラクションの設定で正しいレコード変数を選択してください。 この操作 実行前にユーザーに確認を求め、誤って削除するのを防ぐことを強く推奨します。削除するレコードの ID を含むレコード変数を選択する必要があります。 前に 例: アカウント名の表示と編集 ターゲットオブジェクトを設定:

Dynamic Component の設定で、

  1. ターゲットページ名 を設定します。 フィールドをドラッグ: 最小(Min) Account.

  2. コンポーネントライブラリのタブで、 を開きます Fields フィールド(Account の下)を見つけてキャンバスにドラッグします。Avonni はおそらく Name テキスト入力 コンポーネントを作成します。 レコード操作のための主要なインタラクション

  3. ボタンを追加: をドラッグし、 ボタン キャンバスにコンポーネントを追加し、ラベルを「保存」にします。

  4. ボタンに「On Click」インタラクションを追加:

    • ボタンを選択します。

    • インタラクションパネルに移動します。

    • "On Click" インタラクションを追加します。

    • アクションタイプ: 選択 レコード変数から更新 そして対応するレコード変数を選択します。

これで、この Dynamic Component をアカウントのレコードページに配置すると:

  • テキスト入力は 表示します 現在のアカウントの名前を(バインドされているため)表示します。 $Component.record.Name).

  • ユーザーは edit テキスト入力で名前を編集できます。

  • "保存" ボタンをクリックするとフローがトリガーされて 保存 変更が反映されます。

主な利点

  • 迅速な開発: コードを書かずにデータにバインドされたコンポーネントを迅速に作成できます。

  • 視覚的な設定: ドラッグ&ドロップのインターフェースと自動コンポーネント作成によりプロセスが直感的です。

  • データの一貫性: コンポーネントが常に現在のレコードから正しいデータを表示することを保証します。

まとめると

Fields タブは、設定されたターゲットオブジェクトの API 名に基づいて利用可能なオブジェクトフィールドと標準オブジェクトを表示します。これらのフィールドをドラッグ&ドロップして、ユーザーがレコードを表示、編集、作成できるようにできます。

最終更新

役に立ちましたか?