Class OptionBuilder

  • OptionBuilder facilitates the creation of options for SelectSingle and SelectMultiple elements in Data Studio.

  • It provides methods like setLabel and setValue to define the display text and underlying value of each option.

  • These options are then added to SelectSingle or SelectMultiple components for user interaction within a Data Studio connector.

  • Using OptionBuilder simplifies the process of creating interactive dropdown menus in your custom connectors.

OptionBuilder

A builder for creating options for SelectSingles and SelectMultiples.

const cc = DataStudioApp.createCommunityConnector();
const config = cc.getConfig();

const option1 =
    config.newOptionBuilder().setLabel('option label').setValue('option_value');

const option2 = config.newOptionBuilder()
                    .setLabel('second option label')
                    .setValue('option_value_2');

const info1 = config.newSelectSingle()
                  .setId('api_endpoint')
                  .setName('Data Type')
                  .setHelpText('Select the data type you\'re interested in.')
                  .addOption(option1)
                  .addOption(option2);

Methods

MethodReturn typeBrief description
setLabel(label)OptionBuilderSets the label of this option builder.
setValue(value)OptionBuilderSets the value of this option builder.

Detailed documentation

setLabel(label)

Sets the label of this option builder. Labels are the text that the user sees when selecting one or more options from the dropdown.

Parameters

NameTypeDescription
labelStringThe label to set.

Return

OptionBuilder — This builder, for chaining.


setValue(value)

Sets the value of this option builder. Values are what is passed to the code when a user selects one or more options from the dropdown.

Parameters

NameTypeDescription
valueStringThe value to set.

Return

OptionBuilder — This builder, for chaining.