Parameters

Updated: June 4, 2021
Contents

Overview

Product parameters enables Vendors to collect data from customers that ordered their product and store data related to product fulfillment. Therefore, three different phases of Parameters can be configured within the Parameters section as schematically illustrated and described below:

  • Ordering phase Parameters are specified during the ordering phase by Customers.
  • Fulfillment phase Parameters are set during the fulfillment phase by the Vendor.
  • Configuration phase Parameters are defined and managed even before any order is placed.

Important!

All of the Configuration-phase-related functionality is applicable to Vendor scenarios only. Therefore, Distributors, Resellers, or Customers can NOT modify or even view any configuration phase parameters.

Note that parameter attributes are localized and not versioned.

The following describes all parameter aspects and showcases how to create a parameter on the CloudBlue Connect platform.

Parameter Creation

Proceed your product profile page and navigate to the Parameters section to access your parameter list.

Click the Create Parameter button to launch a parameter creation wizard.

Follow the wizard steps to successfully configure a new parameter.

Type

First, the system requires to specify your parameter type. Choose between email addresses, objects, passwords, choices and other types. Thus, for example, in case your customers should specify email address before ordering your product, select the email parameter type.

Note that available options (such as placeholder text and hint text) vary depending on your selected type.

Phase and Scope

Specify your parameter phase in the following form.

This step has 3 groups of settings, depending on the Phase (Ordering, Fulfillment, or Configuration). All 3 scenarios are described below.

Ordering phase

The customer is asked to provide value for the parameter unless it is hidden. In most cases, such value will be collected by Distributor’s commerce system.

Ordering phase could cover 3 scopes:

  • Subscription: Select this scope to associate your parameter with provided subscriptions.
  • Tier 1 – Choose this scope to collect or store reseller authorization details of your first tier reseller (direct reseller).
  • Tier 2 – Select this scope to collect or store reseller authorization details of your second tier reseller (reseller of the reseller)

Enabled Capability is required!

Note that selecting Tier 1 or Tier 2 scopes for Ordering and Fulfillment phases is available only in case Reseller Authorization capability is enabled.

Fulfillment phase

Fulfillment phase requires Vendors to provide parameter values upon request fulfillment.

  • Typical examples of such parameters are service IDs like “tenant id”, “customer id” or any other data that is used to identify a particular subscription for Vendor’s system.
  • Additionally, this kind of parameter can be used to store attributes that should be specified for the customers (like activation keys, links, etc.). Such parameters typically used in the Activation Templates.
  • Furthermore, in case of fulfillment automation via the Subscription API, such parameters can be used to handle multi-step asynchronous provisioning. For example, Vendors create a parameter that stores information on the provisioning stage and corresponding data attributes.

Fulfillment phase parameters can also cover 3 scopes (Subscription, Tier 1, and Tier 2), same as Ordering phase scopes that are described above.

Configuration phase

The Configuration phase is used to store a number of custom parameters defined and managed before an order is placed. Configuration phase parameters can cover the following scopes:

  • Product: Such configuration parameters are created in the scope of the whole Product and thus are handy to store some constant values used by the fulfillment automation middleware.
  • Marketplace: This scope is useful to store configuration parameters that vary per Marketplaces, like API Endpoint URLs and access information.
  • Item: Use this scope when Item’s MPN attribute is not enough and there is a need to store additional configuration values associated with an Item.
  • Item x Marketplace: When there is a need to store additional information associated with an Item in each Marketplace, Item x Marketplace scope will make this process simple for you by managing them in a uniform way.

Constraints

The list of constraints displayed in the following form vary depending on your selected Phase and Scope. The following describes all available constraints:

  • Required: Mandatory parameters marked as required is enforced by the system in the corresponding phase and scope, e.g. request can’t be fulfilled until all of the required fulfillment-phase parameters are set.
  • Hidden: This constraint comes handy when some conditional logic is required for a given phase and scope. For example, “ask for the parameter only in case of some other condition”, and so on.
  • Unique: Parameters marked with this attribute are checked by the system for uniqueness while storing them in the corresponding scope and phase.
  • Visible by Distributor: When there is a need to make some configuration parameter visible for the Provider, this constraint can be used. For example, “partner code” or similar scenarios.
  • Editable by Distributor – When there is a need to make some configuration parameter not only visible but also editable for the Distributor, this constraint can be used. For instance, “partner access configuration” and scenarios alike.
  • Primary Vendor Reconciliation ID: Value of this parameter can be used as a primary reconciliation ID for matching with Vendor systems. Only one fulfillment phase parameter can be marked as reconciliation ID for a given product.

Details

Specify your parameter details in the following form:

  • ID: Unique identifier of the parameter in the context of a product. Specific IDs are also required to identify parameters using the Subscription API.
  • Title: This text will be shown within the different system inputs. Note that in case that an ordering phase parameter is specified (and not hidden by using constraints), this title will be visible to a customer.
  • Description: This text allows providing meaningful information for what the parameter is used for.

Click the Create button to finalize your parameter configuration.

Summary

As a result, your parameter will be successfully created, The system will also display they parameter summary.

Click Go to Details to review your parameter configuration. Otherwise, click Close to close the summary.

Removing Default Parameters

If you try to delete the product default parameters, your attempt will be rejected because the default parameters are used in the default activation template that is configured within the Embedding section. To delete the parameters, you need to edit the templates that use these parameters as follows:

  1. Access the Embedding section from the product profile page.
  2. Navigate to the Templates tab.
  3. Locate Subscription Approved Template and edit Default Activation Template.
  4. Remove the section where the default parameters are included. Don’t forget to click Save to save your changes.
  5. Proceed to the Parameters section and remove both default parameters.

As a result, default parameters will be successfully deleted.

Is this page helpful?
Translate with Google
Copied to clipboard