Designer GUI Overview

The DynamicPDF Designer is a layout tool used to create templates that are then used to create PDF documents. Layout elements are dragged, dropped, resized, and positioned to create a template as a DLEX file. The DLEX file, combined with a dataset, is then used to generate a PDF document.

The following topics list the DLEX document sections, major Designer Interface Layout elements, and then describes the major features of Designer.

Document Sections

Layout Elements

Main Window

Designer's UI consists of a toolbar along the application's top, the document window, and the properties window.

When opening Designer with no DLEX file loaded, you are presented with the File Explorer. You must either open a DLEX file from the File Explorer, add a file to your File Explorer from your local system, or create a new DLEX file.

After loading a DLEX file or choosing to create a new DLEX file, Designer is enabled.

Toolbar

The toolbar buttons along Designer's top are described from left to right.

Main Navigation Button

Switch the application you wish to work with by selecting the desired tool in the main navigation button (the DynamicPDF image). You can switch between DynamicPDF Designer, Environment Manager, and API and Help Documentation.

New and Open DLEX File

Selecting the New DLEX File button opens the File Explorer. Selecting Open DLEX File opens the File Explorer with the Create button replaced with an Open button.

Adding a File

Drag resources from your local system to the Drag files here to upload to this folder button to add files to your cloud storage space using the Resource Manager.

View DLEX Source

Selecting the View DLEX Source button opens the DLEX Source View.

Edit Layout Data

The Edit Layout Data is where you add or modify the DLEX file's JSON data. You can open a pre-existing JSON data file using the File Explorer and also save the JSON data.

Run Report

The Run Report button (the green arrow) will attempt to generate the PDF document from the DLEX file combined with the JSON dataset.

Add Page and Add Report

The Add Page Button adds a new page to the Document Window while the Add Report button adds a new Report to the Document Window.

Control Elements And Properties

You can add new pages and reports to the Document Window by selecting the Add Page or Add Report buttons.

Adding Elements to a Page or Report

You add elements to a page or report by right-clicking and making a selection from the context menu.

You add RecordBox elements by dragging and dropping the JSON field name from the Data Explorer.

Page

Upon creating a new page you are presented with a blank page. You can only add static elements and non-repeating top-level JSON fields to a page. Only valid selections are displayed in a page when you right-click and view the context menu (invalid choices are greyed-out).

Adding RecordBox or RecordArea

You can only add non-repeating top-level JSON fields to a page. For example, suppose you had the following simple JSON dataset.

{
  "Title":"My Report",
  "ReportCreatedFor": "Alex Smith",
  "Products": [
    {
      "ProductID": 17,
      "ProductName": "Alice Mutton",
      "UnitPrice": 39
    },
    {
      "ProductID": 3,
      "ProductName": "Aniseed Syrup",
      "UnitPrice": 10
    }
  ]
}

You could only add the Title and ReportCreatedFor elements to the page as a RecordBox or RecordArea. The repeating elements in the Products array must be added to a report rather than a page.

Page Properties

The Page Properties explorer contains formatting properties for a page.

Report

You create a report by clicking the Add Report button. This adds a blank report with header, footer, and a body section. The header and footer contains non-repeating data fields and static data such as labels. The details contains the repeating report data from the JSON dataset.

Report Properties

Property	Description
id	The identifier of the report.
bottomMargin	The bottom margin of the report dimensions in points (1/72 inches).
columnLayout	A value indicating how the data in the columns will be laid out.
columnSpacing	The amount of space between columns.
columns	The number of columns the report will have.
leftMargin	The left margin of the report, dimensions in points (1/72 inches).
pageHeight	The report height in points (1/72 inches).
pageOrientation	Drop-down with two choices: portrait or landscape.
pageSize	Drop-down list of most page sizes.
pageWidth	The width of the report dimensions in points (1/72 inches).
rightMargin	The right margin of the report dimensions in points (1/72 inches).
rowSpacing	The amount of space between consecutive rows in the report.
topMargin	The top margin of the report dimensions in points (1/72 inches).
dataName	The name from the JSON data that repeats for each record.
^^^
Figure 15. The Report Properties explorer.
^^^
This property specifies the manner in which the columns will be populated. The three options are explained below (default for a Report is verticalUneven, default for a Subreport is verticalEven):

1. horizontal – Records will appear horizontally across the columns. For instance, if a report has three columns, records will first be placed in column 1, then 2 then 3, then back to 1 and continue in this fashion. A column layout of horizontal will never be splittable.
2. verticalUneven – Records will vertically fill column 1, then proceed to subsequent columns. This is the default layout.
3. verticalEven – Records will vertically fill column 1, then proceed to subsequent columns. On the last page, the verticalEven option will layout the records so that they are as evenly displayed on the page as possible. For instance, if a report has three columns and the last page has 6 records to display, the verticalEven layout may display 2 records on each of the three columns. Where the verticalUneven layout may have just placed all 6 records in the first column.

Template

Templates are a powerful and easy way to add professional formatting to your reports. A template is added to a page or report. When added to a report, the template is divided into three sections, header, footer, and details in the report.

Resizing Template

When loading a template, you must resize the dimensions. For example, in the previous template, we resize the report's header, footer, left and right margins. We then must resize the header, footer, and details section's widths.

Resizing

Resize the report to use the appropriate dimensions for a template using the following properties.

Template Properties

Header/Footer/Details

A report's header, footer, and details are used to space the report to display correctly when the JSON data is applied to generate the report. Each report section is displayed using the following logic.

• The header repeats for each page of data.
• The footer repeats for each page of data.
• The details repeats for each data row.

For example, suppose displaying all the data in a JSON dataset took three pages to display, the header and footer would be displayed three times. The details would be displayed for each row within the dataset.

Header

Footer

Body