Class: I2CE CustomReport Template: Difference between revisions

From IHRIS Wiki
No edit summary
 
(26 intermediate revisions by one other user not shown)
Line 1: Line 1:
This article desrcibes the class '''I2CE_CustomReport_Template'''.
#REDIRECT [[Class: I2CE_CustomReport_Template (4.1.12)]]
*Extends the class: [[Class: I2CE_MagicDataTemplate | I2CE_MagicDataTemplate]].
It is contained in the module [[iHRIS Module List#CustomReports|CustomReports]] in the package [https://launchpad.net/i2ce I2CE]
 
The class is defined in the file: [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0.0-release/annotate/head:/modules/CustomReports/lib/I2CE_CustomReport_Template.php modules/CustomReports/lib/I2CE_CustomReport_Template.php]
 
I2CE_CustomReport_Relationship_Template
@subpackage Core
*Author: Carl Leitner <litlfred@ibiblio.org>
==Variables==
===$templates===
An array of requested relationships templates I2CE_CustomReport_Template  indexed by the type and then by  name
@protected static array $templates
*Type: static protected $templates
 
===$types===
An array index by configTypes.  the values are arrays whose keys are fields with values the
config types the fields are supposed to have
*Type: static protected y $types
 
===$blanket===
An array with keys config types such that all sub-nodes of a node with this configType will have the
configType specified by the value associated to the key
*Type: static protected y $blanket
 
===$required===
an array with keys configTypes with values the required fields for that config type.
will cause a failure if not present
$var protecected static $required
*Type: static protected $required
 
===$ensure===
*Type: static protected $ensure
 
===$permissions===
*Type: static protected $permissions
 
==Methods==
===compareByDisplayName()===
Compares to arrays with keys 'display_name' to see which is "bigger"
*Signature: static public function compareByDisplayName($m,$n)
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ]
Parameters:
* [http://www.php.net/manual/en/language.types.array.php array ] $m
* [http://www.php.net/manual/en/language.types.array.php array ] $n
===createExport()===
Create an export node by appending on to the given configurationGroup node the values
stored in the magic data.
keys specifed by the lowest member of $pipe, if it exists.  Otherwise, if the pipe is empty or null, we export all keys.  Defaults to empty array
*Signature: public function createExport($configNode,$config,$pipe,$configType,$status)
Parameters:
* [http://www.php.net/manual/en/class.domnode.php DOMNode ] $configNode<br/>A configurationGroup node.
* [[Class: I2CE_MagicDataNode | I2CE_MagicDataNode]] $config<br/>The data we wish to store at this node
* [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $pipe<br/>A path component or an array of path components relative to the $config. If the pipe is a non-empty array, we export only the
**Default Value: null
* [http://www.php.net/manual/en/language.types.string.php string ] $configType<br/>Defaults to the empty string.  The configuration type to give the configuration node.
**Default Value: ''
* [http://www.php.net/manual/en/language.types.array.php array ] $status<br/>An array of status options we should set for this configuration node.  Defaults to the empty array
**Default Value: array()
===createExportNodeConfigurationGroup()===
Create an configurationGroup node by appending on to the given configurationGroup node the values
stored in the magic data at the specified $key.
keys specifed by the lowest member of $pipe, if it exists.  Otherwise, if the pipe is empty, we export all keys
*Signature: public function createExportNodeConfigurationGroup($configNode,$config,$pipe,$key,$configType,$status)
Parameters:
* [http://www.php.net/manual/en/class.domnode.php DOMNode ] $configNode<br/>A configurationGroup node.
* [[Class: I2CE_MagicDataNode | I2CE_MagicDataNode]] $config<br/>The data we wish to store at this node
* [http://www.php.net/manual/en/language.types.array.php array ] $pipe<br/>An array of path components relative to the $config. If the pipe is a non-empty array, we export only the
* [http://www.php.net/manual/en/language.types.string.php string ] $key<br/>The key.  (Warning.  It assumes it exists in the magic data!)
* [http://www.php.net/manual/en/language.types.string.php string ] $configType<br/>Defaults to the empty string.  The configuration type to give the configuration node.
* [http://www.php.net/manual/en/language.types.array.php array ] $status<br/>An array of status options we should set for this configuration node.  Defaults to the empty array
===getFormFromReportForm()===
Looks up the form associated to a reportform in the specified relationship
*Signature: static public function getFormFromReportForm($relationship,$reportform)
*Returns: string.  The false on failure
Parameters:
* [http://www.php.net/manual/en/language.types.string.php string ] $relationship
* [http://www.php.net/manual/en/language.types.string.php string ] $reportform<br/>If $reportform == 'primary_form' or $relationship then we are looking up the primary form
===getRelationshipFromReport()===
Get the relationship associated to a report
*Signature: static public function getRelationshipFromReport($report)
*Returns: strng.  The empty string on failure
Parameters:
* [http://www.php.net/manual/en/language.types.string.php string ] $report
===getReportFields()===
Get the reported fields for a report
*Signature: static public function getReportFields($report,$get_disabled)
*Returns: [http://www.php.net/manual/en/language.types.array.php array ] with keys the field name of the form "$form+$field" and values the header for the field
Parameters:
* [http://www.php.net/manual/en/language.types.string.php string ] $report
* [http://www.php.net/manual/en/language.types.boolean.php boolean ] $get_disabled<br/>Defaults to false
**Default Value: false
===getReportNames()===
Get a list of the existing reports
*Signature: static public function getReportNames($cheat)
*Returns: [http://www.php.net/manual/en/language.types.array.php array ] with keys  report shortnames and values an array with indices 'display_name' and 'description' and 'category' and 'config_node'.  the last is
template config node for the report
reports are sorted aplhpabeticaly by 'display_name'
Parameters:
*$cheat
**Default Value: false
===getReportViews()===
Get a list of the existing report views
*Signature: static public function getReportViews()
*Returns: [http://www.php.net/manual/en/language.types.array.php array ] with keys  report view names/index and values an array with indices 'display_name' and 'description' and 'report' and 'config_node',
the last is the template confignode which contains the view
reports are sorted alhpabeticaly by 'display_name'
===getReportViewsByReport()===
Get the report view sorted by report
*Signature: static public function getReportViewsByReport()
*Returns: array.  a multi-dimensional array.  the first index is the short name of the report.
the second index is the name/index of the report view.  This in turn refers to an array
with keys 'display_name' and 'description' and 'config_node',
the last is the template confignode which contains the view
===getReportsByCategory()===
Get the reports available by category
*Signature: static public function getReportsByCategory($cheat)
*Returns: [http://www.php.net/manual/en/language.types.array.php array ] a multi-dimensional array.  the first set of indices is the category sorted alphabetically
the second set of indices are the reports for that category.
for each of these we have an array indexed by 'display_name' and 'description' and 'config_node'.  the last is
template config node for the report
the second set of indices is sorted alphabetically by 'display_name'
Parameters:
*$cheat
**Default Value: false
===getTemplate()===
Gets a  template.  Also caches the results
*Signature: static public function getTemplate($type,$name)
*Returns: I2CE_CustomReportTemplate on sucess
Parameters:
* [http://www.php.net/manual/en/language.types.string.php string ] $type<br/>one of report, relationship or reportView.  Defaults to null meaning we get everything under /modules/CustomReports
**Default Value: null
* [http://www.php.net/manual/en/language.types.string.php string ] $name<br/>Defaults to null meaning we get all the <$type>s of the specified name
**Default Value: null
==Inherited Variables==
===$merges===
Theis protected variable is inherited from [[Class: I2CE_MagicDataTemplate#$merges | I2CE_MagicDataTemplate->$merges]]
 
===$doc===
Theis public variable is inherited from [[Class: I2CE_TemplateMeister#$doc | I2CE_TemplateMeister->$doc]]
 
===$xpath===
Theis protected variable is inherited from [[Class: I2CE_TemplateMeister#$xpath | I2CE_TemplateMeister->$xpath]]
 
===$user===
Theis protected variable is inherited from [[Class: I2CE_TemplateMeister#$user | I2CE_TemplateMeister->$user]]
 
===$working_dir===
Theis protected variable is inherited from [[Class: I2CE_TemplateMeister#$working_dir | I2CE_TemplateMeister->$working_dir]]
 
===$loadOptions===
Theis protected variable is inherited from [[Class: I2CE_TemplateMeister#$loadOptions | I2CE_TemplateMeister->$loadOptions]]
 
===$headers===
Theis protected variable is inherited from [[Class: I2CE_TemplateMeister#$headers | I2CE_TemplateMeister->$headers]]
 
===$verboseErrors===
Theis protected variable is inherited from [[Class: I2CE_TemplateMeister#$verboseErrors | I2CE_TemplateMeister->$verboseErrors]]
==Inherited Fuzzy Methods==
===processValues_color_triple_hex_single()===
This method is inherited from [[Class: I2CE_MagicDataTemplate#processValues_color_triple_hex_single() | I2CE_MagicDataTemplate->processValues_color_triple_hex_single()]]
 
===processValues_color_triple_hex_many()===
This method is inherited from [[Class: I2CE_MagicDataTemplate#processValues_color_triple_hex_many() | I2CE_MagicDataTemplate->processValues_color_triple_hex_many()]]
 
===processValues_color_triple_rgb_single()===
This method is inherited from [[Class: I2CE_MagicDataTemplate#processValues_color_triple_rgb_single() | I2CE_MagicDataTemplate->processValues_color_triple_rgb_single()]]
 
===processValues_color_triple_rgb_many()===
This method is inherited from [[Class: I2CE_MagicDataTemplate#processValues_color_triple_rgb_many() | I2CE_MagicDataTemplate->processValues_color_triple_rgb_many()]]
 
===processValues_color_hex_single()===
This method is inherited from [[Class: I2CE_MagicDataTemplate#processValues_color_hex_single() | I2CE_MagicDataTemplate->processValues_color_hex_single()]]
 
===processValues_color_hex_many()===
This method is inherited from [[Class: I2CE_MagicDataTemplate#processValues_color_hex_many() | I2CE_MagicDataTemplate->processValues_color_hex_many()]]
 
===userMessage()===
This method is inherited from [[Class: I2CE_Fuzzy#userMessage() | I2CE_Fuzzy->userMessage()]]
 
 
[[Category:Class Documentation]]

Latest revision as of 10:42, 18 August 2015