Designer:Data composer

From FlexRule Wiki
Revision as of 09:50, 11 June 2017 by Michael (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

FlexRule Designer > Sample Data > Data Composer


Data composer is a utility in FlexRule Designer that allows you to create and prepare sampling data visually for different purposes. For example, either in debugging and testing you might need to prepare some data.

Introduction

When a project rule project is loaded, simply go to the tools menu and select "Data Composer" as shown below.

Datacomposer-menu.png

Then the Data Composer form will appear.

Dc.png

Data Composer allows you to create a collection (Array) of objects.

Data Composer Form

Its form contains the main section

  • Data list (left side)
  • Object information (right side)

When a new object is created it will be listed on the left side panel. The details of the object will be listed in the right panel.

Dc-toolbar-load.png This button allows you to browse for previously saved data (using Data Composer) and reload it for use or modification.

Dc-toolbar-clear.png Clears the list of added objects

Dc-toolbar-add.png Allows adding a new object of a specific type

Dc-toolbar-add-collection.png Allows adding collections:

  • Empty collection of objects (System.Object)
  • Empty collection of a dynamic object whose elements can be manipulated with Data Composer

Dc-toolbar-add-duplicate.png Creates a duplicate of the selected object in the list

Dc-toolbar-add-delete.png Deletes a selected object from the list

Dc-toolbar-add-up.png Changing the order of objects in the list, moving up.

Dc-toolbar-add-down.png Changing the order of objects in the list, moving down.

Dc-toolbar-add-save.png Saves the prepared data for a file that can be used later on.

Dc-toolbar-watch.png Evaluates, Loads then shows the constructed objects to the Watch window.

Adding New Object

To add a new object, you can simply click Dc-toolbar-add.png and an empty item will be added to the list.

Dc-AddObject.png

Simple Types

By filling in the type value on the right screen, you can create some simple values (e.g., string, integer, etc.) Here is the list of simple types:

  1. System.String
  2. System.Int
  3. System.Double
  4. System.Long
  5. System.Boolean

For example, when you enter 'System.String' in the 'type' field, then you can extend the 'Value' node as shown below:

Dc-AddObject-SimpleValue.png

Complex Types

Complex types are the ones that are not defined by default like simple types, and you need to provide an assembly (a .dll) and select a type from a list. A complex new object needs a type and assembly (enter the type information). Please note that the assembly should be referenced in your project. If it is not, go to the "Project->Properties" menu and then select "References" and add your assembly. It is a good practice to keep all the assemblies local to your project folder. Once the type and assemblies are added, you will see the following screen:

Dc-AddObject-fill.png

Then you can simply expand the "Value" node. An empty type is then created for you to add the properties values:

Dc-AddObject-Value.png

Adding new Collection of Objects

When you select Dc-toolbar-add-collection.png, there are two types of list available:

  1. An empty generic list called Object List. This empty list cannot be modified at design time.
  2. A dynamic list that you can use Data composer to add more elements to it

If you select the Dynamic List and the select the item from left side panel, then you will see the image shown below.

Dc-AddObject-DynamicList.png

If you click on the button that the red arrow shows, then a new Data composer window will be launched. Now you can create the elements of the selected list from previous Data composer screen.

Watch Data

When you can construct your data using Data Composer, you can send the data to a Watch Window to see exactly how it looks.

Dc-WatchWindow-menu.png

By pressing the Watch button, the Watch window will appear and show you the value of your object:

Dc-WatchWindow.png