Exporting Reports

From SmartWiki
Revision as of 14:52, 31 March 2011 by Cameron (talk | contribs)

Jump to: navigation, search

There are two techniques to access report data from other applications.

See Plug-Ins for Microsoft Office for details


This article explains how to use the 2nd method, which is exporting.

  • If you want to export the report data to any other data format (for example comma separated values), then you can use the Export settings for the report to create the file format required.
  • You can also use this technique to create a MS-Excel or MS-Word file, without the need to use the Plug-In application.


Procedure

  • Click the Advanced Export Setting tab.

The Advanced Export Settings window is displayed.

Reps200.png

This window consists of the following settings:

  • Header - Static or variables that you need to display at the top of the export file.
  • Fields - A list of fields taken from the report that is being used to create the report. In addition, you can select two special settings – {tab} – used to add a tab character to the specification and {break} – used to add a line feed to the specification.
  • Detail - You construct the actual record layout for the specification in this area. This section can consist of multiple lines.
  • Footer - Static or variables that you need to display at the bottom of the export file.
  • File Extension - The extension that you wish to associate with the export specifications. By setting this value to any valid Windows file extension, the appropriate application will be launched when the data is exported.


Each field will be delimited by a tab character ({TAB}), and a line feed ({BREAK}) will be added to the end of each exported record.


File Extension

By setting the file extension, you define which program on your computer should be used to process the exported report data. Some common extensions that are useful for exporting date are:

  • txt – Window Notepad.
  • xls – Microsoft Excel.
  • iif – QuickBooks.
  • csv - Comma Separated Values

1. Set the Extension to txt.

Reps199.png

The extension txt is generally associated with Notepad.

2. Click the Save button.

3. Click the Edit Report button.

4. Click the Reports tab.

The report list is displayed and the Employee list report is now displayed with an Export button.

Reps198.png

5. Click the Export button.

Depending on your Browser and Security setting, you may need to answer some prompts before the file can be opened.

Reps197.png

6. If required, click the Open button.

The file is opened in the associated application – Notepad.

The file name is set to the report name plus the extension specified.

Reps196.png

7. Close the Notepad application.

Export to Excel

If you change the extension to xls, then the file will be opened with MS-Excel.

1. Click the Reports tab.

2. Click the Edit button for the Employee List report.

3. Click the Advanced Report Settings tab. Advanced export settings.png

You can specify the layout of the report to be exported in the next screen Advanced export settings2.png

Header section : you specify the column headings for your report to be exported.

Fields : drop down gives a list of variables that correspond to the fields selected in the report through report builder.

Details section : you specify the fields for the report to be exported. The fields that you select will be displayed right to left in exported report so select the field for the last column first.

4. Change the Extension to XLS or CSV.

5. Save the Layout.

6. Return to the Report list and click the Export button.

Advanced export settings3.png


The File is opened in MS-Excel.

Excel report.png


IMPORTANT: In order to support special characters such as French accented letters, euro symbols etc SmartSimple uses UTF-8 encoding. When opening exported files Microsoft Excel always imports using ASCII, so special characters do not appear correctly. This is a flaw with Excel. In order to export data containing special characters to Excel use one of the procedures outlined on the Exporting Reports with Special Characters to Excel article.


Note: If the report has sub reports attached then you must set up the Advanced export settings for each of the sub report attached.

Exporting with Subreports

In order to export a report that contains subreports or merged reports you must define the Advanced Export Settings for the subreports, as well as the main report.

Example:

  • The following would export a report and subreport is Comma Separated Values format (CSV):
@Companies/Accounts - Company name@,
@Companies/Accounts - Address 1@,
@Companies/Accounts - City@,
@Companies/Accounts - State@,
@Companies/Accounts - Company ID@,
@subreport_0@
{BREAK}


See Also