ピックリスト

概要

ピックリストデータソースは、Avonni Dynamic Components 内の入力コンポーネントを Salesforce 組織内の標準またはカスタムのピックリスト項目に接続できるようにします。これにより、事前定義された選択肢をユーザーに提示し、データの一貫性とユーザーフレンドリーな体験を提供するシームレスな方法が実現します。ピックリストデータソースはレコードタイプもサポートします。

これにより以下の利点があります：

データの一貫性： ユーザーが Salesforce のピックリストで定義された有効な値のみを選択できるようにします。
自動更新： Salesforce のピックリスト値が更新されると、その変更は Dynamic Component に自動的に反映されます（手動での更新は不要です）。
簡素化された設定： 既存の Salesforce 設定を活用することで開発時間を短縮します。
レコードタイプのサポート： ピックリストデータソースはレコードタイプの制約を尊重します。レコードタイプがピックリスト項目の値を制御している場合、コンポーネントは現在のレコードのレコードタイプに適した値のみを表示します（該当する場合）。
現在のレコード値に基づくピックリストのフィルタリング： 現在のレコードのフィールド値に基づいてピックリストのオプションをフィルタリングできるようになり、ユーザーにとってさらに関連性の高い選択肢を提供できます。

サポートされるコンポーネント

ピックリストデータソースは、選択オプションを扱うように設計された Avonni コンポーネントで使用できます。例えば：

仕組み

コンポーネントの設定： Avonni Dynamic Component 内で、ピックリストデータソースをサポートする入力コンポーネント（例：コンボボックス）を選択します。
データソースを選択： コンポーネントのプロパティパネルで「データソース」設定（または類似のオプション）を見つけ、「Picklist」を選択します。
ピックリストデータソースを構成する：
- オブジェクト API 名： 使用したいピックリスト項目を含む Salesforce オブジェクトを選択します（例： Account, 商談（Opportunity）, My_Custom_Object__c).
- フィールド API 名： 特定の ピックリスト項目 をそのオブジェクトから選択します（例： Industry（業界）, StageName（商談フェーズ）, My_Custom_Picklist__c).
- レコードタイプID（任意）： レコードタイプがピックリスト項目の値を制御している場合、 任意で レコードタイプID を指定できます。これは通常動的に行われます：
  - 通常、この ID は Dynamic Component 内の変数やリソースから取得します。おそらく @recordId （レコードページ上にいる場合）と組み合わせて、正しい ID を取得するために RecordType オブジェクトに対して「Get Records」を実行します。
  - レコードタイプID を空白にすると、レコードタイプが存在する場合はコンポーネントがピックリストのオプションを表示しないことがあります。
  - レコードタイプID を空白にし、オブジェクトにレコードタイプが定義されていない場合は、コンポーネントは値を表示します。
- ピックリスト値属性（任意） 新しい属性として Picklist Values（ピックリスト値）を追加しました。これにより表示するピックリストオプションを明示的に制御できます。
  - 現在のレコードから値を渡して（例： component.record.picklistvalue）、そのレコードの既存データに基づいてオプションをフィルタリングできます。
  - を空にしておくと、デフォルトですべての利用可能なオプションが表示されます。 Picklist Values（ピックリスト値） （訳注：元のフラグメントに合わせて独立して翻訳）
自動ポピュレーション： コンポーネントは（オブジェクト、フィールド、および任意のレコードタイプに基づいて）有効なピックリスト値を自動的に取得し、それらをユーザーに対するオプションとして表示します。

ユースケース

以下はピックリストデータソースの使用例です：

取引先（Account）業界の選択： 取引先レコードページで、取引先の Industry（業界） ピックリスト項目に接続されたコンボボックスコンポーネントを使用します。 Account オブジェクトのフィールドが表示されます。
商談（Opportunity）フェーズの選択： 商談を更新するコンポーネントでは、コンボボックスやラジオボタングループを StageName（商談フェーズ） 商談のピックリストに接続して使用します。 商談（Opportunity） オブジェクトのフィールドが表示されます。
カスタムオブジェクトのピックリスト： 任意のカスタムオブジェクト上のカスタムピックリスト項目でピックリストデータソースを使用できます。
ケースの発生元の選択：ケースレコードページで値を設定するカスタムピックリストを持つことができます。

重要な考慮事項

ピックリストの更新： Salesforce のピックリスト値の変更（オプションの追加、削除、変更など）は、Dynamic Component に自動的に反映されます。
レコードタイプの依存関係： ピックリスト項目がレコードタイプの依存関係を持つ場合、正しいレコードタイプID を提供するか、レコードタイプが指定されていない場合の処理を行ってください。
複数選択ピックリスト： デュアルリストボックスのような一部の Avonni コンポーネントは、 複数選択（マルチセレクト） ピックリスト項目で使用できます。
アクセス制御：表示されるピックリスト値はユーザーのアクセス権とフィールドレベルのセキュリティを尊重します。
ピックリスト値属性： この属性を使用した場合は、指定された値のみが表示されます。この属性を空にすると、すべての利用可能な値が表示されます。

まとめ

ピックリストデータソースは、Avonni Dynamic Components を既存の Salesforce ピックリスト設定と統合するためのシンプルで強力な方法です。データの一貫性を促進し、開発を簡素化し、コンポーネントが常に最新のピックリストオプションを表示することを保証します。

最終更新 3 か月前

役に立ちましたか？