|
|
| Line 1: |
Line 1: |
| {{otherversions|Class: I2CE_Form}}
| | #REDIRECT [[Class: I2CE_Form (Development)]] |
| {{disambig}}
| |
| {{DEFAULTSORT:Class: I2CE_Form (versions)}}
| |
| [[Category:Broadcast call sign disambiguation pages]]
| |
| This article describes the class ''I2CE_Form'' .
| |
| *Extends the class: [[Class: I2CE_Fuzzy (Development) | I2CE_Fuzzy]].
| |
| *Implements the interface [http://www.php.net/manual/en/class.iterator.php Iterator ]
| |
| *Child Classes:
| |
| ** [[Class: I2CE_List (Development) | I2CE_List]]
| |
| *** [[Class: iHRIS_Contact (Development) | iHRIS_Contact]]
| |
| *** [[Class: iHRIS_Currency (Development) | iHRIS_Currency]]
| |
| *** [[Class: iHRIS_Country (Development) | iHRIS_Country]]
| |
| *** [[Class: I2CE_SimpleList (Development) | I2CE_SimpleList]]
| |
| *** [[Class: iHRIS_Job (Development) | iHRIS_Job]]
| |
| *** [[Class: iHRIS_Position (Development) | iHRIS_Position]]
| |
| *** [[Class: iHRIS_Cadre (Development) | iHRIS_Cadre]]
| |
| *** [[Class: iHRIS_TrainingProgram (Development) | iHRIS_TrainingProgram]]
| |
| *** [[Class: iHRIS_Competency (Development) | iHRIS_Competency]]
| |
| *** [[Class: iHRIS_Scheduled_Training_Course (Development) | iHRIS_Scheduled_Training_Course]]
| |
| *** [[Class: iHRIS_Training_Course (Development) | iHRIS_Training_Course]]
| |
| *** [[Class: iHRIS_ContinuingEducationCourse (Development) | iHRIS_ContinuingEducationCourse]]
| |
| *** [[Class: iHRIS_ListByCountry (Development) | iHRIS_ListByCountry]]
| |
| **** [[Class: iHRIS_Facility (Development) | iHRIS_Facility]]
| |
| ***** [[Class: iHRIS_HealthFacility (Development) | iHRIS_HealthFacility]]
| |
| **** [[Class: iHRIS_QualifyTrainingInstitution (Development) | iHRIS_QualifyTrainingInstitution]]
| |
| *** [[Class: iHRIS_County (Development) | iHRIS_County]]
| |
| *** [[Class: iHRIS_District (Development) | iHRIS_District]]
| |
| *** [[Class: iHRIS_Region (Development) | iHRIS_Region]]
| |
| *** [[Class: I2CE_Form_Locale (Development) | I2CE_Form_Locale]]
| |
| *** [[Class: iHRIS_Degree (Development) | iHRIS_Degree]]
| |
| *** [[Class: I2CE_Role (Development) | I2CE_Role]]
| |
| *** [[Class: iHRIS_Classification (Development) | iHRIS_Classification]]
| |
| *** [[Class: iHRIS_SalaryGrade (Development) | iHRIS_SalaryGrade]]
| |
| *** [[Class: iHRIS_Department (Development) | iHRIS_Department]]
| |
| *** [[Class: iHRIS_Certificate (Development) | iHRIS_Certificate]]
| |
| *** [[Class: iHRIS_DisciplinaryActionReason (Development) | iHRIS_DisciplinaryActionReason]]
| |
| *** [[Class: iHRIS_TrainingDisruptionReason (Development) | iHRIS_TrainingDisruptionReason]]
| |
| *** [[Class: iHRIS_ISCO_08_Major (Development) | iHRIS_ISCO_08_Major]]
| |
| *** [[Class: iHRIS_ISCO_08_Sub_Major (Development) | iHRIS_ISCO_08_Sub_Major]]
| |
| *** [[Class: iHRIS_ISCO_88_Major (Development) | iHRIS_ISCO_88_Major]]
| |
| *** [[Class: iHRIS_ISCO_88_Sub_Major (Development) | iHRIS_ISCO_88_Sub_Major]]
| |
| *** [[Class: iHRIS_ISCO_88_Minor (Development) | iHRIS_ISCO_88_Minor]]
| |
| *** [[Class: iHRIS_ISCO_88_Unit (Development) | iHRIS_ISCO_88_Unit]]
| |
| *** [[Class: iHRIS_Training_Course_Evaluation (Development) | iHRIS_Training_Course_Evaluation]]
| |
| ** [[Class: iHRIS_Person (Development) | iHRIS_Person]]
| |
| *** [[Class: iHRIS_QualifyPerson (Development) | iHRIS_QualifyPerson]]
| |
| *** [[Class: iHRIS_ManagePerson (Development) | iHRIS_ManagePerson]]
| |
| ** [[Class: iHRIS_UUID_Map (Development) | iHRIS_UUID_Map]]
| |
| ** [[Class: I2CE_User_Form (Development) | I2CE_User_Form]]
| |
| ** [[Class: iHRIS_Applicant (Development) | iHRIS_Applicant]]
| |
| ** [[Class: iHRIS_Benefit (Development) | iHRIS_Benefit]]
| |
| ** [[Class: iHRIS_PersonPosition (Development) | iHRIS_PersonPosition]]
| |
| ** [[Class: iHRIS_DisciplinaryAction (Development) | iHRIS_DisciplinaryAction]]
| |
| ** [[Class: iHRIS_Exam (Development) | iHRIS_Exam]]
| |
| ** [[Class: iHRIS_License (Development) | iHRIS_License]]
| |
| ** [[Class: iHRIS_PrivatePractice (Development) | iHRIS_PrivatePractice]]
| |
| ** [[Class: iHRIS_Registration (Development) | iHRIS_Registration]]
| |
| ** [[Class: iHRIS_Training (Development) | iHRIS_Training]]
| |
| ** [[Class: iHRIS_TrainingDisrupt (Development) | iHRIS_TrainingDisrupt]]
| |
| ** [[Class: iHRIS_ContinuingEducation (Development) | iHRIS_ContinuingEducation]]
| |
| ** [[Class: iHRIS_Document (Development) | iHRIS_Document]]
| |
| ** [[Class: iHRIS_Demographic (Development) | iHRIS_Demographic]]
| |
| *** [[Class: iHRIS_ManageDemographic (Development) | iHRIS_ManageDemographic]]
| |
| *** [[Class: iHRIS_QualifyDemographic (Development) | iHRIS_QualifyDemographic]]
| |
| ** [[Class: iHRIS_Education (Development) | iHRIS_Education]]
| |
| ** [[Class: iHRIS_Employment (Development) | iHRIS_Employment]]
| |
| ** [[Class: iHRIS_PersonID (Development) | iHRIS_PersonID]]
| |
| ** [[Class: iHRIS_PersonLanguage (Development) | iHRIS_PersonLanguage]]
| |
| ** [[Class: iHRIS_Notes (Development) | iHRIS_Notes]]
| |
| ** [[Class: iHRIS_Photo (Development) | iHRIS_Photo]]
| |
| ** [[Class: iHRIS_RecordVerify (Development) | iHRIS_RecordVerify]]
| |
| ** [[Class: iHRIS_Accident (Development) | iHRIS_Accident]]
| |
| ** [[Class: iHRIS_PositionInterview (Development) | iHRIS_PositionInterview]]
| |
| ** [[Class: iHRIS_PositionDecision (Development) | iHRIS_PositionDecision]]
| |
| ** [[Class: iHRIS_Salary (Development) | iHRIS_Salary]]
| |
| ** [[Class: iHRIS_Deployment (Development) | iHRIS_Deployment]]
| |
| ** [[Class: iHRIS_SecondaryEducation (Development) | iHRIS_SecondaryEducation]]
| |
| ** [[Class: iHRIS_FacilityInstitution (Development) | iHRIS_FacilityInstitution]]
| |
| ** [[Class: iHRIS_FacilityInstitutionEditFacility (Development) | iHRIS_FacilityInstitutionEditFacility]]
| |
| ** [[Class: iHRIS_FacilityInstitutionEditInstitution (Development) | iHRIS_FacilityInstitutionEditInstitution]]
| |
| ** [[Class: iHRIS_InstitutionInspection (Development) | iHRIS_InstitutionInspection]]
| |
| ** [[Class: iHRIS_OutMigration (Development) | iHRIS_OutMigration]]
| |
| ** [[Class: iHRIS_PersonCompetency (Development) | iHRIS_PersonCompetency]]
| |
| ** [[Class: iHRIS_Person_Scheduled_Training_Course (Development) | iHRIS_Person_Scheduled_Training_Course]]
| |
| ** [[Class: iHRIS_Training_Course_Competency_Evaluation (Development) | iHRIS_Training_Course_Competency_Evaluation]]
| |
| *Location: Part of the module [[I2CE Module List (Development)#forms|forms]] in the package [https://launchpad.net/i2ce I2CE] 4.0-dev
| |
| *Source: Defined in the file [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L36 modules/Forms/lib/I2CE_Form.php] on line 36
| |
| *Author: Luke Duncan <lduncan@intrahealth.org>
| |
| *Since: v1.0.0
| |
| *See: [[Class: I2CE_Template (Development) | I2CE_Template]]
| |
| Abstract class for objects using the [[Class: I2CE_Template (Development) | ]] class that interact with a database and HTML form. This class has a few default functions that are used when interacting with the template engine in setting up form values and displaying the data for objects that tie directly to database tables.
| |
| ==Variables==
| |
| ===$form_name===
| |
| The name of this form for the database.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L41 i2ce/modules/Forms/lib/I2CE_Form.php] on line 41
| |
| *Type: private [http://www.php.net/manual/en/language.types.string.php string ] $form_name
| |
| | |
| ===$display_name===
| |
| The text name of this form for display.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L46 i2ce/modules/Forms/lib/I2CE_Form.php] on line 46
| |
| *Type: private [http://www.php.net/manual/en/language.types.string.php string ] $display_name
| |
| | |
| ===$fields===
| |
| The list of fields with all the information about each field.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L51 i2ce/modules/Forms/lib/I2CE_Form.php] on line 51
| |
| *Type: protected [http://www.php.net/manual/en/language.types.array.php array ] $fields
| |
| | |
| ===$parent===
| |
| String or boolean (false) The form and id of the parent record for this form if there is one. Of the form "$form|$id"
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L56 i2ce/modules/Forms/lib/I2CE_Form.php] on line 56
| |
| *Type: protected [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $parent
| |
| | |
| ===$id===
| |
| The record id for this entry.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L61 i2ce/modules/Forms/lib/I2CE_Form.php] on line 61
| |
| *Type: protected [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $id
| |
| | |
| ===$children===
| |
| An array of children objects for this form. It is an array of arrays. The first being an associative array with the name of the form, the second level is a simple array of the objects.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L70 i2ce/modules/Forms/lib/I2CE_Form.php] on line 70
| |
| *Type: public [http://www.php.net/manual/en/language.types.array.php array ] $children
| |
| | |
| ===$attributes===
| |
| A list of attributes for this form.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L75 i2ce/modules/Forms/lib/I2CE_Form.php] on line 75
| |
| *Type: protected [http://www.php.net/manual/en/language.types.array.php array ] $attributes
| |
| | |
| ===$parent_forms===
| |
| parent_forms. The array with keys form names and values which are arrays of form names, the form names which the form's parent id can take values in
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L202 i2ce/modules/Forms/lib/I2CE_Form.php] on line 202
| |
| *Type: static protected [http://www.php.net/manual/en/language.types.array.php array ] $parent_forms
| |
| | |
| ==Methods==
| |
| ===__construct()===
| |
| Create a new instance of a I2CE_Form object.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L248 i2ce/modules/Forms/lib/I2CE_Form.php] on line 248
| |
| *Signature: public function __construct($form,$id)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $form <br/>The name of this form
| |
| ** integer $id
| |
| ***Default Value: '0'
| |
| ===__get()===
| |
| Return the [[Class: I2CE_FormField (Development) | form field]] value from the [[#$fields | $fields]] array.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L82 i2ce/modules/Forms/lib/I2CE_Form.php] on line 82
| |
| *Signature: protected function __get($key)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $key
| |
| *Returns: [http://www.php.net/manual/en/language.pseudo-types.php mixed ]
| |
| ===__isset()===
| |
| Check to see if a [[Class: I2CE_FormField (Development) | form field]] value has been set.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L106 i2ce/modules/Forms/lib/I2CE_Form.php] on line 106
| |
| *Signature: protected function __isset($key)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $key
| |
| *Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ]
| |
| ===__set()===
| |
| Set the [[Class: I2CE_FormField (Development) | form field]] value in the [[#$fields | $fields]] array.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L95 i2ce/modules/Forms/lib/I2CE_Form.php] on line 95
| |
| *Signature: protected function __set($key,$value)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $key
| |
| ** [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $value
| |
| ===__unset()===
| |
| Unset a [[Class: I2CE_FormField (Development) | form field]].
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L118 i2ce/modules/Forms/lib/I2CE_Form.php] on line 118
| |
| *Signature: protected function __unset($key)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $key
| |
| ===addChildForm()===
| |
| Add a child form object to this forms list of children.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L649 i2ce/modules/Forms/lib/I2CE_Form.php] on line 649
| |
| *Signature: public function addChildForm($child_form,$replace)
| |
| *Parameters:
| |
| ** [[Class: I2CE_Form (Development) | I2CE_Form]] $child_form <br/>The child form
| |
| ** [http://www.php.net/manual/en/language.types.boolean.php boolean ] $replace <br/>Overwrite the child object if it already exists.
| |
| ***Default Value: false
| |
| ===addField()===
| |
| Adds a field to this form.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L392 i2ce/modules/Forms/lib/I2CE_Form.php] on line 392
| |
| *Signature: public function addField($name,$args)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $name
| |
| ** [http://www.php.net/manual/en/language.types.array.php array ] $args <br/>The arguments for this field
| |
| *Returns: [http://www.php.net/manual/en/language.pseudo-types.php mixed ]<br/>I2CE_FormField or false on failure
| |
| ===addFormFields()===
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L299 i2ce/modules/Forms/lib/I2CE_Form.php] on line 299
| |
| *Signature: protected function addFormFields($data)
| |
| *Parameters:
| |
| **$data
| |
| ===cleanup()===
| |
| Clean up all the fields for this form. This will unset all the fields associated with this form. This will remove all circular references to this form so it can be cleaned up by the garbage collector. This should only be called when the form is no longer needed. Trying to access it after this may cause unexpected results or errors.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L332 i2ce/modules/Forms/lib/I2CE_Form.php] on line 332
| |
| *Signature: public function cleanup()
| |
| ===clearFields()===
| |
| Remove fields from the form. This is to be used when only certain fields of the form are being dealt with so the others can be removed to save processing.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L700 i2ce/modules/Forms/lib/I2CE_Form.php] on line 700
| |
| *Signature: public function clearFields($fields,$keep)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.array.php array ] $fields <br/>The fields being worked with.
| |
| ** [http://www.php.net/manual/en/language.types.boolean.php boolean ] $keep <br/>A flag to determine if the given fields should be removed or all except the given fields.
| |
| ***Default Value: true
| |
| ===current()===
| |
| Return the current value for the [[#$fields | $fields]] array for iterating through the form fields.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L134 i2ce/modules/Forms/lib/I2CE_Form.php] on line 134
| |
| *Signature: public function current()
| |
| *Returns: [http://www.php.net/manual/en/language.pseudo-types.php mixed ]
| |
| ===displayField()===
| |
| Display the field in the given node.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L549 i2ce/modules/Forms/lib/I2CE_Form.php] on line 549
| |
| *Signature: public function displayField($node,$template,$args)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/class.domnode.php DOMNode ] $node
| |
| ** [[Class: I2CE_Template (Development) | I2CE_Template]] $template
| |
| ** [http://www.php.net/manual/en/language.types.array.php array ] $args
| |
| ===form()===
| |
| Return the form name for this form.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L522 i2ce/modules/Forms/lib/I2CE_Form.php] on line 522
| |
| *Signature: public function form()
| |
| *Returns: [http://www.php.net/manual/en/language.types.string.php string ]
| |
| ===getAllowedParentForms()===
| |
| Gets the allowed parent forms for a given form
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L213 i2ce/modules/Forms/lib/I2CE_Form.php] on line 213
| |
| *Signature: static public function getAllowedParentForms($form,$use_cache)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $form
| |
| ** [http://www.php.net/manual/en/language.types.boolean.php boolean ] $use_cache <br/>Defaults to true in which case we cached result of finding parent forms
| |
| ***Default Value: true
| |
| *Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>of string, the form names.
| |
| ===getAttribute()===
| |
| Return the attribute value for a given attribute.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L907 i2ce/modules/Forms/lib/I2CE_Form.php] on line 907
| |
| *Signature: public function getAttribute($key)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $key
| |
| *Returns: [http://www.php.net/manual/en/language.pseudo-types.php mixed ]
| |
| ===getChildForms()===
| |
| Get the registered child forms for this form.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L162 i2ce/modules/Forms/lib/I2CE_Form.php] on line 162
| |
| *Signature: public function getChildForms()
| |
| *Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>The list of child form names registered for this form.
| |
| ===getChildFormsByForm()===
| |
| Get the registered child forms for the given form.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L171 i2ce/modules/Forms/lib/I2CE_Form.php] on line 171
| |
| *Signature: static public function getChildFormsByForm($form)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $form <br/>The form to get the children of.
| |
| *Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>The list of child form names registered for the form.
| |
| ===getChildren()===
| |
| Get the added children for this form
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L185 i2ce/modules/Forms/lib/I2CE_Form.php] on line 185
| |
| *Signature: public function getChildren($form)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $form <br/>Defaults to null, in which case we get all children. otherwise we get the popoluated children with the specified form
| |
| ***Default Value: null
| |
| *Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>If $form is null, it is an array with keys the form names and values array of the children of that form type. If $form is set, then it is an array of the forms of type $form
| |
| ===getDisplayName()===
| |
| Return the display name for this form object.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L538 i2ce/modules/Forms/lib/I2CE_Form.php] on line 538
| |
| *Signature: public function getDisplayName()
| |
| *Returns: [http://www.php.net/manual/en/language.types.string.php string ]
| |
| ===getField()===
| |
| Return the I2CE_FormField for the given field name.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L670 i2ce/modules/Forms/lib/I2CE_Form.php] on line 670
| |
| *Signature: public function getField($field)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $field <br/>the field name or a form name:field name
| |
| *Returns: [[Class: I2CE_FormField (Development) | I2CE_FormField]]
| |
| ===getFieldNames()===
| |
| Get the names of all the fields added in this form
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L239 i2ce/modules/Forms/lib/I2CE_Form.php] on line 239
| |
| *Signature: public function getFieldNames()
| |
| *Returns: [http://www.php.net/manual/en/language.types.array.php array ]<br/>of string, the field names.
| |
| ===getFormFieldsData()===
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L273 i2ce/modules/Forms/lib/I2CE_Form.php] on line 273
| |
| *Signature: protected function getFormFieldsData($class,$data)
| |
| *Parameters:
| |
| **$class
| |
| **&$data
| |
| ===getFormId()===
| |
| Returns the form id for this record.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L353 i2ce/modules/Forms/lib/I2CE_Form.php] on line 353
| |
| *Signature: public function getFormId()
| |
| *Returns: [http://www.php.net/manual/en/language.types.string.php string ]<br/>of the form "$form|$id"
| |
| ===getHTMLName()===
| |
| Return the value for the name attribute to be used for this field in a form.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L812 i2ce/modules/Forms/lib/I2CE_Form.php] on line 812
| |
| *Signature: public function getHTMLName()
| |
| *Returns: [http://www.php.net/manual/en/language.types.string.php string ]
| |
| ===getId()===
| |
| Returns the id for this record.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L345 i2ce/modules/Forms/lib/I2CE_Form.php] on line 345
| |
| *Signature: public function getId()
| |
| *Returns: [http://www.php.net/manual/en/language.types.string.php string ]
| |
| ===getParent()===
| |
| Return the parent id for this record. If there isn't a parent record set then return the id for this record.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L419 i2ce/modules/Forms/lib/I2CE_Form.php] on line 419
| |
| *Signature: public function getParent()
| |
| *Returns: mixed.<br/>false if there is no parent id or string a parent id of the form "$form|$id"
| |
| ===getParentForm()===
| |
| Return the name of the parent form for this record. If there isn't a parent record set then return the id for this record.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L447 i2ce/modules/Forms/lib/I2CE_Form.php] on line 447
| |
| *Signature: public function getParentForm()
| |
| *Returns: mixed.<br/>false if there is no parent the parent form
| |
| ===getParentID()===
| |
| Return the parent id for this record. If there isn't a parent record set then return the id for this record.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L429 i2ce/modules/Forms/lib/I2CE_Form.php] on line 429
| |
| *Signature: public function getParentID()
| |
| *Returns: mixed.<br/>false if there is no parent id or string a parent id
| |
| ===getQueryDisplay()===
| |
| Return the values of all the fields that are set.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L831 i2ce/modules/Forms/lib/I2CE_Form.php] on line 831
| |
| *Signature: public function getQueryDisplay()
| |
| *Returns: [http://www.php.net/manual/en/language.types.string.php string ]
| |
| ===getQueryFields()===
| |
| Return all the fields as an associative array
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L819 i2ce/modules/Forms/lib/I2CE_Form.php] on line 819
| |
| *Signature: public function getQueryFields()
| |
| *Returns: [http://www.php.net/manual/en/language.types.array.php array ]
| |
| ===getQueryString()===
| |
| Return all the fields as a query string to be sent to a URL
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L799 i2ce/modules/Forms/lib/I2CE_Form.php] on line 799
| |
| *Signature: public function getQueryString()
| |
| *Returns: [http://www.php.net/manual/en/language.types.string.php string ]
| |
| ===hasAttribute()===
| |
| Return true if a given attribute exists for this form.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L920 i2ce/modules/Forms/lib/I2CE_Form.php] on line 920
| |
| *Signature: public function hasAttribute($key)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $key
| |
| *Returns: boolean;
| |
| ===hasInvalid()===
| |
| Checks to see if any fields of form has in invalid message
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L863 i2ce/modules/Forms/lib/I2CE_Form.php] on line 863
| |
| *Signature: public function hasInvalid()
| |
| *Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ]
| |
| ===key()===
| |
| Return the current key for the [[#$fields | $fields]] array for iterating through the form fields.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L141 i2ce/modules/Forms/lib/I2CE_Form.php] on line 141
| |
| *Signature: public function key()
| |
| *Returns: [http://www.php.net/manual/en/language.pseudo-types.php mixed ]
| |
| ===listFields()===
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L978 i2ce/modules/Forms/lib/I2CE_Form.php] on line 978
| |
| *Signature: static public function listFields($form,$fields,$where_data,$ordering,$limit)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $form <br/>The form name
| |
| ** [http://www.php.net/manual/en/language.types.array.php array ] $fields <br/>of string. The fields we want returned
| |
| ** [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $where_data <br/>Either I2CE_MagicDataNode or array. contains the where clause information about this form or a nested
| |
| ***Default Value: array()
| |
| ** [http://www.php.net/manual/en/language.types.array.php array ] $ordering <br/>An array of fields to order by. Defaults to the empty array. Prepend a - to order by in descending order.
| |
| ***Default Value: array()
| |
| ** [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $limit <br/>Defaults to false. It true, returns only one result. If an integer it is the numeber of records to limit to. If it is as an array of two integers, it is the offset and then number of results to limit to.
| |
| ***Default Value: false
| |
| *Returns: [http://www.php.net/manual/en/language.pseudo-types.php mixed ]<br/>an array with key id's and value and array of values. the array of values has as keys the fields with their corresponding value.
| |
| ===load()===
| |
| Load the member variables from an array
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L769 i2ce/modules/Forms/lib/I2CE_Form.php] on line 769
| |
| *Signature: public function load($post,$loadID,$populate_on_set_id)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.array.php array ] $post <br/>The Post vairables. Usually from an http request.
| |
| ** [http://www.php.net/manual/en/language.types.boolean.php boolean ] $loadID <br/>Defaults to true. If true, and there is exactly one of entry in the array $post['forms'][$this->form_name], we set the values of the form's field, id and parent from that entry. If false, we set the values from $post['forms'][$this->form_name][$this->getID()] if it is present
| |
| ***Default Value: true
| |
| **$populate_on_set_id
| |
| ***Default Value: true
| |
| ===lookupArray()===
| |
| Lookup a given id in the given array.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L880 i2ce/modules/Forms/lib/I2CE_Form.php] on line 880
| |
| *Signature: static protected function lookupArray($id,$arr)
| |
| *Parameters:
| |
| ** integer $id <br/>The id to lookup.
| |
| ** [http://www.php.net/manual/en/language.types.array.php array ] $arr <br/>The array to search through.
| |
| *Returns: [http://www.php.net/manual/en/language.types.string.php string ]
| |
| ===next()===
| |
| Advance the internal pointer for the [[#$fields | $fields]] array for iterating through the form fields.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L147 i2ce/modules/Forms/lib/I2CE_Form.php] on line 147
| |
| *Signature: public function next()
| |
| ===processDOM()===
| |
| Process the DOM for this form.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L568 i2ce/modules/Forms/lib/I2CE_Form.php] on line 568
| |
| *Signature: public function processDOM($node,$template,$method,$args)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/class.domnode.php DOMNode ] $node
| |
| ** [[Class: I2CE_Template (Development) | I2CE_Template]] $template
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $method
| |
| ** [http://www.php.net/manual/en/language.types.array.php array ] $args
| |
| ===removeField()===
| |
| Removes a field from this form. @param array $args The arguments for this field
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L380 i2ce/modules/Forms/lib/I2CE_Form.php] on line 380
| |
| *Signature: public function removeField($name)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $name
| |
| ===reset()===
| |
| Reset this object to its original state.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L638 i2ce/modules/Forms/lib/I2CE_Form.php] on line 638
| |
| *Signature: public function reset()
| |
| ===rewind()===
| |
| Rewind the internal pointer for the [[#$fields | $fields]] array for iterating through the form fields.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L127 i2ce/modules/Forms/lib/I2CE_Form.php] on line 127
| |
| *Signature: public function rewind()
| |
| ===search()===
| |
| @param mixed $limit. Defaults to false. It true, returns only one result. If an integer it is the numeber of records to limit to. If it is as an array of two integers, it is the offset and then number of results to limit to.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L939 i2ce/modules/Forms/lib/I2CE_Form.php] on line 939
| |
| *Signature: static public function search($form,$where_data,$ordering,$limit_one)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $form <br/>The form name.
| |
| ** [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $where_data <br/>Either I2CE_MagicDataNode or array. contains the where clause information about this form or a nested
| |
| ***Default Value: array()
| |
| ** [http://www.php.net/manual/en/language.types.array.php array ] $ordering <br/>An array of fields to order by. Defaults to the empty array. Prepend a - to order by in descending order.
| |
| ***Default Value: array()
| |
| **$limit_one
| |
| ***Default Value: false
| |
| *Returns: [http://www.php.net/manual/en/language.pseudo-types.php mixed ]<br/>an array of matching form ids. However, ff $limit_one is true or 1 or array ($offset,1) then then we return either the id or false, if none found or there was an error.
| |
| ===setAttribute()===
| |
| Set an attribute for this form.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L898 i2ce/modules/Forms/lib/I2CE_Form.php] on line 898
| |
| *Signature: public function setAttribute($key,$value)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $key
| |
| ** [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $value
| |
| ===setDisplayName()===
| |
| Set the display name for this form object.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L530 i2ce/modules/Forms/lib/I2CE_Form.php] on line 530
| |
| *Signature: final public function setDisplayName($display)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $display
| |
| ===setForm()===
| |
| Set the form name for this form object.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L514 i2ce/modules/Forms/lib/I2CE_Form.php] on line 514
| |
| *Signature: final public function setForm($name)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.string.php string ] $name
| |
| ===setFromPost()===
| |
| Load the member variables from an array The array can contain the keys 'id', 'parent', 'fields'. The later of which is an array indexed by field names and which contains the values of the field
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L721 i2ce/modules/Forms/lib/I2CE_Form.php] on line 721
| |
| *Signature: public function setFromPost($post,$populate_on_set_id)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.types.array.php array ] $post <br/>The post object is passed as a reference
| |
| **$populate_on_set_id
| |
| ***Default Value: false
| |
| ===setId()===
| |
| Set the id for this record.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L362 i2ce/modules/Forms/lib/I2CE_Form.php] on line 362
| |
| *Signature: public function setId($id)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $id
| |
| ===setParent()===
| |
| Set the parent id for this record
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L463 i2ce/modules/Forms/lib/I2CE_Form.php] on line 463
| |
| *Signature: public function setParent($parent,$set_id)
| |
| *Parameters:
| |
| ** [http://www.php.net/manual/en/language.pseudo-types.php mixed ] $parent <br/>string or I2CE_Form
| |
| ** [http://www.php.net/manual/en/language.types.boolean.php boolean ] $set_id <br/>If the parent will only have one child object then you can set the id by setting this to true.
| |
| ***Default Value: false
| |
| ===valid()===
| |
| Check to see if the current internal pointer for the [[#$fields | $fields]] array is valid.
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L154 i2ce/modules/Forms/lib/I2CE_Form.php] on line 154
| |
| *Signature: public function valid()
| |
| *Returns: [http://www.php.net/manual/en/language.types.boolean.php boolean ]
| |
| ===validate()===
| |
| Validate all fields that are marked as required or unique. This will check all the fields in this form and if they're required or unique it will perform the required checks
| |
| *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/lib/I2CE_Form.php#L852 i2ce/modules/Forms/lib/I2CE_Form.php] on line 852
| |
| *Signature: public function validate()
| |
| ==Inherited Methods==
| |
| ===_hasMethod()===
| |
| This public method is inherited from [[Class: I2CE_Fuzzy (Development)#_hasMethod() | I2CE_Fuzzy->_hasMethod()]]
| |
| ==Inherited Fuzzy Methods==
| |
| ===userMessage()===
| |
| This method is inherited from [[Class: I2CE_Fuzzy (Development)#userMessage() | I2CE_Fuzzy->userMessage()]]
| |
| ==Fuzzy Methods==
| |
| ===isNumeric()===
| |
| This method is implemented by [[Class: I2CE_Module_CustomReports (Development)#isNumeric() | I2CE_Module_CustomReports->isNumeric() ]]
| |
| ===getLimitStyles()===
| |
| This method is implemented by [[Class: I2CE_Module_FormLimits (Development)#getLimitStyles() | I2CE_Module_FormLimits->getLimitStyles() ]]
| |
| ===checkLimit()===
| |
| This method is implemented by [[Class: I2CE_Module_FormLimits (Development)#checkLimit() | I2CE_Module_FormLimits->checkLimit() ]]
| |
| ===checkWhereClause()===
| |
| This method is implemented by [[Class: I2CE_Module_FormLimits (Development)#checkWhereClause() | I2CE_Module_FormLimits->checkWhereClause() ]]
| |
| ===createCheckFunction()===
| |
| This method is implemented by [[Class: I2CE_Module_FormLimits (Development)#createCheckFunction() | I2CE_Module_FormLimits->createCheckFunction() ]]
| |
| ===createCheckLimitString()===
| |
| This method is implemented by [[Class: I2CE_Module_FormLimits (Development)#createCheckLimitString() | I2CE_Module_FormLimits->createCheckLimitString() ]]
| |
| ===generateLimit()===
| |
| This method is implemented by [[Class: I2CE_Module_FormLimits (Development)#generateLimit() | I2CE_Module_FormLimits->generateLimit() ]]
| |
| ===generateWhereClause()===
| |
| This method is implemented by [[Class: I2CE_Module_FormLimits (Development)#generateWhereClause() | I2CE_Module_FormLimits->generateWhereClause() ]]
| |
| ===processLimit()===
| |
| This method is implemented by [[Class: I2CE_Module_FormLimits (Development)#processLimit() | I2CE_Module_FormLimits->processLimit() ]]
| |
| ===getDisplayedExistingLimit()===
| |
| This method is implemented by [[Class: I2CE_Module_FormLimits (Development)#getDisplayedExistingLimit() | I2CE_Module_FormLimits->getDisplayedExistingLimit() ]]
| |
| ===isComponentized()===
| |
| This method is implemented by [[Class: I2CE_FormStorage (Development)#isComponentizedForm() | I2CE_FormStorage->isComponentizedForm() ]]
| |
| ===addChild()===
| |
| This method is implemented by [[Class: I2CE_FormStorage (Development)#addChild() | I2CE_FormStorage->addChild() ]]
| |
| ===getChildIds()===
| |
| This method is implemented by [[Class: I2CE_FormStorage (Development)#getChildIds() | I2CE_FormStorage->getChildIds() ]]
| |
| ===getStorage()===
| |
| This method is implemented by [[Class: I2CE_FormStorage (Development)#getStorage() | I2CE_FormStorage->getStorage() ]]
| |
| ===isWritable()===
| |
| This method is implemented by [[Class: I2CE_FormStorage (Development)#isWritable() | I2CE_FormStorage->isWritable() ]]
| |
| ===populate()===
| |
| This method is implemented by [[Class: I2CE_FormStorage (Development)#populate() | I2CE_FormStorage->populate() ]]
| |
| ===populateChild()===
| |
| This method is implemented by [[Class: I2CE_FormStorage (Development)#populateChild() | I2CE_FormStorage->populateChild() ]]
| |
| ===populateChildren()===
| |
| This method is implemented by [[Class: I2CE_FormStorage (Development)#populateChildren() | I2CE_FormStorage->populateChildren() ]]
| |
| ===populateFirst()===
| |
| This method is implemented by [[Class: I2CE_FormStorage (Development)#populateFirst() | I2CE_FormStorage->populateFirst() ]]
| |
| ===populateHistory()===
| |
| This method is implemented by [[Class: I2CE_FormStorage (Development)#populateHistory() | I2CE_FormStorage->populateHistory() ]]
| |
| ===populateLast()===
| |
| This method is implemented by [[Class: I2CE_FormStorage (Development)#populateLast() | I2CE_FormStorage->populateLast() ]]
| |
| ===delete()===
| |
| This method is implemented by [[Class: I2CE_FormStorage (Development)#delete() | I2CE_FormStorage->delete() ]]
| |
| ===save()===
| |
| This method is implemented by [[Class: I2CE_FormStorage (Development)#save() | I2CE_FormStorage->save() ]]
| |
| ===setChangeType()===
| |
| This method is implemented by [[Class: I2CE_FormStorage (Development)#setChangeType() | I2CE_FormStorage->setChangeType() ]]
| |
| | |
| | |
| [[Category:Class Documentation (Development)]]
| |
