フィールド

Avonni Dynamic Components パッケージは、Salesforce データをアプリおよびレコードページ上で直接表示・操作するための強力な方法を提供します。Dynamic Component 内のデータフィールドにアクセスするには、Fields タブを使用し、 いずれかTarget Object API Name 設定 またはRecord Variable (適切なオブジェクトタイプのもの)を使用してください。

概要

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

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

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

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

Fields パネルの位置

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

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

オプション 1:Target Object API Name(レコードページおよび一般的なオブジェクトアクセス向け)

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

  2. Target Object API Name を設定 して、操作したい Salesforce オブジェクトの API 名を指定します(例: Account, Contact, My_Custom_Object__c)。これは 通常 コンポーネントを配置するレコードページのオブジェクトです。

  3. を開きます Component Library (左パネル)で Fields タブをクリックしてください。選択したオブジェクトのフィールド一覧が表示されます。

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

オプション 2:Record Variable(特定のレコードやカスタムロジック向け)

  1. Record Variable を作成:Resources パネルにて、新しい Variable リソースを作成し、その Data Typeを Record に設定します。レコードタイプに対して適切な Salesforce オブジェクトを選択してください。

  2. レコード変数の値を設定する: 通常は「読み込み時」の操作を「レコード取得(Get Records)」アクションと組み合わせて使用し、特定のレコードを取得してレコード変数に格納します。(詳細は「読み込み時の操作」のドキュメントを参照してください。).

  3. を開きます Component Library (左パネル)で Fields タブ。レコード変数のオブジェクトタイプに対応するフィールドの一覧が表示されます。

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

次のこと: $Component.record Variable

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

  • レコードページ上: ダイナミックコンポーネントが レコードページ, $Component.record に配置されている場合、 現在のレコードのデータが含まれます。例えば、 $Component.record.Name はアカウントの名前がアカウントレコードページ上に保持されることを示します。

  • レコードページ上でない場合: コンポーネントが 配置されていない (例:アプリページ上)場合、 $Component.record は空または未定義である可能性があります。そのような場合は、データを取得するためにクエリデータソースを使用し、代わりに その データを扱うことが多いです。 $Component.record.

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

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

重要な情報

レコード操作の主要なインタラクション

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

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

    • ユースケース: データを特定の レコード変数に読み込んでいる場合に使用します (「読み込み時」 > 「レコード取得(Get Records)」アクションを使用する、またはさまざまな入力フィールドをそのフィールドにバインドするなど)および変更を保存したい場合、 その変数から 対応する Salesforce レコードへ戻します。

    • 方法: これを「保存」または「更新」ボタンの「クリック時(On Click)」イベントに追加し、インタラクションの設定で正しいレコード変数を選択してください。

  • レコード変数からの作成:

    • ユースケース: 用途: これを使用して 新しい

    • 方法: レコード変数にバインドされた入力フィールドにユーザーが入力したデータを使用して、新しい Salesforce レコードを作成します(カスタムフォームでよく使用されます)。 これを「作成」「送信」または「新規保存」ボタンの「クリック時(On Click)」イベントに追加し、新しいレコードのデータを含むレコード変数を選択してください。

  • レコード変数からのアップサート:

    • ユースケース: 作成と更新のロジックを組み合わせます。レコード変数にIDが存在する場合は既存レコードを更新し、そうでない場合は新しいレコードを作成します。

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

  • レコード変数からの削除:

    • ユースケース: 指定したレコード変数に含まれるIDを持つSalesforceレコードを削除します。

    • 方法: これを「削除」ボタンの「クリック時」イベントに追加してください。 重要:必ず「確認ダイアログを開く」インタラクションを使用することを強く推奨します 前に このアクション でユーザーに確認を求め、誤って削除されるのを防いでください。削除するレコードのIDを含むレコード変数を選択する必要があります。

例:アカウント名の表示と編集

  1. 対象オブジェクトを設定: ダイナミックコンポーネントの設定で、 対象ページ名Account.

  2. フィールドをドラッグ: を開きます Fields コンポーネントライブラリのタブ。次に Name フィールド(Accountの下)を見つけてキャンバスにドラッグします。Avonniはおそらく テキスト入力 コンポーネントのクリックによってトリガーされます。

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

  4. ボタンに「クリック時」インタラクションを追加:

    • ボタンを選択します。

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

    • 「クリック時」インタラクションを追加します。

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

これで、このダイナミックコンポーネントをアカウントのレコードページに配置すると:

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

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

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

主な利点

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

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

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

まとめ

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

最終更新

役に立ちましたか?