Configure a Form to Run a Data Source

You can configure the action of loading a data entry form to act to run a data source. To do this, you associate a data source with an existing data service, associate the form with the data source, and then define the trigger or triggers for the form to load data from the data source.

Tip: If you have not yet created the data source for which the loading of this form should act as a trigger, you can select the trigger when you create the data source instead. For more information, see Create a Database Data Source or Create an Alternate Data Source.

To configure the loading of a form to act as a trigger in Application Design , use this procedure.

1. In Application Design , open or create a new form and add fields to the form. For more information, see Adding Controls.
2. Associate a data source with an existing data service. For more information, see Configuring Label Data Sources.
3. Do the following to associate the form with the data source.
   1. In the View > Data Sources pane, click the new data source you created in step 2 to display the list of available fields.
   2. Click and drag a data source field onto a field onto the form to assign the data source as the data ref for that field. Your cursor changes when your pointer is over a field that can accept the data source.
4. Do the following to define the trigger or triggers for the form to load data from the data source.
   1. From the Insert tab, click and drag Run Data Source to the canvas. The Run Data Source Action dialog box appears.
   2. Trigger Source should be set to the form, and Trigger Event should be set to onLoad.
   3. Set the Priority if necessary. For more information, see Configure the Running Order for Queries and Rules.
      

      Tip: If the form acts as a trigger for more than one data source and the order in which the data sources are run relative to each other is important, then you must configure values for priority The order in which actions, rules, or data services that have otherwise identical triggers are run. Priority values are compared only if the actions have the same trigger source, trigger event, and trigger key (if any). The type of trigger source is irrelevant. Among actions, rules, or data services with otherwise identical triggers, the trigger source with the lowest value for priority is run first. for these actions.

   4. If the data source should only run under a certain condition. Select Conditional, and describe the conditions.
      1. Enter a Name.
      2. Select an Operator.
      3. Enter a Value.
   5. Select the data source to use for the action from the Data Sources.
   6. Click OK.