Class: I2CE FormRelationship (Development): Difference between revisions

From IHRIS Wiki
No edit summary
No edit summary
 
(One intermediate revision by one other user not shown)
Line 2: Line 2:
This article describes the class ''I2CE_FormRelationship'' .
This article describes the class ''I2CE_FormRelationship'' .
*Extends the class: [[Class: I2CE_Fuzzy (Development) | I2CE_Fuzzy]].
*Extends the class: [[Class: I2CE_Fuzzy (Development) | I2CE_Fuzzy]].
*Location: Part of the module [[I2CE Module List (Development)#formRelationships|formRelationships]] in the package [https://launchpad.net/i2ce I2CE] 4.0-dev
*Location: Part of the module [[I2CE Module List (Development)#formRelationships|formRelationships]] in the package [https://launchpad.net/i2ce I2CE] 4.1-dev
*Source: Defined in the file [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L29 modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 29
*Source: Defined in the file [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L29 modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 29
*Author: Carl Leitner <litlfred@ibiblio.org>
*Author: Carl Leitner <litlfred@ibiblio.org>
I2CE_CustomRelationship
I2CE_CustomRelationship
==Variables==
==Variables==
===$primaryForm===
===$primaryForm===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L33 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 33
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L33 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 33
*Type: protected $primaryForm
*Type: protected $primaryForm


===$primaryFormName===
===$primaryFormName===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L34 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 34
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L34 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 34
*Type: protected $primaryFormName
*Type: protected $primaryFormName


===$parentFormNames===
===$parentFormNames===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L35 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 35
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L35 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 35
*Type: protected $parentFormNames
*Type: protected $parentFormNames


===$formConfigs===
===$formConfigs===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L36 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 36
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L36 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 36
*Type: protected $formConfigs
*Type: protected $formConfigs


===$relationship===
===$relationship===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L37 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 37
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L37 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 37
*Type: protected $relationship
*Type: protected $relationship


===$relConfig===
===$relConfig===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L38 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 38
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L38 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 38
*Type: protected $relConfig
*Type: protected $relConfig


===$form_reference===
===$form_reference===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L39 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 39
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L39 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 39
*Type: protected $form_reference
*Type: protected $form_reference
===$use_cache===
Defatuls to true.  Set to use cache for getting values in relationship hierarchy
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L44 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 44
*Type: protected [http://www.php.net/manual/en/language.types.boolean.php boolean ] $use_cache
===$use_disp_fields===
@var boolean $use_displ_fields.  Defaults to true.  Whether or not to return the display fields when getting relationship data
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L61 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 61
*Type: protected $use_disp_fields
===$funcDetails===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L653 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 653
*Type: protected $funcDetails


===$operands===
===$operands===
array $operands of string.  The SQL operands recognzied
array $operands of string.  The SQL operands recognzied
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L461 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 461
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L774 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 774
*Type: static protected static $operands
*Type: static protected static $operands
===$additional_limits===
An array, indexed by report form names,  of additional limits that are set for a relationship
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1933 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1933
*Type: protected [http://www.php.net/manual/en/language.types.array.php array ] $additional_limits


==Methods==
==Methods==
===__construct()===
===__construct()===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L46 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 46
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L89 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 89
*Signature: public function __construct($relationship,$relationship_base,$form_reference)
*Signature: public function __construct($relationship,$relationship_base,$form_reference)
*Parameters:
*Parameters:
Line 50: Line 69:
** [http://www.php.net/manual/en/language.pseudo-types.php callback ] $form_reference
** [http://www.php.net/manual/en/language.pseudo-types.php callback ] $form_reference
***Default Value: null
***Default Value: null
===_getFunctionDetails()===
Get the array of function details at the specified for the specified function at the speci @var I2CE_MagicDataNode $funcConfig @var array $dependents  A list of functions this function depends on
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L621 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 621
*Signature: protected function _getFunctionDetails($funcConfig,$dependents)
*Parameters:
**$funcConfig
**$dependents
===_getLimitingFields()===
===_getLimitingFields()===
internal function to get the fields which are in the limits for one where clause in a relationship @param array $limited_fields array of boolean indexed by the names of the fields
internal function to get the fields which are in the limits for one where clause in a relationship @param array $limited_fields array of boolean indexed by the names of the fields
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L486 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 486
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L799 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 799
*Signature: protected function _getLimitingFields($whereConfig,$limiting_fields)
*Signature: protected function _getLimitingFields($whereConfig,$limiting_fields)
*Parameters:
*Parameters:
** [[Class: I2CE_MagicDataNode (Development) | I2CE_MagicDataNode]] $whereConfig
** [[Class: I2CE_MagicDataNode (Development) | I2CE_MagicDataNode]] $whereConfig
**&$limiting_fields  
**&$limiting_fields  
===_walkSatisfyingForms()===
Worker method  to walk relationship hierarchy to get joined forms in relationship
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1803 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1803
*Signature: protected function _walkSatisfyingForms($formName,$form,$id,$fields,$ordering,$results)
*Parameters:
**$formName
** [http://www.php.net/manual/en/language.types.string.php string ] $form <br/>the form
** [http://www.php.net/manual/en/language.types.string.php string ] $id <br/>the id
** [http://www.php.net/manual/en/language.types.array.php array ] $fields <br/>keys are relationship formnames, values are array of fields we wan returned
** [http://www.php.net/manual/en/language.types.array.php array ] $ordering <br/>keys are relationship formnames, values are array of fields we want ordered by
** [http://www.php.net/manual/en/language.types.array.php array ] &$results
===addParentIdToWhereClause()===
===addParentIdToWhereClause()===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L324 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 324
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L552 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 552
*Signature: protected function addParentIdToWhereClause($where,$parent_id)
*Signature: protected function addParentIdToWhereClause($where,$parent_id)
*Parameters:
*Parameters:
**&$where  
**&$where  
**$parent_id  
**$parent_id  
===dropEmpty()===
===disableCaching()===
Determine if we should consider a relationship to not be satisifed if there is no form for the given named form
to no use cache for getting values in relationship hierarchy
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L188 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 188
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L55 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 55
*Signature: public function dropEmpty($formName)
*Signature: public function disableCaching()
*Parameters:
===enableCaching()===
** [http://www.php.net/manual/en/language.types.string.php string ] $formName
to use cache for getting values in relationship hierarchy
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ]
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L49 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 49
*Signature: public function enableCaching()
===evaluateFunction()===
===evaluateFunction()===
Evaluate a given relationship function on the given form data @param string $funciton
Evaluate a given relationship function on the given form data @param string $funciton
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L401 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 401
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L712 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 712
*Signature: public function evaluateFunction($function,$formData,$displayValue)
*Signature: public function evaluateFunction($function,$formData,$displayValue)
*Parameters:
*Parameters:
Line 80: Line 118:
***Default Value: true
***Default Value: true
*Returns: [http://www.php.net/manual/en/language.types.string.php string ]
*Returns: [http://www.php.net/manual/en/language.types.string.php string ]
===formSatisfiesRelationship()===
Checks to see if a given named form and id satisfies the relationship for the given primary form @param string $namedFormId.  The id of the named form we wish to check. Can be either "$form|$id" oe "$id"
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L339 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 339
*Signature: public function formSatisfiesRelationship($form_id,$namedForm,$namedFormID)
*Parameters:
** [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $form_id <br/>Either  an I2CE_Form instnace, a  string ( the  form id) or an array of string (priamry_form, id) for the primary form of the relationship
** [http://www.php.net/manual/en/language.types.string.php string ] $namedForm <br/>The name of the form in the relationship
**$namedFormID
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ]<br/>or  Null on failure
===generateWhereClause()===
===generateWhereClause()===
Generate the where clause for the join of a given named form
Generate the where clause for the join of a given named form
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L518 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 518
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L831 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 831
*Signature: public function generateWhereClause($formName)
*Signature: public function generateWhereClause($formName)
*Parameters:
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $formName
** [http://www.php.net/manual/en/language.types.string.php string ] $formName
*Returns: mixed.<br/>false on failure or a SQL string on success
*Returns: mixed.<br/>false on failure or a SQL string on success
===getAdditionalLimits()===
Modifty the given where clause, if any, based on any additional limits that have been set for the named form
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1948 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1948
*Signature: protected function getAdditionalLimits($formName,$where)
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $formName <br/>the named form in the relationship
** [http://www.php.net/manual/en/language.types.array.php array ] &$where <br/>the existing where clause
===getAncestorFormNames()===
Get the named forms in the relationship which are ancestral to the given named form
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1011 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1011
*Signature: public function getAncestorFormNames($childFormName)
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName
*Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>of string, the named ancestral forms
===getChildFormNames()===
Get the named forms for the given named form upto a specified depth
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1046 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1046
*Signature: public function getChildFormNames($formName,$depth)
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $formName @var int $depth.  Defaults to 1 in which case we only get the immediate children.  If depth = null, we get all child forms
**$depth
***Default Value: 1
*Returns: [http://www.php.net/manual/en/language.types.array.php array ]
===getForm()===
===getForm()===
Returns the form for a given named form in the relationship
Returns the form for a given named form in the relationship
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L69 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 69
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L120 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 120
*Signature: public function getForm($formname)
*Signature: public function getForm($formname)
*Parameters:
*Parameters:
Line 96: Line 166:
===getFormConfig()===
===getFormConfig()===
Get the magic data node(s) for the name form in the relationship @param string $form.
Get the magic data node(s) for the name form in the relationship @param string $form.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L120 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 120
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L212 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 212
*Signature: public function getFormConfig($formname)
*Signature: public function getFormConfig($formname)
*Parameters:
*Parameters:
Line 102: Line 172:
***Default Value: null
***Default Value: null
*Returns: mixed.<br/>false on failture.  If $forname is null, we return an array of I2CE_MagicDataNodes index by the form names.  If $formma,e is a string then we return the  config for the named form.
*Returns: mixed.<br/>false on failture.  If $forname is null, we return an array of I2CE_MagicDataNodes index by the form names.  If $formma,e is a string then we return the  config for the named form.
===getFormData()===
Get the forms that satisfy a relationship for the given primary form id
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1734 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1734
*Signature: public function getFormData($form,$id,$fields,$ordering,$as_iterator)
*Parameters:
**$form
** [http://www.php.net/manual/en/language.types.string.php string ] $id <br/>the id of the primary form
** [http://www.php.net/manual/en/language.types.array.php array ] $fields <br/>keys are relationship formnames, values are array of fields we wan returned
***Default Value: array()
** [http://www.php.net/manual/en/language.types.array.php array ] $ordering <br/>keys are relationship formnames, values are array of fields we want ordered by
***Default Value: array()
**$as_iterator
***Default Value: true
*Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>of mixed.  The array may be empty if the $form_id  does not satisfy the relationship.  It is indexed by the named form and the form objects are already populated.  If there was no matching form for a given named form, then the value of the array elemet will be false
===getFormDataJoiningByID()===
Find all form ids matching the given join
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1830 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1830
*Signature: public function getFormDataJoiningByID($formName,$parentForm,$parentId,$fields,$ordering)
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $formName <br/>The named form
** [http://www.php.net/manual/en/language.types.string.php string ] $parentForm <br/>The parent of this form
** [http://www.php.net/manual/en/language.types.string.php string ] $parentId <br/>The id of the  parent of this form
** [http://www.php.net/manual/en/language.types.array.php array ] $fields <br/>keys are relationship formnames, values are array of fields we wan returned
** [http://www.php.net/manual/en/language.types.array.php array ] $ordering <br/>keys are relationship formnames, values are array of fields we want ordered by
*Returns: [http://www.php.net/manual/en/language.types.array.php array ]
===getFormDataJoiningByID_child()===
Get the forms ids for joining  on the named parent forms if with the parent of the named child form
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L2158 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 2158
*Signature: public function getFormDataJoiningByID_child($childFormName,$parentForm,$parentId,$joinData,$where,$limit,$fields,$ordering)
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the name of the child form in the relationship
** [http://www.php.net/manual/en/language.types.string.php string ] $parentForm
** [http://www.php.net/manual/en/language.types.string.php string ] $parentId
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $where
** [http://www.php.net/manual/en/language.types.array.php array ] $limit
** [http://www.php.net/manual/en/language.types.array.php array ] $fields <br/>keys are relationship formnames, values are array of fields we want returned
** [http://www.php.net/manual/en/language.types.array.php array ] $ordering <br/>keys are relationship formnames, values are array of fields we want ordered by
*Returns: mixed.<br/>An array of form ids
===getFormDataJoiningByID_child_field()===
Get the forms ids  for joining on the named parent form's id with the named child form on a given field
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L2200 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 2200
*Signature: public function getFormDataJoiningByID_child_field($childFormName,$parentForm,$parentId,$joinData,$where,$limit,$fields,$ordering)
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the name of the child form in the relationship
** [http://www.php.net/manual/en/language.types.string.php string ] $parentForm
** [http://www.php.net/manual/en/language.types.string.php string ] $parentId
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $where
** [http://www.php.net/manual/en/language.types.array.php array ] $limit
** [http://www.php.net/manual/en/language.types.array.php array ] $fields <br/>keys are relationship formnames, values are array of fields we want returned
** [http://www.php.net/manual/en/language.types.array.php array ] $ordering <br/>keys are relationship formnames, values are array of fields we want ordered by
*Returns: mixed.<br/>An array of form ids
===getFormDataJoiningByID_fields()===
Get the forms ids for joining on a given field of  a named child form's with the named parent form on a given field
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L2250 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 2250
*Signature: public function getFormDataJoiningByID_fields($childFormName,$parentForm,$parentId,$joinData,$where,$limit,$fields,$ordering)
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the name of the child form in the relationship
** [http://www.php.net/manual/en/language.types.string.php string ] $parentForm
** [http://www.php.net/manual/en/language.types.string.php string ] $parentId
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $where
** [http://www.php.net/manual/en/language.types.array.php array ] $limit
** [http://www.php.net/manual/en/language.types.array.php array ] $fields <br/>keys are relationship formnames, values are array of fields we want returned
** [http://www.php.net/manual/en/language.types.array.php array ] $ordering <br/>keys are relationship formnames, values are array of fields we want ordered by
*Returns: mixed.<br/>An array of form ids
===getFormDataJoiningByID_ids()===
Get the forms ids for joining on ids of the named parent/child forms
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L2118 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 2118
*Signature: public function getFormDataJoiningByID_ids($childFormName,$parentForm,$parentId,$joinData,$where,$limit,$fields,$ordering)
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the name of the child form in the relationship
** [http://www.php.net/manual/en/language.types.string.php string ] $parentForm
** [http://www.php.net/manual/en/language.types.string.php string ] $parentId
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $where
** [http://www.php.net/manual/en/language.types.array.php array ] $limit
** [http://www.php.net/manual/en/language.types.array.php array ] $fields <br/>keys are relationship formnames, values are array of fields we want returned
** [http://www.php.net/manual/en/language.types.array.php array ] $ordering <br/>keys are relationship formnames, values are array of fields we want ordered by
*Returns: mixed.<br/>An array of form ids
===getFormDataJoiningByID_parent()===
Get the forms ids for joining as the named child form's id with the parent  of the named parent form
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1975 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1975
*Signature: public function getFormDataJoiningByID_parent($childFormName,$parentForm,$parentId,$joinData,$where,$limit,$fields,$ordering)
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the name of the child form in the relationship
** [http://www.php.net/manual/en/language.types.string.php string ] $parentForm
** [http://www.php.net/manual/en/language.types.string.php string ] $parentId
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $where
** [http://www.php.net/manual/en/language.types.array.php array ] $limit
** [http://www.php.net/manual/en/language.types.array.php array ] $fields <br/>keys are relationship formnames, values are array of fields we want returned
** [http://www.php.net/manual/en/language.types.array.php array ] $ordering <br/>keys are relationship formnames, values are array of fields we want ordered by
*Returns: mixed.<br/>An array of form ids
===getFormDataJoiningByID_parent_field()===
Get the forms ids for joining as a named child form's id with the named parent form on a given field
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L2019 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 2019
*Signature: public function getFormDataJoiningByID_parent_field($childFormName,$parentForm,$parentId,$joinData,$where,$limit,$fields,$ordering)
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the name of the child form in the relationship
** [http://www.php.net/manual/en/language.types.string.php string ] $parentForm
** [http://www.php.net/manual/en/language.types.string.php string ] $parentId
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $where
** [http://www.php.net/manual/en/language.types.array.php array ] $limit
** [http://www.php.net/manual/en/language.types.array.php array ] $fields <br/>keys are relationship formnames, values are array of fields we want returned
** [http://www.php.net/manual/en/language.types.array.php array ] $ordering <br/>keys are relationship formnames, values are array of fields we want ordered by
*Returns: mixed.<br/>An array of form ids
===getFormDataJoiningByID_reference()===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L2063 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 2063
*Signature: public function getFormDataJoiningByID_reference($childFormName,$parentForm,$parentId,$joinData,$where,$limit,$fields,$ordering)
*Parameters:
**$childFormName
**$parentForm
**$parentId
**$joinData
**$where
**$limit
**$fields
**$ordering
===getFormIdsJoiningOn()===
===getFormIdsJoiningOn()===
Find all form ids matching the given join
Find all form ids matching the given join
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L282 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 282
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L447 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 447
*Signature: public function getFormIdsJoiningOn($formName,$parentFormObj,$only_first_match)
*Signature: public function getFormIdsJoiningOn($formName,$parentFormObj)
*Parameters:
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $formName <br/>The named form
** [http://www.php.net/manual/en/language.types.string.php string ] $formName <br/>The named form
** [[Class: I2CE_Form (Development) | I2CE_Form]] $parentFormObj <br/>The populated form object of the named parent form in the relationship
** [[Class: I2CE_Form (Development) | I2CE_Form]] $parentFormObj <br/>The parent of this form
** [http://www.php.net/manual/en/language.types.boolean.php boolean ] $only_first_match <br/>Defaults to true in which case we only return the first matching form
***Default Value: true
*Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>of string, the form ids
*Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>of string, the form ids
===getFormIdsJoiningOn_child()===
===getFormIdsJoiningOn_child()===
Get the forms ids for joining  on the named parent forms if with the parent of the named child form @param string $childForm the name of the child form in the relationship
Get the forms ids for joining  on the named parent forms if with the parent of the named child form
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L662 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 662
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1450 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1450
*Signature: public function getFormIdsJoiningOn_child($formName,$parentFormObj,$joinData,$where,$limit)
*Signature: public function getFormIdsJoiningOn_child($childFormName,$parentFormObj,$joinData,$where,$limit)
*Parameters:
*Parameters:
**$formName
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the name of the child form in the relationship
** [[Class: I2CE_Form (Development) | I2CE_Form]] $parentFormObj
** [[Class: I2CE_Form (Development) | I2CE_Form]] $parentFormObj
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
Line 124: Line 313:
*Returns: mixed.<br/>An array of form ids
*Returns: mixed.<br/>An array of form ids
===getFormIdsJoiningOn_child_field()===
===getFormIdsJoiningOn_child_field()===
Get the forms ids  for joining on the named parent form's id with the named child form on a given field @param string $childForm the name of the child form in the relationship
Get the forms ids  for joining on the named parent form's id with the named child form on a given field
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L708 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 708
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1550 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1550
*Signature: public function getFormIdsJoiningOn_child_field($formName,$parentFormObj,$joinData,$where,$limit)
*Signature: public function getFormIdsJoiningOn_child_field($childFormName,$parentFormObj,$joinData,$where,$limit)
*Parameters:
*Parameters:
**$formName
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the name of the child form in the relationship
** [[Class: I2CE_Form (Development) | I2CE_Form]] $parentFormObj
** [[Class: I2CE_Form (Development) | I2CE_Form]] $parentFormObj
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
Line 135: Line 324:
*Returns: mixed.<br/>An array of form ids
*Returns: mixed.<br/>An array of form ids
===getFormIdsJoiningOn_fields()===
===getFormIdsJoiningOn_fields()===
Get the forms ids for joining on a given field of  a named child form's with the named parent form on a given field @param string $childForm the name of the child form in the relationship
Get the forms ids for joining on a given field of  a named child form's with the named parent form on a given field
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L842 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 842
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1625 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1625
*Signature: public function getFormIdsJoiningOn_fields($formName,$parentFormObj,$joinData,$where,$limit)
*Signature: public function getFormIdsJoiningOn_fields($childFormName,$parentFormObj,$joinData,$where,$limit)
*Parameters:
*Parameters:
**$formName
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the name of the child form in the relationship
** [[Class: I2CE_Form (Development) | I2CE_Form]] $parentFormObj
** [[Class: I2CE_Form (Development) | I2CE_Form]] $parentFormObj
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
Line 146: Line 335:
*Returns: mixed.<br/>An array of form ids
*Returns: mixed.<br/>An array of form ids
===getFormIdsJoiningOn_ids()===
===getFormIdsJoiningOn_ids()===
Get the forms ids for joining on ids of the named parent/child forms @param string $childForm the name of the child form in the relationship
Get the forms ids for joining on ids of the named parent/child forms
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L577 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 577
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1400 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1400
*Signature: public function getFormIdsJoiningOn_ids($formName,$parentFormObj,$joinData,$where,$limit)
*Signature: public function getFormIdsJoiningOn_ids($childFormName,$parentFormObj,$joinData,$where,$limit)
*Parameters:
*Parameters:
**$formName
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the name of the child form in the relationship
** [[Class: I2CE_Form (Development) | I2CE_Form]] $parentFormObj
** [[Class: I2CE_Form (Development) | I2CE_Form]] $parentFormObj
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
Line 157: Line 346:
*Returns: mixed.<br/>An array of form ids
*Returns: mixed.<br/>An array of form ids
===getFormIdsJoiningOn_parent()===
===getFormIdsJoiningOn_parent()===
Get the forms ids for joining as the named child form's id with the parent  of the named parent form @param string $childForm the name of the child form in the relationship
Get the forms ids for joining as the named child form's id with the parent  of the named parent form
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L618 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 618
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1199 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1199
*Signature: public function getFormIdsJoiningOn_parent($formName,$parentFormObj,$joinData,$where,$limit)
*Signature: public function getFormIdsJoiningOn_parent($childFormName,$parentFormObj,$joinData,$where,$limit)
*Parameters:
*Parameters:
**$formName
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the name of the child form in the relationship
** [[Class: I2CE_Form (Development) | I2CE_Form]] $parentFormObj
** [[Class: I2CE_Form (Development) | I2CE_Form]] $parentFormObj
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
Line 168: Line 357:
*Returns: mixed.<br/>An array of form ids
*Returns: mixed.<br/>An array of form ids
===getFormIdsJoiningOn_parent_field()===
===getFormIdsJoiningOn_parent_field()===
Get the forms ids for joining as a named child form's id with the named parent form on a given field @param string $childForm the name of the child form in the relationship
Get the forms ids for joining as a named child form's id with the named parent form on a given field
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L774 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 774
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1325 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1325
*Signature: public function getFormIdsJoiningOn_parent_field($formName,$parentFormObj,$joinData,$where,$limit)
*Signature: public function getFormIdsJoiningOn_parent_field($childFormName,$parentFormObj,$joinData,$where,$limit)
*Parameters:
*Parameters:
**$formName
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the name of the child form in the relationship
** [[Class: I2CE_Form (Development) | I2CE_Form]] $parentFormObj
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $where
** [http://www.php.net/manual/en/language.types.array.php array ] $limit
*Returns: mixed.<br/>An array of form ids
===getFormIdsJoiningOn_reference()===
Get the forms ids for joining as a named child form's id with the named parent form on a given field
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1251 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1251
*Signature: public function getFormIdsJoiningOn_reference($childFormName,$parentFormObj,$joinData,$where,$limit)
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the name of the child form in the relationship
** [[Class: I2CE_Form (Development) | I2CE_Form]] $parentFormObj
** [[Class: I2CE_Form (Development) | I2CE_Form]] $parentFormObj
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
Line 180: Line 380:
===getFormNames()===
===getFormNames()===
Get the names of the forms in the relationship
Get the names of the forms in the relationship
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L179 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 179
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L271 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 271
*Signature: public function getFormNames()
*Signature: public function getFormNames()
*Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>of string.
*Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>of string.
===getForms()===
===getForms()===
Internal method to walk the relationship and get all the form configs and parent form names and store them in  arrays
Internal method to walk the relationship and get all the form configs and parent form names and store them in  arrays
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L102 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 102
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L189 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 189
*Signature: protected function getForms($config,$formConfigs,$parentForms,$parent_form_name)
*Signature: protected function getForms($config,$formConfigs,$parentForms,$parent_form_name,$depth)
*Parameters:
*Parameters:
** [[Class: I2CE_MagicDataNode (Development) | I2CE_MagicDataNode]] $config <br/>The node we are walking
** [[Class: I2CE_MagicDataNode (Development) | I2CE_MagicDataNode]] $config <br/>The node we are walking
Line 192: Line 392:
** [http://www.php.net/manual/en/language.types.array.php array ] $parentForms <br/>The array of string which maps the named parent form of a named form
** [http://www.php.net/manual/en/language.types.array.php array ] $parentForms <br/>The array of string which maps the named parent form of a named form
** [http://www.php.net/manual/en/language.types.string.php string ] $parent_form_name <br/>The name of the parent form for the given $config
** [http://www.php.net/manual/en/language.types.string.php string ] $parent_form_name <br/>The name of the parent form for the given $config
**$depth
***Default Value: 0
===getFormsSatisfyingRelationship()===
===getFormsSatisfyingRelationship()===
Get the forms that satisfy a relationship for the given primary form id
Get the forms that satisfy a relationship for the given primary form id
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L199 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 199
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L366 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 366
*Signature: public function getFormsSatisfyingRelationship($form_id)
*Signature: public function getFormsSatisfyingRelationship($form_id)
*Parameters:
*Parameters:
** [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $form_id <br/>Either a string, the  form id or an array of string (priamry_form, id) for the primary form of the relationship
** [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $form_id <br/>Either an I2CE_Form instnace, a string ( the  form id) or an array of string (priamry_form, id) for the primary form of the relationship
*Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>of mixed.  The array may be empty if the $form_id  does not satisfy the relationship.  It is indexed by the named form and the form objects are already populated.  If there was no matching form for a given named form, then the value of the array elemet will be false
*Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>of mixed.  The array may be empty if the $form_id  does not satisfy the relationship.  It is indexed by the named form and the form objects are already populated.  If there was no matching form for a given named form, then the value of the array elemet will be false
===getFunctionDetails()===
===getFunctionDetails()===
Get the details of a relationship function
Get the details of a relationship function
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L368 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 368
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L661 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 661
*Signature: public function getFunctionDetails($function)
*Signature: public function getFunctionDetails($functions)
*Parameters:
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $function
** [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $functions <br/>string or an array of string
*Returns: mixed.<br/>false on failure.  On success an array with the keys 'qry' the query string, 'type' the return SQL type of the function, 'required_fields' the form fields reuquired in the relationship,  and 'field' which is an instance of I2CE_FormField for the function
*Returns: mixed.<br/>false on failure.  On success an array with the keys 'qry' the query string, 'type' the return SQL type of the function, 'required_fields' the form fields reuquired in the relationship,  and 'field' which is an instance of I2CE_FormField for the function
===getFunctionDetailsWalker()===
Walks the function data tree to creates the list of function details
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L595 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 595
*Signature: protected function getFunctionDetailsWalker($config,$functions,$dependents)
*Parameters:
** [[Class: I2CE_MagicDataNode (Development) | I2CE_MagicDataNode]] $config
** [http://www.php.net/manual/en/language.types.array.php array ] &$functions <br/>The working list fo functions.
** [http://www.php.net/manual/en/language.types.array.php array ] $dependents <br/>Defaul to empty array.  The functions that all the functions at this level depend on
***Default Value: array()
===getJoin()===
===getJoin()===
Get the SQL join statemetn for the given form @param string the named form in the relationship
Get the SQL join statemetn for the given form
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L893 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 893
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1078 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1078
*Signature: public function getJoin($formName)
*Signature: public function getJoin($childFormName,$join_method)
*Parameters:
*Parameters:
**$formName
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the named form in the relationship
**$join_method
***Default Value: 'JOIN'
*Returns: mixed.<br/>String, the SQL join statements on succes, false on failure
*Returns: mixed.<br/>String, the SQL join statements on succes, false on failure
===getJoiningFields()===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1674 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1674
*Signature: public function getJoiningFields($childFormName)
*Parameters:
**$childFormName
===getLimitingFields()===
===getLimitingFields()===
Gets the names of the fields which are in a limit for a where clause of a given form
Gets the names of the fields which are in a limit for a where clause of a given form
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L468 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 468
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L781 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 781
*Signature: public function getLimitingFields($formName)
*Signature: public function getLimitingFields($formName)
*Parameters:
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $formName <br/>The anmed form in the relationship
** [http://www.php.net/manual/en/language.types.string.php string ] $formName <br/>The anmed form in the relationship
*Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>of string, the fields that are present in the limit
*Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>of string, the fields that are present in the limit
===getLinkingData()===
Get linking data, if any, for the indicated field of the named form @param string $joinForm the named form we are trying to join
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L862 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 862
*Signature: protected function getLinkingData($formName,$fieldName,$joinFormName,$joinField,$style,$reversed,$primary_table)
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $formName <br/>The named form in the relationship
** [http://www.php.net/manual/en/language.types.string.php string ] $fieldName <br/>The field name
**$joinFormName
** [http://www.php.net/manual/en/language.types.string.php string ] $joinField <br/>The field of the joined form we are looking for
**$style
***Default Value: 'default'
**$reversed
***Default Value: false
**$primary_table
***Default Value: 'primary_table'
*Returns: [http://www.php.net/manual/en/language.pseudo-types.php mixed ]<br/>If no linking data then return false.  Otherwise is in an array with keys sub_select, forms and  fields
===getParentFormNames()===
===getParentFormNames()===
Get the name(s) of parent forms
Get the name(s) of parent forms
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L138 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 138
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L230 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 230
*Signature: public function getParentFormNames($formname)
*Signature: public function getParentFormNames($formname)
*Parameters:
*Parameters:
Line 230: Line 464:
===getPrimaryForm()===
===getPrimaryForm()===
Get the primary form
Get the primary form
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L154 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 154
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L246 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 246
*Signature: public function getPrimaryForm()
*Signature: public function getPrimaryForm()
*Returns: [http://www.php.net/manual/en/language.types.string.php string ]
*Returns: [http://www.php.net/manual/en/language.types.string.php string ]
===getPrimaryFormName()===
===getPrimaryFormName()===
Gets the name of the primary from (e.g. the  name of the relationship)
Gets the name of the primary from (e.g. the  name of the relationship)
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L162 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 162
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L254 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 254
*Signature: public function getPrimaryFormName()
*Signature: public function getPrimaryFormName()
*Returns: [http://www.php.net/manual/en/language.types.string.php string ]
*Returns: [http://www.php.net/manual/en/language.types.string.php string ]
===getReferencedForm()===
===getReferencedForm()===
Get the SQL name of a form via the registered callback functin
Get the SQL name of a form via the registered callback functin
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L348 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 348
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L575 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 575
*Signature: public function getReferencedForm($form)
*Signature: public function getReferencedForm($form)
*Parameters:
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $form
** [http://www.php.net/manual/en/language.types.string.php string ] $form
*Returns: mixed.<br/>False on failure. A string on success
*Returns: mixed.<br/>False on failure. A string on success
===getReferenedForm()===
===getRelationship()===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L546 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 546
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L81 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 81
*Signature: public function getReferenedForm($form)
*Signature: public function getRelationship()
*Parameters:
**$form
===getRequiredForms()===
===getRequiredForms()===
Gets the forms required by the relationship
Gets the forms required by the relationship
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L84 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 84
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L135 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 135
*Signature: public function getRequiredForms()
*Signature: public function getRequiredForms()
*Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>of string
*Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>of string
===hasAncestor()===
Determine if the form name given has ancestral conditions.
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L297 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 297
*Signature: public function hasAncestor($formName)
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $formName
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ]
===isJoin()===
Determine if we should consider a relationship to not be satisifed if there is no form for the given named form
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L315 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 315
*Signature: public function isJoin($formName)
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $formName
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ]
===isPrimaryFormName()===
===isPrimaryFormName()===
Check to see if the given form name is the primary form name.  Note the primary form name is the same as the relationship name
Check to see if the given form name is the primary form name.  Note the primary form name is the same as the relationship name
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L170 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 170
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L262 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 262
*Signature: public function isPrimaryFormName($formname)
*Signature: public function isPrimaryFormName($formname)
*Parameters:
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $formname
** [http://www.php.net/manual/en/language.types.string.php string ] $formname
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ]
===isRightJoin()===
Determine if we should consider a relationship to not be satisifed if there is no form for the given named form
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L326 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 326
*Signature: public function isRightJoin($formName)
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $formName
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ]
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ]
===joinOn_child()===
===joinOn_child()===
Generate SQL join statement for joining  on the named parent forms if with the parent of the named child form
Generate SQL join statement for joining  on the named parent forms if with the parent of the named child form
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L647 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 647
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1431 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1431
*Signature: public function joinOn_child($childForm,$joinData)
*Signature: public function joinOn_child($childFormName,$joinData)
*Parameters:
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $childForm <br/>the name of the child form in the relationship
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the name of the child form in the relationship
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
*Returns: mixed.<br/>On success, a string which is the SQL join statement.  On failure, false
*Returns: mixed.<br/>On success, a string which is the SQL join statement.  On failure, false
===joinOn_child_field()===
===joinOn_child_field()===
Generate SQL join statement for joining on the named parent form's id with the named child form on a given field
Generate SQL join statement for joining on the named parent form's id with the named child form on a given field
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L686 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 686
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1474 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1474
*Signature: public function joinOn_child_field($childForm,$joinData)
*Signature: public function joinOn_child_field($childFormName,$joinData)
*Parameters:
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $childForm <br/>the name of the child form in the relationship
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the name of the child form in the relationship
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
*Returns: mixed.<br/>On success, a string which is the SQL join statement.  On failure, false
*Returns: mixed.<br/>On success, a string which is the SQL join statement.  On failure, false
===joinOn_fields()===
===joinOn_fields()===
Generate SQL join statement for joining on a given field of  a named child form's with the named parent form on a given field
Generate SQL join statement for joining on a given field of  a named child form's with the named parent form on a given field
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L815 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 815
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1593 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1593
*Signature: public function joinOn_fields($childForm,$joinData)
*Signature: public function joinOn_fields($childFormName,$joinData)
*Parameters:
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $childForm <br/>the name of the child form in the relationship
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the name of the child form in the relationship
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
*Returns: mixed.<br/>On success, a string which is the SQL join statement.  On failure, false
*Returns: mixed.<br/>On success, a string which is the SQL join statement.  On failure, false
===joinOn_ids()===
===joinOn_ids()===
Generate SQL join statement for joining on ids of the named parent/child forms
Generate SQL join statement for joining on ids of the named parent/child forms
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L562 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 562
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1381 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1381
*Signature: public function joinOn_ids($childForm,$joinData)
*Signature: public function joinOn_ids($childFormName,$joinData)
*Parameters:
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $childForm <br/>the name of the child form in the relationship
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the name of the child form in the relationship
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
*Returns: mixed.<br/>On success, a string which is the SQL join statement.  On failure, false
*Returns: mixed.<br/>On success, a string which is the SQL join statement.  On failure, false
===joinOn_parent()===
===joinOn_parent()===
Generate SQL join statement for joining as the named child form's id with the parent  of the named parent form
Generate SQL join statement for joining as the named child form's id with the parent  of the named parent form
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L603 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 603
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1181 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1181
*Signature: public function joinOn_parent($childForm,$joinData)
*Signature: public function joinOn_parent($childFormName,$joinData)
*Parameters:
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $childForm <br/>the name of the child form in the relationship
** [http://www.php.net/manual/en/language.types.string.php string ] $childFormName <br/>the name of the child form in the relationship
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
*Returns: mixed.<br/>On success, a string which is the SQL join statement.  On failure, false
*Returns: mixed.<br/>On success, a string which is the SQL join statement.  On failure, false
===joinOn_parent_field()===
===joinOn_parent_field()===
Generate SQL join statement for joining as a named child form's id with the named parent form on a given field
Generate SQL join statement for joining as a named child form's id with the named parent form on a given field @param string $childForm the name of the child form in the relationship
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L752 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 752
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1291 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1291
*Signature: public function joinOn_parent_field($childForm,$joinData)
*Signature: public function joinOn_parent_field($childFormName,$joinData)
*Parameters:
**$childFormName
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
*Returns: mixed.<br/>On success, a string which is the SQL join statement.  On failure, false
===joinOn_reference()===
Generate SQL join statement for joining as a named child form's id with the named parent form on a given field @param string $childForm the name of the child form in the relationship
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1225 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1225
*Signature: public function joinOn_reference($childFormName,$joinData)
*Parameters:
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $childForm <br/>the name of the child form in the relationship
**$childFormName
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
** [http://www.php.net/manual/en/language.types.array.php array ] $joinData <br/>The array containg the join data
*Returns: mixed.<br/>On success, a string which is the SQL join statement.  On failure, false
*Returns: mixed.<br/>On success, a string which is the SQL join statement.  On failure, false
===limitOne()===
Determine if we should consider a relationship to not be satisifed if there is no form for the given named form
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L281 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 281
*Signature: public function limitOne($formName)
*Parameters:
** [http://www.php.net/manual/en/language.types.string.php string ] $formName
*Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ]
===setAdditionalLimit()===
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L1939 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 1939
*Signature: public function setAdditionalLimit($formName,$where)
*Parameters:
**$formName
**$where
===useDisplayFields()===
Set the relationship to use the display fields when getting form data
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L65 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 65
*Signature: public function useDisplayFields()
===useRawFields()===
Set the relationship to use the raw data when getting form data
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L71 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 71
*Signature: public function useRawFields()
===usesRawFields()===
check if the relationship to use the raw data when getting form data
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.1-dev/annotate/head:/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php#L77 i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php] on line 77
*Signature: public function usesRawFields()
==Inherited Methods==
==Inherited Methods==
===_hasMethod()===
===_hasMethod()===

Latest revision as of 08:14, 6 May 2015


This article describes the class I2CE_FormRelationship .

I2CE_CustomRelationship

Variables

$primaryForm

$primaryFormName

$parentFormNames

$formConfigs

$relationship

$relConfig

$form_reference

$use_cache

Defatuls to true. Set to use cache for getting values in relationship hierarchy

$use_disp_fields

@var boolean $use_displ_fields. Defaults to true. Whether or not to return the display fields when getting relationship data

$funcDetails

$operands

array $operands of string. The SQL operands recognzied

$additional_limits

An array, indexed by report form names, of additional limits that are set for a relationship

Methods

__construct()

_getFunctionDetails()

Get the array of function details at the specified for the specified function at the speci @var I2CE_MagicDataNode $funcConfig @var array $dependents A list of functions this function depends on

_getLimitingFields()

internal function to get the fields which are in the limits for one where clause in a relationship @param array $limited_fields array of boolean indexed by the names of the fields

_walkSatisfyingForms()

Worker method to walk relationship hierarchy to get joined forms in relationship

addParentIdToWhereClause()

disableCaching()

to no use cache for getting values in relationship hierarchy

enableCaching()

to use cache for getting values in relationship hierarchy

evaluateFunction()

Evaluate a given relationship function on the given form data @param string $funciton

formSatisfiesRelationship()

Checks to see if a given named form and id satisfies the relationship for the given primary form @param string $namedFormId. The id of the named form we wish to check. Can be either "$form|$id" oe "$id"

generateWhereClause()

Generate the where clause for the join of a given named form

getAdditionalLimits()

Modifty the given where clause, if any, based on any additional limits that have been set for the named form

getAncestorFormNames()

Get the named forms in the relationship which are ancestral to the given named form

getChildFormNames()

Get the named forms for the given named form upto a specified depth

getForm()

Returns the form for a given named form in the relationship

getFormConfig()

Get the magic data node(s) for the name form in the relationship @param string $form.

  • Defined in i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php on line 212
  • Signature: public function getFormConfig($formname)
  • Parameters:
    • $formname
      • Default Value: null
  • Returns: mixed.
    false on failture. If $forname is null, we return an array of I2CE_MagicDataNodes index by the form names. If $formma,e is a string then we return the config for the named form.

getFormData()

Get the forms that satisfy a relationship for the given primary form id

  • Defined in i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php on line 1734
  • Signature: public function getFormData($form,$id,$fields,$ordering,$as_iterator)
  • Parameters:
    • $form
    • string $id
      the id of the primary form
    • array $fields
      keys are relationship formnames, values are array of fields we wan returned
      • Default Value: array()
    • array $ordering
      keys are relationship formnames, values are array of fields we want ordered by
      • Default Value: array()
    • $as_iterator
      • Default Value: true
  • Returns: array
    of mixed. The array may be empty if the $form_id does not satisfy the relationship. It is indexed by the named form and the form objects are already populated. If there was no matching form for a given named form, then the value of the array elemet will be false

getFormDataJoiningByID()

Find all form ids matching the given join

getFormDataJoiningByID_child()

Get the forms ids for joining on the named parent forms if with the parent of the named child form

  • Defined in i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php on line 2158
  • Signature: public function getFormDataJoiningByID_child($childFormName,$parentForm,$parentId,$joinData,$where,$limit,$fields,$ordering)
  • Parameters:
    • string $childFormName
      the name of the child form in the relationship
    • string $parentForm
    • string $parentId
    • array $joinData
      The array containg the join data
    • array $where
    • array $limit
    • array $fields
      keys are relationship formnames, values are array of fields we want returned
    • array $ordering
      keys are relationship formnames, values are array of fields we want ordered by
  • Returns: mixed.
    An array of form ids

getFormDataJoiningByID_child_field()

Get the forms ids for joining on the named parent form's id with the named child form on a given field

  • Defined in i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php on line 2200
  • Signature: public function getFormDataJoiningByID_child_field($childFormName,$parentForm,$parentId,$joinData,$where,$limit,$fields,$ordering)
  • Parameters:
    • string $childFormName
      the name of the child form in the relationship
    • string $parentForm
    • string $parentId
    • array $joinData
      The array containg the join data
    • array $where
    • array $limit
    • array $fields
      keys are relationship formnames, values are array of fields we want returned
    • array $ordering
      keys are relationship formnames, values are array of fields we want ordered by
  • Returns: mixed.
    An array of form ids

getFormDataJoiningByID_fields()

Get the forms ids for joining on a given field of a named child form's with the named parent form on a given field

  • Defined in i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php on line 2250
  • Signature: public function getFormDataJoiningByID_fields($childFormName,$parentForm,$parentId,$joinData,$where,$limit,$fields,$ordering)
  • Parameters:
    • string $childFormName
      the name of the child form in the relationship
    • string $parentForm
    • string $parentId
    • array $joinData
      The array containg the join data
    • array $where
    • array $limit
    • array $fields
      keys are relationship formnames, values are array of fields we want returned
    • array $ordering
      keys are relationship formnames, values are array of fields we want ordered by
  • Returns: mixed.
    An array of form ids

getFormDataJoiningByID_ids()

Get the forms ids for joining on ids of the named parent/child forms

  • Defined in i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php on line 2118
  • Signature: public function getFormDataJoiningByID_ids($childFormName,$parentForm,$parentId,$joinData,$where,$limit,$fields,$ordering)
  • Parameters:
    • string $childFormName
      the name of the child form in the relationship
    • string $parentForm
    • string $parentId
    • array $joinData
      The array containg the join data
    • array $where
    • array $limit
    • array $fields
      keys are relationship formnames, values are array of fields we want returned
    • array $ordering
      keys are relationship formnames, values are array of fields we want ordered by
  • Returns: mixed.
    An array of form ids

getFormDataJoiningByID_parent()

Get the forms ids for joining as the named child form's id with the parent of the named parent form

  • Defined in i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php on line 1975
  • Signature: public function getFormDataJoiningByID_parent($childFormName,$parentForm,$parentId,$joinData,$where,$limit,$fields,$ordering)
  • Parameters:
    • string $childFormName
      the name of the child form in the relationship
    • string $parentForm
    • string $parentId
    • array $joinData
      The array containg the join data
    • array $where
    • array $limit
    • array $fields
      keys are relationship formnames, values are array of fields we want returned
    • array $ordering
      keys are relationship formnames, values are array of fields we want ordered by
  • Returns: mixed.
    An array of form ids

getFormDataJoiningByID_parent_field()

Get the forms ids for joining as a named child form's id with the named parent form on a given field

  • Defined in i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php on line 2019
  • Signature: public function getFormDataJoiningByID_parent_field($childFormName,$parentForm,$parentId,$joinData,$where,$limit,$fields,$ordering)
  • Parameters:
    • string $childFormName
      the name of the child form in the relationship
    • string $parentForm
    • string $parentId
    • array $joinData
      The array containg the join data
    • array $where
    • array $limit
    • array $fields
      keys are relationship formnames, values are array of fields we want returned
    • array $ordering
      keys are relationship formnames, values are array of fields we want ordered by
  • Returns: mixed.
    An array of form ids

getFormDataJoiningByID_reference()

getFormIdsJoiningOn()

Find all form ids matching the given join

getFormIdsJoiningOn_child()

Get the forms ids for joining on the named parent forms if with the parent of the named child form

getFormIdsJoiningOn_child_field()

Get the forms ids for joining on the named parent form's id with the named child form on a given field

getFormIdsJoiningOn_fields()

Get the forms ids for joining on a given field of a named child form's with the named parent form on a given field

getFormIdsJoiningOn_ids()

Get the forms ids for joining on ids of the named parent/child forms

getFormIdsJoiningOn_parent()

Get the forms ids for joining as the named child form's id with the parent of the named parent form

getFormIdsJoiningOn_parent_field()

Get the forms ids for joining as a named child form's id with the named parent form on a given field

getFormIdsJoiningOn_reference()

Get the forms ids for joining as a named child form's id with the named parent form on a given field

getFormNames()

Get the names of the forms in the relationship

getForms()

Internal method to walk the relationship and get all the form configs and parent form names and store them in arrays

getFormsSatisfyingRelationship()

Get the forms that satisfy a relationship for the given primary form id

  • Defined in i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php on line 366
  • Signature: public function getFormsSatisfyingRelationship($form_id)
  • Parameters:
    • mixed $form_id
      Either an I2CE_Form instnace, a string ( the form id) or an array of string (priamry_form, id) for the primary form of the relationship
  • Returns: array
    of mixed. The array may be empty if the $form_id does not satisfy the relationship. It is indexed by the named form and the form objects are already populated. If there was no matching form for a given named form, then the value of the array elemet will be false

getFunctionDetails()

Get the details of a relationship function

  • Defined in i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php on line 661
  • Signature: public function getFunctionDetails($functions)
  • Parameters:
    • mixed $functions
      string or an array of string
  • Returns: mixed.
    false on failure. On success an array with the keys 'qry' the query string, 'type' the return SQL type of the function, 'required_fields' the form fields reuquired in the relationship, and 'field' which is an instance of I2CE_FormField for the function

getFunctionDetailsWalker()

Walks the function data tree to creates the list of function details

getJoin()

Get the SQL join statemetn for the given form

getJoiningFields()

getLimitingFields()

Gets the names of the fields which are in a limit for a where clause of a given form

getLinkingData()

Get linking data, if any, for the indicated field of the named form @param string $joinForm the named form we are trying to join

  • Defined in i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php on line 862
  • Signature: protected function getLinkingData($formName,$fieldName,$joinFormName,$joinField,$style,$reversed,$primary_table)
  • Parameters:
    • string $formName
      The named form in the relationship
    • string $fieldName
      The field name
    • $joinFormName
    • string $joinField
      The field of the joined form we are looking for
    • $style
      • Default Value: 'default'
    • $reversed
      • Default Value: false
    • $primary_table
      • Default Value: 'primary_table'
  • Returns: mixed
    If no linking data then return false. Otherwise is in an array with keys sub_select, forms and fields

getParentFormNames()

Get the name(s) of parent forms

  • Defined in i2ce/modules/Forms/modules/FormRelationship/lib/I2CE_FormRelationship.php on line 230
  • Signature: public function getParentFormNames($formname)
  • Parameters:
    • string $formname
      • Default Value: null
  • Returns: mixed.
    If $formname is null we return an array index by relationship form names of all the parent forms. If $formname is a string, it is the parentform name, if it exists of false otherwise.

getPrimaryForm()

Get the primary form

getPrimaryFormName()

Gets the name of the primary from (e.g. the name of the relationship)

getReferencedForm()

Get the SQL name of a form via the registered callback functin

getRelationship()

getRequiredForms()

Gets the forms required by the relationship

hasAncestor()

Determine if the form name given has ancestral conditions.

isJoin()

Determine if we should consider a relationship to not be satisifed if there is no form for the given named form

isPrimaryFormName()

Check to see if the given form name is the primary form name. Note the primary form name is the same as the relationship name

isRightJoin()

Determine if we should consider a relationship to not be satisifed if there is no form for the given named form

joinOn_child()

Generate SQL join statement for joining on the named parent forms if with the parent of the named child form

joinOn_child_field()

Generate SQL join statement for joining on the named parent form's id with the named child form on a given field

joinOn_fields()

Generate SQL join statement for joining on a given field of a named child form's with the named parent form on a given field

joinOn_ids()

Generate SQL join statement for joining on ids of the named parent/child forms

joinOn_parent()

Generate SQL join statement for joining as the named child form's id with the parent of the named parent form

joinOn_parent_field()

Generate SQL join statement for joining as a named child form's id with the named parent form on a given field @param string $childForm the name of the child form in the relationship

joinOn_reference()

Generate SQL join statement for joining as a named child form's id with the named parent form on a given field @param string $childForm the name of the child form in the relationship

limitOne()

Determine if we should consider a relationship to not be satisifed if there is no form for the given named form

setAdditionalLimit()

useDisplayFields()

Set the relationship to use the display fields when getting form data

useRawFields()

Set the relationship to use the raw data when getting form data

usesRawFields()

check if the relationship to use the raw data when getting form data

Inherited Methods

_hasMethod()

This public method is inherited from I2CE_Fuzzy->_hasMethod()

Inherited Fuzzy Methods

userMessage()

This method is inherited from I2CE_Fuzzy->userMessage()