Changes

Jump to: navigation, search

Exporting Reports

679 bytes added, 16:12, 19 February 2021
Custom Export
__TOC__
 
=File Export=
[[Image:ReportExport.PNG]]
 
 
* '''Export Format''' - a dropdown list of different file format you can export the report to.
* '''Folder Type''' - can be exported to either a [[SmartFolders_Overview|SmartFolder]] or a [[SmartFolders_Overview#Configuration_-_Advanced|Configuration Folder]]
* '''Folder''' - choose the subfolder where you want to export the file to.
* '''Data Position''' -  determines the starting position of your list view results (the "data").
* '''Meta Data Position''' - determines the starting position of the report criteria (the "metadata"). If your report does not utilize [wiki/Criteria criteria], the Meta Data will be blank.
* '''Export File Name''' - set a filename that is applied when the report is exported. If left empty then the default name for exported file is "Book".
 
<pre>
Note: The syntax for both the "Data Position" and "Meta Data Position" fields is ''worksheet'';''column'';''row''
The default setting is 0;0;0 for both fields. This means that your list view results will be exported, with the topmost, leftmost value appearing in the first worksheet, in cell A1.
The numbering begins at zero, so the first worksheet, first column or first row would be referenced with a 0, as opposed to 1.<br /> Therefore, if you wanted either the list view results or the metadata to be placed in the<br /> third worksheet of your Excel file, starting in cell B4, you would enter ''2;1;3''<br /> The syntax for the first worksheet, cell A1 would be ''0;0;0''
</pre>
 
==File Extension==
A report can be exported into a flat file with the following file extension:
'''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 Custom Export settings for each of the sub report attached.
'''Note===CSV Data Security===When exporting data into a CSV format, files can become vulnerable to [https:''' If //owasp.org/www-community/attacks/CSV_Injection malicious CSV injection attacks]. As a precautionary measure, an additional space will be added at the report has sub reports attached then beginning of any values starting with at signs ( @ ), plus signs ( + ), minus signs ( - ), piping symbols ( | ), or equals signs ( = ). Therefore, when you must set up export a file from Platform3 into a CSV format and later need to import that file into another system, please ensure you trim the Custom Export settings for each additional space in front of the sub report attachedany values.
==Export to XML==
<details>{BREAK}
</pre>
 
 
 
 
2. In the '''Detail''' section add the child elements, in the sample below the child is ''employee'' with subchildren ''firstname'', ''lastname'', ''salary'' and ''startdate''.
* The following would export a report and subreport in Comma Separated Values format (CSV):
 <pre>@Companies/Accounts - Company name@,
@Companies/Accounts - Address 1@,
@Companies/Accounts - City@,
=Custom Export=
* Click the '''Custom Export''' tab (formerly Advanced Export Settings). The '''Custom Export''' window is displayedsettings allows users to configure the information they wish to export from SmartSimple to external applications such as MS Word, MS Excel or Quickbooks.
[[Image:Reps200.png|800px]]
This window consists of the following settings:
** '''COUNT''' - count the total rows per report. '''''@COUNT('''''column_name''''')@'''''
** '''SUM''' - sum of a column in the report. '''''@SUM('''''column_name''''')@ '''''
** '''Current Date''' - add current date using standard format YYYY, YY, MM, DD, HH, mm** [[Sscalculation|sscalculation]] can also be used in the header or footer<!--Ticket# 56482 - Ability to Sum and Count in report custom export header--><!--Ticket# 122241 - To add current date in the header for custom export report-->* Please refer to '''[[Exporting Reports with Total Group By]]''' when exporting reports when [[Using Total Group Options in Report Builder]] 
==Using Custom Export to SmartFolder or SFTPexport in Excel==A 1. Click the '''Reports''' tab. 2. Click the '''Edit''' button for the '''Employee List''' report . 3. Click the''' Custom Export''' tab.<br />[[image:Advanced export settings.png]] You can now specify the layout of the report to be automated to exported in the next screen [[image:Advanced export settings2.png]] '''Header''' section : you specify the column headings for your report to a SmartFolder or an external SFTP sitebe exported. You can now schedule  '''Fields''' drop down : gives a recurring task on a daily, weekly, or monthly basis list of variables that correspond to automatically run a the fields selected in the report through report and export builder. '''Details''' section : you specify the fields for the contentsreport to be exported.The file fields that you select will be exported based displayed right to left in exported report so select the normal field for the last column first. 4. Change the '''Extension''' to '''XLS''' or ''File Export'CSV''' and no option for . 5. Save the '''Custom ExportLayout'''  is currently available.<!--54913 - Ability to store report export to specified SmartFolder--><!--67965 - Extend schedule report export 6. Return to custom template-->the '''Report''' list and click the '''Export''' button.
From the report configuration, go to '''FILE EXPORT''' tab and under '''Scheduled Export''', configure desired settings[[Image:Advanced export settings3.png|thumb|none|900px]]
[[The '''File:ScheduledExport''' is opened in MS-Excel.PNG|800px]]
* '''Export Type '''- specify the type of export for the scheduled export[[Image:Excel report.png]]
: ''Options:'':* File Export - export file based on settings from [wiki/Exporting_Reports '''File =Export'''] tab:* Custom Export - export file based on settings from [wiki/Custom_Export '''Custom Export''']:* '''Frequency''' - choose the frequency of the export:** Disabled:** Daily :** Weekly:** Monthly:** Quarterly:** Yearly:** On Demand - used when report is linked to an autoloader.'''At (Start Date)''' - specify time for the scheduled export'''Starting''' - specify the start date for the scheduled export:* '''Export To''' - select where to export the file:** '''SmartFolder or SFTP'''=:*** '''URL''' - enter the url of the sftp site:*** '''Username''' - username to allow access to the sftp:*** '''Password''' - password to allow access to the sftp:*** '''Path''' - sftp folder location where the files will A report can now be pushed i.e. ''/in'' or ''/out'''''Configuration Folder''''''SmartFolder''':*** '''SmartFolder''' - select the SmartFolder where the files will be pushed'''Update Status After Export''' - status of the records will changed automated to the selected status after export.'''Trigger Workflow After Export''' - workflow selected will be triggered to all records after export.:* '''Export File Name''' - file name of the file can be specified including stamp date. It is recommended to append as report as per schedule on a timestamp. To stamp the datedaily, use [YYYY]weekly,[YY],[MM],[DD],[HH],[mm]. i.eor monthly basis to a SmartFolder or an external SFTP site. MyExportedReport_[YYYY]-[MM]-[DD]:* '''Last Exported''' - date and time of the last export.:*
===Examples===Go to  [[Scheduled Report Export]] on how to configure scheduled report exports.
:*:* Export Every Monday of the week @ 0900
:*:: Choose a future date that falls on a Monday for the '''Start Date''', '''Weekly''' for the '''Frequency''' and select the '''Time of Export''' dropdown list.
:*:
:*:* Export Every 15th of the month
:*:: Choose '''15th''' (future date) for the '''Start Date''' and '''Monthly''' for the '''Frequency''' and select the '''Time of Export''' dropdown list.
===Troubleshooting===:* :*:* This won't work for reports that have any criteria, or reports with any other variables that require a user session or user input <!--54913 - for instance, the setting that allows you Ability to select a template from a store report export to specified SmartFolder before exporting. Reports violating these will either not be exported, or have no data when exported, or maybe some other unpredictable result.-->:*:* To reset/change the <!--67965 - Extend schedule, '''Disabled''' the '''Frequency''' then save it. This will delete the current setting configurations from the database. Then, enter new schedule settings and save.:*:* No option for '''Custom Export'''  is currently availablereport export to custom template-->
*
==See Also==:** [[Exporting List View Results to Microsoft Excel]]:** [[Report Variables]]:** [[Exporting Reports with Special Characters to Excel]]:** [[Exporting Multiple Lines Text Fields to HTML]]:** [[Using ReportProperty with a Word Merge Document]]
{{PrevNextStart}} [[Creating a Dashboard to Display a Set of Charts]]
{{PrevNextMid}} Back to [[Reports]] Category {{PrevNextEnd}}
[[Category:Reports]] [[Category:XML]]
Smartstaff
1,385
edits

Navigation menu