How to: Configure Triggers and Values Using Cross-Runtime Support

Cross-Runtime Support allows Centauri  modules to trigger or send values to Vega-compatible components inside a Vega-enabled Panel component. Additionally, Vega components inside a Vega-enabled Panel can trigger Centauri logic using Cross-Runtime Support and the Operations Builder.

Set up Cross-Runtime Support in our How to: Use Cross-Runtime Support article.

There are three methods for triggering, or sending values to components between runtimes:

  • Trigger a Vega Component in a Centauri module: Creators use a Centauri logic component and the vegaExecute Output type to execute (trigger) a Vega component inside a Vega-enabled Panel component.

  • Send a Value to a Vega Component in a Centauri module: Creators use a Centauri logic component and the vegaValue Output type to send values from a Centauri module to a Vega-enabled Panel component containing Vega compatible components.

  • Trigger or modify a Centauri components from a Vega-enabled Panel component : Creators use the Operations Builder's Execute External Command operation to trigger or send a value to a Centauri component.

Click on the tabs below to learn how to use each method.

For this example, display a hidden Text Field component by configuring Centauri Button and Initializer components to trigger Vega logic inside of a Vega-enabled Panel component.

The Initializer and Decisions are the only components that trigger Cross-Runtime Support.

What You Need

To configure the Centauri module, you need the following components:

Configure the Vega Panel component

For this example, enable the Vega runtime in a Panel component:

1. In the Module Builder, drag and drop a Panel component onto the canvas.
2. In the Property ID field, enter panelVega.
3. Navigate to the Runtime settings.
4. Set the Render Components with drop-down to Vega (2.0).
5. Click Save Component.

Configure the Vega Text Field

Add and configure a hidden Text Field. Later, we'll use the vega

1. Drag and drop a  Text Field component on the canvas, placing it inside the panelVega Panel component.
2. In the Property ID field, enter lastName.
3. In the Label Text field, enter Last Name.
4. Under Default State Options, set Hide Field to  (ON).
5. Click Save Component.

Configure the Vega Initializer

1. Drag and drop a Radio Button component icon Initializer component on the canvas, placing it above the lastName  Text Field component and inside the panelVega Panel component.
2. In the Property ID and Canvas Label Text fields, enter initShowLastName.
3. In the Outputs table, enter the following:
  Source Type Value

1

lastName

visible

yes

4. Click Save Component.

Configure the Centauri Initializer

Setup an Initializer to target the Vega Initializer. Use dot notation to target the the Vega Initializer inside the Vega-enabled Panel component. You'll also use the vegaExecute operation to trigger the Vega Initializer:

1. Drag and drop a Radio Button component icon Initializer component on the canvas, placing it above the panelVega Panel component.
2. In the Property ID and Canvas Label Text fields, enter initCentauriShowLastName.
3. In the Outputs table, enter the following:

#

Source

Type

Value

1

panelVega.initShowLastName

vegaExecute

GO

4. Click Save Component.

Configure the Centauri Button

1. Drag and drop a Button component Icon Button component on the canvas, placing it below the panelVega Panel component.
2. In the Property ID field, enter btnCentauriShowLastName.
3. In the Label Text field, enter Display Last Name Field.
4. Navigate to the Actions settings.
5. From the Action Type drop-down, enter or select Event.
6. From the On Click field, enter or select initCentauriShowLastName.
7. Click Save Component.
8.  Save  your module.

Preview your module in Express View. You'll see the following functionality:

 

Best Practices

  • Only use the vegaExecute and vegaValue output types in Centauri logic components to interact with components in a Vega-enabled Panel component.

  • Only use the Execute External Command operation in a Vega-enabled Panel component to communicate with Centauri components.