Feature toggles

Some tooltip text!

• 3 minutes to read

 • 3 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.

• Windows Application: SuperOffice.config and SOUSER.INI
• Web Application: web.config

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	Available from version	Released in version	Pilot in version
Configurable Screens	ConfigurableScreens	10.0.2
Dashboards 2.0	NewDashboards	10.0.2
OAuth 2.0 Authentication	NewAuthentication	10.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
OAuth 2.0 Service	NewAuth	10.0.x	9.2 R10 ONSITE
Configurable Archives	SCILHostedArchives,ConfigurableArchive	10.1.3

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.