In this section, you can set up a configuration wizard, which assists users with handling complex data configuration tasks. The UI part is the same as any Configurator where users provide input for several parameters with cascading dependencies. The advantage of a Configuration Wizard is that it can take the user inputs and further work with the data, for example, write to Company Parameter or Product tables.

The Configurator Wizard can also be a convenient way to allow users to modify data tables without giving them the required user privileges. Users will not be able to modify data directly but could do so in a controlled way using the wizard – no permissions are required but users can only modify what the wizard allows them.

Create Configuration Wizard

To create a Configuration Wizard, do the following:

Define two generic calculation logics:
- Configuration Wizard logic – This logic defines the configurator UI with user inputs. See the Configurators section for details.
- Execution logic – Retrieves the inputs from the configurator and executes the programmed actions (e.g., writes to Company Parameter tables or to Product Master).
Go to Administration > Configuration Wizards Admin and add a new wizard.
Select the previously created logics.
You can limit the availability of the wizard to specific user groups.
The new Configuration Wizard will appear in the Master Data > Configuration Wizards menu.

Example:

In this very simple example, we will show how user inputs are configured, the values entered by the user retrieved and a Product record updated.

Let's start with the wizard logic – the first element defines a user entry, where the user selects a product.

def cep = api.createConfiguratorEntry(InputType.PRODUCT, "Product")
return cep

In the second element, the label of the selected product is retrieved and pre-filled in the Label field. The user is supposed to change the label.

def productSku = api.input("Product")

if( !productSku ){
  def ce = api.createConfiguratorEntry()
  ce.setMessage("<div style='margin:20px;color:red;'>Please select Product</div>")
  return false
}

def descr = api.product("label", productSku)

def ced = api.createConfiguratorEntry(InputType.STRINGUSERENTRY, "Label")
ced.getFirstInput().setValue(descr)

return ced

In the execution logic, the user inputs defined by the wizard logic and filled in by the user are retrieved ('Product' and 'Label') and the Label value for the specified Sku is written to the Products table:

def sku = api.input("Product")
def label = api.input("Label")
api.logInfo("Configurator Wizard Runner: sku", sku)
api.logInfo("Configurator Wizard Runner: label", label)

if( !sku ){
  api.logInfo("Configurator Wizard Runner: SKU is missing!", "")
  return false
}
if( !label ){
  api.logInfo("Configurator Wizard Runner: Label is missing!", "")
  return false
}

api.update("P", ["sku" : sku,"label" : label])

Further settings:

You can also add custom buttons to the wizard to allow users to perform various actions.
The possible actions include:
- recalculate configurator
- open a document (Manual Price List, Quote, etc.)
- execute the execution formula
- clear and reset
- close the configurator
- open a web link in a new tab
- launch a configuration wizard
Results of the execution logic can be displayed directly in the wizard dialog (they are renderred as readonly):

Run Configuration Wizard

Go to Master Data > Configuration Wizards.
Select a wizard from the list.
Enter the required information and click OK.