ChoiceRestrictor is a sophisticated custom control for the PowerApps Component Framework (PCF) designed to manage the availability of options in OptionSets and MultiSelectOptionSets within Dynamics 365 CRM. It provides a user-friendly solution for restricting certain options without altering existing records, thereby preserving data integrity while controlling user selection.
One real-world D365 CRM problem we encountered involved a scenario where certain options within an OptionSet field must be hidden or disabled based on specific conditions. For instance, in a sales opportunity form, we wanted to prevent users from selecting a specific sales stage unless they had completed a prerequisite step, such as entering customer information. This was crucial to ensure data consistency and prevent incomplete records. However, modifying the existing OptionSet directly would have required updating all existing records, which was impractical and time-consuming. The ChoiceRestrictor control provided a flexible and efficient solution by dynamically controlling the visibility and availability of options based on predefined criteria, addressing the issue without impacting existing data.
- Restricted Choices: This allows you to restrict users from selecting certain options in real-time, without affecting the existing records in the database. This prevents users from selecting disabled options moving forward, while preserving data consistency for records created before the restriction was applied.
- Non-Intrusive Data Management: Ensures that the restriction of options does not impact existing records or require complex JavaScript logic to handle the removal of options. It simplifies the management of choice fields by applying restrictions without modifying historical data.
- Easy Configuration: Provides an intuitive configuration interface to specify restricted choices and manage user access to options.
Choice: Bound property that specifies the OptionSet or MultiSelectOptionSet to which the control is connected. This property is required for the control to function correctly.RestrictedChoices: A comma-separated list of choices that are restricted. This property allows you to specify which options should be disabled from the user selection.RestrictedChoicesVisibility: This property allows you to specify that restricted options should be disabled or hidden from the user selection. Note - Existing records where restricted options are selected will not be hidden.
ChoiceRestrictor is ideal for scenarios where you need to restrict user selections within choice fields while maintaining the integrity of existing records. It provides a straightforward solution for managing available options without affecting previously created data or requiring complex logic. This control enhances user experience by clearly defining selectable options and ensuring that only valid choices are available for new records.
ChoiceRestrictorControl SingleSelect
ChoiceRestrictorControl MultiSelect
This project is licensed under the MIT License - see the LICENSE file for details.
You can adjust the sections and content as needed to fit your project's specifics and documentation style.