Agregar Ajax para buscar una descripcion

* Para añadir una función de AJAX para traer una descripcion de la base de datos a partir de un codigo es de la siguiente manera. En el formulario ("_edit_form.php"), agregar la siguiente línea al comienzo.

<pre>
  <?php echo javascript_include_tag('ajax') ?>
</pre> Luego ubicar dentro del _edit_form, la caja de texto donde se escribira el código al cual le quiero buscar la descripción, por ejemplo en el formulario Unidades Ejecutoras (fordefcatpre) necesito que al tipear el código del Responsable se muestre la descripcion del mismo, en este caso dentro de la caja de texto del codigo del Responsable debemos programar el evento onBlur (perder el foco) para que ejecute un procedimiento que busque en la base de datos la descripción correspondiente y la pinte en la vista de forma inmediata. Para ello la caja de texto del código del responsable queda de la siguiente manera
<pre>
 <?php echo label_for('fordefcatpre[codemp]', __($labels['fordefcatpre{codemp}']), 'class="required" ') ?>
  <div class="content<?php if ($sf_request->hasError('fordefcatpre{codemp}')): ?> form-error<?php endif; ?>">
  <?php if ($sf_request->hasError('fordefcatpre{codemp}')): ?>
    <?php echo form_error('fordefcatpre{codemp}', array('class' => 'form-error-msg')) ?>
  <?php endif; ?>

   <?php echo input_auto_complete_tag('fordefcatpre[codemp]', $fordefcatpre->getCodemp(), 
    'fordefcatpre/autocomplete?ajax=1',  array('autocomplete' => 'off','maxlength' => 16, 'onBlur'=> remote_function(array(
			  'url'      => 'fordefcatpre/ajax',  			   
			  'complete' => 'AjaxJSON(request, json)',
  			  'with' => "'ajax=1&cajtexmos=fordefcatpre_nomemp&cajtexcom=fordefcatpre_codemp&codigo='+this.value"
			  ))),
     array('use_style' => 'true')
  ) 
?></div>
</pre> En el evento onBlur se usa el remote_function que tiene los siguientes parametros
* El url indica el nombre de la funcion a ejecutar, esta función debe crearse en el actions.class con el nombre de executeAjax.
* En el complete se indica la funcion javascripts que se va a ejecutar, esta función ya existe dentro del archivo ajax.js.
*El with son los parametros que deben pasarse a la funcion que se ejecutara en el actions.class
Los parametros del with son necesarios y son los siguientes, 
*El parametro ajax: indica la accion ejecutar dentro de la función executeAjax.
*El parametro cajtexmos: indica el nombre del id de la caja de texto donde se va a colocar la descripción a mostrar.
*El parametro cajtexcom es para el caso de que el valor que se esta tipeando se quiera rellenar con ceros a la izquierda, si es el caso aqui se coloca el nombre de la caja de texto correspondiente, y sino se pasa vacio (' ')
*El parametro codigo,siempre debe ir informado con this.value, que indica el valor que se acaba de tipear.
<br>
 Ahora en el archivo actions.class se debe colocar la siguiente función:
<pre>
 public function executeAjax()
  {
    $cajtexmos=$this->getRequestParameter('cajtexmos');
    $cajtexcom=$this->getRequestParameter('cajtexcom');
    if ($this->getRequestParameter('ajax')=='1')
    {
      $dato=NphojintPeer::getNombre($this->getRequestParameter('codigo'));	  			 
      $output = '[["'.$cajtexmos.'","'.$dato.'",""]]';		 			 	    
    } 	 
    $this->getResponse()->setHttpHeader("X-JSON", '('.$output.')'); 
    return sfView::HEADER_ONLY;
  }	 
</pre>  

Esta función se debe colocar igual en el action.class correspondiente, lo unico que se debe cambiar es la instrucción:

            $dato=NphojintPeer::getNombre($this->getRequestParameter('codigo'));	  			 

Aqui se debe llamar a la función que busque en la base de datos la descripción que se quiere mostrar, para este caso se quiere mostrar la Nombre del responsable  a partir del código, entonces en la clase NphojintPeer cree el metodo que me hace la busqueda.
   Luego en la variable $output se debe crear un arreglo con datos que se necesita la funcion AjaxJSON par mostrarlos en la vista. 
         $output = '[["'.$cajtexmos.'","'.$dato.'",""]]';

  La variable '''$output''' se construye con arreglos de 3 posiciones: 

# Posición se le envia el nombre de la caja de texto donde debe mostrar la descripcion.
# La descripción que se quiere  mostrar.
# El siguiente parametro del arreglo indica si es para completar la caja con ceros o no, para este caso se deja en blanco. 

El segundo arreglo es para indicar que se rellene con ceros a la izquierda, en el 1er parametro se envia el nombre de la caja de texto donde se quiere completar con ceros, el 2do parametro la cantidad de ceros a rellenar, y el tercero se debe colocar 'C' de completar.

En caso, de que el codigo que vaya a utilizar ajax se le tenga que completar con ceros a la izquierda. En la varariable $output, se le agrega otro campo en el arreglo con el numero de ceros ha completar:

<pre>
$dato=FordefprgPeer::getPrograma($this->getRequestParameter('codigo'));
$output = '[["'.$cajtexmos.'","'.$dato.'",""],["'.$cajtexcom.'","3","c"]]';
</pre>

Es importante señalar que la funcion getPrograma de la clase FordefprgPeer.php debemos agregar al código los ceros a la izquierda para que no pierda la busqueda.

<pre>
  public static function getPrograma($codigo)
  {
     return Herramientas::getX('CODPRG','Fordefprg','Desprg',str_pad($codigo,3,0,STR_PAD_LEFT));		
  }
</pre>


Para que auto complete se debe llamar la siguiente función en el actions.class.php
<pre>
public function executeAutocomplete()
  {
	if ($this->getRequestParameter('ajax')=='1')
	{
	  $this->tags=Herramientas::autocompleteAjax('CODEMP','Nphojint','Codemp',$this->getRequestParameter('fordefcatpre[codemp]'));
    }		   
  }   
</pre>

Ademas de agregar esta funcion de debe copiar el archivo autocompleteSucces que se encuentra en la carpeta templates del la forma Fordefcatpre.
Y listo....


== Ajax utilizando filtros ==
Solamente hay que colocar al final de la variable '''$this->tags''', la siguientes estructura
$this->tags=Herramientas::autocompleteAjax('','','','','''array('campo1','campo2','campo2'),array('value1','value2','value3')''');	

donde:
<pre> 
  campo1 = value1
  campo2 = value2
  campo3 = value3
</pre>



<pre>
public function executeAutocomplete()
 {
   if ($this->getRequestParameter('ajax')=='2')
    {   
$this->tags=Herramientas::autocompleteAjax('CODCTA','Contabb','codcta',trim($this->getRequestParameter('bndefcons[ctadepcar]')),array('cargab'),array('C'));	
    }
 }
</pre>