Tabulation saveAsReport - Revision history

Administrator at 02:26, 13 May 2022

2022-05-13T02:26:10Z

← Older revision		Revision as of 02:26, 13 May 2022
Line 1:		Line 1:
	[Will obsolete soon and replace by [[Tabulation_class\|Tabulation.SaveAsReport]]]		[Will obsolete soon and replace by [[Tabulation_class\|Tabulation.SaveAsReport]]. More detail at [[ConversionMethods\|ConversionMethods]] ]

	==== Tabulation_saveAsReport ====		==== Tabulation_saveAsReport ====

Administrator at 09:46, 12 May 2022

2022-05-12T09:46:29Z

← Older revision		Revision as of 09:46, 12 May 2022
Line 1:		Line 1:
	~~{{HelpFiles}}~~		[Will obsolete soon and replace by [[Tabulation_class\|Tabulation.SaveAsReport]]]

	==== Tabulation_saveAsReport ====		==== Tabulation_saveAsReport ====

Cg van at 08:18, 28 December 2011

2011-12-28T08:18:31Z

← Older revision		Revision as of 08:18, 28 December 2011
Line 1:		Line 1:
	{{HelpFiles}}		{{HelpFiles}}

	==== Tabulation_saveAsReport ====		==== Tabulation_saveAsReport ====

	This function tells the interpreter to save the tabulation results as a report once the script is executed, and returns the report's resource unique id.		This function tells the interpreter to save the tabulation results as a report once the script is executed, and returns the report's resource unique id.
Line 31:		Line 31:
	'''Examples'''		'''Examples'''

	''createCrossDiagram({"Sex"}, {"Civil_status"});''		''createCrossDiagram({"Sex"}, {"Civil_status"});''

	''<nowiki>array groups = {{1, "Read"}, {2, "Write"}};</nowiki> ''		''<nowiki>array groups = {{1, "Read"}, {2, "Write"}};</nowiki> ''

	''number reportUniqueId = Tabulation_saveAsReport("Tabulation report", 123, groups, true); ''		''number reportUniqueId = Tabulation_saveAsReport("Tabulation report", 123, groups, true); ''

	''//Result: Return Resource Id of ~~report that has just been created~~ (e.g: 37282468)''		''//Result: Return Resource Id of the newly generated Report (e.g: 37282468)''

	'''Availability'''		'''Availability'''

Cg van at 08:16, 28 December 2011

2011-12-28T08:16:46Z

← Older revision		Revision as of 08:16, 28 December 2011
Line 1:		Line 1:
	~~[[Category:Diagram/report generating CGScript functions]]~~		{{HelpFiles}}
	{{HelpFiles}}

	====Tabulation_saveAsReport====		==== Tabulation_saveAsReport ====

	This function tells the interpreter to save the tabulation results as a report once the script is executed, and returns the report's resource unique id.		This function tells the interpreter to save the tabulation results as a report once the script is executed, and returns the report's resource unique id.

	The report created will be a standard report and diagrams based on dynamic custom columns must be included as diagrams with fixed values, because the custom columns will not be available if the user chooses to view the report later.		The report created will be a standard report and diagrams based on dynamic custom columns must be included as diagrams with fixed values, because the custom columns will not be available if the user chooses to view the report later.

	If overwrite is set to true and if a report and / or report template already exists under the parent resource specified then they will be deleted given that the current user has sufficient permission to do so, else a runtime exception must be thrown.		If overwrite is set to true and if a report and / or report template already exists under the parent resource specified then they will be deleted given that the current user has sufficient permission to do so, else a runtime exception must be thrown.

	By default the current user will get full permission to both the report and report template.		By default the current user will get full permission to both the report and report template.

	'''Syntax'''		'''Syntax'''

	Tabulation_saveAsReport(''name'', ''parentResourceId'', ''permissionGroups'' [, ''overwrite''])		Tabulation_saveAsReport(''name'', ''parentResourceId'', ''permissionGroups'' [, ''overwrite''])

	'''Arguments'''		'''Arguments'''

	''name'': Is a string expression. This is the name which will be used for both the report and the report template. The name must conform to the business rules specified for resource names, failing to do so must result in a runtime exception.		''name'': Is a string expression. This is the name which will be used for both the report and the report template. The name must conform to the business rules specified for resource names, failing to do so must result in a runtime exception.

	''parentResourceId'': Is a number expression. This is the id for the parent resource which will contain the report and report template (having a path on a report template will be possible from version 5.5). The following resources can be used as parent: Folder and Project. Using any other parent as resource will result in a runtime exception. The current user (user context) must have sufficient permission for the parent resource in order to add the report and report template, failing to have sufficient permissions must result in a runtime exception being thrown.		''parentResourceId'': Is a number expression. This is the id for the parent resource which will contain the report and report template (having a path on a report template will be possible from version 5.5). The following resources can be used as parent: Folder and Project. Using any other parent as resource will result in a runtime exception. The current user (user context) must have sufficient permission for the parent resource in order to add the report and report template, failing to have sufficient permissions must result in a runtime exception being thrown.

	''permissionGroups'': Is an array consisting of arrays of 2 elements. First element must be a group id and the second element a permission level. This way it is possible to give different groups different levels of resource access. If the format of the permissionGroups argument is not according to the above then a runtime exception must be thrown.		''permissionGroups'': Is an array consisting of arrays of 2 elements. First element must be a group id and the second element a permission level. This way it is possible to give different groups different levels of resource access. If the format of the permissionGroups argument is not according to the above then a runtime exception must be thrown.

	''overwrite'': If set to true the existing report and report template will be overwritten. The argument is optional and if not specified overwrite must default to false causing a runtime exception if the report and report template already exists.		''overwrite'': If set to true the existing report and report template will be overwritten. The argument is optional and if not specified overwrite must default to false causing a runtime exception if the report and report template already exists.

	'''Return type'''		'''Return type'''

	Number (ResourceId of the newly generated Report)		Number (ResourceId of the newly generated Report)

	'''Examples'''		'''Examples'''

	~~<nowiki>array groups =~~ {~~{1,~~ "~~Read~~"}, {2, "~~Write~~"}};~~</nowiki>~~		''createCrossDiagram({"Sex"}, {"Civil_status"});''

	~~number reportUniqueId~~ = ~~Tabulation_saveAsReport(~~"~~Tabulation report~~", ~~123~~, ~~groups, true)~~;		''<nowiki>array groups = {{1, "Read"}, {2, "Write"}};</nowiki> ''

	''~~'Availability'~~''		''number reportUniqueId = Tabulation_saveAsReport("Tabulation report", 123, groups, true); ''

	Version 5.5		''//Result: Return Resource Id of report that has just been created (e.g: 37282468)''
	__NOTOC__
	<!-- imported from file: 5260.htm-->		'''Availability'''

			Version 5.5 __NOTOC__ <!-- imported from file: 5260.htm-->

			[[Category:Diagram/report_generating_CGScript_functions]]

Cg huyphong at 10:24, 12 December 2011

2011-12-12T10:24:15Z

← Older revision		Revision as of 10:24, 12 December 2011
Line 1:		Line 1:
	[[Category:Diagram/report generating CGScript functions]]		[[Category:Diagram/report generating CGScript functions]]
			{{HelpFiles}}

	====Tabulation_saveAsReport====		====Tabulation_saveAsReport====

Cg_pham at 03:14, 29 March 2011

2011-03-29T03:14:41Z

← Older revision		Revision as of 03:14, 29 March 2011
Line 1:		Line 1:
	[[Category:~~HelpBooks~~]]		[[Category:Diagram/report generating CGScript functions]]

Catglobe: jrfconvert import

2011-03-07T08:57:22Z

jrfconvert import

New page

[[Category:HelpBooks]]

====Tabulation_saveAsReport====

This function tells the interpreter to save the tabulation results as a report once the script is executed, and returns the report's resource unique id.

The report created will be a standard report and diagrams based on dynamic custom columns must be included as diagrams with fixed values, because the custom columns will not be available if the user chooses to view the report later.

If overwrite is set to true and if a report and / or report template already exists under the parent resource specified then they will be deleted given that the current user has sufficient permission to do so, else a runtime exception must be thrown.

By default the current user will get full permission to both the report and report template.

'''Syntax'''

Tabulation_saveAsReport(''name'', ''parentResourceId'', ''permissionGroups'' [, ''overwrite''])

'''Arguments'''

''name'': Is a string expression. This is the name which will be used for both the report and the report template. The name must conform to the business rules specified for resource names, failing to do so must result in a runtime exception.

''parentResourceId'': Is a number expression. This is the id for the parent resource which will contain the report and report template (having a path on a report template will be possible from version 5.5). The following resources can be used as parent: Folder and Project. Using any other parent as resource will result in a runtime exception. The current user (user context) must have sufficient permission for the parent resource in order to add the report and report template, failing to have sufficient permissions must result in a runtime exception being thrown.

''permissionGroups'': Is an array consisting of arrays of 2 elements. First element must be a group id and the second element a permission level. This way it is possible to give different groups different levels of resource access. If the format of the permissionGroups argument is not according to the above then a runtime exception must be thrown.

''overwrite'': If set to true the existing report and report template will be overwritten. The argument is optional and if not specified overwrite must default to false causing a runtime exception if the report and report template already exists.

'''Return type'''

Number (ResourceId of the newly generated Report)

'''Examples'''

<nowiki>array groups = {{1, "Read"}, {2, "Write"}};</nowiki>

number reportUniqueId = Tabulation_saveAsReport("Tabulation report", 123, groups, true);

'''Availability'''

Version 5.5
__NOTOC__