Generate a report

Usage:	[main arguments...][optional arguments...]

or -properties	specify a file name with path of properties file.


Main arguments include:
-project		: Specifies the MagicDraw project path as a file name.
-output			: Specifies the output file path as a file name.
-template		: Specifies a template name used to generate a report document.
			  The template must exist in MagicDraw prior to using this command.
-package		: Specifies the name of one or more packages in a MagicDraw project to be included in the report.
			  Multiple package entries must be separated by a semicolon (;).
-element		: Specifies the name of one or more elements from a MagicDraw project to be included in a report.
			  Multiple element entries must be separated by a semicolon (;).
			  Either "-package" argument or "-element" argument have to be specified.
-elementID		: Specifies the element ID of one or more elements in a MagicDraw project to be included in the report. 
			  Use "Element ID" as element ID for Local project and Teamwork project.
			  Use "Server Element ID" as element ID for TWCloud project.
			  Multiple element entries must be separated by a semicolon (;).


Optional arguments include:
-report			: Specifies report data name in a template.
			  The Report Data file must exist in MagicDraw prior to using this command.
			  The last generating report data will be set as the default.
-autoImage<0|1|2|3>	: Specifies how an image will be shown in a report document.
				0 - No resize
				1 - Fit image to paper (large only)
				2 - Fit and rotate image(clockwise) to paper (large only)
				3 - Fit and rotate image(counter-clockwise) to paper (large only)
			  The default value for this argument is 1.
-imageFormat<jpg|png|svg|emf|wmf>	: Specifies an image format in a report document.
					  The default value for this argument is jpg.
-recursive<true|false>	: Specifies how to select a package in a MagicDraw project.
			  The default value for this argument is true.
-includeAuxiliary<true|false>	: Specifies to select packages, including auxiliary packages.
				  The default value is false.
-outputOnBlankField	: Set output on blank field.
-category		: Specifies category of template.
-fields<[name=value]>	: Specifies user defined fields.
-upload			: Specifies server address where generated report is uploaded to.
			  The upload value syntax is:
				"{scheme}://[{userInfo}@]{host}[:{port}][/{path}]"
			  where square brackets [...] delineate optional.
				scheme		-	The supported scheme is 'ftp', 'ftps', 'sftp', 'http' or 'https'. This field is required.
				userInfo	-	Defines username and/or password separated by ':' for connecting to server. The username is required.
				host		-	Defines host name or an IP address. This field is required.
				port		-	Defines a port number. The port value has to be a value from 1 to 65535.
				path		-	Defines a path that is used to specify the resource requested.

										
Server arguments include:
-servertype<tw|twcloud>	: Specifies server type to connect, where:
				tw	-	Teamwork Server
				twcloud	-	Teamwork Cloud
			  The default value is "tw".
-server			: Specifies server name or IP address (and port).
-login			: Specifies login name to login to server.
-password		: Specifies password to login to server.
-ssl<true|false>	: Specifies if a Secured Connection (SSL) is used.
			  The default value is false.
-pversion		: Specifies version of server project.
-tag			: Specifies tag name of server project.
			  The tag value is non-case sensitive.
			  This "-tag" arguments can not be used with "-pversion".
-incremental<true|false>	: Specifies how to create output file name for "-tag".
				  This arguemnt will be used with "-tag" only.
					true	-	The output report shall be generated by appending a new generated output file name with the incremental number.
							For example, report1.docx, report2.docx, etc.
					alse	-	The latest project version in the returned project collection of -tag option would be generated only.
				  The default value is true.


The additional arguments for Teamwork Cloud project include:
-usagepackage		: Specifies one or more packages in Project Usages of Teamwork Cloud project.
			  For Teamwork Cloud projects, "-package" is used to select one or more packages only in Primary Model of Teamwork Cloud projects.
			  This "-usagepackage" argument can be used with "-package" to select packages in both Primary Model and Project Usages.
			  Sets -includeAuxiliary as true if at least one specified usage package is an auxiliary resource.
-usageelement		: Specifies one or more elements in Project Usages of Teamwork Cloud project.
			  For Teamwork Cloud projects, "-element" is used to select one or more elements only in Primary Model of Teamwork Cloud projects.
			  This "-usageelement" argument can be used with "-element" to select elements in both Primary Model and Project Usages.
			  Sets -includeAuxiliary as true if at least one specified usage element is an auxiliary resource.
-includeAllProjectUsages<true|false>	: Specifies if include all Project Usages.
					  The default is false.
-branch			: Specifies branch of Teamwork Cloud project.
			  If  "-pversion" and "-tag" are not specified, The latest version of specified branch will be returned.
			  "-branch" and "-pversion" cannot be specified in the same command for Teamwork Cloud report generation.
-updatemodule<true|false>	: Specifies if update project usages of Teamwork Cloud project to latest version.
				  The default is false.
-projectpassword	: Specifies a password to open a password-protected Teamwork Cloud project.


Generate teamwork password

Usage:	-generatepassword password

password		: Specifies password to generate encrypted password.


Overwrite existing file

Usage:	-overwrite overwrite

overwrite		: Specifies "true" to overwrite all files automatically. overwrite is true by default.
			  Specifies other value to show prompt if specified output file exists.
				enter "y" or "yes" to remove previously generated report before generating report.
				enter "n" or "no" to terminate generating report.