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

Overview
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.
Triggering a Vega Component in a Centauri Module
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 ![]() |
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 ![]() |
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 ![]() |
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.
Resources