Appboard/old/data collections

Revision as of 19:45, 13 March 2012 by imported>Cmace (created to remove appboard_builder)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

HeaderFlow03.png

Data Collections are sets of tabular data that are maintained in memory by AppBoard. The contents of the Data Collections can be manipulated through filtering, grouping, sorting and pivoting features available in the Data Collections Wizard. Associations can also be established between collections to support the visualization of multiple data sets.



Reviewing Data Collections

Use these instructions to view a list of all Data Collections that are available in the system:

  1. Click "Data Collections" link in the left side tool pallette.
  2. Data Collections are listed in a data grid in the first page.
  3. To preview the data in the Data Collection you can hit the preview button on the same line.


Adding a Data Collection

Use these instructions to create a new Data Collection:

  1. Click "Data Collections" link in the left side tool palette.
  2. Click "Add" button at the bottom of the page.
  3. Enter a unique name for the new Data Collection.
  4. Select the Data Source from the drop down list.
  5. Choose the Polling Interval value, these are in seconds.
  6. Add any optional Context Data Class
  7. Add any optional Filter Rules. See Filtering a Data Collection.
  8. Click the "Next" button.
  9. Add any Client Side Filter Rules as needed.
  10. Click "Finish" to create the Data Collection.


Name Description
Data Collection Name Your unique name that you give to the Data Collection.
Data Source The Data Source being used in this Data Collection
Polling Interval
Context Data Class


Server Side Filter

If you want to add a Server Side Filter, in the "Configure" screen of the "Data Collections Wizard," click "Add Rule" under the "Server Side Filter" field. You are given three options: Data Collection Context Comparison, Server Widget Interaction Comparison, and Simple Property Comparison. Here are some guidelines for each of the choices.


Data Collection Context Comparison

Field Description
Target Data Collection The Data Collection you are applying the filter to.
Property This is the property name to perform the comparison against.
Operator This is the operation part of the expression, IE. Equal to(=), Not equal to(!=), Contains, etc.
Local Property This is the property name of this widget that will be evaluated against the property of the other widget.


Server Widget Interaction Comparison

Field Description
Event The event that will cause the filter rule to be active.
Widget The widget whose property will be compared against.
Property This is the property name to perform the comparison against.
Operator This is the operation part of the expression, IE. Equal to(=), Not equal to(!=), Contains, etc.
Local Property This is the property name of this widget that will be evaluated against the property of the other widget.


Simple Property Comparison

Field Description
Property This is the property name to perform the comparison against.
Operator This is the operation part of the expression, IE. Equal to(=), Not equal to(!=), Contains, etc.
Value This is the static value that the property will be evaluated against.


Client Side Filter

If you wish to add a Client Side Filter to your Data Collection, click the "Add Rule" button in the "Client Side Filter" screen of the "Data Collections Wizard." From there, you will be given three choices: Match Regular Expression, Simple Property Comparison, Widget Interaction Comparison.


Editing a Data Collection

Use these instructions to modify an existing Data Collection:

  1. Click "Data Collections" link in the left side tool palette.
  2. Select the Data Collection from the data grid.
  3. Click "Edit" to view the selected Data Collection.
  4. Make any modifications to the Data Collection.
  5. Click "Finish" to save the changes to the Data Collection.


Removing a Data Collection

Use these instructions to remove an existing Data Collection:

  1. Click "Data Collections" link in the left side tool palette.
  2. Click on the Data Collection you would like to delete.
  3. Click the "Delete" button at the bottom of the page.
  4. Click "Yes" to confirm the removal of the Data Collection or
    click "No" if you do not wish to remove the Data Collection.