The swExport tool can be used to export SystemWeaver Reports in PDF format. Using this tool, you can implement your own application that can utilize the swExport.exe for report export based on your organization's needs.
To obtain the tool, contact your internal SystemWeaver support team, or support@systemweaver.com.
Prerequisites
- An existing Report to export
- An installation of SystemWeaver version R47 or later
- An installation of swExport.exe version R47 or later
Meta Model
Report export has no required meta model, or item structure, and is suitable for all Report use cases. All it requires is an existing Report to export.
Example Report
Explanation of Settings
Parameter | Definition | Expected value type | Comment | Example |
serverName | The name or IP address of SystemWeaver server | String | Required | serverName=localhost |
serverPort | The port of SystemWeaver server | Integer | Required | serverPort=1768 |
serverUsername | The SystemWeaver username to connect with | String | Optional. If not supplied, Windows authentication will be used. | serverUsername=user |
serverPassword | The SystemWeaver password to connect with | String | Optional. If not supplied, Windows authentication will be used. | serverPassword=pass |
type | Specifies export is of a Report | report | Required | type=report |
configItem | The report configuration to be executed | Config item xID or Ref id* | Required | configItem=SI0111:ReqReport configItem=x34000000000A384D |
filename** | The name of the PDF output file. | String | Required | filename=requirementsReport.pdf |
itemID | The xID of the item | SystemWeaver xID | Required | itemID=x0000001D04533514 |
parameter | To specify a parameter name and selected value | Parameter name, and item xID and value | Optional, but required if there are parameters specified in the configuration | parameter="(p0;x04000000000F3AD1)" parameter"(p1;false)" |
* The difference between the two is explained in Referencing Latest vs Specific Version of Config Item View.
** Note that if you hardcode the name and do several exports, older output will be replaced. To keep the old files, make the name dynamic, e.g., Name + TimeOfExport.
The above settings can also be found in the application help via command line: swExport.exe help
Example Command Lines
Using Username and Password
Using Network Authentication
With Parameter
swExport serverName=sys7 serverPort=1345 type="report" itemID=x04000000001036EF configItem=SSRP:ParameterTest parameter="(p1;x0400000000103700)" filename="C:\Temp\Parameter_report.pdf"
The commands will log in the user account to the server, build and export the report, and then log out.
Example Result
Things to consider
- Exported reports are without bookmarks.