Introduction
Onboarding
What is CloudBees Feature Management?
Use cases
Introduction
Installing client-side SDKs
Installing server-side SDKs
About feature flags
Environments
Creating a feature flag
Creating a boolean flagCreating a string flagCreating a number flagCreating a flag via Dynamic APISetting flag default values
Feature flag settings
Deleting a feature flag
Embedded feature flags
Multiplatform feature flags
Flag freeze levels
Feature flag configuration update flow
Configuration values
Toggling flags on and off
Audiences
Custom properties
Percentage rollouts
Scheduled rollouts
Target groups
Flag dependencies
About features
Creating and deleting features
Managing features
Configuration as Code
Verbose logging
Local testing
Microservices testing
User space error handler
Flag impressions
Fetched handler
Integrating with Jira
Managing users
Managing teams and permissions
Managing applications
Managing billing plans
Audit log
SAML single sign-on
Two-factor authentication
Allow/Disallow domains
Secret mode
Support policies
Supported platforms
Terms and services
Open Source Software Attributes

Creating a number flag

This section describes how to define a number flag.

Understanding number flags

Number flags are flags that can have multiple number values. When you create a number flag in your application, you define the default value and all the other values this flag can have. Like simple boolean flags, the number flag name is derived from the flag variable name.

Creating a container class and defining a feature flag

To add a number flag, you need two things:

  • A container class for your flags

  • A defined flag inside the container class

In the example below, a number flag is defined with the name titleSize. The flag name is derived from the flag variable name. The titleSize flag has a default value of 12.

If you need a number flag to be more dynamic with regards to value, you can define a number flag in the code with only one value (which is also the default value). This will result in a Free Text input field when configuring the flag’s through the CloudBees Feature Management dashboard.

In the example below, the title size can be any one of 12, 14, 18 and 24. By default, it will be 12.

React Native JavaScript Node.js JavaScript SSR .NET Python Android JDK 
const flags = {
  titleSize: new Rox.RoxNumber(12, [12, 14, 18, 24]),
};
 
const flags = {
  titleSize: new Rox.RoxNumber(12, [12, 14, 18, 24]),
};
 
const flags = {
  titleSize: new Rox.RoxNumber(12, [12, 14, 18, 24]),
};
 
import {RoxNumber} from 'rox-ssr';
const flags = {
  titleSize: new Rox.RoxNumber(12, [12, 14, 18, 24]),
};
 
using Io.Rollout.Rox.Server.Flags;

public class Container : IRoxContainer
{
    public RoxInt titleSize = new RoxInt(5, new List<int>() { 8, 13 });
    public RoxDouble specialNumber = new RoxDouble(3.14, new List<int>() { 2.71, 0.577 });
}
 
from rox.core.entities.rox_int import RoxInt
from rox.core.entities.rox_double import RoxDouble

class MyContainer:
  def __init__(self):
    self.title_size = RoxInt(5, [8, 13])
    self.special_number = RoxDouble(3.14, [2.71, 0.577])
 
import io.rollout.configuration.RoxContainer;
import io.rollout.flags.Freeze;
import io.rollout.flags.RoxDouble;
import io.rollout.flags.RoxInt;

public class Container implements RoxContainer {
    public final RoxInt titleSize = new RoxInt(5, new int[]{ 8, 13 }, Freeze.UntilLaunch);
    public final RoxDouble specialNumber = new RoxDouble(3.14, new double[]{ 2.71, 0.577 }, Freeze.UntilLaunch);
}
 
import io.rollout.configuration.RoxContainer;
import io.rollout.flags.RoxDouble;
import io.rollout.flags.RoxInt;

public class Container implements RoxContainer {
    public final RoxInt titleSize = new RoxInt(5, new int[]{ 8, 13 });
    public final RoxDouble specialNumber = new RoxDouble(3.14, new double[]{ 2.71, 0.577 });
}

Registering the container class

Once you have the container class, you need to register its instance to the CloudBees Feature Management SDK. This is done with the Rox.register SDK function.

The namespace parameter is a logical separation between containers and can be used to find flags on the dashboard.

  • A namespace can only be registered once.
React Native JavaScript Node.js JavaScript SSR .NET Python Android JDK 
const flags = {
  // define Rox entities here
}
Rox.register('<namespace>', flags);
await Rox.setup('<ROLLOUT_KEY>');
 
const flags = {
  // define Rox entities here
}
Rox.register('<namespace>', flags);
Rox.setup('<ROLLOUT_KEY>');
 
const flags = {
  // define Rox entities here
}
Rox.register('<namespace>', flags);
await Rox.setup('<ROLLOUT_KEY>');
 
import {Rox} from 'rox-ssr';
const flags = {
  // define Rox entities here
}
Rox.register('<namespace>', flags);
Rox.setup('<ROLLOUT_KEY>');
 
Container flags = new Container();
Rox.Register("<namespace>", flags);
await Rox.Setup(<ROLLOUT_KEY>);
 
flags = Container()
Rox.register(flags)
Rox.setup(<ROLLOUT_KEY>)
 
public class App extends Application {

  @Override
  public void onCreate() {
    super.onCreate();

    Container flags = new Container();
    Rox.register("<namespace>", flags);
    Rox.setup(this);

    // This can also be done in the MainActivity if your app doesn't extends the Application class
  }
}
 
Container flags = new Container();
Rox.register("<namespace>", flags);
Rox.setup("<ROLLOUT_KEY>");

Using a number flag

React Native JavaScript Node.js JavaScript SSR .NET Python Android JDK 
  console.log('Title size is ' + flags.titleColors.getValue());
 
  console.log('Title size is ' + flags.titleColors.getValue());
 
  console.log('Title size is ' + flags.titleColors.getValue());
 
  console.log('Title size is ' + flags.titleColors.getValue());
 
  Console.WriteLine("Title size is {0}", flags.titleSize.GetValue());
  Console.WriteLine("The special number is {0}, flags.specialNumber.GetValue());
 
  print('Title size is {}'.format(flags.title_size.get_value()))
  print('The special number is {}'.format(flags.special_number.get_value()))
 
  System.out.println("Title size is " + flags.titleSize.getValue());
  System.out.println("The special number is " + flags.specialNumber.getValue());
 
  System.out.println("Title size is " + flags.titleSize.getValue());
  System.out.println("The special number is " + flags.specialNumber.getValue());

Flag freeze level Flag freeze is available on client side SDKs by default.

  • SDK version 4.x the default is set to untilForeground

  • SDK version 5.0 or later the default is set to none

See Understanding a flag freeze for more information.
Creating a string flag
Creating a flag via Dynamic API