Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

Cloud Service Automation4.80.0002

Use > Topology Designs > Topology Design Subscriber Options

Topology design subscriber options

Use settings on the Subscriber Options tab to configure option sets and options to present to a user at subscription time. Option sets are configured in a topology design by adding options, creating option properties, and binding option properties to component or group properties in the design.

Option sets, options, and properties offer the subscriber the ability to customize the service that gets provisioned. An option set should contain one or more options and can be configured to allow the subscriber to select one or multiple options within the option set. Option properties can then be defined on an option, with the value for the property provided either by the designer, service offering manager, or subscriber. Bindings configured on option properties map the provided value to component or group properties in the design. In this use case, the user selected options and property values to customize the service that is provisioned.

After options have been entered, you can publish the design. Option Sets and Options cannot be deleted after they are published. After publishing, the option sets are made available in the Offerings area of the Cloud Service Management Console, where they can be further refined and configured. The subscriber options are then exposed to subscribers in the Marketplace Portal, allowing them to select values that customize the service offering for their personal needs.

Add Option Set

Use this functionality to create a hierarchy of option sets that is up to three levels deep:

Option Set 1
- Option
  - Option Set 2
    - Option
      - Option Set 3
        Option

Click the Add Option Set link or click the button in the upper right panel. You can also click the Copy Option Set and Paste Option Set buttons to copy option sets, both within and across designs.

After an option set has been created, you can configure the following values for the option set on the right side of the window:

Image - Clicking the image icon allows you to change the image for the option set.
Display Name - Specify a display name for the option set.
Description - Specify a description for the option set.
Modify Options - Check Modifiable during service modification to allow the subscriber to modify this option set in the Marketplace Portal after a subscription has been ordered. If checked, ensure that all property bindings from options in the option set exclusively target properties that are themselves modifiable during service modification. Unchecking prevents a subscriber from changing the selected values of this option set when modifying the subscription in the Marketplace Portal.

Managing Multiple Option Sets or Options

The selected option set or option is highlighted in blue. With the option set or option selected, you can Use <Ctrl> + the arrow keys to drag the selection up and down the list to reorder. An option set or option can also be reordered by clicking and dragging it.

Delete an Option Set or Option

With the option set or option selected, press the Delete key on the keyboard or click the trash can on the right.

Copy and Paste an Option Set or Option

You can copy and paste option sets or options within a design, between designs, and within a tree within a design. The copy includes the entire structure, including property bindings when copied within the same design. When pasting options or option sets into a new design, bindings will not be copied and you will need to manually configure them.

After copying and pasting an option set or option, changes to the original option set or option do not impact the newly created option set or option or vice versa.

To Add Options to an Option Set and Configure Selection Options

Click the option count button to navigate to the list of options for that option set. The name of the current option set will be displayed above the list of options. Click Add Option to add an option to the option set.

After selecting Add Option, the new Option Display Name is automatically generated to a unique value; you can then customize the Display Name and Description for the option.

An option set can be configured for Single-Select or Multi-Select.

Single-Select - Select to present options as radio boxes in the Marketplace Portal. A subscriber is required to select a single value.

Multi-Select - Select to present options as check boxes in the Marketplace Portal. The subscriber can select 0 or more options for a Multi-Select option set.

Adding Properties to Options

Within an option, the properties panel on the right allows you to view, add, and edit properties, as well as to create bindings.

To Configure Attributes

The following attributes can be configured when creating an option property:

Item Description

Property Type

Item	Description
Property Type	Select one of the following: Boolean — A property whose value is True or False. Integer — A property whose value is a positive or negative whole number or zero. List — A property where you can define a list of values for the subscriber to select. String — A property whose value is a sequence of characters. Configure the following items for each property type: Name — A unique name for the property. Display Name — The display name for the property. Description — A description of the property. Editable — If selected, indicates the property is editable in a service offering created from the design and can be configured in the offering to be editable in the Marketplace Portal. Required — If the property is Editable, you can select Required to require the service offering or subscriber to provide a value for the property. Boolean properties that are Editable are implicitly Required.
Property Details	For Boolean properties: Service Offering and Marketplace Portal Settings: Editable - Indicates that this property can be made editable in the Offerings area and in the Marketplace Portal Default Value - Select true or false Note Boolean properties are always required, which means that when a subscription is ordered, a value must be provided for this field. This option cannot be changed for Boolean properties. For Integer properties: Service Offering and Marketplace Portal Settings Editable - Select to make this field editable in the Offerings area and in the Marketplace Portal Required - Integer properties are always required, which means that when a subscription is ordered, a value must be provided for this field. Value Range - If Editable is checked, configure a minimum and maximum allowed value for the property. Default Value - Select or type a positive or negative whole number or zero. If you enter a decimal number, the value will be truncated to the nearest integer. The maximum allowed integer value is 2147483647 and the minimum is -2147483648; if you enter a value outside these bounds the value will be automatically converted to the closest maximum or minimum value. For List properties: Service Offering and Marketplace Portal Settings: Editable - Indicates that this property can be made editable in the Offerings area and in the Marketplace Portal. Dynamic entry properties are always editable; this field cannot be changed for dynamic entry properties. Required - Select to indicate that when a subscription is ordered, a value must be provided for this field. List Selection Type: Single-Select - Select to present options as radio boxes in the Marketplace Portal. Multi-Select - Select to present options as check boxes in the Marketplace Portal. List Items: Switch to Static Entry (default) - Enter the name and value for an entry in the list. After the value entry, a new item line is displayed automatically. Switch to Dynamic Entry - Select a script name and specify the HTTP parameter names and token values. Validation Script - Both dynamic property and semantic validation are implemented as drop down list with script names and (none) value. There are manage scripts and configure parameters links with respective functionality. Note Manage Scripts displays only scripts for dynamic properties. Script parameters are similar to dynamic properties and new Tokens are defined `CURRENT_ VALUE` (current running subscription value of property and not currently edited request). Manage Scripts - Click to manage JavaScript files that can be used to provide values for the dynamic list properties. See Script Management. HTTP Parameters - Specify the HTTP parameters to use when executing the script. The required input parameters are dependent on the script that has been selected; contact the script developer if necessary to determine the necessary input parameters. Parameter Name - For each Parameter Name you enter, supply a Parameter Value, which can be a token or a constant value. Note The script is invoked at subscription ordering or modification time by the user `csaReportingUser`, who has read-only access to CSA. For more information on this user, see the Cloud Service Automation Configuration Guide. Select Token - Click the Select Token icon () to enter a token. See Tokens. Refresh Data - Click the Refresh Data icon ( ) to run the script and display the results. For String properties: Service Offering and Marketplace Portal Settings: Editable - Select to make this field editable in the Offerings area and in the Marketplace Portal. Required – Select to indicate that when a subscription is ordered, a value must be provided for this field. Input Type: Single-Line - The input area is presented as and accepts only one line of text. Multi-Line - The input area is presented as a text box and can accept one or more lines of content. Number of Characters - Configure the minimum and maximum number of characters that can be entered for this property. These fields are available only when the Editable and Single-Line options are selected. Input Restriction - Choose an Input Restriction from the following list. These fields are available only when the Editable and Single-Line options are selected. (none) - No input restriction will be performed. A minimum and maximum length can still be configured. Custom Regular Expression - Validates the value based on a regular expression, as specified in the Regular Expression text box. Email Address - Checks that a valid email format is entered. IPV4 Address - Checks that a valid IPV4 address is entered. IPV6 Address - Checks that a valid IPV6 address is entered. Non-Numeric Characters - Checks that no numeric characters are entered. URL Address - Checks that a valid URL format is entered. The regular expression used for validating the URL values may allow creating some invalid URL values such as `http`, `http:/`, `http://` or `hhh:////`. This is because the regular expression validates a wide range of official IANA-registered schemes, which may not detect some invalid URL values. Default Value - Type a string of characters. Confidential - Select this box to mask the values so that they cannot be read in the user interface; no encryption of the value is performed. Note that this field is available only when the Single-Line option is selected.
Property Bindings	Select the topology component or group to which you want to push the value of this property. Then select the appropriate property from the list of compatible properties. This is called a target binding.

Select one of the following:

Boolean — A property whose value is True or False.
Integer — A property whose value is a positive or negative whole number or zero.
List — A property where you can define a list of values for the subscriber to select.
String — A property whose value is a sequence of characters.

Configure the following items for each property type:

Name — A unique name for the property.
Display Name — The display name for the property.
Description — A description of the property.
Editable — If selected, indicates the property is editable in a service offering created from the design and can be configured in the offering to be editable in the Marketplace Portal.
Required — If the property is Editable, you can select Required to require the service offering or subscriber to provide a value for the property. Boolean properties that are Editable are implicitly Required.

Property Details

For Boolean properties:

Service Offering and Marketplace Portal Settings:
- Editable - Indicates that this property can be made editable in the Offerings area and in the Marketplace Portal
Default Value - Select true or false

Note Boolean properties are always required, which means that when a subscription is ordered, a value must be provided for this field. This option cannot be changed for Boolean properties.

For Integer properties:

Service Offering and Marketplace Portal Settings
- Editable - Select to make this field editable in the Offerings area and in the Marketplace Portal
- Required - Integer properties are always required, which means that when a subscription is ordered, a value must be provided for this field.
- Value Range - If Editable is checked, configure a minimum and maximum allowed value for the property.
- Default Value - Select or type a positive or negative whole number or zero. If you enter a decimal number, the value will be truncated to the nearest integer. The maximum allowed integer value is 2147483647 and the minimum is -2147483648; if you enter a value outside these bounds the value will be automatically converted to the closest maximum or minimum value.

For List properties:

Service Offering and Marketplace Portal Settings:
- Editable - Indicates that this property can be made editable in the Offerings area and in the Marketplace Portal. Dynamic entry properties are always editable; this field cannot be changed for dynamic entry properties.
- Required - Select to indicate that when a subscription is ordered, a value must be provided for this field.
List Selection Type:
- Single-Select - Select to present options as radio boxes in the Marketplace Portal.
- Multi-Select - Select to present options as check boxes in the Marketplace Portal.

List Items:
- Switch to Static Entry (default) - Enter the name and value for an entry in the list. After the value entry, a new item line is displayed automatically.
- Switch to Dynamic Entry - Select a script name and specify the HTTP parameter names and token values.
  - Validation Script - Both dynamic property and semantic validation are implemented as drop down list with script names and (none) value. There are manage scripts and configure parameters links with respective functionality.
    
    Note Manage Scripts displays only scripts for dynamic properties.
    Script parameters are similar to dynamic properties and new Tokens are defined CURRENT_ VALUE (current running subscription value of property and not currently edited request).
  - Manage Scripts - Click to manage JavaScript files that can be used to provide values for the dynamic list properties. See Script Management.
  - HTTP Parameters - Specify the HTTP parameters to use when executing the script. The required input parameters are dependent on the script that has been selected; contact the script developer if necessary to determine the necessary input parameters.
    - Parameter Name - For each Parameter Name you enter, supply a Parameter Value, which can be a token or a constant value.
      
      Note The script is invoked at subscription ordering or modification time by the user csaReportingUser, who has read-only access to CSA. For more information on this user, see the Cloud Service Automation Configuration Guide.
    - Select Token - Click the Select Token icon () to enter a token. See Tokens.
  - Refresh Data - Click the Refresh Data icon ( ) to run the script and display the results.

For String properties:

Service Offering and Marketplace Portal Settings:
- Editable - Select to make this field editable in the Offerings area and in the Marketplace Portal.
- Required – Select to indicate that when a subscription is ordered, a value must be provided for this field.
Input Type:
- Single-Line - The input area is presented as and accepts only one line of text.
- Multi-Line - The input area is presented as a text box and can accept one or more lines of content.
- Number of Characters - Configure the minimum and maximum number of characters that can be entered for this property. These fields are available only when the Editable and Single-Line options are selected.
- Input Restriction - Choose an Input Restriction from the following list. These fields are available only when the Editable and Single-Line options are selected.
  - (none) - No input restriction will be performed. A minimum and maximum length can still be configured.
  - Custom Regular Expression - Validates the value based on a regular expression, as specified in the Regular Expression text box.
  - Email Address - Checks that a valid email format is entered.
  - IPV4 Address - Checks that a valid IPV4 address is entered.
  - IPV6 Address - Checks that a valid IPV6 address is entered.
  - Non-Numeric Characters - Checks that no numeric characters are entered.
  - URL Address - Checks that a valid URL format is entered. The regular expression used for validating the URL values may allow creating some invalid URL values such as http, http:/, http:// or hhh:////. This is because the regular expression validates a wide range of official IANA-registered schemes, which may not detect some invalid URL values.
- Default Value - Type a string of characters.
- Confidential - Select this box to mask the values so that they cannot be read in the user interface; no encryption of the value is performed. Note that this field is available only when the Single-Line option is selected.

Property Bindings Select the topology component or group to which you want to push the value of this property. Then select the appropriate property from the list of compatible properties. This is called a target binding.

Property icons

Edit Property - The Property Type cannot be changed, but any other fields related to the property type can be edited.

Bind Property - Binding is a link between option model properties and service component properties or groups in a design. A property can have more than one binding. Click the Configure Bindings icon to display a working area where you can view and delete existing bindings and configure new bindings.

Delete Property - Click the trashcan icon to delete the property.
Copy properties - Click the Copy Property to All Options icon to copy the current property to all options in the current option set. This icon is only present for Single-Select option sets.

Send Help Center feedback