Adding Data Fields

Data fields are fields that will be filled with live data from the datasource when the report is run. While the template is being edited, ReportWeaver displays the field name in the cell where the data field appears. Data fields are treated differently when they appear in a table:

Table fields are data fields that come from a collection. They are placeholders for a whole column of data in the report. A table field is created automatically when a field of an object in a collection is added to the report. Table fields can only appear in a table template. When a table field is added to a frame, the table template is created for you. This happens with the table wizard.

Singular fields fields appear only once per report. They are created for fields that are reachable from the master object of the report without traversing a collection.

Adding a field to a template

To add a data field:

  1. Select the field tab in the structure pane.
  2. Drag the the field onto the page.
  3. Drop it below the other cells.
  4. The field will appear right below the bottom cell.

The field will be added to the grid as shown below:

  1. The red rectangle shows where the field will be placed.
  2. You can drop a field between two cells. Then a new row/column will be added automatically to place the field.
  3. Dropping a field anywhere below the the other cells will add the field as a new grid row at the bottom.
  4. The field will be added to the cell. ReportWeaver does not add live values immediately. Instead it adds a placeholder with the name of the field. This placeholder will be replaced with live data when the report is run.
  5. The indicator at the bottom shows the name of the data field and its type .

Important:ReportWeaver uses a grid to layout a template. Elements are not placed at the random location where they are dropped, but rather snap into place in the grid. Please take a minute to learn how ReportWeavers grid based layout works. Grid based layout speeds up report devlopment and allows the layout to adjust elegantly to changing contents.SeeGrid Based Layout

Note: The grid is indicated by grey lines to make placement easier. If you want to view the template without the grid,select View/Toggle Grid from the menu.

Adding fields from related objects.

You can easily add fields from nested or related objects. ReportWeaver will automatically create the required navigation path. E.g., to add the elements_length (which is in a related object accessed through the products member), simply open the branch labeled products in the fields tree of the structure pane. Then drag the elements_length field onto the template.

  1. Links between objects are indicated by the object link icon . They are shown when there is a 1:1 relationship in the database (or an object reference)
  2. ReportWeaver will then create a field called products_elements_length that automatically navigates to the related value.
  3. Note: Be careful when you navigate across a collection icon . It indicates a 1:n relationship (or a collection of objects) in the database. You can also drag a collection or a field from a collection element to the template. However for collections ReportWeaver will pop up the table wizard. SeeCreating Tables.

To modify the arrangement of cells using drag and drop please see the chapter on SeeGrid Based Layout