Tomando el control de Sugar CRM. Autor: Joaquín "Everglades" Sorianello Fecha: 24/05/2011 Licencia:

Transcripción

1 1 Tomando el control de Sugar CRM Autor: Joaquín "Everglades" Sorianello Fecha: 24/05/2011 Licencia:

2 2 Esto son los Everglades Esto son los Everglades

3 3 Disclaimer Disclaimer Sobre el Contenido Todo el contenido de esta charla es resultado de investigaciones, suposiciones y corazonadas sobre como el CRM funciona. Lo único que puedo asegurar es que el contenido de estos slides permite trabajar de forma mas limpia y agrega recursos a nuestra caja de herramientas. Sobre los Slides Hay mucho código, siéntanse libres de preguntar todo lo que necesiten

4 4 Elementos de un Módulo Elementos de un Módulo Beans Son los objetos de negocio de la aplicación. En ellos se encuentran y deberían agregarse, todos los métodos que modifican el Bean.

5 5 Vistas Vistas Nos proveen de distintas formas de visualizar la información

6 6 Controlador Controlador Permite crear acciones, que gobiernan el comportamiento global del Bean

7 7 Remojando el Bean Remojando el Bean Todos los Beans de la aplicación heredan de SugarBean Algunos métodos útiles para sobreescribir: retrieve recibe un id, y popula el bean con los datos de la DB Útil para agregar fuentes de datos externas (webservices en nuestro caso) <?php function retrieve($id = -1, $encode=true, $deleted=true) { $this->webservice = new GcoopRestPlazosFijos(); try { $this->array_plazosf = $this->webservice->plazos_fijos_array($id); $this->name = "Plazos Fijos $id"; $this->id = $id; catch (Exception $e) { $this->arrayplazosf = array(); $this->name = 'Ocurrio un Error'.$e->getMessage(); $this->id = 1; return $this;?>

8 8 Remojando el Bean save actualiza o inserta los datos del Bean actual en la base de datos. <?php function save($check_notify=false) { if (empty($this->name)) { $this->name = "Plazo Fijo";?> return parent::save($check_notify);

9 9 Descontrolando el controller Descontrolando el controller Hay varias formas de definir acciones en SugarCRM La forma mas práctica, y fácil de definirlo es crear el archivo controller.php en la raíz del modulo. Los controllers heredan de SugarController Las nuevas acciones se definen con action_nombreaccion En la acción podemos crear lógica para definir que vista se debe mostrar <?php function action_validar() { $this->loadbean(); # Carga el bean, y llama al método validar del mismo # Si la validación es satisfactoria muestra la vista de confirmación if ($this->bean->validar()) { $this->view = 'confirmar'; else { $this->view = 'error'; $this->bean->save();?>

10 10 Avistando la Vista Avistando la Vista Las Vistas se definen en views/* y tienen nombre de la forma view.nombrevista.php Las vistas heredan de ViewDetail, ViewEdit, o SugarView, según el caso <?php class ViewConfirmar extends ViewDetail { function ViewConfirmar() { parent::viewdetail(); $this->options['show_header'] = false; $this->options['show_footer'] = false; function predisplay() { $metadatafile = "modules/$this->module/metadata/confirmviewdefs.php"; $this->dv = new DetailView2(); $this->dv->ss =& $this->ss; $this->dv->setup($this->module, $this->bean, $metadatafile, 'include/detailview/detailview.tpl'); function display() { //definimos los campos readfile("modules/$this->module/views/custom_header.html"); parent::display(); readfile("modules/$this->module/views/custom_footer.html");

11 11 Avistando la Vista En este caso, estamos usando una vista similar a un detail view, y definimos su estructura en el archivo metadata/confirmviewdefs.php <?php $module_name = 'gcoop_plazofijo'; $viewdefs[$module_name]['detailview'] = array( 'templatemeta' => array( 'form' => array( 'buttons'=> array('gcoop_confirm','gcoop_cancel','edit',), 'hideaudit'=>true,), 'maxcolumns' => '2', 'widths' => array( array('label' => '10', 'field' => '30'), array('label' => '10', 'field' => '30'), ),), 'panels' =>array ( 'default' => array ( array( 'cuenta_nrocuenta', 'moneda',), array( 'saldo', 'titulares',),

12 12 Abotonando los Botones Abotonando los Botones En la definición anterior se utilizan los botones GCOOP_CONFIRM GCOOP_CANCEL Hay dos formas de definir nuevos botones: y Usando html custom <?php $viewdefs['accounts']['editview'] = array( 'templatemeta' => array( 'form' => array( 'buttons'=>array( 'SAVE', array('customcode'=> '<input title="{$app.lbl_close_and_create_button_title" '. ' accesskey="{$app.lbl_close_and_create_button_key" '. ' class="button" '. ' onclick="alert(\'hello {$id \')"; '. ' type="submit" '. ' name="button" '. ' value="{$app.lbl_close_and_create_button_label">') )),

13 13 Abotonando los Botones Agregamos el caso en el switch en: include/smarty/plugins/function.sugar_button.php En el caso de que sean para Details Views hay que agregar el nombre del boton en: include/templatehandler/templatehandler.php <?php case "GCOOP_CONFIRM": $view=($_request['action']=='editview')? 'EditView' : (($view=='editview')? 'EditView':$view); return '{if $bean->aclaccess("save")<input title="{$app.lbl_confirm_button_title" accesskey="{$app.lbl_save_button_key" class="button" onclick="this.form.action.value=\'cerrar\';" type="submit" name="button" value="{$app.lbl_confirm_button_label">{/if '; break;

14 14 Preguntas Preguntas