The Seed Data Wizard eases the task of applying existing seed data to messages or actions within a clip by permitting the user to select an Input value to replace a selected value with seed data from an existing repository or URL-based seed data file.
The Seed Data Wizard button is used to launch the wizard on selected text (much in the manner of the Session Template Wizard) and ease the task of deploying seed data into a specific clip context.
The steps below demonstrate how the user can select text, specify a custom property to store values, and a seed data file from which to populate values. The example used is from an iOS app that presents a periodic table of elements expressed by element name and the content offset (in the list of elements) from the top of the app. The seed data object, Randomized Table of Elements, has two columns as shown below.
Use the following steps from either the Info Window for an app action or from the lower panel editor.
Select the portion of an Input value to replace. For example, in the Locator field shown below the value of the locator, Americium, is selected.
The Seed Data Wizard appears with the Value field populated by the selection text. Create New Property is selected by default and existing properties are listed.
After selection, click the Seed Data Wizard button on the Clip Editor toolbar.
Enter a new property name (or make a selection from the existing list if the property you want already exists).
In the Value type drop-down, specify the repository or URL type.
For Repository, select the seed data object to use.
For URL, enter the CSV file to access. This must be in a reachable location.
In the Data section at the bottom of the wizard, optionally change Row representation to Struct.
If Struct is selected, the Column selector will use the format ".ColumnName.”
If Array (the default) is selected, the Columns selector will use the format ".[index]."
Click the Columns button to reveal the Column selector.
If array was selected in the Row representation field, the Column Index selector appears.
If struct was selected in the Row representation field, the Column Name selector appears.
Select the first column to use (the columns are presented by index, starting with 0). For example, our seed data file has two columns, Element Name and Offset from Top.
Tip: Check Save value for analytics to see this custom property in results.
Click Apply. The wizard progress bar shows the change being applied, backs up the clip and lists its name.
Click Close to exit the wizard. The resulting substitution takes the specified format. Instead of Americium, we have property.column name (or property. if array was used).
Next, return to the Inputs view for the given app action (App Action8 in this example), and select the second value to replace (in this case, the Tap Offset).
After selection, click the Seed Data Wizard button a second time—this time with the Tap Offset value shown. The wizard appears. Not that the custom property created above is now listed.
Click the Column Name drop-down (or Column Index if you used array above).
Click Apply. Once again the value is applied.
Click Close to exit the wizard.
Save the clip after making the above changes. App Action8 is shown with the applied changes above.
You can examine and edit, if desired, the clip custom property after using the wizard by clicking the Clip Editor, Properties tab, Clip Custom Properties node.
After setting up the new clip custom property using the Seed Data Wizard, it can be easily applied to subsequent messages. To do so, select the text as we did above and then invoke the Seed Data Wizard on it. Alternately, you can select the text and then click the Properties button to invoke the ISSE Editor.