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.

• 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
Configurable Screens Sale	ConfigurableSale		10.2.1
Configurable Screens Proj	ConfigurableProject		10.2.1
Configurable Archives	SCILHostedArchives,ConfigurableArchive	10.1.5	10.2.1
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
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

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.