Smart Content Forms Manual

The Smart Content app is divided into three screens: Forms, Templates and Setup. This manual is focused on Forms, where data is gathered and content is generated.

Data Files

Data files are used to store data in a way that can be accessed by smart content reports. They use the *.nsdata file extension and follow the W3C-backed XML open standard.

Files are accessed using the file tree on the left side of the window, which is discussed further in the Tag user manual. The Forms screen is shown below after selecting an empty demo folder as the current favorite.

Importing sample files into an empty folder in the Forms screen

To shorten this explanation, it helps to reuse some existing files. The Import / From sample / Custom order menu item copies a simple data setup file, a report file, and an empty data file (along with some other files).

New data files can also be created using the + menu beneath the file tree. You will be prompted for a report (template file) in the same folder or a different location.

After importing the sample, select the Custom order.nsdata file and then the order form tab. This will display the auto-generated form that gathers data for the order.rng data setup file.

Form that gathers data for the order.rng data setup file

It should be noted, that this form was generated entirely from information in the data setup file. The Custom order.nsdata file has a reference to a report (Order summary.xsl), and will create one form for every imported (direct or indirect) data setup file.

Auto Upgrading Data

If you change, add or remove any of the data setup files imported by a report, the data file may be auto upgraded on next use. Whenever a *.nsdata file is opened in Tag, any change in data definitions will be detected. The user will have the choice of upgrading the data, or not opening the file in the Forms screen.

If the file is not opened, it can still be accessed in other ways (e.g., to generate a summary report, convert to another format, etc.). It simply cannot be used to generate content in Tag, unless it is fully consistent with the current version of the report.

The process of auto upgrading data files will attempt to save as much data as possible. For example, if a data field is moved within the data setup file, it will trigger an auto upgrade with no data loss (the value is copied from old location to new location). If the field's name changes, or its properties change significantly, the value may not be copied.

Entering Data

Where possible, form controls will prevent invalid input. For example, if an Integer box is selected as a Form control in the Setup screen, then while entering data the form control will not accept any characters other than 0-9.

When entered data is invalid, an error message will appear (e.g., scaled scores must be within 0-20 range).

Data validation error shows in red above the form control

Sometimes there are many more fields in a data setup file than you want for a particular report. For this situation, there is a filter (in the more menu) on every form to only show fields that are required or used in the report.

Menu item to toggle filter for required/used controls only

Buttons to save data are beneath the form. If there are multiple forms you can also use navigation buttons at the bottom to move between them.

Auto Fill

If the data you want gathered in forms comes from other sources (e.g., database, other system, survey, cloud service, ...), the auto-fill feature can save you a lot of time. If you can get an extract of the data in CSV format, then it only requires a bit of mapping.

Menu item to open CSV import wizard

Each form has a more button (3 vertical dots) which has an Auto fill / Copy data from CSV... menu item. It opens a CSV import wizard.

First page of wizard confirms how to handle hidden fields

If the filter to hide unused fields in on (by default it is), the first page of the wizard suggests turning it off. Leaving it on will truncate the imported data to only use copy column values into fields that are visible in the form (i.e., required or used in report). Click Next to locate the CSV.

Table view of rows in the CSV

After selecting the CSV to import from, a table view of rows is displayed. When one row is selected to import, the Next button will become available.

The next page is where data mapping occurs. On the left side is a list of CSV column names. On the right is a list of data fields from the current form.

Empty data mapping panel

To map data values, click on a CSV column name on the left. Then click on the corresponding data field on the right. This creates a mapping line between the two which shows how data will be copied. Repeat until all columns of interest are mapped. Remove lines by clicking on them and pressing the Delete key.

Full data mapping panel

When the mapping is all done, you have the option to save it to a mapping file (*.nsmap). You can use mapping files to save steps during auto fill in the future, or add one to the report so it is always available in the form. More information is provided in the Templates manual.

It is possible to skip the step of creating a CSV when the data resides in another system. Tag has internal bindings for several system types that are not in the general user interface (e.g., database, web APIs, other applications, SPARQL and more). These bindings can be accessed by Enterprise level subscribers.

The CSV Import step-by-step guide provides another view of the auto fill feature.

CSV Export

The previous section showed how to copy data values from one CSV file to one data file. This section explains how to export (copy) data from one or more data files to one CSV.

The columns of a CSV file correspond to data fields. One row of a CSV corresponds to one set of fields (e.g., a data file).

The CSV export feature is accessed on the Generate page using the export menu, or using the more menu beneath the file tree and the Export / Comma separated values (CSV)... menu item.

Exporting CSV data using the export menu on the Generate page

Whichever way you initiate it, a wizard opens to walk you through a few steps. First, specify which file(s) to scan for values. If multiple data files are of interest, they must all reference the same report. This ensures they all map data fields to CSV columns in exactly the same way.

CSV export dialog where you can export from one file or several

When you click Next, the data is prepared for export and the number of rows is displayed. After clicking Next again you can choose a file location, save the CSV file, and open it using the default program to open CSV files on your computer.

Notification page that confirms valid data and shows row count

Here is a view of the exported CSV.

View of CSV results as a spreadsheet

The CSV Export step-by-step guide provides an example of combining four data files for the same report into a single CSV file with four rows.

Content Generation

After data has been entered into all forms, click the magic wand form tab to return to the Generation page.

Generation page - ready to create *.docx file

If there are no errors in any forms, then content generation is possible. The eye tool supports preview and is always available. You can see what the generated content will look like, but not save or copy.

Generation preview simulates *.docx output

The magic wand tool will also be available if your account has sufficient permission to generate to a file. If you purchase a subscription, you get unlimited generations as shown above.

New accounts also have unlimited generations during the free trial period. After that, they get 3 free generations to a file per month while using a $0 Community subscription.

Free tier accounts can manage their 3 generations to a file per month on this screen. The screenshot below shows that 2 of 3 free generations have been used so far this month. The counter resets each month on the day that the account was created (to a max of day 28).

Two of three generations have been used, link to purchase is showing

The shopping cart tool opens the self-serve billing portal in a web browser. Here you can securely purchase a subscription using a credit card. After making a purchase, clicking the refresh tool will update the screen to allow unlimited generations as shown earlier.

SEO Script Generation

[pending]