Source for file DBMS_FIELD_IDENTIFLDTREESEL.phpclass

Documentation is available at DBMS_FIELD_IDENTIFLDTREESEL.phpclass

  1. <?php
  2. /**
  3.   * Class file DBMS_FIELD_IDENTIFLDTREESEL.phpclass
  4.   *
  5.   * @project    Open CSP-Management
  6.   * @package    dbms_field
  7.   * @category   any
  8.   *
  9.   * @author     Peter Krebs (pk)<pitlinz@users.sourceforge.net>
  10.   * @license    http://opensource.org/licenses/gpl-license.php GNU Public License
  11.   *
  12.   * @since pk-05-02-19 IDENTIFIEDTREESELECT -> IDENTIFIE<b>L</b>DTREESELECT
  13.   * @version $Id: DBMS_FIELD_IDENTIFLDTREESEL.phpclass,v 1.4 2008/08/12 08:22:38 pitlinz Exp $
  14.   */
  15.  
  16.     // --------------------------------------------------------
  17.     // requirements
  18.     // --------------------------------------------------------
  19.  
  20.     pcf_require_class("DBMS_FIELD_TREESELECT",dirname(__FILE__) . "/");
  21.  
  22. /**
  23.   * Handles foreign keys with a identifier field
  24.   *
  25.   * @project    Open CSP-Management
  26.   * @package    dbms_field
  27.   * @category   any
  28.   *
  29.   * @author     Peter Krebs (pk)<pitlinz@users.sourceforge.net>
  30.   * @license    http://opensource.org/licenses/gpl-license.php GNU Public License
  31.   *
  32.   * @since pk-05-02-19 IDENTIFIEDTREESELECT -> IDENTIFLDTREESEL
  33.   * @version $Id: DBMS_FIELD_IDENTIFLDTREESEL.phpclass,v 1.4 2008/08/12 08:22:38 pitlinz Exp $
  34.   */
  35. class DBMS_FIELD_IDENTIFLDTREESEL extends DBMS_FIELD_TREESELECT {
  36.     var $className          = "IDENTIFLDTREESEL";
  37.     protected $identField         = "";
  38.  
  39.     /**
  40.       * source file of the class
  41.       *
  42.       * @var string $classSrcFile 
  43.       * @since pk-05-02-19
  44.       ***/
  45.     protected $classSrcFile=__FILE__;
  46.  
  47.     /**
  48.       * @var string $sortAdd sorting of sublings
  49.       * @since pk-07-01-07
  50.       ***/
  51.     protected $sortAdd="";
  52.  
  53.     // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  54.     // methods
  55.     // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  56.  
  57.     /**
  58.       * returns an array of field to bie shown in the edit form
  59.       * by using editTbl_echoForm
  60.       *
  61.       * the array is in the form:
  62.       *
  63.       * <code>
  64.       * [_sectionName_]
  65.       *      [TITLE] -> string
  66.       *      [_rowName_]
  67.       *         [FLDLAB]  (complete html code with <td></td>)
  68.       *         [FLDVAL] (complete html code with <td></td>)
  69.       * </code>
  70.       *
  71.       * @param boolean $debug 
  72.       *
  73.       * @returns array
  74.       *
  75.       * @since pk-06-07-04
  76.       *
  77.       ***/
  78.     function editTbl_getFieldEditArr($debug=FALSE) {
  79.         if ($debug) echoDebugMethod(__FILE__,get_class($this),"DBMS_FIELD_IDENTIFLDTREESEL::editTbl_getFieldEditArr()","",0);
  80.         $a_ret=parent::editTbl_getFieldEditArr($debug);
  81.  
  82.         $a_ret['DBLOOKUP']['FLD_SHOWLSTSORT']['FLDVAL']="ORDER BY [IDENTFIELD],<input name=\"sortAdd\" value=\"".htmlspecialchars($this->sortAdd)."\" size=\"40\">";
  83.         $a_ret['DBLOOKUP']['IDENTFIELD']=array(
  84.             'FLDLAB'=>"IDENTIFIER Field:",
  85.             'FLDVAL'=>"<input name=\"identField\" value=\"".$this->identField."\" size=\"40\">"
  86.         );
  87.  
  88.         return $a_ret;
  89.     }
  90.  
  91.  
  92.  
  93.     /**
  94.       * saves the post values from the field definition input form
  95.       */
  96.     function save() {
  97.         $ret =parent::save();
  98.  
  99.         if (isset($_POST['identField']))
  100.         {
  101.             $this->identField            =$_POST['identField'];
  102.             $this->sortField             =$this->identField;
  103.         }
  104.         $this->sortAdd               =((isset($_POST['sortAdd']) && (!empty($_POST['sortAdd']))) ? $_POST['sortAdd'] : "");
  105.         if (!empty($this->sortAdd)) $this->sortField.=",".$this->sortAdd;
  106.  
  107.         return $ret;
  108.     }
  109.  
  110.     // ###########################################
  111.  
  112.     /**
  113.       * returns the select statement for the tree nodes
  114.       *
  115.       * @returns string
  116.       *
  117.       ***/
  118.     function getSelectStmt($debug=FALSE) {
  119.         
  120.         return "";
  121.         
  122.         $debug=($debug || $this->fldDebug);
  123.         if ($debug) echo "<p><b>DBMS_FIELD_IDENTIFLDTREESEL::getSelectStmt(...)</b> (".get_class($this).")</p><blockquote>";
  124.  
  125.         $ret = "SELECT ".$this->showField." AS SHOWFIELD";
  126.         $ret.= ",".$this->keyField." AS KEYFIELD";
  127.         $ret.= ",".$this->parentField." AS PARENTFIELD";
  128.         $ret.= ",".$this->identField." AS IDENTFIELD";
  129.         $ret.= " FROM ".$this->foreignTbl;
  130.  
  131.         if ($debug) echo "<p>$ret</p></blockquote>";
  132.         return $ret;
  133.     }
  134.  
  135.     // ###########################################
  136.  
  137.     /**
  138.       * returns the treedesc array
  139.       *
  140.       * @param string $arrName 
  141.       * @param boolean $debug 
  142.       *
  143.       *  returns array
  144.       *
  145.       ***/
  146.     function getPCF_TreeDesc($arrName="DBVAL",$debug=FALSE) {
  147.         $debug=($debug || $this->fldDebug); // <pk-04-08-31 />
  148.         if ($debug) echo "<p><b>DBMS_FIELD_IDENTIFLDTREESEL::getPCF_TreeDesc($arrName,...)</b> (".get_class($this).")</p><blockquote>";
  149.  
  150.         $dbDesc=parent::getPCF_TreeDesc($arrName);
  151.         $dbDesc['ADDFIELDS'].=(!empty($dbDesc['ADDFIELDS']) ? "," : "") .$this->identField." AS IDENTFIELD";
  152.         if ($debug) echo "<pre>".print_r($dbDesc,TRUE),"<pre></blockquote>";
  153.         return $dbDesc;
  154.     }
  155.  
  156.     // ###########################################
  157.  
  158.     function echoIntededOption($row,$aValue="") {
  159.         echo "\t<option value=\"".$row['KEYFIELD']."\"";
  160.         if ($aValue==$row['KEYFIELD']) echo " selected";
  161.         echo ">".$row['IDENTFIELD'].": ".$row['SHOWFIELD']."</option>\n";
  162.     }
  163.  
  164.     function echoNotIntededOption($row,$aValue="") {
  165.         echo "\t<option value=\"".$row['KEYFIELD']."\"";
  166.         if ($aValue==$row['KEYFIELD']) echo " selected";
  167.         echo ">".$row['SHOWFIELD']." (".$row['IDENTFIELD'].")</option>\n";
  168.     }
  169.  
  170.     
  171.     function getScreenValue($aValue,$arrName="DBVAL",$debug=FALSE) 
  172.     {
  173.         /*
  174.          * @todo
  175.          */ 
  176.         return $aValue;
  177.                 
  178.         $str_query=$this->getSelectStmt();        
  179.         if (!empty($this->lookupWhere))  // <pk-08-01-08>
  180.         {
  181.             require_once __OCSP_PHPINCPATH__."common/pcf_templates.phpinc";
  182.             $str_query.=" WHERE ".pcf_tmpl_parse($this->lookupWhere,${$this->myDataArrName});
  183.         }
  184.         
  185.         $obj_myDB=$this->myForm->getDBObj();
  186.         
  187.         if ($row=$obj_myDB->quickQuery($query)) return $row['IDENTFIELD']." - ".$row['SHOWFIELD'];
  188.         else if (!empty($aValue)) return $aValue;
  189.         return "";
  190.     }
  191.  
  192. }
  193. ?>

Documentation generated on Thu, 08 Jan 2009 17:41:56 +0100 by phpDocumentor 1.4.0a2