modules/Versions/Version.php

Show: inherited
Table of Contents

\Version

Package:

SugarBean is the base class for all business objects in Sugar. It implements the primary functionality needed for manipulating business objects: create, retrieve, update, delete. It allows for searching and retrieving list of records.

It allows for retrieving related objects (e.g. contacts related to a specific account).

In the current implementation, there can only be one bean per folder. Naming convention has the bean name be the same as the module and folder name. All bean names should be singular (e.g. Contact). The primary table name for a bean should be plural (e.g. contacts).

Parent(s)
\SugarBean

Properties

Propertypublic  $acltype= ''module''
inheritedInherited from: \SugarBean::$$acltype
Default value'module'Details
Type
n/a
Inherited_from
\SugarBean::$$acltype  
Propertypublic  $additional_column_fields= 'Array()'
Default valueArray()Details
Type
n/a
Propertypublic  $additional_meta_fields= 'array()'
inheritedInherited from: \SugarBean::$$additional_meta_fields
Default valuearray()Details
Type
n/a
Inherited_from
\SugarBean::$$additional_meta_fields  
Propertypublic  $column_fields= 'array()'
inheritedInherited from: \SugarBean::$$column_fields
Default valuearray()Details
Type
n/a
Inherited_from
\SugarBean::$$column_fields  
Propertypublic  $created_by= ''
Details
Type
n/a
Propertypublic  $created_by_name= ''
Details
Type
n/a
Propertypublic  $current_notify_user= ''
inheritedInherited from: \SugarBean::$$current_notify_user
Details
Type
n/a
Inherited_from
\SugarBean::$$current_notify_user  
Propertypublic  $custom_fields= ''
inheritedInherited from: \SugarBean::$$custom_fields
Details
Type
n/a
Inherited_from
\SugarBean::$$custom_fields  
Propertypublic  $date_entered= ''
Details
Type
n/a
Propertypublic  $date_modified= ''
Details
Type
n/a
Propertypublic\DBManager  $db= ''
inherited

A pointer to the database object

Inherited from: \SugarBean::$$db
Details
Type
\DBManager
Inherited_from
\SugarBean::$$db  
Propertypublic  $db_version= ''
Details
Type
n/a
PropertypublicBOOL  $deleted= ''

true if this bean has been deleted, false otherwise.

Details
Type
BOOL
Propertypublic  $disable_custom_fields= 'false'
inheritedInherited from: \SugarBean::$$disable_custom_fields
Default valuefalseDetails
Type
n/a
Inherited_from
\SugarBean::$$disable_custom_fields  
PropertypublicBOOL  $disable_vardefs= 'false'
inherited

Disble vardefs. This should be set to true only for beans that do not have varders. Tracker is an example

-- default falseInherited from: \SugarBean::$$disable_vardefs
Default valuefalseDetails
Type
BOOL
Inherited_from
\SugarBean::$$disable_vardefs  
PropertypublicBOOL  $duplicates_found= 'false'
inherited

When running a query on related items using the method: retrieve_by_string_fields this value will be set to true if more than one item matches the search criteria.

Inherited from: \SugarBean::$$duplicates_found
Default valuefalseDetails
Type
BOOL
Inherited_from
\SugarBean::$$duplicates_found  
Propertypublic  $fetched_row= 'false'
inheritedInherited from: \SugarBean::$$fetched_row
Default valuefalseDetails
Type
n/a
Inherited_from
\SugarBean::$$fetched_row  
Propertypublic  $field_defs= ''
inheritedInherited from: \SugarBean::$$field_defs
Details
Type
n/a
Inherited_from
\SugarBean::$$field_defs  
Propertypublic  $field_name_map= ''
Details
Type
n/a
Propertypublic  $file_version= ''
Details
Type
n/a
Propertypublic  $force_load_details= 'false'
inheritedInherited from: \SugarBean::$$force_load_details
Default valuefalseDetails
Type
n/a
Inherited_from
\SugarBean::$$force_load_details  
Propertypublic  $id= ''
Details
Type
n/a
Propertypublic  $importable= 'false'
inherited

Set to true in the child beans if the module supports importing

Inherited from: \SugarBean::$$importable
Default valuefalseDetails
Type
n/a
Inherited_from
\SugarBean::$$importable  
Propertypublic  $in_import= 'false'
inherited

Set to true in <modules>/Import/views/view.step4.php if a module is being imported

Inherited from: \SugarBean::$$in_import
Default valuefalseDetails
Type
n/a
Inherited_from
\SugarBean::$$in_import  
Propertypublic  $in_workflow= 'false'
inherited

Set to true if the bean is being dealt with in a workflow

Inherited from: \SugarBean::$$in_workflow
Default valuefalseDetails
Type
n/a
Inherited_from
\SugarBean::$$in_workflow  
Propertypublic  $layout_def= ''
inheritedInherited from: \SugarBean::$$layout_def
Details
Type
n/a
Inherited_from
\SugarBean::$$layout_def  
Propertypublic  $list_fields= 'array()'
inheritedInherited from: \SugarBean::$$list_fields
Default valuearray()Details
Type
n/a
Inherited_from
\SugarBean::$$list_fields  
Propertypublic  $listview_inner_join= 'array()'
inherited

Used to pass inner join string to ListView Data.

Inherited from: \SugarBean::$$listview_inner_join
Default valuearray()Details
Type
n/a
Inherited_from
\SugarBean::$$listview_inner_join  
Propertyprotectedarray  $loaded_relationships= 'array()'
inherited

A way to keep track of the loaded relationships so when we clone the object we can unset them.

Inherited from: \SugarBean::$$loaded_relationships
Default valuearray()Details
Type
array
Inherited_from
\SugarBean::$$loaded_relationships  
Propertyprotectedint  $max_logic_depth= '10'
inherited

How deep logic hooks can go

Inherited from: \SugarBean::$$max_logic_depth
Default value10Details
Type
int
Inherited_from
\SugarBean::$$max_logic_depth  
Propertypublic  $modified_by_name= ''
Details
Type
n/a
Propertypublic  $modified_user_id= ''
Details
Type
n/a
PropertypublicString  $module_dir= ''Versions''

The name of the module folder for this type of bean.

Default value'Versions'Details
Type
String
Propertypublic  $module_name= ''''
inheritedInherited from: \SugarBean::$$module_name
Default value''Details
Type
n/a
Inherited_from
\SugarBean::$$module_name  
Propertypublic  $name= ''
Details
Type
n/a
PropertypublicString  $new_assigned_user_name= ''
inherited

holds the full name of the user that an item is assigned to. Only used if notifications are turned on and going to be sent out.

Inherited from: \SugarBean::$$new_assigned_user_name
Details
Type
String
Inherited_from
\SugarBean::$$new_assigned_user_name  
Propertypublic  $new_schema= 'true'
Default valuetrueDetails
Type
n/a
PropertypublicBOOL  $new_with_id= 'false'
inherited

When createing a bean, you can specify a value in the id column as long as that value is unique. During save, if the system finds an id, it assumes it is an update. Setting new_with_id to true will make sure the system performs an insert instead of an update.

-- default falseInherited from: \SugarBean::$$new_with_id
Default valuefalseDetails
Type
BOOL
Inherited_from
\SugarBean::$$new_with_id  
Propertypublic  $number_formatting_done= 'false'
inheritedInherited from: \SugarBean::$$number_formatting_done
Default valuefalseDetails
Type
n/a
Inherited_from
\SugarBean::$$number_formatting_done  
PropertypublicString  $object_name= '"Version"'

This is the singular name of the bean. (i.e. Contact).

Default value"Version"Details
Type
String
Propertypublic  $optimistic_lock= 'false'
inheritedInherited from: \SugarBean::$$optimistic_lock
Default valuefalseDetails
Type
n/a
Inherited_from
\SugarBean::$$optimistic_lock  
Propertypublic  $process_field_encrypted= 'false'
inheritedInherited from: \SugarBean::$$process_field_encrypted
Default valuefalseDetails
Type
n/a
Inherited_from
\SugarBean::$$process_field_encrypted  
PropertypublicBOOL  $process_save_dates= 'true'
inherited

Whether to process date/time fields for storage in the database in GMT

Inherited from: \SugarBean::$$process_save_dates
Default valuetrueDetails
Type
BOOL
Inherited_from
\SugarBean::$$process_save_dates  
PropertypublicArray  $processed_dates_times= 'array()'
inherited

An array of booleans. This array is cleared out when data is loaded.

of booleansInherited from: \SugarBean::$$processed_dates_times

As date/times are converted, a "1" is placed under the key, the field is converted.

Default valuearray()Details
Type
Array
Inherited_from
\SugarBean::$$processed_dates_times  
Propertypublic  $relationship_fields= 'array()'
inheritedInherited from: \SugarBean::$$relationship_fields
Default valuearray()Details
Type
n/a
Inherited_from
\SugarBean::$$relationship_fields  
PropertypublicBOOL  $save_from_post= 'true'
inherited

This signals to the bean that it is being saved in a mass mode.

Inherited from: \SugarBean::$$save_from_post

Examples of this kind of save are import and mass update. We turn off notificaitons of this is the case to make things more efficient.

Default valuetrueDetails
Type
BOOL
Inherited_from
\SugarBean::$$save_from_post  
Propertypublic\unknown_type  $set_created_by= 'true'
inherited

This allows for seed data to be created without using the current uesr to set the id.

Inherited from: \SugarBean::$$set_created_by

This should be replaced by altering the current user before the call to save.

Default valuetrueDetails
Type
\unknown_type
Inherited_from
\SugarBean::$$set_created_by  
Propertypublic  $special_notification= 'false'
inherited

Set to true in the child beans if the module use the special notification template

Inherited from: \SugarBean::$$special_notification
Default valuefalseDetails
Type
n/a
Inherited_from
\SugarBean::$$special_notification  
PropertypublicString  $table_name= ''versions''

The database table where records of this Bean are stored.

Default value'versions'Details
Type
String
Propertypublic  $team_set_id= ''
inheritedInherited from: \SugarBean::$$team_set_id
Details
Type
n/a
Inherited_from
\SugarBean::$$team_set_id  
Propertypublic  $tracker_visibility= 'true'
inherited

By default it will be true but if any module is to be kept non visible to tracker, then its value needs to be overriden in that particular module to false.

Inherited from: \SugarBean::$$tracker_visibility
Default valuetrueDetails
Type
n/a
Inherited_from
\SugarBean::$$tracker_visibility  
Propertypublic  $ungreedy_count= 'false'
inherited

Set this to true if you query contains a sub-select and bean is converting both select statements into count queries.

Inherited from: \SugarBean::$$ungreedy_count
Default valuefalseDetails
Type
n/a
Inherited_from
\SugarBean::$$ungreedy_count  
PropertypublicBOOL  $update_date_entered= 'false'
inherited

Setting this to true allows for updates to overwrite the date_entered

Inherited from: \SugarBean::$$update_date_entered
Default valuefalseDetails
Type
BOOL
Inherited_from
\SugarBean::$$update_date_entered  
PropertypublicBOOL  $update_date_modified= 'true'
inherited

Should the date modified column of the bean be updated during save? This is used for admin level functionality that should not be updating the date modified. This is only used by sync to allow for updates to be replicated in a way that will not cause them to be replicated back.

Inherited from: \SugarBean::$$update_date_modified
Default valuetrueDetails
Type
BOOL
Inherited_from
\SugarBean::$$update_date_modified  
PropertypublicBOOL  $update_modified_by= 'true'
inherited

Should the modified by column of the bean be updated during save? This is used for admin level functionality that should not be updating the modified by column. This is only used by sync to allow for updates to be replicated in a way that will not cause them to be replicated back.

Inherited from: \SugarBean::$$update_modified_by
Default valuetrueDetails
Type
BOOL
Inherited_from
\SugarBean::$$update_modified_by  

Methods

methodpublicACLAccess( \$view $view, \$is_owner $is_owner = 'not_set' ) : void
inherited

Check whether the user has access to a particular view for the current bean/module

Inherited from: \SugarBean::ACLAccess()
Parameters
Name Type Description
$view \$view

string required, the view to determine access for i.e. DetailView, ListView...

$is_owner \$is_owner

bool optional, this is part of the ACL check if the current user is an owner they will receive different access

methodpublicSugarBean( ) : void
inherited

Constructor for the bean, it performs following tasks:

Inherited from: \SugarBean::SugarBean()
  1. Initalized a database connections
  2. Load the vardefs for the module implemeting the class. cache the entries if needed
  3. Setup row-level security preference All implementing classes must call this constructor using the parent::SugarBean() class.
methodpublicVersion( ) : void

methodpublic__clone( ) : void
inherited

Handle the following when a SugarBean object is cloned

Inherited from: \SugarBean::__clone()

Currently all this does it unset any relationships that were created prior to cloning the object

Details
Api
 
methodprivate_checkOptimisticLocking(  $action,  $isUpdate ) : void
inherited

Moved from save() method, functionality is the same, but this is intended to handle Optimistic locking functionality.

Inherited from: \SugarBean::_checkOptimisticLocking()
Parameters
Name Type Description
$action
$isUpdate
methodpublic_get_num_rows_in_query( string $query, boolean $is_count_query = false ) : int
inherited

Returns the number of rows that the given SQL query should produce

Inherited from: \SugarBean::_get_num_rows_in_query()

Internal function, do not override.

Parameters
Name Type Description
$query string

valid select query

$is_count_query boolean

Optional, Default false, set to true if passed query is a count query.

Returns
Type Description
int count of rows found
methodprivate_loadCachedArray( \$module_dir $module_dir, \$module $module, \$key $key ) : void
inherited

This function is designed to cache references to field arrays that were previously stored in the bean files and have since been moved to separate files. Was previously in include/CacheHandler.php

Inherited from: \SugarBean::_loadCachedArray()
Parameters
Name Type Description
$module_dir \$module_dir

string the module directory

$module \$module

string the name of the module

$key \$key

string the type of field array we are referencing, i.e. list_fields, column_fields, required_fields

methodprivate_sendNotifications(  $check_notify ) : void
inherited

Send assignment notifications and invites for meetings and calls

Inherited from: \SugarBean::_sendNotifications()
Parameters
Name Type Description
$check_notify
methodpublicadd_address_streets( string $street_field ) : void
inherited

Combined the contents of street field 2 thru 4 into the main field

Inherited from: \SugarBean::add_address_streets()
Parameters
Name Type Description
$street_field string
methodpublicadd_list_count_joins( string $query, string $where ) : void
inherited

Add any required joins to the list count query. The joins are required if there is a field in the $where clause that needs to be joined.

Inherited from: \SugarBean::add_list_count_joins()
Parameters
Name Type Description
$query string
$where string

Internal Function, do Not override.

methodpublicafterImportSave( ) : void
inherited

Called during the import process after a bean save, to handle any needed post-save logic when importing a record

Inherited from: \SugarBean::afterImportSave()
methodpublicassign_display_fields(  $currentModule ) : void
inherited

Inherited from: \SugarBean::assign_display_fields()
Parameters
Name Type Description
$currentModule
methodpublicbean_implements(  $interface ) : void
inherited

Inherited from: \SugarBean::bean_implements()
Parameters
Name Type Description
$interface
methodpublicbeforeImportSave( ) : void
inherited

Called during the import process before a bean save, to handle any needed pre-save logic when importing a record

Inherited from: \SugarBean::beforeImportSave()
methodpublicbuild_generic_where_clause(  $the_query_string ) : void

builds a generic search based on the query string using or do not include any $this-> because this is called on without having the class instantiated

Parameters
Name Type Description
$the_query_string
methodpublicbuild_related_in( string $query ) : void
inherited

Constructs an comma separated list of ids from passed query results.

Inherited from: \SugarBean::build_related_in()
Parameters
Name Type Description
$query string

@query query to be executed.

methodpublicbuild_related_list( string $query, object $template, int $row_offset = 0, int $limit = -1 ) : array
inherited

This function is used to execute the query and create an array template objects from the resulting ids from the query.

Inherited from: \SugarBean::build_related_list()

It is currently used for building sub-panel arrays.

Parameters
Name Type Description
$query string
  • the query that should be executed to build the list
$template object
  • The object that should be used to copy the records.
$row_offset int

Optional, default 0

$limit int

Optional, default -1

Returns
Type Description
array
methodpublicbuild_related_list2( string $query, object $template, array $field_list ) : array
inherited

Optionally copies values from fetched row into the bean.

Inherited from: \SugarBean::build_related_list2()

Internal function, do not override.

Parameters
Name Type Description
$query string
  • the query that should be executed to build the list
$template object
  • The object that should be used to copy the records
$field_list array

List of fields.

Returns
Type Description
array
methodpublicbuild_related_list_where( string $query, object $template,  $where = '',  $in = '',  $order_by,  $limit = '',  $row_offset = 0 ) : void
inherited

This function is used to execute the query and create an array template objects from the resulting ids from the query.

Inherited from: \SugarBean::build_related_list_where()

It is currently used for building sub-panel arrays. It supports an additional where clause that is executed as a filter on the results

Parameters
Name Type Description
$query string
  • the query that should be executed to build the list
$template object
  • The object that should be used to copy the records.
$where
$in
$order_by
$limit
$row_offset
methodprotectedbuild_sub_queries_for_union(  $subpanel_list,  $subpanel_def,  $parentbean,  $order_by ) : void
staticinherited

Inherited from: \SugarBean::build_sub_queries_for_union()
Parameters
Name Type Description
$subpanel_list
$subpanel_def
$parentbean
$order_by
methodpubliccall_custom_logic(  $event,  $arguments = null ) : void
inherited

Trigger custom logic for this module that is defined for the provided hook The custom logic file is located under custom/modules/[CURRENT_MODULE]/logic_hooks.php.

Inherited from: \SugarBean::call_custom_logic()

That file should define the $hook_version that should be used. It should also define the $hook_array. The $hook_array will be a two dimensional array the first dimension is the name of the event, the second dimension is the information needed to fire the hook. Each entry in the top level array should be defined on a single line to make it easier to automatically replace this file. There should be no contents of this file that are not replacable.

$hook_array['before_save'][] = Array(1, testtype, 'custom/modules/Leads/test12.php', 'TestClass', 'lead_before_save_1'); This sample line creates a before_save hook. The hooks are procesed in the order in which they are added to the array. The second dimension is an array of: processing index (for sorting before exporting the array) A logic type hook label/type php file to include php class the method is in php method to call

The method signature for version 1 hooks is: function NAME(&$bean, $event, $arguments) $bean - $this bean passed in by reference. $event - The string for the current event (i.e. before_save) $arguments - An array of arguments that are specific to the event.

Parameters
Name Type Description
$event
$arguments
methodpubliccheck_date_relationships_load( ) : \this
inherited

This function retrieves a record of the appropriate type from the DB.

Inherited from: \SugarBean::check_date_relationships_load()

It fills in all of the fields from the DB into the object it was called on.

Returns
Type Description
\this - The object that it was called apon or null if exactly 1 record was not found.
methodpubliccleanBean( ) : void
inherited

Cleans char, varchar, text, etc. fields of XSS type materials

Inherited from: \SugarBean::cleanBean()
methodpublicconvertField(  $fieldvalue,  $fieldDef ) : string
inherited

Converts the field value based on the provided fieldDef

Inherited from: \SugarBean::convertField()
Parameters
Name Type Description
$fieldvalue
$fieldDef
Returns
Type Description
string
methodpublicconvertRow( array $row ) : array
inherited

Convert row data from DB format to internal format Mostly useful for dates/times

Inherited from: \SugarBean::convertRow()
Parameters
Name Type Description
$row array
Returns
Type Description
array $row
methodpubliccreateRelationshipMeta( string $key, object $db, string $tablename, array $dictionary, string $module_dir, boolean $iscustom = false ) : void
inherited

Populates the relationship meta for a module.

Inherited from: \SugarBean::createRelationshipMeta()

It is called during setup/install. It is used statically to create relationship meta data for many-to-many tables.

Parameters
Name Type Description
$key string

name of the object.

$db object

database handle.

$tablename string

table, meta data is being populated for.

$dictionary array

dictionary vardef dictionary for the object. *

$module_dir string

module_dir name of subdirectory where module is installed.

$iscustom boolean

Optional,set to true if module is installed in a custom directory. Default value is false.

Details
Static
Internal function, do not override.  
methodpubliccreate_audit_table( ) : void
inherited

If auditing is enabled, create the audit table.

Inherited from: \SugarBean::create_audit_table()

Function is used by the install scripts and a repair utility in the admin panel.

Internal function, do not override.

methodpubliccreate_export_query( string $order_by, string $where ) : string
inherited

Returns the query used for the export functionality for a module. Override this method if you wish to have a custom query to pull this data together instead

Inherited from: \SugarBean::create_export_query()
Parameters
Name Type Description
$order_by string
$where string
Returns
Type Description
string SQL query
methodpubliccreate_index(  $query ) : void
inherited

This is a helper function that is used to quickly created indexes when creating tables.

Inherited from: \SugarBean::create_index()
Parameters
Name Type Description
$query
methodpubliccreate_list_count_query( string $query ) : string
inherited

Changes the select expression of the given query to be 'count(*)' so you can get the number of items the query will return. This is used to populate the upper limit on ListViews.

Inherited from: \SugarBean::create_list_count_query()
Parameters
Name Type Description
$query string

Select query string

Returns
Type Description
string count query Internal function, do not override.
methodpubliccreate_new_list_query( string $order_by, string $where, array $filter = array(), array $params = array(), int $show_deleted = 0, string $join_type = '', boolean $return_array = false, object $parentbean = null, boolean $singleSelect = false,  $ifListForExport = false ) : String
inherited

Return the list query used by the list views and export button. Next generation of create_new_list_query function.

Inherited from: \SugarBean::create_new_list_query()

Override this function to return a custom query.

Parameters
Name Type Description
$order_by string

custom order by clause

$where string

custom where clause

$filter array

Optioanal

$params array

Optional *

$show_deleted int

Optional, default 0, show deleted records is set to 1.

$join_type string
$return_array boolean

Optional, default false, response as array

$parentbean object

creating a subquery for this bean.

$singleSelect boolean

Optional, default false.

$ifListForExport
Returns
Type Description
String select query string, optionally an array value will be returned if $return_array= true.
methodpubliccreate_notification_email( string $notify_user ) : void
inherited

This function handles create the email notifications email.

Inherited from: \SugarBean::create_notification_email()
Parameters
Name Type Description
$notify_user string

the user to send the notification email to

methodpubliccreate_qualified_order_by( string $order_by, string $qualify ) : \prefixed
inherited

Ensure that fields within order by clauses are properly qualified with their tablename. This qualification is a requirement for sql server support.

Inherited from: \SugarBean::create_qualified_order_by()
Parameters
Name Type Description
$order_by string

original order by from the query

$qualify string

prefix for columns in the order by list.

Returns
Type Description
\prefixed Internal function do not override.
methodpubliccreate_relationship_meta(  $key,  $db,  $log,  $tablename,  $dictionary,  $module_dir ) : void
inherited

This method has been deprecated.

Inherited from: \SugarBean::create_relationship_meta()
Parameters
Name Type Description
$key
$db
$log
$tablename
$dictionary
$module_dir
Details
See
\createRelationshipMeta()  
Static
 
methodpubliccreate_tables( ) : void
inherited

Creates tables for the module implementing the class.

Inherited from: \SugarBean::create_tables()

If you override this function make sure that your code can handles table creation.

methodpublicdecrypt_after_retrieve( STRING $value ) : string
inherited

Decode and decrypt a base 64 encoded string with field type 'encrypt' in this bean using Blowfish.

Inherited from: \SugarBean::decrypt_after_retrieve()
Parameters
Name Type Description
$value STRING

value - an encrypted and base 64 encoded string.

Returns
Type Description
string
methodpublicdelete_linked( string $id ) : void
inherited

Iterates through all the relationships and deletes all records for reach relationship.

Inherited from: \SugarBean::delete_linked()
Parameters
Name Type Description
$id string

Primary key value of the parent reocrd

methodpublicdrop_tables( ) : void
inherited

Delete the primary table for the module implementing the class.

Inherited from: \SugarBean::drop_tables()

If custom fields were added to this table/module, the custom table will be removed too, along with the cache entries that define the custom fields.

methodpublicencrpyt_before_save( STRING $value ) : string
inherited

Encrpyt and base64 encode an 'encrypt' field type in the bean using Blowfish. The default system key is stored in cache/Blowfish/{keytype}

Inherited from: \SugarBean::encrpyt_before_save()
Parameters
Name Type Description
$value STRING

value -plain text value of the bean field.

Returns
Type Description
string
methodpublicfill_in_additional_detail_fields( ) : void
inherited

This is designed to be overridden and add specific fields to each record.

Inherited from: \SugarBean::fill_in_additional_detail_fields()

This allows the generic query to fill in the major fields, and then targeted queries to get related fields and add them to the record. The contact's account for instance. This method is only used for populating extra fields in the detail form

methodpublicfill_in_additional_list_fields( ) : void
inherited

This is designed to be overridden and add specific fields to each record.

Inherited from: \SugarBean::fill_in_additional_list_fields()

This allows the generic query to fill in the major fields, and then targeted queries to get related fields and add them to the record. The contact's account for instance. This method is only used for populating extra fields in lists.

methodpublicfill_in_additional_parent_fields( ) : void
inherited

This is desgined to be overridden or called from extending bean. This method will fill in any parent_name fields.

Inherited from: \SugarBean::fill_in_additional_parent_fields()
methodpublicfill_in_link_field(  $linkFieldName,  $def ) : void
inherited

Inherited from: \SugarBean::fill_in_link_field()
Parameters
Name Type Description
$linkFieldName
$def
methodpublicfill_in_relationship_fields( ) : void
inherited

Fill in fields where type = relate

Inherited from: \SugarBean::fill_in_relationship_fields()
methodpublicfixUpFormatting( ) : void
inherited

Function corrects any bad formatting done by 3rd party/custom code

Inherited from: \SugarBean::fixUpFormatting()

This function will be removed in a future release, it is only here to assist upgrading existing code that expects formatted data in the bean

methodpublicformat_all_fields( ) : void
inherited

This functions adds formatting to all number fields before presenting them to user interface.

Inherited from: \SugarBean::format_all_fields()

Internal function, do not override.

methodpublicformat_field(  $fieldDef ) : void
inherited

Inherited from: \SugarBean::format_field()
Parameters
Name Type Description
$fieldDef
methodpublicfromArray( Array $arr ) : void
inherited

Converts an array into an acl mapping name value pairs into files

Inherited from: \SugarBean::fromArray()
Parameters
Name Type Description
$arr Array
methodpublicgetACLCategory( ) : string
inherited

Returns the ACL category for this module; defaults to the SugarBean::$acl_category if defined otherwise it is SugarBean::$module_dir

Inherited from: \SugarBean::getACLCategory()
Returns
Type Description
string
methodpublicgetAuditEnabledFieldDefinitions( ) : \an
inherited

Returns a list of fields with their definitions that have the audited property set to true.

Inherited from: \SugarBean::getAuditEnabledFieldDefinitions()

Before calling this function, check whether audit has been enabled for the table/module or not. You would set the audit flag in the implemting module's vardef file.

Returns
Type Description
\an array of
Details
See
\is_AuditEnabled  
methodpublicgetFieldDefinition( string $name ) : Array
inherited

Returns field definition for the requested field name.

Inherited from: \SugarBean::getFieldDefinition()

The definitions were loaded in the constructor.

Parameters
Name Type Description
$name string

field name,

Returns
Type Description
Array Field properties or boolean false if the field doesn't exist Internal function, do not override.
methodpublicgetFieldDefinitions( ) : Array
inherited

Returns field definitions for the implementing module.

Inherited from: \SugarBean::getFieldDefinitions()

The definitions were loaded in the constructor.

Returns
Type Description
Array Field definitions. Internal function, do not override.
methodpublicgetFieldValue( string $name ) : \varies
inherited

Returns the value for the requested field.

Inherited from: \SugarBean::getFieldValue()

When a row of data is fetched using the bean, all fields are created as variables in the context of the bean and then fetched values are set in these variables.

Parameters
Name Type Description
$name string

field name,

Returns
Type Description
\varies Field value. Internal function, do not override.
methodpublicgetIndices( ) : Array
inherited

Returns index definitions for the implementing module.

Inherited from: \SugarBean::getIndices()

The definitions were loaded in the constructor.

Returns
Type Description
Array Index definitions. Internal function, do not override.
methodpublicgetObjectName( ) : \nothing
inherited

Returns the object name. If object_name is not set, table_name is returned.

Inherited from: \SugarBean::getObjectName()

All implementing classes must set a value for the object_name variable.

Returns
Type Description
\nothing
methodpublicgetOwnerField(  $returnFieldName = false ) : STRING
inherited

Get owner field

Inherited from: \SugarBean::getOwnerField()
Parameters
Name Type Description
$returnFieldName
Returns
Type Description
STRING
methodpublicgetOwnerWhere( \GUID $user_id ) : STRING
inherited

Gets there where statement for checking if a user is an owner

Inherited from: \SugarBean::getOwnerWhere()
Parameters
Name Type Description
$user_id \GUID
Returns
Type Description
STRING
methodpublicgetPrimaryFieldDefinition( ) : Array
inherited

Returnss definition for the id field name.

Inherited from: \SugarBean::getPrimaryFieldDefinition()

The definitions were loaded in the constructor.

Returns
Type Description
Array Field properties. Internal function, do not override.
methodpublicgetRealKeyFromCustomFieldAssignedKey(  $name ) : void
Parameters
Name Type Description
$name
methodpublicgetRelatedFields(  $module,  $id,  $fields,  $return_array = false ) : void
inherited

Inherited from: \SugarBean::getRelatedFields()
Parameters
Name Type Description
$module
$id
$fields
$return_array
methodpublicgetTableName( ) : String
inherited

Returns the implementing class' table name.

Inherited from: \SugarBean::getTableName()

All implementing classes set a value for the table_name variable. This value is returned as the table name. If not set, table name is extracted from the implementing module's vardef.

Returns
Type Description
String Table name. Internal function, do not override.
methodpublicget_audit_table_name( ) : String
inherited

Returns the name of the audit table.

Inherited from: \SugarBean::get_audit_table_name()

Audit table's name is based on implementing class' table name.

Returns
Type Description
String Audit table name. Internal function, do not override.
methodpublicget_custom_table_name( ) : String
inherited

Returns the name of the custom table.

Inherited from: \SugarBean::get_custom_table_name()

Custom table's name is based on implementing class' table name.

Returns
Type Description
String Custom table name. Internal function, do not override.
methodpublicget_full_list( string $order_by = "", string $where = "",  $check_dates = false, int $show_deleted = 0 ) : void
inherited

Returns a full (ie non-paged) list of the current object type.

Inherited from: \SugarBean::get_full_list()
Parameters
Name Type Description
$order_by string

the order by SQL parameter. defaults to ""

$where string

where clause. defaults to ""

$check_dates
$show_deleted int

show deleted records. defaults to 0

methodpublicget_import_required_fields( ) : array
inherited

Returns an array of fields that are required for import

Inherited from: \SugarBean::get_import_required_fields()
Returns
Type Description
array
methodpublicget_importable_fields( ) : array
inherited

Returns an array of fields that are able to be Imported into i.e. 'importable' not set to 'false'

Inherited from: \SugarBean::get_importable_fields()
Returns
Type Description
array List of fields. Internal function, do not override.
methodpublicget_linked_beans( string $field_name,  $bean_name, array $sort_array = array(), int $begin_index = 0, int $end_index = -1, int $deleted = 0,  $optional_where = "" ) : void
inherited

Returns an array of beans of related data.

Inherited from: \SugarBean::get_linked_beans()

For instance, if an account is related to 10 contacts , this function will return an array of contacts beans (10) with each bean representing a contact record. Method will load the relationship if not done so already.

Parameters
Name Type Description
$field_name string

relationship to be loaded.

$bean_name
$sort_array array

optional, unused

$begin_index int

Optional, default 0, unused.

$end_index int

Optional, default -1

$deleted int

Optional, Default 0, 0 adds deleted=0 filter, 1 adds deleted=1 filter.

$optional_where
methodpublicget_linked_fields( ) : array
inherited

Returns an array of fields that are of type link.

Inherited from: \SugarBean::get_linked_fields()
Returns
Type Description
array List of fields. Internal function, do not override.
methodpublicget_list_view_array( ) : void
inherited

Assigns all of the values into the template for the list view

Inherited from: \SugarBean::get_list_view_array()
methodpublicget_list_view_data( ) : void
inherited

Override this function to set values in the array used to render list view data.

Inherited from: \SugarBean::get_list_view_data()
methodpublicget_notification_recipients( ) : void
inherited

Determines which users receive a notification

Inherited from: \SugarBean::get_notification_recipients()
methodpublicget_profile( ) : void

methodpublicget_related_fields( ) : array
inherited

Returns an array of fields that are of type relate.

Inherited from: \SugarBean::get_related_fields()
Returns
Type Description
array List of fields. Internal function, do not override.
methodpublicget_related_list( object $child_seed, string $related_field_name, string $order_by = "", string $where = "",  $row_offset = 0,  $limit = -1,  $max = -1,  $show_deleted = 0 ) : array
inherited

Fetches data from all related tables.

Inherited from: \SugarBean::get_related_list()
Parameters
Name Type Description
$child_seed object
$related_field_name string

relation to fetch data for

$order_by string

Optional, default empty

$where string

Optional, additional where clause

$row_offset
$limit
$max
$show_deleted
Returns
Type Description
array Fetched data. Internal function, do not override.
methodpublicget_summary_text( ) : string
inherited

Returns the summary text that should show up in the recent history list for this object.

Inherited from: \SugarBean::get_summary_text()
Returns
Type Description
string
methodpublicget_union_related_list( \SugarBean $parentbean, string $order_by = "", string $sort_order = '', string $where = "",  $row_offset = 0,  $limit = -1,  $max = -1,  $show_deleted = 0,  $subpanel_def ) : void
inherited

Constructs a query to fetch data for supanels and list views

Inherited from: \SugarBean::get_union_related_list()

It constructs union queries for activities subpanel.

Parameters
Name Type Description
$parentbean \SugarBean

constructing queries for link attributes in this bean

$order_by string

Optional, order by clause

$sort_order string

Optional, sort order

$where string

Optional, additional where clause Internal Function, do not overide.

$row_offset
$limit
$max
$show_deleted
$subpanel_def
methodpublicget_where( array $fields_array, boolean $deleted = true ) : string
inherited

Construct where clause from a list of name-value pairs.

Inherited from: \SugarBean::get_where()
Parameters
Name Type Description
$fields_array array

Name/value pairs for column checks

$deleted boolean

Optional, default true, if set to false deleted filter will not be added.

Returns
Type Description
string The WHERE clause
methodpublichasCustomFields( ) : void
inherited

Inherited from: \SugarBean::hasCustomFields()
methodpublichas_been_modified_since( \date $date, string $modified_user_id ) : void
inherited

Performs a check if the record has been modified since the specified date

Inherited from: \SugarBean::has_been_modified_since()
Parameters
Name Type Description
$date \date

Datetime for verification

$modified_user_id string

User modified by

methodpublicisOwner( \GUID $user_id ) : boolean
inherited

Returns true of false if the user_id passed is the owner

Inherited from: \SugarBean::isOwner()
Parameters
Name Type Description
$user_id \GUID
Returns
Type Description
boolean
methodpublicis_AuditEnabled( ) : boolean
inherited

Return true if auditing is enabled for this object You would set the audit flag in the implemting module's vardef file.

Inherited from: \SugarBean::is_AuditEnabled()
Returns
Type Description
boolean Internal function, do not override.
methodpublicis_expected_version(  $expected_version ) : void

Parameters
Name Type Description
$expected_version
methodpubliclist_view_parse_additional_sections(  $list_form ) : void
inherited

Let implementing classes to fill in row specific columns of a list view form

Inherited from: \SugarBean::list_view_parse_additional_sections()
Parameters
Name Type Description
$list_form
methodpubliclistviewACLHelper( ) : ARRAY
inherited

Used in order to manage ListView links and if they should links or not based on the ACL permissions of the user

Inherited from: \SugarBean::listviewACLHelper()
Returns
Type Description
ARRAY of STRINGS
methodpublicloadFromRow( array $arr ) : \nothing
inherited

Loads a row of data into instance of a bean. The data is passed as an array to this function

Inherited from: \SugarBean::loadFromRow()
Parameters
Name Type Description
$arr array

row of data fetched from the database.

Returns
Type Description
\nothing Internal function do not override.
methodpublicloadLayoutDefs( ) : void
inherited

Inherited from: \SugarBean::loadLayoutDefs()
methodpublicload_relationship( string $rel_name ) : \nothing.
inherited

Loads the request relationship. This method should be called before performing any operations on the related data.

Inherited from: \SugarBean::load_relationship()

This method searches the vardef array for the requested attribute's definition. If the attribute is of the type link then it creates a similary named variable and loads the relationship definition.

Parameters
Name Type Description
$rel_name string

relationship/attribute name.

Returns
Type Description
\nothing.
methodpublicload_relationships( ) : \Nothing
inherited

Loads all attributes of type link.

Inherited from: \SugarBean::load_relationships()

DO NOT CALL THIS FUNCTION IF YOU CAN AVOID IT. Please use load_relationship directly instead.

Method searches the implmenting module's vardef file for attributes of type link, and for each attribute create a similary named variable and load the relationship definition.

Returns
Type Description
\Nothing Internal function, do not override.
methodpublicmark_deleted(  $id ) : void
inherited

This function should be overridden in each module. It marks an item as deleted.

Inherited from: \SugarBean::mark_deleted()

If it is not overridden, then marking this type of item is not allowed

Parameters
Name Type Description
$id
methodpublicmark_relationships_deleted( int $id ) : void
inherited

This function deletes relationships to this object. It should be overridden to handle the relationships of the specific object.

Inherited from: \SugarBean::mark_relationships_deleted()

This function is called when the item itself is being deleted.

Parameters
Name Type Description
$id int

id of the relationship to delete

methodpublicmark_undeleted(  $id ) : void
inherited

Restores data deleted by call to mark_deleted() function.

Inherited from: \SugarBean::mark_undeleted()

Internal function, do not override.

Parameters
Name Type Description
$id
methodpublicmark_upgraded(  $name,  $dbVersion,  $fileVersion ) : void

Updates the version info based on the information provided

Parameters
Name Type Description
$name
$dbVersion
$fileVersion
methodprotectedparseDateDefault( string $value, bool $time = false ) : string
inherited

Create date string from default value like '+1 month'

Inherited from: \SugarBean::parseDateDefault()
Parameters
Name Type Description
$value string
$time bool

Should be expect time set too?

Returns
Type Description
string
methodpublicparse_additional_headers(  $list_form,  $xTemplateSection ) : void
inherited

Inherited from: \SugarBean::parse_additional_headers()
Parameters
Name Type Description
$list_form
$xTemplateSection
methodpublicpopulateDefaultValues(  $force = false ) : void
inherited

Inherited from: \SugarBean::populateDefaultValues()
Parameters
Name Type Description
$force
methodpublicpopulateRelatedBean( \SugarBean $newbean ) : void
inherited

Called from ImportFieldSanitize::relate(), when creating a new bean in a related module. Will copies fields over from the current bean into the related. Designed to be overriden in child classes.

Inherited from: \SugarBean::populateRelatedBean()
Parameters
Name Type Description
$newbean \SugarBean

newly created related bean

methodpublicpreprocess_fields_on_save( ) : void
inherited

This function processes the fields before save.

Inherited from: \SugarBean::preprocess_fields_on_save()

Interal function, do not override.

methodpublicprocess_detail_query( string $query, int $row_offset, int $limit = -1, int $max_per_page = -1, string $where = '', int $offset = 0 ) : array
inherited

Applies pagination window to select queries used by detail view, executes the query and returns fetched data.

Inherited from: \SugarBean::process_detail_query()

Internal function, do not override.

Parameters
Name Type Description
$query string

query to be processed.

$row_offset int
$limit int

optional, default -1

$max_per_page int

Optional, default -1

$where string

Custom where clause.

$offset int

Optional, default 0

Returns
Type Description
array Fetched data.
methodpublicprocess_full_list_query( string $query, boolean $check_date = false ) : array
inherited

Processes fetched list view data

Inherited from: \SugarBean::process_full_list_query()

Internal function, do not override.

Parameters
Name Type Description
$query string

query to be processed.

$check_date boolean

Optional, default false. if set to true date time values are processed.

Returns
Type Description
array Fetched data.
methodpublicprocess_list_query( string $query, int $row_offset, int $limit = -1, int $max_per_page = -1, string $where = '' ) : array
inherited

Processes the list query and return fetched row.

Inherited from: \SugarBean::process_list_query()

Internal function, do not override.

Parameters
Name Type Description
$query string

select query to be processed.

$row_offset int

starting position

$limit int

Optioanl, default -1

$max_per_page int

Optional, default -1

$where string

Optional, additional filter criteria.

Returns
Type Description
array Fetched data
methodpublicprocess_order_by( string $order_by, \SugarBean $submodule = null ) : string
inherited

Prefixes column names with this bean's table name.

Inherited from: \SugarBean::process_order_by()
Parameters
Name Type Description
$order_by string

Order by clause to be processed

$submodule \SugarBean

name of the module this order by clause is for

Returns
Type Description
string Processed order by clause Internal function, do not override.
methodpublicprocess_special_fields( ) : void
inherited

This method is called during an import before inserting a bean Define an associative array called $special_fields the keys are user defined, and don't directly map to the bean's fields the value is the method name within that bean that will do extra processing for that field. example: 'full_name'=>'get_names_from_full_name'

Inherited from: \SugarBean::process_special_fields()
methodpublicprocess_union_list_query( object $parent_bean, string $query, int $row_offset, int $limit = -1, int $max_per_page = -1, string $where = '', array $subpanel_def, string $query_row_count = '',  $secondary_queries = array() ) : array
inherited

Applies pagination window to union queries used by list view and subpanels, executes the query and returns fetched data.

Inherited from: \SugarBean::process_union_list_query()

Internal function, do not override.

Parameters
Name Type Description
$parent_bean object
$query string

query to be processed.

$row_offset int
$limit int

optional, default -1

$max_per_page int

Optional, default -1

$where string

Custom where clause.

$subpanel_def array

definition of sub-panel to be processed

$query_row_count string
$secondary_queries
Returns
Type Description
array Fetched data.
methodpublicremoveRelationshipMeta( string $key, string $db, string $tablename, string $dictionary, string $module_dir ) : \Nothing
inherited

Removes relationship metadata cache.

Inherited from: \SugarBean::removeRelationshipMeta()

Every module that has relationships defined with other modules, has this meta data cached. The cache is stores in 2 locations: relationships table and file system. This method clears the cache from both locations.

Parameters
Name Type Description
$key string

module whose meta cache is to be cleared.

$db string

database handle.

$tablename string

table name

$dictionary string

vardef for the module

$module_dir string

name of subdirectory where module is installed.

Returns
Type Description
\Nothing
Details
Static
Internal function, do not override.  
methodpublicremove_relationship_meta(  $key,  $db,  $log,  $tablename,  $dictionary,  $module_dir ) : void
inherited

This method has been deprecated.

Inherited from: \SugarBean::remove_relationship_meta()
Parameters
Name Type Description
$key
$db
$log
$tablename
$dictionary
$module_dir
Details
See
\removeRelationshipMeta()  
Static
 
methodpublicretrieve( string $id = -1, boolean $encode = true, boolean $deleted = true ) : void
inherited

Function fetches a single row of data given the primary key value.

Inherited from: \SugarBean::retrieve()

The fetched data is then set into the bean. The function also processes the fetched data by formattig date/time and numeric values.

Parameters
Name Type Description
$id string

Optional, default -1, is set to -1 id value from the bean is used, else, passed value is used

$encode boolean

Optional, default true, encodes the values fetched from the database.

$deleted boolean

Optional, default true, if set to false deleted filter will not be added. Internal function, do not override.

methodpublicretrieve_by_string_fields( array $fields_array, boolean $encode = true, boolean $deleted = true ) : object
inherited

Constructs a select query and fetch 1 row using this query, and then process the row

Inherited from: \SugarBean::retrieve_by_string_fields()

Internal function, do not override.

Parameters
Name Type Description
$fields_array array

@fields_array array of name value pairs used to construct query.

$encode boolean

Optional, default true, encode fetched data.

$deleted boolean

Optional, default true, if set to false deleted filter will not be added.

Returns
Type Description
object Instance of this bean with fetched data.
methodpublicretrieve_parent_fields( array $type_info ) : void
inherited

Returns parent record data for objects that store relationship information

Inherited from: \SugarBean::retrieve_parent_fields()
Parameters
Name Type Description
$type_info array

Interal function, do not override.

methodpublicretrieve_relationships(  $table,  $values,  $select_id ) : void
inherited

Inherited from: \SugarBean::retrieve_relationships()
Parameters
Name Type Description
$table
$values
$select_id
methodpublicsave( boolean $check_notify = FALSE ) : void
inherited

Implements a generic insert and update logic for any SugarBean This method only works for subclasses that implement the same variable names.

Inherited from: \SugarBean::save()

This method uses the presence of an id field that is not null to signify and update. The id field should not be set otherwise.

Parameters
Name Type Description
$check_notify boolean

Optional, default false, if set to true assignee of the record is notified via email.

methodpublicsave_relationship_changes( \$is_update $is_update,  $exclude = array() ) : void
inherited

This function is a good location to save changes that have been made to a relationship.

Inherited from: \SugarBean::save_relationship_changes()

This should be overriden in subclasses that have something to save.

Parameters
Name Type Description
$is_update \$is_update

true if this save is an update.

$exclude
methodpublicsend_assignment_notifications( string $notify_user, string $admin ) : void
inherited

Handles sending out email notifications when items are first assigned to users

Inherited from: \SugarBean::send_assignment_notifications()
Parameters
Name Type Description
$notify_user string

user to notify

$admin string

the admin user that sends out the notification

methodpublicset_relationship(  $table,  $relate_values,  $check_duplicates = true,  $do_update = false,  $data_values = null ) : void
inherited

Inherited from: \SugarBean::set_relationship()
Parameters
Name Type Description
$table
$relate_values
$check_duplicates
$do_update
$data_values
methodpublicsetupCustomFields( string $module_name, boolean $clean_load = true ) : void
inherited

Loads the definition of custom fields defined for the module.

Inherited from: \SugarBean::setupCustomFields()

Local file system cache is created as needed.

Parameters
Name Type Description
$module_name string

setting up custom fields for this module.

$clean_load boolean

Optional, default true, rebuilds the cache if set to true.

methodpublictoArray(  $dbOnly = false,  $stringOnly = false,  $upperKeys = false ) : array
inherited

returns this bean as an array

Inherited from: \SugarBean::toArray()
Parameters
Name Type Description
$dbOnly
$stringOnly
$upperKeys
Returns
Type Description
array of fields with id, name, access and category
methodpublictrack_view( string $user_id, string $current_module, string $current_view = '' ) : void
inherited

Tracks the viewing of a detail record.

Inherited from: \SugarBean::track_view()

This leverages get_summary_text() which is object specific.

Internal function, do not override.

Parameters
Name Type Description
$user_id string
  • String value of the user that is viewing the record.
$current_module string
  • String value of the module being processed.
$current_view string
  • String value of the current view
methodpublicunPopulateDefaultValues( ) : void
inherited

Basically undoes the effects of SugarBean::populateDefaultValues(); this method is best called right after object initialization.

Inherited from: \SugarBean::unPopulateDefaultValues()
methodpublicunformat_all_fields( ) : void
inherited

Removes formatting from values posted from the user interface.

Inherited from: \SugarBean::unformat_all_fields()

It only unformats numbers. Function relies on user/system prefernce for format strings.

Internal Function, do not override.

Documentation was generated by DocBlox 0.18.1.