Feature toggles

•

Environment: onsite

Some tooltip text!

• 4 minutes to read

 • 4 minutes to read

Some features are enabled by feature toggles.

To enable toggled features - you need to add two sections manually in your NetServer configuration file.

• Web Application: web.config
• For SupeOffice versions less than 10, and support the feature: Windows Application: SuperOffice.config and SOUSER.INI

Note

If you have used feature toggles before and want to enable a new feature, simply add a new key to your existing configuration.

1. Open the web.config file for your web installation.

2. Define a new section group named FeatureToggles inside the SuperOffice group.

   Locate the parent element:

   <configuration>
     <configSections>
       <sectionGroup name="SuperOffice">
   

   Add this (if it's not already defined):

   <sectionGroup name="FeatureToggles">
     <section name="State" type="System.Configuration.NameValueSectionHandler, System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
   </sectionGroup>
   

3. Add (or update) the FeatureToggles section:

   Locate the SuperOffice element:

   </configSections>
   <SuperOffice>
   

   Add this:

   <FeatureToggles>
     <State>
       <add key="NewDashboards" value="true" />
       <add key="ConfigurableScreens" value="true" />
     </State>
   </FeatureToggles>
   

   Replace the key with the features you want to toggle (see list below).

4. Save the file. The application pool will be recycled to get the new settings. Now you can use the new features in the Web client.

Previous feature toggles

Feature	Toggle name	Released in version	Available from version
New Service (*1)	NewServiceRequest	10.2.5	10.2.1
New Notifications	NewNotifications	10.2.5	10.2.5
New TimeZone	NewTimezoneHandling	10.2.5	10.2.1
Configurable Screens Sale (*2)	ConfigurableSale	10.2.5	10.2.1
Configurable Screens Proj (*2)	ConfigurableProject	10.2.5	10.2.1
Configurable Archives	SCILHostedArchives,ConfigurableArchive	10.1.3	10.1.6
New Search	NewSearch	10.2.5	10.1.8
Configurable Screens P&C	ConfigurableScreens	10.0.2	9.2 R12
Dashboards 2.0	NewDashboards	10.0.2	9.2 R12
OAuth 2.0 Service	NewAuth	10.0.6	9.2 R12
OAuth 2.0 Authentication	NewAuthentication	10.0.6	9.2 R10
New Selection	NewSelection	9.x
New Export To Excel	NewExportToExcel	9.x
Bulk Update	BulkUpdate	9.x
Consent Management	ConsentManagement	9.x
New Invitation	NewInvitation	9.x
Email Template	EmailTemplate	9.x
User Management	UserManagement	9.x

Available from version = Version that support the FeatureToggle.

Released in version = Version that have the feaure automatic on, and does not support the FeatureToggle

*1 = The NewServiceRequest feature toggle is dependent on the NewTimezoneHandling feature toggle

*2 = The ConfigurableSale and ConfigurableProject feature toggle is dependent on the SCILHostedArchives feature toggle

Look up enabled features

You can use the value from the feature_toggle field of the config table to determine if a feature is enabled. It contains a delimited string of all the enabled feature toggles.

• Use comma ',' as the delimiter between the feature toggles
• Use colon ':' as the delimiter between the feature toggle name, and if it's enabled or not

Example CRMScript:

#setLanguageLevel 3;

SearchEngine seConfig;
seConfig.addField("config.feature_toggle");
seConfig.execute();

String featureTogglesString = seConfig.getField("config.feature_toggle");

String[] featureToggles = featureTogglesString.split(",");

for (Integer i = 0; i < featureToggles.length(); i++)
{
  String[] featureToggleValues = featureToggles[i].split(":");
  String featureToggleName = featureToggleValues[0];
  String featureToggleEnabled = featureToggleValues[1];
  printLine(featureToggleName + " = " + featureToggleEnabled);
}

Result:

Tip

You can retrieve the feature_toggle field value using the dynamic archive provider when using the SuperOffice web services.