Prerequisites to the portal forms:

- finalize form fields in the order of their dependencies
- introduced the SelectObjectField which will implement an autocomplete (currently remains a drop-down whatever the number of items)
- code refactoring

SVN:trunk[3951]

sources/form/field/selectobjectfield.class.inc.php

@@ -0,0 +1,102 @@
+<?php
+
+// Copyright (C) 2010-2016 Combodo SARL
+//
+//   This file is part of iTop.
+//
+//   iTop is free software; you can redistribute it and/or modify	
+//   it under the terms of the GNU Affero General Public License as published by
+//   the Free Software Foundation, either version 3 of the License, or
+//   (at your option) any later version.
+//
+//   iTop 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 Affero General Public License for more details.
+//
+//   You should have received a copy of the GNU Affero General Public License
+//   along with iTop. If not, see <http://www.gnu.org/licenses/>
+
+namespace Combodo\iTop\Form\Field;
+
+use \Closure;
+use Combodo\iTop\Form\Validator\NotEmptyExtKeyValidator;
+
+/**
+ * Description of SelectObjectField
+ *
+ */
+class SelectObjectField extends Field
+{
+	protected $sOqlQuery;
+	protected $iMaximumComboLength;
+	protected $iMinAutoCompleteChars;
+
+	public function __construct($sId, Closure $onFinalizeCallback = null)
+	{
+		parent::__construct($sId, $onFinalizeCallback);
+		$this->sOqlQuery = null;
+		$this->iMaximumComboLength = null;
+		$this->iMinAutoCompleteChars = 3;
+	}
+
+	public function SetOqlQuery($sOqlQuery)
+	{
+		$this->sOqlQuery = $sOqlQuery;
+	}
+
+	public function SetMaximumComboLength($iMaximumComboLength)
+	{
+		$this->iMaximumComboLength = $iMaximumComboLength;
+	}
+
+	public function SetMinAutoCompleteChars($iMinAutoCompleteChars)
+	{
+		$this->iMinAutoCompleteChars = $iMinAutoCompleteChars;
+	}
+
+	/**
+	 * Sets if the field is mandatory or not.
+	 * Setting the value will automatically add/remove a MandatoryValidator to the Field
+	 *
+	 * @param boolean $bMandatory
+	 * @return \Combodo\iTop\Form\Field\Field
+	 */
+	public function SetMandatory($bMandatory)
+	{
+		// Before changing the property, we check if it was already mandatory. If not, we had the mandatory validator
+		if ($bMandatory && !$this->bMandatory)
+		{
+			$this->AddValidator(new NotEmptyExtKeyValidator());
+		}
+
+		if (!$bMandatory)
+		{
+			foreach ($this->aValidators as $iKey => $oValue)
+			{
+				if ($oValue::Getname() === NotEmptyExtKeyValidator::GetName())
+				{
+					unset($this->aValidators[$iKey]);
+				}
+			}
+		}
+
+		$this->bMandatory = $bMandatory;
+		return $this;
+	}
+
+	public function GetOqlQuery()
+	{
+		return $this->sOqlQuery;
+	}
+
+	public function GetMaximumComboLength()
+	{
+		return $this->iMaximumComboLength;
+	}
+
+	public function GetMinAutoCompleteChars()
+	{
+		return $this->iMinAutoCompleteChars;
+	}
+}