Class: I2CE FormStorage (Development): Difference between revisions
(Created page with '{{otherversions|Class: I2CE_FormStorage}} This article describes the class ''I2CE_FormStorage'' . *Extends the class: I2CE_Module. *Locatio…') |
No edit summary |
||
Line 15: | Line 15: | ||
===$componentized_forms=== | ===$componentized_forms=== | ||
A cached list of componentized forms. array of string, the form names | A cached list of componentized forms. array of string, the form names | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L265 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 265 | ||
*Type: static protected static $componentized_forms | *Type: static protected static $componentized_forms | ||
===$storage=== | ===$storage=== | ||
An array with a cache of the storage type for a form. | An array with a cache of the storage type for a form. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L291 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 291 | ||
*Type: static protected [http://www.php.net/manual/en/language.types.array.php array ] $storage | *Type: static protected [http://www.php.net/manual/en/language.types.array.php array ] $storage | ||
===$storageMechs=== | ===$storageMechs=== | ||
An array with a cache of the storage mechanisms | An array with a cache of the storage mechanisms | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L323 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 323 | ||
*Type: static protected [http://www.php.net/manual/en/language.types.array.php array ] $storageMechs | *Type: static protected [http://www.php.net/manual/en/language.types.array.php array ] $storageMechs | ||
Line 31: | Line 31: | ||
===FF_IG_save()=== | ===FF_IG_save()=== | ||
Save the FormField to the database. | Save the FormField to the database. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L1284 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 1284 | ||
*Signature: public function FF_IG_save($form_field,$do_check,$user) | *Signature: public function FF_IG_save($form_field,$do_check,$user) | ||
*Parameters: | *Parameters: | ||
Line 40: | Line 40: | ||
===FF_IG_setSequence()=== | ===FF_IG_setSequence()=== | ||
Set the value of this field to the next sequence for the form field. | Set the value of this field to the next sequence for the form field. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L1342 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 1342 | ||
*Signature: public function FF_IG_setSequence($form_field) | *Signature: public function FF_IG_setSequence($form_field) | ||
*Parameters: | *Parameters: | ||
Line 46: | Line 46: | ||
===FF_SP_save()=== | ===FF_SP_save()=== | ||
Save the FormField_STRING_PASS to the database. | Save the FormField_STRING_PASS to the database. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L1313 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 1313 | ||
*Signature: public function FF_SP_save($form_field,$do_check,$user) | *Signature: public function FF_SP_save($form_field,$do_check,$user) | ||
*Parameters: | *Parameters: | ||
Line 55: | Line 55: | ||
===FF_populateHistory()=== | ===FF_populateHistory()=== | ||
Populate the history of entries for the form field if the storage module handles history. | Populate the history of entries for the form field if the storage module handles history. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L1362 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 1362 | ||
*Signature: public function FF_populateHistory($form_field) | *Signature: public function FF_populateHistory($form_field) | ||
*Parameters: | *Parameters: | ||
Line 62: | Line 62: | ||
===FF_save()=== | ===FF_save()=== | ||
Save the FormField to the database. | Save the FormField to the database. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L1260 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 1260 | ||
*Signature: public function FF_save($form_field,$do_check,$user) | *Signature: public function FF_save($form_field,$do_check,$user) | ||
*Parameters: | *Parameters: | ||
Line 71: | Line 71: | ||
===_populate()=== | ===_populate()=== | ||
Internal worker method to populate a form object. | Internal worker method to populate a form object. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L916 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 916 | ||
*Signature: public function _populate($form,$storageMechanism) | *Signature: public function _populate($form,$storageMechanism) | ||
*Parameters: | *Parameters: | ||
Line 80: | Line 80: | ||
===_save()=== | ===_save()=== | ||
Internal worker method to save a form object. | Internal worker method to save a form object. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L1195 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 1195 | ||
*Signature: protected function _save($form,$user,$transact,$storageMechanism) | *Signature: protected function _save($form,$user,$transact,$storageMechanism) | ||
*Parameters: | *Parameters: | ||
Line 92: | Line 92: | ||
===addChild()=== | ===addChild()=== | ||
add the given child to the form for this object. | add the given child to the form for this object. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L1061 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 1061 | ||
*Signature: public function addChild($form,$form_name,$id) | *Signature: public function addChild($form,$form_name,$id) | ||
*Parameters: | *Parameters: | ||
Line 100: | Line 100: | ||
===delete()=== | ===delete()=== | ||
Delete a form object. | Delete a form object. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L1225 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 1225 | ||
*Signature: public function delete($form,$transact,$complete,$no_history) | *Signature: public function delete($form,$transact,$complete,$no_history) | ||
*Parameters: | *Parameters: | ||
Line 113: | Line 113: | ||
===exportData()=== | ===exportData()=== | ||
Move data for a form from one storage mechansim to another | Move data for a form from one storage mechansim to another | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L218 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 218 | ||
*Signature: static public function exportData($form,$target,$user,$ids) | *Signature: static public function exportData($form,$target,$user,$ids) | ||
*Parameters: | *Parameters: | ||
Line 124: | Line 124: | ||
===getChildIds()=== | ===getChildIds()=== | ||
Gets the id's for the given child for this form. | Gets the id's for the given child for this form. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L1042 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 1042 | ||
*Signature: public function getChildIds($form,$child_form_name,$order_by,$where,$limit) | *Signature: public function getChildIds($form,$child_form_name,$order_by,$where,$limit) | ||
*Parameters: | *Parameters: | ||
Line 138: | Line 138: | ||
===getComponentizedForms()=== | ===getComponentizedForms()=== | ||
static function which gets a list of all componentized forms | static function which gets a list of all componentized forms | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L271 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 271 | ||
*Signature: static public function getComponentizedForms($use_cache) | *Signature: static public function getComponentizedForms($use_cache) | ||
*Parameters: | *Parameters: | ||
Line 149: | Line 149: | ||
===getLastListCount()=== | ===getLastListCount()=== | ||
Return the last results from a search query for a form. | Return the last results from a search query for a form. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L1453 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 1453 | ||
*Signature: static public function getLastListCount($form) | *Signature: static public function getLastListCount($form) | ||
*Parameters: | *Parameters: | ||
Line 156: | Line 156: | ||
===getMechanismByStorage()=== | ===getMechanismByStorage()=== | ||
Returns the storage mechanism for the given storage type. | Returns the storage mechanism for the given storage type. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L344 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 344 | ||
*Signature: static public function getMechanismByStorage($storage) | *Signature: static public function getMechanismByStorage($storage) | ||
*Parameters: | *Parameters: | ||
Line 166: | Line 166: | ||
===getMigratedValue()=== | ===getMigratedValue()=== | ||
Get the new value for a field that has been migrated. | Get the new value for a field that has been migrated. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L462 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 462 | ||
*Signature: static public function getMigratedValue($migrate_node,$form,$old_id,$field,$map_form) | *Signature: static public function getMigratedValue($migrate_node,$form,$old_id,$field,$map_form) | ||
*Parameters: | *Parameters: | ||
Line 177: | Line 177: | ||
===getNewMigratedValue()=== | ===getNewMigratedValue()=== | ||
Get the new migrated value for from the old value. @param mixed $old_id | Get the new migrated value for from the old value. @param mixed $old_id | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L439 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 439 | ||
*Signature: static public function getNewMigratedValue($migrate_node,$map_form,$old_value,$old_amt) | *Signature: static public function getNewMigratedValue($migrate_node,$map_form,$old_value,$old_amt) | ||
*Parameters: | *Parameters: | ||
Line 188: | Line 188: | ||
===getOldMigratedValue()=== | ===getOldMigratedValue()=== | ||
Get the old value for a field that has been migrated. | Get the old value for a field that has been migrated. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L388 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 388 | ||
*Signature: static public function getOldMigratedValue($migrate_node,$form,$old_id,$field,$map_form) | *Signature: static public function getOldMigratedValue($migrate_node,$form,$old_id,$field,$map_form) | ||
*Parameters: | *Parameters: | ||
Line 199: | Line 199: | ||
===getRecords()=== | ===getRecords()=== | ||
Return an array of all the record ids for a given form. | Return an array of all the record ids for a given form. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L1387 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 1387 | ||
*Signature: public function getRecords($factory,$form_name) | *Signature: public function getRecords($factory,$form_name) | ||
*Parameters: | *Parameters: | ||
Line 207: | Line 207: | ||
===getStorage()=== | ===getStorage()=== | ||
Return the storage class for the given form. | Return the storage class for the given form. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L301 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 301 | ||
*Signature: static public function getStorage($form_name,$no_cache) | *Signature: static public function getStorage($form_name,$no_cache) | ||
*Parameters: | *Parameters: | ||
Line 215: | Line 215: | ||
*Returns: [http://www.php.net/manual/en/language.types.string.php string ] | *Returns: [http://www.php.net/manual/en/language.types.string.php string ] | ||
===getStorageMechanism()=== | ===getStorageMechanism()=== | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L331 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 331 | ||
*Signature: static public function getStorageMechanism($form_name,$no_cache) | *Signature: static public function getStorageMechanism($form_name,$no_cache) | ||
*Parameters: | *Parameters: | ||
Line 224: | Line 224: | ||
===importData()=== | ===importData()=== | ||
Move data for a form from one storage mechansim to another @param I2CE_FormStorage_Mechansim $target | Move data for a form from one storage mechansim to another @param I2CE_FormStorage_Mechansim $target | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L233 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 233 | ||
*Signature: static public function importData($form,$source,$user,$ids) | *Signature: static public function importData($form,$source,$user,$ids) | ||
*Parameters: | *Parameters: | ||
Line 235: | Line 235: | ||
===isComponentized()=== | ===isComponentized()=== | ||
static function to determine if a form is componentized | static function to determine if a form is componentized | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L248 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 248 | ||
*Signature: static public function isComponentized($form) | *Signature: static public function isComponentized($form) | ||
*Parameters: | *Parameters: | ||
Line 242: | Line 242: | ||
===isComponentizedForm()=== | ===isComponentizedForm()=== | ||
Fuzzy method to check if a form instance is componentized | Fuzzy method to check if a form instance is componentized | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L884 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 884 | ||
*Signature: public function isComponentizedForm($formClass) | *Signature: public function isComponentizedForm($formClass) | ||
*Parameters: | *Parameters: | ||
Line 249: | Line 249: | ||
===isWritable()=== | ===isWritable()=== | ||
Check to see if this form is considered to be writable. | Check to see if this form is considered to be writable. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L1410 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 1410 | ||
*Signature: static public function isWritable($form) | *Signature: static public function isWritable($form) | ||
*Parameters: | *Parameters: | ||
Line 255: | Line 255: | ||
===listDisplayFields()=== | ===listDisplayFields()=== | ||
Lists the display values for a field | Lists the display values for a field | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L856 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 856 | ||
*Signature: static public function listDisplayFields($form,$fields,$parent,$where_data,$ordering,$limit,$mod_time) | *Signature: static public function listDisplayFields($form,$fields,$parent,$where_data,$ordering,$limit,$mod_time) | ||
*Parameters: | *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.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.types.array.php array ] $fields <br/>of string. The fields we want returned Can include the special field 'last_modified' to get the last modification time for any of the fields of that form which is returned in the format "Y-m-d H:i:s" | ||
** [http://www.php.net/manual/en/language.types.boolean.php boolean ] $parent <br/>Defaults to false. If it is scalar and non-boolean, it is consider to be the ID of the parent, and then we get all forms with parent the given id. | ** [http://www.php.net/manual/en/language.types.boolean.php boolean ] $parent <br/>Defaults to false. If it is scalar and non-boolean, it is consider to be the ID of the parent, and then we get all forms with parent the given id. | ||
***Default Value: false | ***Default Value: false | ||
Line 272: | Line 272: | ||
*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. | *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. | ||
===listFields()=== | ===listFields()=== | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L829 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 829 | ||
*Signature: static public function listFields($form,$fields,$parent,$where_data,$ordering,$limit,$mod_time) | *Signature: static public function listFields($form,$fields,$parent,$where_data,$ordering,$limit,$mod_time) | ||
*Parameters: | *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.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.types.array.php array ] $fields <br/>of string. The fields we want returned. Can include the special field 'last_modified' to get the last modification time for any of the fields of that form which is returned in the format "Y-m-d H:i:s" | ||
** [http://www.php.net/manual/en/language.types.boolean.php boolean ] $parent <br/>Defaults to false. If it is scalar and non-boolean, it is consider to be the ID of the parent, and then we get all forms with parent the given id. | ** [http://www.php.net/manual/en/language.types.boolean.php boolean ] $parent <br/>Defaults to false. If it is scalar and non-boolean, it is consider to be the ID of the parent, and then we get all forms with parent the given id. | ||
***Default Value: false | ***Default Value: false | ||
Line 290: | Line 290: | ||
===lookupDisplayField()=== | ===lookupDisplayField()=== | ||
Looks up the display value of the item based on the code. This is the default method that most implementations of lookup () use. It finds the description of the object based on the code and saves it in the cache and returns it. | Looks up the display value of the item based on the code. This is the default method that most implementations of lookup () use. It finds the description of the object based on the code and saves it in the cache and returns it. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L800 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 800 | ||
*Signature: static public function lookupDisplayField($form,$id,$fields,$delim) | *Signature: static public function lookupDisplayField($form,$id,$fields,$delim) | ||
*Parameters: | *Parameters: | ||
Line 302: | Line 302: | ||
===lookupField()=== | ===lookupField()=== | ||
Looks up the dbvalue of the item based on the code. This is the default method that most implementations of lookup () use. It finds the description of the object based on the code and saves it in the cache and returns it. | Looks up the dbvalue of the item based on the code. This is the default method that most implementations of lookup () use. It finds the description of the object based on the code and saves it in the cache and returns it. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L773 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 773 | ||
*Signature: static public function lookupField($form,$id,$fields,$delim) | *Signature: static public function lookupField($form,$id,$fields,$delim) | ||
*Parameters: | *Parameters: | ||
Line 314: | Line 314: | ||
===migrateField()=== | ===migrateField()=== | ||
Migrate field data from an old setMap reference to a new MAP form field type. The old data should have been saved in a migrate_data magic data (see storeMigrateData ). | Migrate field data from an old setMap reference to a new MAP form field type. The old data should have been saved in a migrate_data magic data (see storeMigrateData ). | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L663 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 663 | ||
*Signature: static public function migrateField($form_name,$field_list,$migrate_path,$user) | *Signature: static public function migrateField($form_name,$field_list,$migrate_path,$user) | ||
*Parameters: | *Parameters: | ||
Line 324: | Line 324: | ||
===migrateForm()=== | ===migrateForm()=== | ||
Migrate a given form from one storage method to the current storage method. This should only be used when upgrading a module that moved a form storage from one type to another. | Migrate a given form from one storage method to the current storage method. This should only be used when upgrading a module that moved a form storage from one type to another. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L500 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 500 | ||
*Signature: static public function migrateForm($form_name,$storage,$user,$migrate_path,$id_field,$skip_fields,$migrate_fields,$callback) | *Signature: static public function migrateForm($form_name,$storage,$user,$migrate_path,$id_field,$skip_fields,$migrate_fields,$callback) | ||
*Parameters: | *Parameters: | ||
Line 343: | Line 343: | ||
===moveData()=== | ===moveData()=== | ||
Move data for a form from one storage mechansim to another | Move data for a form from one storage mechansim to another | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L169 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 169 | ||
*Signature: static public function moveData($form,$source,$target,$user,$ids) | *Signature: static public function moveData($form,$source,$target,$user,$ids) | ||
*Parameters: | *Parameters: | ||
Line 355: | Line 355: | ||
===populate()=== | ===populate()=== | ||
Use method to populate a form object. | Use method to populate a form object. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L905 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 905 | ||
*Signature: public function populate($form) | *Signature: public function populate($form) | ||
*Parameters: | *Parameters: | ||
Line 362: | Line 362: | ||
===populateChild()=== | ===populateChild()=== | ||
Populate all instances of the given child form for this object. | Populate all instances of the given child form for this object. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L1084 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 1084 | ||
*Signature: public function populateChild($form,$form_name,$order_by,$where,$type) | *Signature: public function populateChild($form,$form_name,$order_by,$where,$type) | ||
*Parameters: | *Parameters: | ||
Line 375: | Line 375: | ||
===populateChildren()=== | ===populateChildren()=== | ||
Populate the given child form for this object. | Populate the given child form for this object. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L1127 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 1127 | ||
*Signature: public function populateChildren($form,$forms,$orderBy) | *Signature: public function populateChildren($form,$forms,$orderBy) | ||
*Parameters: | *Parameters: | ||
Line 384: | Line 384: | ||
===populateFirst()=== | ===populateFirst()=== | ||
Populate the first child of a form object based on the given field | Populate the first child of a form object based on the given field | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L1001 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 1001 | ||
*Signature: public function populateFirst($form,$forms) | *Signature: public function populateFirst($form,$forms) | ||
*Parameters: | *Parameters: | ||
Line 392: | Line 392: | ||
===populateHistory()=== | ===populateHistory()=== | ||
Populate Last of a form object. | Populate Last of a form object. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L940 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 940 | ||
*Signature: public function populateHistory($form) | *Signature: public function populateHistory($form) | ||
*Parameters: | *Parameters: | ||
Line 398: | Line 398: | ||
===populateLast()=== | ===populateLast()=== | ||
Populate the last child of a form object based on the given field | Populate the last child of a form object based on the given field | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L954 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 954 | ||
*Signature: public function populateLast($form,$forms) | *Signature: public function populateLast($form,$forms) | ||
*Parameters: | *Parameters: | ||
Line 406: | Line 406: | ||
===save()=== | ===save()=== | ||
User method to save a form object. | User method to save a form object. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L1182 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 1182 | ||
*Signature: public function save($form,$user,$transact) | *Signature: public function save($form,$user,$transact) | ||
*Parameters: | *Parameters: | ||
Line 415: | Line 415: | ||
*Returns: boolean.<br/>true on success | *Returns: boolean.<br/>true on success | ||
===search()=== | ===search()=== | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L732 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 732 | ||
*Signature: static public function search($form,$parent,$where_data,$ordering,$limit) | *Signature: static public function search($form,$parent,$where_data,$ordering,$limit) | ||
*Parameters: | *Parameters: | ||
Line 430: | Line 430: | ||
===setChangeType()=== | ===setChangeType()=== | ||
Set the change type for the given form. If this method isn't called then the change type will be I2CE_FormStorage::CHANGE_UPDATE | Set the change type for the given form. If this method isn't called then the change type will be I2CE_FormStorage::CHANGE_UPDATE | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L1160 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 1160 | ||
*Signature: public function setChangeType($form,$change_type,$field) | *Signature: public function setChangeType($form,$change_type,$field) | ||
*Parameters: | *Parameters: | ||
Line 440: | Line 440: | ||
===setLastListCount()=== | ===setLastListCount()=== | ||
Add the last results from a search query for a form. | Add the last results from a search query for a form. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L1441 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 1441 | ||
*Signature: static public function setLastListCount($form,$count) | *Signature: static public function setLastListCount($form,$count) | ||
*Parameters: | *Parameters: | ||
Line 447: | Line 447: | ||
===storeMigrateData()=== | ===storeMigrateData()=== | ||
Save the given fields to the given magic data node so it can later be referenced when migrating the form. | Save the given fields to the given magic data node so it can later be referenced when migrating the form. | ||
*Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php# | *Defined in [http://bazaar.launchpad.net/~intrahealth+informatics/i2ce/4.0-dev/annotate/head:/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php#L367 i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php] on line 367 | ||
*Signature: static public function storeMigrateData($forms,$migrate_path) | *Signature: static public function storeMigrateData($forms,$migrate_path) | ||
*Parameters: | *Parameters: |
Revision as of 07:56, 3 August 2010
This article describes the class I2CE_FormStorage .
- Extends the class: I2CE_Module.
- Location: Part of the module forms-storage in the package I2CE 4.0-dev
- Source: Defined in the file modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 38
- Author: Carl Leitner <litlfred@ibiblio.org>
- Since: 3.2
I2CE_Module_FormStorage
Variables
$lastListCount
A list of forms with the last count returned for listDisplayFields
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 43
- Type: static protected array $lastListCount
$componentized_forms
A cached list of componentized forms. array of string, the form names
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 265
- Type: static protected static $componentized_forms
$storage
An array with a cache of the storage type for a form.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 291
- Type: static protected array $storage
$storageMechs
An array with a cache of the storage mechanisms
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 323
- Type: static protected array $storageMechs
Methods
FF_IG_save()
Save the FormField to the database.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 1284
- Signature: public function FF_IG_save($form_field,$do_check,$user)
- Parameters:
- $form_field
- boolean $do_check
A flag to determine if a check should be made for the same value being saved. @param I2CE_User I2CE_User The user saving this data. - $user
- Returns: boolean
FF_IG_setSequence()
Set the value of this field to the next sequence for the form field.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 1342
- Signature: public function FF_IG_setSequence($form_field)
- Parameters:
- I2CE_FormField_INT_GENERATE $form_field
FF_SP_save()
Save the FormField_STRING_PASS to the database.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 1313
- Signature: public function FF_SP_save($form_field,$do_check,$user)
- Parameters:
- I2CE_FormField_STRING_PASS $form_field
- boolean $do_check
A flag to determine if a check should be made for the same value being saved. @param I2CE_User I2CE_User The user saving this data. - $user
- Returns: boolean
FF_populateHistory()
Populate the history of entries for the form field if the storage module handles history.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 1362
- Signature: public function FF_populateHistory($form_field)
- Parameters:
- I2CE_FormField $form_field
- Returns: boolean
FF_save()
Save the FormField to the database.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 1260
- Signature: public function FF_save($form_field,$do_check,$user)
- Parameters:
- I2CE_FormField $form_field
- boolean $do_check
A flag to determine if a check should be made for the same value being saved. @param I2CE_User I2CE_User The user saving this data. - $user
- Returns: boolean
_populate()
Internal worker method to populate a form object.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 916
- Signature: public function _populate($form,$storageMechanism)
- Parameters:
- I2CE_Form $form
- I2CE_FormStorage_Mechanism $storageMechanism
Default to null which indicates we should use the registered form storage mecahnsim.- Default Value: null
- Returns: boolean
_save()
Internal worker method to save a form object.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 1195
- Signature: protected function _save($form,$user,$transact,$storageMechanism)
- Parameters:
- I2CE_Form $form
- I2CE_User $user
- boolean $transact
Defaults to true.- Default Value: true
- I2CE_FormStorage_Mechanism $storageMechanism
Default to null which indicates we should use the registered form storage mecahnsim.- Default Value: null
- Returns: boolean.
true on success
addChild()
add the given child to the form for this object.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 1061
- Signature: public function addChild($form,$form_name,$id)
- Parameters:
delete()
Delete a form object.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 1225
- Signature: public function delete($form,$transact,$complete,$no_history)
- Parameters:
- I2CE_Form $form
- boolean $transact
a flag to use transactions or not. default: true- Default Value: true
- boolean $complete
a flag to determine if a complete delete should happen. default: false- Default Value: false
- boolean $no_history
a flag to determine if the record should not go to the deleted_records table. default: false- Default Value: false
- Returns: boolean
exportData()
Move data for a form from one storage mechansim to another
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 218
- Signature: static public function exportData($form,$target,$user,$ids)
- Parameters:
- Returns: boolean.
true on success
getChildIds()
Gets the id's for the given child for this form.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 1042
- Signature: public function getChildIds($form,$child_form_name,$order_by,$where,$limit)
- Parameters:
- I2CE_Form $form
- string $child_form_name
the child form name - mixed $order_by
A string or array of strings. The fields to oreder by . defaults to empty array.- Default Value: array()
- $where
- Default Value: array()
- 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.- Default Value: false
- Returns: array
getComponentizedForms()
static function which gets a list of all componentized forms
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 271
- Signature: static public function getComponentizedForms($use_cache)
- Parameters:
- boolean $use_cache
Use the cached value of the list for componentized forms if possible. Defualts to true- Default Value: true
- boolean $use_cache
- Returns: array
of string, the componentized forms
getHooks()
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 81
- Signature: static public function getHooks()
getLastListCount()
Return the last results from a search query for a form.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 1453
- Signature: static public function getLastListCount($form)
- Parameters:
- string $form
The form name
- string $form
- Returns: integer
getMechanismByStorage()
Returns the storage mechanism for the given storage type.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 344
- Signature: static public function getMechanismByStorage($storage)
- Parameters:
- string $storage
- Returns: I2CE_FormStorage_Mechanism
or false on failure
getMethods()
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 47
- Signature: static public function getMethods()
getMigratedValue()
Get the new value for a field that has been migrated.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 462
- Signature: static public function getMigratedValue($migrate_node,$form,$old_id,$field,$map_form)
- Parameters:
- I2CE_MagicDataNode $migrate_node
- string $form
- mixed $old_id
- string $field
- mixed $map_form
- Returns: string
getNewMigratedValue()
Get the new migrated value for from the old value. @param mixed $old_id
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 439
- Signature: static public function getNewMigratedValue($migrate_node,$map_form,$old_value,$old_amt)
- Parameters:
- I2CE_MagicDataNode $migrate_node
- string $map_form
- $old_value
- integer $old_amt
For currency data this is the amount- Default Value: 0
- Returns: mixed
getOldMigratedValue()
Get the old value for a field that has been migrated.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 388
- Signature: static public function getOldMigratedValue($migrate_node,$form,$old_id,$field,$map_form)
- Parameters:
- I2CE_MagicDataNode $migrate_node
- string $form
- mixed $old_id
- string $field
- mixed $map_form
- Returns: array
array( 'map_form', 'old_value' );
getRecords()
Return an array of all the record ids for a given form.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 1387
- Signature: public function getRecords($factory,$form_name)
- Parameters:
- I2CE_FormFactory $factory
- $form_name
- Returns: array
getStorage()
Return the storage class for the given form.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 301
- Signature: static public function getStorage($form_name,$no_cache)
- Parameters:
- Returns: string
getStorageMechanism()
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 331
- Signature: static public function getStorageMechanism($form_name,$no_cache)
- Parameters:
- Returns: I2CE_FormStorage_Mechanism
or false on failure
importData()
Move data for a form from one storage mechansim to another @param I2CE_FormStorage_Mechansim $target
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 233
- Signature: static public function importData($form,$source,$user,$ids)
- Parameters:
- Returns: boolean.
true on success
isComponentized()
static function to determine if a form is componentized
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 248
- Signature: static public function isComponentized($form)
- Parameters:
- string $form
- Returns: boolean
isComponentizedForm()
Fuzzy method to check if a form instance is componentized
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 884
- Signature: public function isComponentizedForm($formClass)
- Parameters:
- I2CE_Form $formClass
- Returns: boolean
isWritable()
Check to see if this form is considered to be writable.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 1410
- Signature: static public function isWritable($form)
- Parameters:
- mixed $form
string, I2CE_Form or I2CE_FormField
- mixed $form
listDisplayFields()
Lists the display values for a field
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 856
- Signature: static public function listDisplayFields($form,$fields,$parent,$where_data,$ordering,$limit,$mod_time)
- Parameters:
- string $form
The form name - array $fields
of string. The fields we want returned Can include the special field 'last_modified' to get the last modification time for any of the fields of that form which is returned in the format "Y-m-d H:i:s" - boolean $parent
Defaults to false. If it is scalar and non-boolean, it is consider to be the ID of the parent, and then we get all forms with parent the given id.- Default Value: false
- mixed $where_data
Either I2CE_MagicDataNode or array. contains the where clause information about this form or a nested- Default Value: array()
- array $ordering
An array of fields to order by. Defaults to the empty array. Prepend a - to order by in descending order.- Default Value: array()
- 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.- Default Value: false
- integer $mod_time
Defaults to -1. If non-negative, we only list the requested fields for an id if at least one of them has a modification time greater than or equal to $mod_time. If the form storage has no way of tracking modifucation time, all entries are listed.- Default Value: -1
- string $form
- Returns: mixed
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.
listFields()
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 829
- Signature: static public function listFields($form,$fields,$parent,$where_data,$ordering,$limit,$mod_time)
- Parameters:
- string $form
The form name - array $fields
of string. The fields we want returned. Can include the special field 'last_modified' to get the last modification time for any of the fields of that form which is returned in the format "Y-m-d H:i:s" - boolean $parent
Defaults to false. If it is scalar and non-boolean, it is consider to be the ID of the parent, and then we get all forms with parent the given id.- Default Value: false
- mixed $where_data
Either I2CE_MagicDataNode or array. contains the where clause information about this form or a nested- Default Value: array()
- array $ordering
An array of fields to order by. Defaults to the empty array. Prepend a - to order by in descending order.- Default Value: array()
- 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.- Default Value: false
- integer $mod_time
Defaults to -1. If non-negative, we only list the requested fields for an id if at least one of them has a modification time greater than or equal to $mod_time. If the form storage has no way of tracking modifucation time, all entries are listed.- Default Value: -1
- string $form
- Returns: mixed
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.
lookupDisplayField()
Looks up the display value of the item based on the code. This is the default method that most implementations of lookup () use. It finds the description of the object based on the code and saves it in the cache and returns it.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 800
- Signature: static public function lookupDisplayField($form,$id,$fields,$delim)
- Parameters:
- string $form
The name of the form in the database. - integer $id
The code of the entry to lookup. - mixed $fields
A field or an array of fields to look up and return. Defaults to 'name'- Default Value: array('name')
- string $delim
The delimiter to put between returned fields if there are more than one. If false , then we return as an array. Defaults to '-'- Default Value: '-'
- string $form
- Returns: string
or false on failure
lookupField()
Looks up the dbvalue of the item based on the code. This is the default method that most implementations of lookup () use. It finds the description of the object based on the code and saves it in the cache and returns it.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 773
- Signature: static public function lookupField($form,$id,$fields,$delim)
- Parameters:
- string $form
The name of the form in the database. - integer $id
The code of the entry to lookup. - mixed $fields
A field or an array of fields to look up and return. Defaults to 'name'- Default Value: array('name')
- string $delim
The delimiter to put between returned fields if there are more than one. If false , then we return as an array. Defaults to '-'- Default Value: '-'
- string $form
- Returns: string
or false on failure
migrateField()
Migrate field data from an old setMap reference to a new MAP form field type. The old data should have been saved in a migrate_data magic data (see storeMigrateData ).
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 663
- Signature: static public function migrateField($form_name,$field_list,$migrate_path,$user)
- Parameters:
- string $form_name
- array $field_list
The list of fields that need to be changed as an array of field => map_form. Optionally the field list can be: array( "field" => array( "prev_field" => "prev_map_form" ) ) The field will get the old value from the list of fields (with mapped forms) for when the field name was changed. - string $migrate_path
Where the migrate data has been saved. - I2CE_User $user
The user to save the new form field.
- Returns: boolean
migrateForm()
Migrate a given form from one storage method to the current storage method. This should only be used when upgrading a module that moved a form storage from one type to another.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 500
- Signature: static public function migrateForm($form_name,$storage,$user,$migrate_path,$id_field,$skip_fields,$migrate_fields,$callback)
- Parameters:
- string $form_name
- string $storage
The old storage mechanism - I2CE_User $user
The user object to use to save the new forms. - string $migrate_path
The full path in MagicData to save the old to new mappings.- Default Value: false
- string $id_field
The old field name to use the value of for the new form id.- Default Value: false
- array $skip_fields
A list of fields to not migrate to the new form.- Default Value: array()
- array $migrate_fields
A list of fields that have already been migrated and need to use the migrate path to convert the data. Format is array( "field" => "map_form" ) These forms and fields should have already been passed to storeMigrateData so the data can be retrieved from there.- Default Value: array()
- $callback
- Default Value: null
- Returns: boolean
moveData()
Move data for a form from one storage mechansim to another
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 169
- Signature: static public function moveData($form,$source,$target,$user,$ids)
- Parameters:
- string $form
The form - I2CE_FormStorage_Mechansim $source
- I2CE_FormStorage_Mechansim $target
- I2CE_User $user
The user object used to save the data to the target storage mechanism - mixed $ids
An id or an array of the ids we wish to move. Defaults to null, in which case all id's are moved- Default Value: null
- string $form
- Returns: boolean.
true on success
populate()
Use method to populate a form object.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 905
- Signature: public function populate($form)
- Parameters:
- I2CE_Form $form
- Returns: boolean
populateChild()
Populate all instances of the given child form for this object.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 1084
- Signature: public function populateChild($form,$form_name,$order_by,$where,$type)
- Parameters:
- I2CE_Form $form
- string $form_name
The form name to populate - mixed $order_by
A field or array of fields to sort by. Preceded by "-" to sort in reverse order. - array( "-start_date", "name" ). Defaults to null in which case if get the default sort order that is registered for the type (which defaults to none) @param mixed @where an aarray of where information to limit getting the child id's by. If null, we get the default limits for the type (which defaults to none)- Default Value: null
- $where
- Default Value: null
- string $type
Defaults to 'default'- Default Value: 'default'
populateChildren()
Populate the given child form for this object.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 1127
- Signature: public function populateChildren($form,$forms,$orderBy)
- Parameters:
- I2CE_Form $form
- mixed $forms
A string or an array such, the form names (the child forms to populate) - array( "demographic", "contact" ) - array $orderBy
An associative array of form names with an array of either string, field to sort by or an array of the fields Defaults to empty array - array( "contact" => "contact_type" )- Default Value: array()
populateFirst()
Populate the first child of a form object based on the given field
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 1001
- Signature: public function populateFirst($form,$forms)
- Parameters:
populateHistory()
Populate Last of a form object.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 940
- Signature: public function populateHistory($form)
- Parameters:
- I2CE_Form $form
populateLast()
Populate the last child of a form object based on the given field
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 954
- Signature: public function populateLast($form,$forms)
- Parameters:
save()
User method to save a form object.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 1182
- Signature: public function save($form,$user,$transact)
- Parameters:
- Returns: boolean.
true on success
search()
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 732
- Signature: static public function search($form,$parent,$where_data,$ordering,$limit)
- Parameters:
- string $form
The form name. - boolean $parent
Defaults to false. If it is scalar and non-boolean, it is consider to be the ID of the parent, and then we get all forms with parent the given id.- Default Value: false
- mixed $where_data
array or class implementing ArrayAccess, Iterator, and Countable (e.g. MagicDataNode) . the where data.- Default Value: array()
- mixed $ordering
An field or an array of fields to order by. Defaults to the empty array. Prepend a - to order by in descending order.- Default Value: array()
- 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.- Default Value: false
- string $form
- Returns: mixed
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.
setChangeType()
Set the change type for the given form. If this method isn't called then the change type will be I2CE_FormStorage::CHANGE_UPDATE
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 1160
- Signature: public function setChangeType($form,$change_type,$field)
- Parameters:
setLastListCount()
Add the last results from a search query for a form.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 1441
- Signature: static public function setLastListCount($form,$count)
- Parameters:
- string $form
The form name - integer $count
The number of results.
- string $form
storeMigrateData()
Save the given fields to the given magic data node so it can later be referenced when migrating the form.
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 367
- Signature: static public function storeMigrateData($forms,$migrate_path)
- Parameters:
validate_formfield()
Hooked Function to check if a field is unique or unique restricted to a certain field
- Defined in i2ce/modules/Forms/modules/FormStorage/lib/I2CE_FormStorage.php on line 94
- Signature: public function validate_formfield($field_obj)
- Parameters:
- I2CE_FormField $field_obj
- Returns: boolean
Inherited Methods
__construct()
This public method is inherited from I2CE_Module->__construct()
action_configure()
This public method is inherited from I2CE_Module->action_configure()
action_disable()
This public method is inherited from I2CE_Module->action_disable()
action_enable()
This public method is inherited from I2CE_Module->action_enable()
action_initialize()
This public method is inherited from I2CE_Module->action_initialize()
getCLIHooks()
This public method is inherited from I2CE_Module->getCLIHooks()
getCLIMethods()
This public method is inherited from I2CE_Module->getCLIMethods()
getConfig()
This public method is inherited from I2CE_Module->getConfig()
post_update()
This public method is inherited from I2CE_Module->post_update()
pre_upgrade()
This public method is inherited from I2CE_Module->pre_upgrade()
upgrade()
This public method is inherited from I2CE_Module->upgrade()
_hasMethod()
This public method is inherited from I2CE_Fuzzy->_hasMethod()
Inherited Fuzzy Methods
launchBackgroundProcess()
This method is inherited from I2CE_Module->launchBackgroundProcess()
launchBackgroundPHPScript()
This method is inherited from I2CE_Module->launchBackgroundPHPScript()
launchBackgroundPage()
This method is inherited from I2CE_Module->launchBackgroundPage()
userMessage()
This method is inherited from I2CE_Fuzzy->userMessage()