[Migration] Enable SCIM2 Group based User Filtering Improvements by Default

[dhaura]

Purpose

• The following SCIM2 group based user filtering improvements were done with a config to enable/ disable the improvements.
  • The SCIM 2 user endpoint with a groups filter returns the totalResults based on the total user count corresponding to the given group-based filter.
  • When invoking the user endpoint with a groups filter by passing a role (hybrid or system roles), it returns an empty list when role group separation is enabled, instead of returning users linked to the passed role.
• With the following PR, these improvements are enabled by default in the product.
  • Enable SCIM2 Group based User Filtering Improvements by Default carbon-identity-framework#5830
• Therefore, these improvements should be noted in migration docs of future releases.

Related Issues

• SCIM returns faulty totalResults when the filter parameter is given with pagination parameters #12813

Related PRs

• Add config to get the totalResults by user count carbon-identity-framework#5533
• Get totalResults Value by Total User Count in SCIM2 User API wso2-extensions/identity-inbound-provisioning-scim2#547
• Get totalResults value by user count carbon-kernel#3906
• Improve getUserCountByRole() Method carbon-kernel#3951

[nilasini]

Updated the migration doc