変数とコンポーネントデータの使用

変数とコンポーネントデータの使用

Avonni Dynamic Components は、コンポーネントを本当に動的で応答性の高いものにするために、さまざまなデータ型に簡単にアクセスできるようにします。これにはシステム提供の グローバル変数、あなたが定義した Resources (変数、定数、式)や キャンバス上の他のコンポーネントの属性 が含まれます。これらのデータにアクセスする方法を理解することは、強力なインタラクションやインターフェースを構築する鍵です。

データへのアクセス方法:リソースセレクタ

コンポーネントビルダー内でこれらのデータ型にアクセスする主要な方法は、 任意の を通じてです。 リソースセレクタ。これは多くのプロパティ、フィルター設定、インタラクション設定の隣にある小さなアイコン(しばしば { }、タグや変数記号に似たもの)です。

リソースセレクタをクリックすると、通常次の選択肢が表示されます:

  • グローバル変数(通常は $)

  • あなたが定義したリソース(変数、定数、式 - 通常は {!YourResourceName})

  • コンポーネント属性(他のコンポーネントを参照する際に @ComponentName.attribute)

を使用)

グローバル変数へのアクセス

グローバル変数は、コンポーネントが動作しているコンテキストに関する用意された情報を提供します。これらはリソースセレクタを介して選択します。

  • $Api:Salesforce の API に関連する情報を提供します。(高度なシナリオで使用)。

  • $Component:Dynamic Component 自身に特有のコンテキストを提供します。

    • $Component.recordその が設定され、コンポーネントが レコードページにある場合、この重要な変数は 現在のレコード全体のデータを保持します。フィールドにはドット表記でアクセスします(例: にバインドされます)。ユーザーはこれらのフィールドを表示または編集できます。, $Component.record.Industry).

    • (例:ケースの詳細やカスタムオブジェクトのページ)でコンポーネントをコンテキスト認識させるために不可欠です。このフィールドに (または @recordId リソースセレクタ経由): がある場合、 その が設定され、コンポーネントが レコードページにある場合は現在のレコードの 15 桁または 18 桁の ID を直接提供します。フィルターやインタラクションに渡す際に非常に便利です。

  • $Organization:現在の Salesforce 組織に関する詳細を提供します(例: $Organization.Id, $Organization.Name).

  • $Profile:現在のユーザーの Salesforce プロファイルに関する詳細を提供します(例: $Profile.Id, $Profile.Name)。プロファイルに基づいた表示制御に役立ちます。

  • $System:システム関連の情報を提供します(可用性は文脈により異なる場合があります)。

  • $User現在ログインしているユーザーに関する詳細.

    • 例: $User.Id, $User.FirstName, $User.LastName, $User.Email, $User.Username。パーソナライズ、データのフィルタリング(「自分のレコード」)、条件ロジックに便利です。

自分のリソース(変数、定数、式)へのアクセス

リソースパネルで作成した変数、定数、式は簡単に使用できます:

  • 方法: プロパティ、フィルター値、またはインタラクション入力の横にあるリソースセレクタをクリックします。リストから目的の変数、定数、または式リソースを選択します。

  • 構文(表示): ビルダーは通常参照を次のように表示します: {!YourResourceApiName}.

  • ユースケース: 計算値の表示、ユーザー入力の保存、デフォルト値の設定、表示制御、フィルターでの使用、インタラクションへのデータ渡し。

他のコンポーネントの属性へのアクセス(リアクティビティの鍵)

これがコンポーネントを動的に相互作用させる方法です:

  • 方法: リソースセレクタをクリックします。次に、 コンポーネント属性 オプションを選択します。

  • コンポーネントの選択: 等しい キャンバス上の別のコンポーネント からデータを取得したいコンポーネントを選びます。 から.

  • 属性の選択: そのコンポーネントの特定の 属性 の値が必要なものを選択します(例: .value は入力コンポーネント用、 .firstSelectedRow はデータテーブル用、 activeItemValue はタブ用)。

  • 構文(表示): ビルダーは通常参照を次のように表示します: @ComponentApiName.attributeName を指定します(例: @MyCombobox.value, @AccountsTable.firstSelectedRow.Id).

  • ユースケース: リアクティブなフィルターの作成(データテーブル A の選択に基づいてデータテーブル B をフィルターする)、表示コンポーネントの更新(コンボボックスの選択に基づいてテキストを表示する)、別のコンポーネントの状態に基づく表示制御など。

実用的な例

例 1:現在のユーザー名を表示する

  1. を追加します AccountId equals {!inputAccountId} コンポーネントのリソースからの値にすることができます。

  2. その プロパティでリソースセレクタをクリックします。

  3. 選択: グローバル変数.

  4. 選択: $User.

  5. 選択: FirstName。(値は $User.FirstName).

  6. 別の AccountId equals {!inputAccountId} コンポーネントのリソースからの値にすることができます。

  7. その を追加し、リソースセレクタを使って次を選択します グローバル変数 > $User > LastName.

  8. または式を使うこともできます {!$User.FirstName} & " " & {!$User.LastName}

例 2:コンボボックスで表示制御を行う

ユーザーがステータス(「Active」または「Inactive」)を選択できるコンボボックスがあるとします。「Inactive」が選択されているときのみ「再有効化」ボタンを表示したい場合の例です。

  1. コンボボックスの追加: Avonni コンボボックスを追加します。に名前を付けます API名 を指定します(例: StatusSelector)。オプションを設定します(ラベル/値:Active/active、Inactive/inactive)。

  2. ボタンの追加: Avonni ボタンを追加します。その ラベル を「Reactivate」に設定します。

  3. ボタンの表示設定: ボタンを選択します。の Visible プロパティでリソースセレクタをクリックします:

    • を選択します: コンポーネント属性.

    • コンポーネント: コンボボックスを選択します(StatusSelector).

    • 属性: 選択: .

    • 演算子: に設定: 演算子を選択します。.

    • 値: 'New York' inactive (コンボボックスのオプション値と一致させます)。

これで、コンボボックスで「Inactive」が選択されているときにのみ「再有効化」ボタンが表示されます。

まとめ

Avonni Dynamic Components は、リソースセレクタを通じてグローバルコンテキスト、あなたが定義したリソース、他のコンポーネントの状態に柔軟にアクセスできます。これを習得することで、コードなしで高度に動的でインタラクティブ、かつデータ認識型のユーザーインターフェースを構築できます。

最終更新

役に立ちましたか?