Overview of the Data Flow Interactions Feature
Data Flow Interactions allow certain variables from other widgets to be exposed to the Widget under specific scenarios. This way you can, for example, apply variables to text to dynamically state a donor list tier, for example.
Select External Widget
Choose the widget that you'd like to "listen" to in order to trigger the Data Flow Interaction. This can be selected from any of the pages, and stresses the importance of properly naming each widget.
Exposed Variables
Unique variables will be displayed based on the external widget selected. At this time the Donor List widget is the only widget with exposable variables.
Format
The ${} format indicates to the system that this is an internal variable. Applying the variables against qualified widgets will be covered later down this page.
Variables
${fullname}
Tables
Uses Column A (Column 1) in the Donor List widget's currently viewed List to output the full name. Typically this is used when a name is clicked on to expose further columns against it in the Tables.
Blackbaud Raiser's Edge NXT
Uses the combined full name including their Title (if selected) to output the full name. Typically this is used when a name is clicked on to expose further variables. At the time of writing, there are no additional variables to pull from Raiser's Edge NXT but do please provide feedback of your use case as we are actively seeking to expand this functionality.
DonorPerfect
Uses the combined full name including their Title (if selected) to output the full name. Typically this is used when a name is clicked on to expose further variables. At the time of writing, there are no additional variables to pull from DonorPerfect but do please provide feedback of your use case as we are actively seeking to expand this functionality.
Google Sheets
Uses Column A (Column 1) in the Donor List widget's currently viewed List to output the full name. Typically this is used when a name is clicked on to expose further columns against it in the List.
${source_image_url}
Uses the image applied against the Donor List widget's List.
This is particularly useful in any situation where you want to change an image in an image widget so that it syncs with the current List.
For example, you could change the background depending on the List chosen.
${source_name}
Uses the List Name from the Donor List widget's List.
This is particularly useful in any situation where you want to change text in an text widget so that it syncs with the current List.
For example, you could change the title of a donor list depending on the List chosen.
Select External Widget Output
This is the defining event to where the Data Flow Interaction takes place.
The following widgets support the following output events:
| Widget Name | onClick | onDonorClick | onDonorShift |
| App | |||
| Clock | |||
| Donor List | X | X | |
| Image | X | ||
| Pager | |||
| Playlist | X | ||
| Pop Up | |||
| QR Code | |||
| RSS Feed | |||
| Search | |||
| Text | X | ||
| Weather |
For example, if you selected an External Widget that is an Image widget with an onClick event then when that image is clicked it will do the action defined in the Associated Internal Input.
Select Associated Internal Input
This tells the system what you want to happen to the selected widget when the chosen external widget does the "Output" chosen.
Available Input Actions
Not all widgets have the same input actions available.
| Widget Name |
Input 1 |
Input 2 |
Input 3 |
Input 4 |
| App | ||||
| Clock | ||||
| Donor List | shuffleToNextList | shuffleToPreviousList | setAnchor | setWord |
| Image | apply_exposed_variables | |||
| Pager | ||||
| Playlist | forcePreviousItem | forceNextItem | ||
| Pop Up | apply_exposed_variables | toggleShow | show | hide |
| QR Code | ||||
| RSS Feed | ||||
| Search | ||||
| Text | apply_exposed_variables | |||
| Weather |
Donor List Widget
shuffleToNextList
This is the action to move to the next page of the donor list. Typically paired with an image widget used as a button.
shuffleToPreviousList
This is the action to move to the previous page of the donor list. Typically paired with an image widget used as a button.
setAnchor
Moves to the selected letter chosen at the beginning of the name. This is typically paired with the Extra Input Data field which lets you define the letter.
For example, if you want an image widget to snap the donor list to the first name starting with G then you'd use setAnchor with Extra Input Data of G.
Note that this only searches by the first letter shown, and assumes that the list has been made alphabetical. This works best if the last names are shown first.
setWord
This is identical in concept to the setAnchor feature but instead of being a letter it would for a specific string of text. For example, you could set the Extra Input Data as "David" and it would show all Davids in the list.
For more robust searching, use the Search widget.
Image Widget
apply_exposed variables
This lets the variables pass from the external widget into the selected widget.
Use this to link it to the Donor List widget and pull the image from it to make that image available to the Image widget.
In this scenario we'd also need to apply the variable name to the widget URL so that it knows to use the Data Flow Interaction's variable for an image.
Note that in the Canvas configuration page you won't be able to view Data Flow Interactions functioning, but you can use the Canvas Preview feature to test it. It's suggested to keep the preview open in a separate browser tab while building a Canvas so you can test as you go.
Playlist Widget
forcePreviousItem
This is the action to move to the previous item in the playlist. Typically paired with an image widget used as a button.
Note that the playlist does not restart its timing on use of this feature. This is to ensure that synchronized widgets remain in sync.
forceNextItem
This is the action to move to the next item in the playlist. Typically paired with an image widget used as a button.
Note that the playlist does not restart its timing on use of this feature. This is to ensure that synchronized widgets remain in sync.
Pop Up Widget
apply_exposed_variables
Sends variables into the pop up widget for viewing. For example, it could pull and expose the Donor List widget variables for use in the pop up page.
toggleShow
Either hides or shows the pop up widget depending on its current state. If currently shown then this would hide the widget, and vice versa.
show
Shows the pop up widget into view.
hide
Hides the pop up widget from view.
Text Widget
apply_exposed_variables
Sends variables into the text widget .
For example, you could add the name of a donor to a pop up page.
Add Button
Most importantly, once you've configured the Data Flow Interaction, you'll need to press Add to get the interaction into the Canvas. After that happens, you should see the saved Data Flow Interaction in the Dataflow section.
