deployedmetadataimplementation.php

来自「SugarCRM5.1 开源PHP客户关系管理系统」· PHP 代码 · 共 192 行

<?php
if(!defined('sugarEntry') || !sugarEntry) die('Not A Valid Entry Point');
/*********************************************************************************
 * SugarCRM is a customer relationship management program developed by
 * SugarCRM, Inc. Copyright (C) 2004 - 2007 SugarCRM Inc.
 * 
 * This program is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License version 3 as published by the
 * Free Software Foundation with the addition of the following permission added
 * to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
 * IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
 * OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
 * 
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
 * details.
 * 
 * You should have received a copy of the GNU General Public License along with
 * this program; if not, see http://www.gnu.org/licenses or write to the Free
 * Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
 * 02110-1301 USA.
 * 
 * You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
 * SW2-130, Cupertino, CA 95014, USA. or at email address [e-mail].
 * 
 * The interactive user interfaces in modified source and object code versions
 * of this program must display Appropriate Legal Notices, as required under
 * Section 5 of the GNU General Public License version 3.
 * 
 * In accordance with Section 7(b) of the GNU General Public License version 3,
 * these Appropriate Legal Notices must retain the display of the "Powered by
 * SugarCRM" logo. If the display of the logo is not reasonably feasible for
 * technical reasons, the Appropriate Legal Notices must display the words
 * "Powered by SugarCRM".
 *********************************************************************************/
/*
 * Implementation class (following a Bridge Pattern) for handling loading and saving deployed module metadata
 * For example, listview or editview viewdefs
 */

require_once 'modules/ModuleBuilder/parsers/views/AbstractMetaDataImplementation.php' ;
require_once 'modules/ModuleBuilder/parsers/views/MetaDataImplementationInterface.php' ;
require_once 'modules/ModuleBuilder/parsers/views/ListLayoutMetaDataParser.php' ;
require_once 'modules/ModuleBuilder/parsers/views/GridLayoutMetaDataParser.php' ;
require_once 'modules/ModuleBuilder/parsers/constants.php' ;

class DeployedMetaDataImplementation extends AbstractMetaDataImplementation implements MetaDataImplementationInterface
{

    /*
     * Constructor
     * @param string $view
     * @param string $moduleName
     */
    function __construct ($view , $moduleName)
    {
        $this->_view = strtolower ( $view ) ;
        $this->_moduleName = $moduleName ;
        // BEGIN ASSERTIONS
        if (! isset ( $this->_fileVariables [ $view ] ))
        {
            sugar_die ( get_class ( $this ) . ": View $view is not supported" ) ;
        }
        if (! isset ( $GLOBALS [ 'beanList' ] [ $moduleName ] ))
        {
            sugar_die ( get_class ( $this ) . ": Modulename $moduleName is not a Deployed Module" ) ;
        }
        // END ASSERTIONS
        

        $this->_history = new History ( $this->getFileName ( $view, $moduleName, MB_HISTORYMETADATALOCATION ) ) ;
        
        foreach ( array ( MB_HISTORYMETADATALOCATION , MB_WORKINGMETADATALOCATION , MB_CUSTOMMETADATALOCATION , MB_BASEMETADATALOCATION ) as $type )
        {
            $this->_sourceFilename = $this->getFileName ( $view, $moduleName, $type ) ;
            if (null !== ($loaded = $this->_loadFromFile ( $this->_sourceFilename )))
                break ;
        }
        
        if ($loaded === null)
        {
            // Special handling for QuickCreates - if we don't have a QuickCreate definition in the usual places, then use an EditView 
            if ($view == MB_QUICKCREATE)
            {
                $this->_sourceFilename = $this->getFileName ( MB_EDITVIEW, $moduleName, MB_BASEMETADATALOCATION ) ;
                $loaded = $this->_loadFromFile ( $this->_sourceFilename ) ;
            }
            // if we found an EditView, we can happily convert it into a QuickCreate
            if ($loaded !== null)
            {
                // Now change the array index from EditView to QuickCreate
                $temp = $loaded [ GridLayoutMetaDataParser::$variableMap [ MB_EDITVIEW ] ] ;
                unset ( $loaded [ GridLayoutMetaDataParser::$variableMap [ MB_EDITVIEW ] ] ) ;
                $loaded [ GridLayoutMetaDataParser::$variableMap [ MB_QUICKCREATE ] ] = $temp ;
                // finally, save out our new definition so that we have a base record for the history to work from
                $this->_sourceFilename = $this->getFileName ( MB_QUICKCREATE, $moduleName, MB_CUSTOMMETADATALOCATION ) ;
                $this->_saveToFile ( $this->_sourceFilename, $loaded ) ;
            } else
                sugar_die ( get_class ( $this ) . ": view definitions for View $this->_view and Module $this->_moduleName are missing" ) ;
        }
        
        $this->_viewdefs = $loaded ;
        
        $class = $GLOBALS [ 'beanList' ] [ $moduleName ] ;
        require_once ($GLOBALS [ 'beanFiles' ] [ $class ]) ;
        $module = new $class ( ) ;
        
        // Now construct the list of valid fields associated with this module
        $fielddefs = ! empty ( $module->field_name_map ) ? $module->field_name_map : $module->field_defs ;
        $fielddefs = array_change_key_case ( $fielddefs ) ;
        $this->_fielddefs = array ( ) ;
        // Run through the preliminary list, keeping only those fields that are valid to include in a layout
        foreach ( $fielddefs as $key => $def )
        {
            if ( parent::validField ($def) && strcmp ( strtolower($key) , 'deleted' ) != 0)
            {
                $this->_fielddefs [ strtolower ( $key ) ] = $def ;
                //$GLOBALS['log']->debug( get_class($this)."->__construct(): including ".print_r($def,true) );
            }
            else
            {
                //$GLOBALS['log']->debug( get_class($this)."->__construct(): removing $key from _fielddefs as it fails the test for inclusion");
            }
        }

        //$GLOBALS['log']->debug( get_class($this)."->__construct(): remaining entries in _fielddefs are: ".implode(",",array_keys($this->_fielddefs)));
    
    }

    function getLanguage ()
    {
        return $this->_moduleName ;
    }

    /*
     * Save a draft layout
     * @param array defs    Layout definition in the same format as received by the constructor
     */
    function save ($defs)
    {
        $this->_history->append ( $this->_sourceFilename ) ;
        $GLOBALS [ 'log' ]->debug ( get_class ( $this ) . "->save(): writing to " . $this->getFileName ( $this->_view, $this->_moduleName, MB_WORKINGMETADATALOCATION ) ) ;
        $this->_saveToFile ( $this->getFileName ( $this->_view, $this->_moduleName, MB_WORKINGMETADATALOCATION ), $defs ) ;
    }

    /*
     * Deploy a layout
     * @param array defs    Layout definition in the same format as received by the constructor
     */
    function deploy ($defs)
    {
        $this->_history->append ( $this->_sourceFilename ) ;
        // when we deploy get rid of the working file; we have the changes in the MB_CUSTOMMETADATALOCATION so no need for a redundant copy in MB_WORKINGMETADATALOCATION
        // this also simplifies manual editing of layouts. You can now switch back and forth between Studio and manual changes without having to keep these two locations in sync
        $workingFilename = $this->getFileName ( $this->_view, $this->_moduleName, MB_WORKINGMETADATALOCATION ) ;
        if (file_exists ( $workingFilename ))
            unlink ( $this->getFileName ( $this->_view, $this->_moduleName, MB_WORKINGMETADATALOCATION ) ) ;
        $filename = $this->getFileName ( $this->_view, $this->_moduleName, MB_CUSTOMMETADATALOCATION ) ;
        $GLOBALS [ 'log' ]->debug ( get_class ( $this ) . "->deploy(): writing to " . $filename ) ;
        $this->_saveToFile ( $filename, $defs ) ;
        // now clear the cache so that the results are immediately visible
        include_once ('include/TemplateHandler/TemplateHandler.php') ;
        TemplateHandler::clearCache ( $this->_moduleName ) ;
    }

    /*
     * Construct a full pathname for the requested metadata
     * Can be called statically 
     * @param string view           The view type, that is, EditView, DetailView etc
     * @param string modulename     The name of the module that will use this layout
     * @param string type           
     */
    public static function getFileName ($view , $moduleName , $type = MB_CUSTOMMETADATALOCATION)
    {
        $_filenames = array ( MB_LISTVIEW => 'listviewdefs' , MB_SEARCHVIEW => 'searchdefs' , MB_EDITVIEW => 'editviewdefs' , MB_DETAILVIEW => 'detailviewdefs' , MB_QUICKCREATE => 'quickcreatedefs' ) ;
        $_pathMap = array ( MB_BASEMETADATALOCATION => '' , MB_CUSTOMMETADATALOCATION => 'custom/' , MB_WORKINGMETADATALOCATION => 'custom/working/' , MB_HISTORYMETADATALOCATION => 'custom/history/' ) ;
        $type = strtolower ( $type ) ;
        
        // BEGIN ASSERTIONS
        if (! isset ( $_pathMap [ $type ] ))
        {
            sugar_die ( "DeployedMetaDataImplementation: Type $type is not recognized" ) ;
        }
        // END ASSERTIONS
        

        // Construct filename
        return $_pathMap [ $type ] . 'modules/' . $moduleName . '/metadata/' . $_filenames [ $view ] . '.php' ;
    }
}