1, 'date_modified'=>1, 'created_by'=>1, 'id'=>1, 'modified_user_id'=>1); class TemplateField{ /* The view is the context this field will be used in -edit -list -detail -search */ var $view = 'edit'; var $name = ''; var $vname = ''; var $id = ''; var $size = '20'; var $len = '255'; var $required = false; var $default = null; var $default_value = null; var $type = 'varchar'; var $comment = ''; var $bean; var $ext1 = ''; var $ext2 = ''; var $ext3 = ''; var $ext4 = ''; var $audited= 0; var $massupdate = 0; var $importable = 'true' ; var $duplicate_merge=0; var $new_field_definition; var $reportable = true; var $label_value = ''; var $help = ''; var $formula = ''; var $unified_search = 0; var $supports_unified_search = false; var $vardef_map = array( 'name'=>'name', 'label'=>'vname', // bug 15801 - need to ALWAYS keep default and default_value consistent as some methods/classes use one, some use another... 'default_value'=>'default', 'default'=>'default_value', 'display_default'=>'default_value', // 'default_value'=>'default_value', // 'default'=>'default_value', 'len'=>'len', 'required'=>'required', 'type'=>'type', 'audited'=>'audited', 'massupdate'=>'massupdate', 'options'=>'ext1', 'help'=>'help', 'comments'=>'comment', 'importable'=>'importable', 'duplicate_merge'=>'duplicate_merge', 'duplicate_merge_dom_value'=>'duplicate_merge_dom_value', //bug #14897 'merge_filter'=>'merge_filter', 'reportable' => 'reportable', 'min'=>'ext1', 'max'=>'ext2', 'ext2'=>'ext2', 'ext4'=>'ext4', //'disable_num_format'=>'ext3', 'ext3'=>'ext3', 'label_value'=>'label_value', 'unified_search'=>'unified_search', ); /* HTML FUNCTIONS */ function get_html(){ $view = $this->view; if(!empty($GLOBALS['studioReadOnlyFields'][$this->name]))$view = 'detail'; switch($view){ case 'search':return $this->get_html_search(); case 'edit': return $this->get_html_edit(); case 'list': return $this->get_html_list(); case 'detail': return $this->get_html_detail(); } } function set($values){ foreach($values as $name=>$value){ $this->$name = $value; } } function get_html_edit(){ return 'not implemented'; } function get_html_list(){ return $this->get_html_detail(); } function get_html_detail(){ return 'not implemented'; } function get_html_search(){ return $this->get_html_edit(); } function get_html_label(){ $label = "{MOD." .$this->vname . "}"; if(!empty($GLOBALS['app_strings'][$this->vname])){ $label = "{APP." .$this->label . "}"; } if($this->view == 'edit' && $this->is_required()){ $label .= '*'; } if($this->view == 'list'){ if(isset($this->bean)){ if(!empty($this->id)){ $name = $this->bean->table_name . '_cstm.'. $this->name; $arrow = $this->bean->table_name . '_cstm_'. $this->name; }else{ $name = $this->bean->table_name . '.'. $this->name; $arrow = $this->bean->table_name . '_'. $this->name; } }else{ $name = $this->name; $arrow = $name; } $label = "{MOD.$this->label}{arrow_start}{".$arrow."_arrow}{arrow_end}"; } return $label; } /* XTPL FUNCTIONS */ function get_xtpl($bean = false){ if($bean) $this->bean = $bean; $view = $this->view; if(!empty($GLOBALS['studioReadOnlyFields'][$this->name]))$view = 'detail'; switch($view){ case 'search':return $this->get_xtpl_search(); case 'edit': return $this->get_xtpl_edit(); case 'list': return $this->get_xtpl_list(); case 'detail': return $this->get_xtpl_detail(); } } function get_xtpl_edit(){ return '/*not implemented*/'; } function get_xtpl_list(){ return get_xtpl_detail(); } function get_xtpl_detail(){ return '/*not implemented*/'; } function get_xtpl_search(){ //return get_xtpl_edit(); } function is_required(){ if($this->required){ return true; } return false; } /* DB FUNCTIONS */ function get_db_type(){ if(!empty($this->type)) { $type = $GLOBALS['db']->getColumnType($this->type); } if(!empty($type)) return " $type"; $type = $GLOBALS['db']->getColumnType("varchar"); return " $type({$this->len})"; } function get_db_default($modify=false){ $GLOBALS['log']->debug('get_db_default(): default_value='.$this->default_value); if (!$modify or empty($this->new_field_definition['default_value']) or $this->new_field_definition['default_value'] != $this->default_value ) { if(!is_null($this->default_value)){ // add a default value if it is not null - we want to set a default even if default_value is '0', which is not null, but which is empty() if(NULL == trim($this->default_value)){ return " DEFAULT NULL"; } else { return " DEFAULT '$this->default_value'"; } }else{ return ''; } } } /* * Return the required clause for this field * Confusingly, when modifying an existing field ($modify=true) there are two exactly opposite cases: * 1. if called by Studio, only $this->required is set. If set, we return "NOT NULL" otherwise we return "NULL" * 2. if not called by Studio, $this->required holds the OLD value of required, and new_field_definition['required'] is the NEW * So if not called by Studio we want to return NULL if required=true (because we are changing FROM this setting) */ function get_db_required($modify=false){ // $GLOBALS['log']->debug('get_db_required required='.$this->required." and ".(($modify)?"true":"false")." and ".print_r($this->new_field_definition,true)); $req = ""; if ($modify) { if (!empty($this->new_field_definition['required'])) { if ($this->required and $this->new_field_definition['required'] != $this->required) { $req = " NULL "; } } else { $req = ($this->required) ? " NOT NULL " : ''; // bug 17184 tyoung - set required correctly when modifying custom field in Studio } } else { if (empty($this->new_field_definition['required']) or $this->new_field_definition['required'] != $this->required ) { if(!empty($this->required) && $this->required){ $req = " NOT NULL"; } } } return $req; } /* function get_db_required($modify=false){ $GLOBALS['log']->debug('get_db_required required='.$this->required." and ".(($modify)?"true":"false")." and ".print_r($this->new_field_definition,true)); if ($modify) { if (!empty($this->new_field_definition['required'])) { if ($this->required and $this->new_field_definition['required'] != $this->required) { return " null "; } return ""; } } if (empty($this->new_field_definition['required']) or $this->new_field_definition['required'] != $this->required ) { if(!empty($this->required) && $this->required){ return " NOT NULL"; } } return ''; } */ /** * Oracle Support: do not set required constraint if no default value is supplied. * In this case the default value will be handled by the application/sugarbean. */ function get_db_add_alter_table($table) { return $GLOBALS['db']->getHelper()->addColumnSQL($table, $this->get_field_def(), true); } function get_db_delete_alter_table($table) { return $GLOBALS['db']->getHelper()->dropColumnSQL( $table, $this->get_field_def() ); } /** * mysql requires the datatype caluse in the alter statment.it will be no-op anyway. */ function get_db_modify_alter_table($table){ return $GLOBALS['db']->alterColumnSQL($table, $this->get_field_def()); } /* * BEAN FUNCTIONS * */ function get_field_def(){ $array = array( 'required'=>$this->convertBooleanValue($this->required), 'source'=>'custom_fields', 'name'=>$this->name, 'vname'=>$this->vname, 'type'=>$this->type, 'massupdate'=>$this->massupdate, 'default'=>$this->default, 'comments'=> (isset($this->comments)) ? $this->comments : '', 'help'=> (isset($this->help)) ? $this->help : '', 'importable'=>$this->importable, 'duplicate_merge'=>$this->duplicate_merge, 'duplicate_merge_dom_value'=> isset($this->duplicate_merge_dom_value) ? $this->duplicate_merge_dom_value : $this->duplicate_merge, 'audited'=>$this->convertBooleanValue($this->audited), 'reportable'=>$this->convertBooleanValue($this->reportable), 'unified_search'=>$this->convertBooleanValue($this->unified_search) ); if(!empty($this->len)){ $array['len'] = $this->len; } if(!empty($this->size)){ $array['size'] = $this->size; } $this->get_dup_merge_def($array); return $array; } protected function convertBooleanValue($value) { if ($value === 'true' || $value === '1' || $value === 1) return true; else if ($value === 'false' || $value === '0' || $value === 0) return false; else return $value; } /* if the field is duplicate merge enabled this function will return the vardef entry for the same. */ function get_dup_merge_def(&$def) { switch ($def['duplicate_merge_dom_value']) { case 0: $def['duplicate_merge']='disabled'; break; case 1: $def['duplicate_merge']='enabled'; break; case 2: $def['merge_filter']='enabled'; $def['duplicate_merge']='enabled'; break; case 3: $def['merge_filter']='selected'; $def['duplicate_merge']='enabled'; break; case 4: $def['merge_filter']='enabled'; $def['duplicate_merge']='disabled'; break; } } /* HELPER FUNCTIONS */ function prepare(){ if(empty($this->id)){ $this->id = $this->name; } } /** * populateFromRow * This function supports setting the values of all TemplateField instances. * @param $row The Array key/value pairs from fields_meta_data table */ function populateFromRow($row=array()) { $fmd_to_dyn_map = array('comments' => 'comment', 'require_option' => 'required', 'label' => 'vname', 'mass_update' => 'massupdate', 'max_size' => 'len', 'default_value' => 'default', 'id_name' => 'ext3'); if(!is_array($row)) { $GLOBALS['log']->error("Error: TemplateField->populateFromRow expecting Array"); } //Bug 24189: Copy fields from FMD format to Field objects foreach ($fmd_to_dyn_map as $fmd_key => $dyn_key) { if (isset($row[$fmd_key])) { $this->$dyn_key = $row[$fmd_key]; } } foreach($row as $key=>$value) { $this->$key = $value; } } function populateFromPost(){ foreach($this->vardef_map as $vardef=>$field){ if(isset($_REQUEST[$vardef])){ $this->$vardef = $_REQUEST[$vardef]; if($vardef != $field){ $this->$field = $this->$vardef; } } } $this->applyVardefRules(); $GLOBALS['log']->debug('populate: '.print_r($this,true)); } protected function applyVardefRules() { } function get_additional_defs(){ return array(); } function delete($df){ $df->deleteField($this); } /** * get_field_name * * This is a helper function to return a field's proper name. It checks to see if an instance of the module can * be created and then attempts to retrieve the field's name based on the name lookup skey supplied to the method. * * @param String $module The name of the module * @param String $name The field name key * @return The field name for the module */ protected function get_field_name($module, $name) { $bean = loadBean($module); if(empty($bean) || is_null($bean)) { return $name; } $field_defs = $bean->field_defs; return isset($field_defs[$name]['name']) ? $field_defs[$name]['name'] : $name; } /** * save * * This function says the field template by calling the DynamicField addFieldObject function. It then * checks to see if updates are needed for the SearchFields.php file. In the event that the unified_search * member variable is set to true, a search field definition is updated/created to the SearchFields.php file. * * @param $df Instance of DynamicField */ function save($df){ // $GLOBALS['log']->debug('saving field: '.print_r($this,true)); $df->addFieldObject($this); require_once('modules/ModuleBuilder/parsers/parser.searchfields.php'); $searchFieldParser = new ParserSearchFields( $df->getModuleName() , $df->getPackageName() ) ; //If unified_search is enabled for this field, then create the SearchFields entry $fieldName = $this->get_field_name($df->getModuleName(), $this->name); if($this->unified_search && !isset($searchFieldParser->searchFields[$df->getModuleName()][$fieldName])) { $searchFieldParser->addSearchField($fieldName, array('query_type'=>'default')); $searchFieldParser->saveSearchFields($searchFieldParser->searchFields); } } } ?>