定数

Avonni Dynamic Components の定数リソースは、コンポーネント全体で再利用できる固定値を定義することを可能にします。変数とは異なり、 定数は変更できません 最初に定義された後に変更されます。これにより、設定値、デフォルト値、参照情報など、一貫して保持すべき値を格納するのに最適です。

1. 概要

定数リソースは名前付きの値で、 一度だけ Dynamic Component のライフサイクル全体を通じて不変のままになります。これにはいくつかの利点があります:

• 集中管理された設定: 重要な値を単一の場所に保存することで、複数のコンポーネントやインタラクションを探し回らずに簡単に更新できます。

• 可読性: 説明的な定数名（例: DEFAULT_COUNTRY_CODE) を使用すると、ハードコーディングされた値（例: 'US').

• ）を使うよりもコンポーネント設定が理解しやすくなります。 保守性: いずれか 定数値を変更する必要がある場合（例: デフォルトの国コードが変更された場合）、更新は

• の場所（定数リソース）でのみ行えばよいです。 型安全性:

定数には定義されたデータ型（Text、Number、Boolean など）があり、エラーの防止に役立ちます。

2. 使用例

• 以下は定数リソースが役立つ一般的なシナリオです: デフォルト値:

• 入力フィールド、フィルタ、またはその他のコンポーネント設定のデフォルト値を提供します。例: 住所フォームのデフォルト国コード。 構成設定:

• コンポーネントの動作を制御する構成オプションを保存します。例: リストに表示する最大レコード数。 参照値:

• 比較や計算で使用できる固定値のセットを定義します。例: ステータスコード、カテゴリ名、エラーコード。 一緒に使う：両方の利点を享受 API エンドポイント（注意が必要）: は API エンドポイント URL を定数として 保存できますが、 エンドポイントが（開発、テスト、本番環境などで）変わる可能性がある場合は注意が必要です。API エンドポイントには通常、Custom Metadata Types や Named Credentials の方が適しています。

• ブールフラグ: 固定の状態や条件を表すために Boolean 定数を使用します。例: IS_DEBUG_MODE （設定値: を実行します—追加の設定は不要です。 や false).

• レコードタイプ ID:レコードタイプ ID を保存します。

3. 定数リソースの作成

Avonni Dynamic Component で定数リソースを作成するには:

1. リソースパネルを開く: 歯車アイコン（通常 Salesforce の右上にあります）をクリックします。 リソース ボタン（通常はページエディタやコンポーネントパネルにあります）。

2. 新しいリソースを作成: 新しいリソースを作成するボタンをクリックします（多くの場合 "+" アイコンや「New Resource」とラベルされたボタン）。

3. 「Constant」を選択: リソースタイプとして「Constant」を選びます。

4. 定数を設定:

   • API 名： 定数の一意の識別子を入力します。一貫した命名規則に従った説明的な名前を使用してください（例: DEFAULT_COUNTRY_CODE, MAX_LIST_ITEMS）。この名前でコンポーネント内から定数を参照します。API 名は一意でなければなりません。

   • 説明（任意）: 定数の目的について簡単な説明を記載します。これはドキュメント化や保守性に役立ちます。

   • データ型: 定数に適したデータ型を選択してください:

     • Boolean: を実行します—追加の設定は不要です。 や false.

     • Date: 日付値（例: 2024-07-26).

     • Date/Time: 日付と時刻の値（例: 2024-07-26T14:30:00Z).

     • Number: 数値（整数または小数）。

     • Record: 通常は ID によって Salesforce レコードへの参照を保存するために使用します。ここでレコードのすべてのフィールドを定義することは一般的ではありません。代わりにレコードの 15 または 18 文字の ID を保存します。

     • Text: テキスト文字列。

   • 値： ホストされている画像の 初期 値を参照するフィルターを追加します： のみ 定数の値。定数作成後にこの値は変更できません。提供される値はデータ型と一致する必要があります。

4. 定数リソースの使用

定数リソースを作成したら、Dynamic Component の設定全体で簡単に参照できます。あなたは 特別な構文を手動で入力する必要はありません 代わりに、リストから定数を選択します:

1. プロパティを見つける: コンポーネントのプロパティパネル（またはインタラクションの設定内）で、定数値を使用したいプロパティを見つけます。これはフィルタ値、コンポーネントのデフォルト値、テキストフィールドの内容などである場合があります。

2. リソースを選択: プロパティの横にドロップダウンリスト、選択ボタン、または（多くの場合）変数/リソースアイコンのようなアイコンが表示されます。これは動的値を選択できることを示します。クリックしてください。

3. 定数を選ぶ: 利用可能なリソース（変数や定数）が表示されます。リストから定数リソースを選択してください。システムは定数への正しい参照を自動的に挿入します。通常、中括弧 { } で表示されます。

例:

• フィルタ内で: あなたは Data Table のフィルタを設定しています。 Countryで絞り込みたい場合、 'US'値を直接入力する代わりに、"Value" フィールドの横にあるリソース選択ボタンをクリックし、リストから定数を選びます。 DEFAULT_COUNTRY_CODE 定数を選択します。

• コンポーネントのプロパティ内で: Text Input コンポーネントのデフォルト値を設定しているとします。デフォルト値を直接入力する代わりに、リソース選択ボタンをクリックして定数を選択します。

• 条件付き表示: Boolean 型の定数である SHOW_ADVANCED_OPTIONS という定数を作成した場合、表示条件において利用可能なリソースから直接その定数を選択します。

5. 重要な考慮点

• 不変性: 定数は できません 作成後に変更されません。値が変更される可能性がある場合は、代わりに 変数 リソースを使用してください。

• 命名規則: 定数には明確で一貫した命名規則を使用してください（例: 全て大文字とアンダースコア）: MAX_RECORDS).

• 入力および出力変数のデータ型がフローとコンポーネント間で一致していることを確認してください。 定数に対して正しいデータ型を選択してください。

• 代替手段: 機密データやコンポーネント外で管理する必要がある値（例: API キー、環境固有の設定）については、定数の代わりに Custom Metadata Types、Custom Settings、または Named Credentials を検討してください。

まとめると

Avonni Dynamic Components の定数リソースは、固定値を効率的に管理する方法を提供し、より整理され、読みやすく、保守しやすいコンポーネントの作成に寄与します。ライフサイクル中に変更されるべきでないデフォルト、構成、および値に使用してください。