modules/UpgradeWizard/SugarMerge/DetailViewMerge.php
\DetailViewMerge
This class extends the EditViewMerge - since the meta data is relatively the same the only thing that needs to be changed is the parameter for viewdefs
- Parent(s)
- \EditViewMerge
Properties

BOOLEAN
$bestMatch= 'true'
trueDetails- Type
- BOOLEAN
- Inherited_from
- \EditViewMerge::$$bestMatch

ARRAY
$customData= 'array()'
this will store the meta data for the custom file
Inherited from: \EditViewMerge::$$customDataarray()Details- Type
- ARRAY
- Inherited_from
- \EditViewMerge::$$customData

ARRAY
$customFields= 'array()'
this will store an associative array contianing all the fields that are used in the custom meta data file
Inherited from: \EditViewMerge::$$customFieldsarray()Details- Type
- ARRAY
- Inherited_from
- \EditViewMerge::$$customFields

$customPanelIds= 'array()'
The ids of the panels found in custom metadata fuke
Inherited from: \EditViewMerge::$$customPanelIdsarray()Details- Type
- n/a
- Inherited_from
- \EditViewMerge::$$customPanelIds

STRING
$defaultPanel= ''default''
The default panel we place the fields in if we aren't using the best match algorithim
Inherited from: \EditViewMerge::$$defaultPanel'default'Details- Type
- STRING
- Inherited_from
- \EditViewMerge::$$defaultPanel

$fieldConversionMapping= 'array(
'Campaigns' => array('created_by_name'=>'date_entered', 'modified_by_name'=>'date_modified'),
'Cases' => array('created_by_name'=>'date_entered', 'modified_by_name'=>'date_modified'),
'Contracts' => array('created_by_name'=>'date_entered', 'modified_by_name'=>'date_modified'),
'Leads' => array('created_by'=>'date_entered'),
'Meetings' => array('created_by_name'=>'date_entered', 'modified_by_name'=>'date_modified'),
'ProspectLists' => array('created_by_name'=>'date_entered', 'modified_by_name'=>'date_modified'),
'Prospects' => array('created_by_name'=>'date_entered', 'modified_by_name'=>'date_modified'),
)'
array(
'Campaigns' => array('created_by_name'=>'date_entered', 'modified_by_name'=>'date_modified'),
'Cases' => array('created_by_name'=>'date_entered', 'modified_by_name'=>'date_modified'),
'Contracts' => array('created_by_name'=>'date_entered', 'modified_by_name'=>'date_modified'),
'Leads' => array('created_by'=>'date_entered'),
'Meetings' => array('created_by_name'=>'date_entered', 'modified_by_name'=>'date_modified'),
'ProspectLists' => array('created_by_name'=>'date_entered', 'modified_by_name'=>'date_modified'),
'Prospects' => array('created_by_name'=>'date_entered', 'modified_by_name'=>'date_modified'),
)Details- Type
- n/a
- Inherited_from
- \EditViewMerge::$$fieldConversionMapping

\FILEPOINTER
$fp= 'NULL'
The file pointer to log to if set to NULL it will use the GLOBALS['log'] if available and log to debug
Inherited from: \EditViewMerge::$$fpNULLDetails- Type
- \FILEPOINTER
- Inherited_from
- \EditViewMerge::$$fp

BOOLEAN
$isMultiPanel= 'true'
If true then it works as though it's a multipanel
Inherited from: \EditViewMerge::$$isMultiPaneltrueDetails- Type
- BOOLEAN
- Inherited_from
- \EditViewMerge::$$isMultiPanel

ARRAY
$mergedFields= 'array()'
this will store an associative array contianing all the merged fields
Inherited from: \EditViewMerge::$$mergedFieldsarray()Details- Type
- ARRAY
- Inherited_from
- \EditViewMerge::$$mergedFields

STRING
$module= ''module''
'module'Details- Type
- STRING
- Inherited_from
- \EditViewMerge::$$module

ARRAY
$newData= 'array()'
array()Details- Type
- ARRAY
- Inherited_from
- \EditViewMerge::$$newData

ARRAY
$newFields= 'array()'
this will store an associative array contianing all the fields that are used in the new meta data file
Inherited from: \EditViewMerge::$$newFieldsarray()Details- Type
- ARRAY
- Inherited_from
- \EditViewMerge::$$newFields

$newPanelIds= 'array()'
The ids of the panels found in original metadata fuke
Inherited from: \EditViewMerge::$$newPanelIdsarray()Details- Type
- n/a
- Inherited_from
- \EditViewMerge::$$newPanelIds

ARRAY
$originalData= 'array()'
this will store the meta data for the original file
Inherited from: \EditViewMerge::$$originalDataarray()Details- Type
- ARRAY
- Inherited_from
- \EditViewMerge::$$originalData

ARRAY
$originalFields= 'array()'
this will store an associative array contianing all the fields that are used in the original meta data file
Inherited from: \EditViewMerge::$$originalFieldsarray()Details- Type
- ARRAY
- Inherited_from
- \EditViewMerge::$$originalFields

$originalPanelIds= 'array()'
The ids of the panels found in original metadata fuke
Inherited from: \EditViewMerge::$$originalPanelIdsarray()Details- Type
- n/a
- Inherited_from
- \EditViewMerge::$$originalPanelIds

STRING
$panelName= ''panels''
'panels'Details- Type
- STRING
- Inherited_from
- \EditViewMerge::$$panelName

BOOLEAN
$scanForMultiPanel= 'true'
Determines if getFields should analyze panels to determine if it is a MultiPanel
trueDetails- Type
- BOOLEAN

$templateMetaName= ''templateMeta''
The name of the templateMeta data secion in the meta data
Inherited from: \EditViewMerge::$$templateMetaName'templateMeta'Details- Type
- n/a
- Inherited_from
- \EditViewMerge::$$templateMetaName

STRING
$varName= ''viewdefs''
The variable name that is used with the file for example in editviewdefs and detailviewdefs it is $viewdefs
Inherited from: \EditViewMerge::$$varName'viewdefs'Details- Type
- STRING
- Inherited_from
- \EditViewMerge::$$varName
Methods

areMatchingValues(
\MULTI $val1, \MULTI $val2
)
:
BOOLEANreturns true if $val1 and $val2 match otherwise it returns false
Inherited from: \EditViewMerge::areMatchingValues()| Name | Type | Description |
|---|---|---|
| $val1 | \MULTI |
|
| $val2 | \MULTI |
|
| Type | Description |
|---|---|
| BOOLEAN | - if $val1 and $val2 match |

arrayMerge(
ARRAY $gimp, ARRAY $dom
)
:
ARRAY
| Name | Type | Description |
|---|---|---|
| $gimp | ARRAY |
|
| $dom | ARRAY |
|
| Type | Description |
|---|---|
| ARRAY | $merged - the merges array |

buildPanels(
)
:
ARRAYWalks through the merged fields and places them in the appropriate place based on their location parameter as well as the choosen algorithim
Inherited from: \EditViewMerge::buildPanels()| Type | Description |
|---|---|
| ARRAY | $panels - the new panels section for the merged file |

clear(
)
:
voidClears out the values of the arrays so that the same object can be utilized
Inherited from: \EditViewMerge::clear()
getData(
)
:
ARRAYThis will return the meta data of the merged file
Inherited from: \EditViewMerge::getData()| Type | Description |
|---|---|
| ARRAY | - the meta data of the merged file |

getFields(
ARRAY $panels
)
:
ARRAYThis takes in a list of panels and returns an associative array of field names to the meta-data of the field as well as the locations of that field
Inherited from: \EditViewMerge::getFields()| Name | Type | Description |
|---|---|---|
| $panels | ARRAY |
|
| Type | Description |
|---|---|
| ARRAY | $fields - an associate array of fields and their meta-data as well as their location |

loadData(
STRING $module, STRING $original_file, STRING $new_file, STRING $custom_file
)
:
voidLoads the meta data of the original, new, and custom file into the variables originalData, newData, and customData respectively
Inherited from: \EditViewMerge::loadData()| Name | Type | Description |
|---|---|---|
| $module | STRING |
|
| $original_file | STRING |
|
| $new_file | STRING |
|
| $custom_file | STRING |
|

log(
\MULTI $message
)
:
voidLogs the given message if the message is not a string it will export it first. If $this->fp is NULL then it will try to log to the $GLOBALS['log'] if it is available
Inherited from: \EditViewMerge::log()| Name | Type | Description |
|---|---|---|
| $message | \MULTI |

merge(
STRING $module, STRING $original_file, STRING $new_file, STRING $custom_file
=
false, BOOLEAN $save
=
true
)
:
BOOLEANpublic function that will merge meta data from an original sugar file that shipped with the product, a customized file, and a new file shipped with an upgrade
Inherited from: \EditViewMerge::merge()| Name | Type | Description |
|---|---|---|
| $module | STRING |
|
| $original_file | STRING |
|
| $new_file | STRING |
|
| $custom_file | STRING |
|
| $save | BOOLEAN |
|
| Type | Description |
|---|---|
| BOOLEAN | - if the merged file was saved if false is passed in for the save parameter it always returns true |

mergeField(
ARRAY $orig, ARRAY $new, ARRAY $custom
)
:
ARRAY
| Name | Type | Description |
|---|---|---|
| $orig | ARRAY |
|
| $new | ARRAY |
|
| $custom | ARRAY |
|
| Type | Description |
|---|---|
| ARRAY | $merged - the merged meta-data |

mergeFields(
)
:
voidMerges the fields together and stores them in $this->mergedFields
Inherited from: \EditViewMerge::mergeFields()
mergeMetaData(
)
:
voidParses out the fields for each files meta data and then calls on mergeFields and setPanels

mergeTemplateMeta(
)
:
voidMerge the templateMeta entry for the view defs. Also assume that any changes made in the custom files should have precedence since they must be changed manually, even over new files that may be provided in the upgarde patch.
Inherited from: \EditViewMerge::mergeTemplateMeta()
save(
STRING $to
)
:
BOOLEAN
| Name | Type | Description |
|---|---|---|
| $to | STRING |
|
| Type | Description |
|---|---|
| BOOLEAN | - success or failure of the save |

setBestMatch(
BOOLEAN $on
=
true
)
:
voidAllows the user to choose to use the best match algorithim or not
Inherited from: \EditViewMerge::setBestMatch()| Name | Type | Description |
|---|---|---|
| $on | BOOLEAN |

setDefaultPanel(
STRING $name
=
'default'
)
:
voidAllows users to set the name to use as the default panel in the meta data
Inherited from: \EditViewMerge::setDefaultPanel()| Name | Type | Description |
|---|---|---|
| $name | STRING |
|

setLogFile(
STRING $file
)
:
voidopens the file with the 'a' parameter and use it to log messages to
Inherited from: \EditViewMerge::setLogFile()| Name | Type | Description |
|---|---|---|
| $file | STRING |
|

setLogFilePointer(
\FILEPOINTER $fp
)
:
voidAllows the user to set a filepointer that is already open to log to
Inherited from: \EditViewMerge::setLogFilePointer()| Name | Type | Description |
|---|---|---|
| $fp | \FILEPOINTER |

setPanels(
)
:
voidSets the panel section for the meta-data after it has been merged
Inherited from: \EditViewMerge::setPanels()