Configure a blueprint rule

Configure a rule that contains actions the system can take on blueprint attributes or events.

Before you begin

  • Role required: sn_cmp.cloud_service_designer
  • A blueprint attribute or event.

Procedure

  1. Open a blueprint, click Operations > Form, and open an existing form record.
  2. Open a record in the Catalog Properties or Events related list.
    Note: By default, the FormLoad and FieldChange events are provided. Most event rules can be based on one of the two events.
  3. On the Rules related list, click New and then fill in the form.
    Field Description
    Name

    Description

    Enter a name and description.
    Source Field Select a catalog property on which to base the rule.
    Order

    Enter a number that tells the system which record to evaluate first in relation to others. The record with the lowest number runs first.

  4. Right-click the form header and select Save.

Example

This example rule is based on the CloudAccount property and contains an action that tells the system to update the list of locations when the user changes the cloud account.
Figure 1. Example blueprint rule
An example blueprint rule

What to do next

Configure a condition and action.

Configure a blueprint rule condition

Configure the condition on a blueprint form event rule that determines when the actions in the rule can run. Conditions are optional.

Before you begin

  • Role required: sn_cmp.cloud_service_designer
  • A blueprint rule for a property or event.

Procedure

  1. Open a rule for a property or an event on a blueprint.
  2. On the Conditions related list, click New.
  3. Fill out the form fields (see table).
    Field Description
    Operand Enter the property against which you can perform the condiontal evaluation. For example, if your blueprint has a property which holds the value of a datacenter, enter the property name here.
    Operator Select an operator that evaluates the operand.
    Value Enter a value that the evaluated event rule must match.
    Condition Type
    If you configure multiple conditions, select the logical operator that determines how the system evaluates the condition in relation to the next condition (the next condition is determined by the Order field):
    • AND: this condition the next condition must meet the criteria before the policy is eligible for execution.
    • OR: this condition or the next condition that matches the criteria can allow the policy to be eligible for execution.
    If you do not select an option, AND is used by default.
    Order

    Enter a number that tells the system which record to evaluate first in relation to others. The record with the lowest number runs first.

  4. Click Submit.

Example

This example condition applies when the user selects the AWS Datacenter for the Logical_Datacenter property, which is a field on the catalog item form:
Figure 2. Example blueprint condition
Example blueprint condition

What to do next

Configure a blueprint action.

Configure a blueprint action

Configure actions that the system runs when blueprint form attribute actions or event actions are triggered.

Before you begin

  • Role required: sn_cmp.cloud_service_designer
  • A blueprint rule for a property or event.

About this task

Note: You can override properties in policy actions and blueprint form event actions. If you configure overrides in both places, the blueprint form event override gets triggered last and takes precedence.

Procedure

  1. Open a rule for a property or an event on a blueprint.
  2. On the Actions related list, click New and then fill in the form.
    Field Description
    Name Unique and descriptive name.
    Action Type Select an action type:
    • Reload:
    • Show:
    • Hide:
    • MakeMandatory:
    • MakeNonMandatory:
    • TriggerChangeEvent:
    • SetValue:
    Datasource Select an action type:
    • Reload Cloud Account:
    • Reload Cloud Location:
    • Check Quota:
    • Reload Resource Profile:
    • Reload From Profile:
    Target Field Enter the name of the field on the form that the action applies to. For example, if you selected TriggerChangeEvent for the action type, the value of the field changes when something changes on the form, as specified in the blueprint rule.
    Value Enter an optional value that you want to assign to the target field. For example, if you selected SetValue for the Action Type field and you want to update the Resource Group Name, you can use the value ${ResourceGroup}, which pulls the names of the resource groups from the blueprint.
    Order

    Enter a number that tells the system which record to evaluate first in relation to others. The record with the lowest number runs first.

  3. Right-click the header and select Save.
  4. Enter an optional Key and Value in the KeyValues related list. The value in the Value field is applied to the attribute in the Key field.
  5. Create as many actions as necessary.

Example

This example action applies to the blueprint rule example, which is based on the CloudAccount attribute. The action tells the system to update the list of locations when the user changes the cloud account.
Figure 3. Example blueprint action

What to do next

Publish a blueprint as a cloud service catalog item.