GetList

Описание и параметры

CDBResult
CSaleOrderProps::GetList(
	array arOrder = array(),
	array arFilter = array(),
	array arGroupBy = false,
	array arNavStartParams = false,
	array arSelectFields = array()
);

Метод возвращает результат выборки из свойств заказов в соответствии со своими параметрами. Нестатический метод.

Параметры вызова

array(
	"название_поля1" => "направление_сортировки1",
	"название_поля2" => "направление_сортировки2",
	. . .
)

array(
	"[модификатор1][оператор1]название_поля1" => "значение1",
	"[модификатор2][оператор2]название_поля2" => "значение2",
	. . .
)

array(
	"REQUIED" => "Y"
)

array(
	"название_поля1",
	"группирующая_функция2" => "название_поля2", 
	. . .
)

Возвращаемые значения

Возвращается объект класса CDBResult, содержащий набор ассоциативных массивов параметров свойств с ключами:

Если в качестве параметра arGroupBy передается пустой массив, то метод вернет число записей, удовлетворяющих фильтру.

Пример использования

<?
// Выведем форму для ввода свойств заказа для группы свойств с кодом 5, которые входят в профиль покупателя, для типа плательщика с кодом 2
$db_props = CSaleOrderProps::GetList(
	array("SORT" => "ASC"),
	array(
		"PERSON_TYPE_ID" => 2,
		"PROPS_GROUP_ID" => 5,
		"USER_PROPS" => "Y"
	),
	false,
	false,
	array()
);

if ($props = $db_props->Fetch())
{
	echo "Заполните параметры заказа:<br>";
	do
	{
		echo $props["NAME"];
		if ($props["REQUIED"]=="Y" || 
			$props["IS_EMAIL"]=="Y" || 
			$props["IS_PROFILE_NAME"]=="Y" || 
			$props["IS_LOCATION"]=="Y" || 
			$props["IS_LOCATION4TAX"]=="Y" || 
			$props["IS_PAYER"]=="Y"
		)
		{
		echo "*";
		}
		echo ": ";

		if ($props["TYPE"]=="CHECKBOX")
		{
			echo '<input type="checkbox" class="inputcheckbox" name="ORDER_PROP_'.$props["ID"].'" value="Y"'.(($props["DEFAULT_VALUE"]=="Y")?" checked":"").'>';
		}
		elseif ($props["TYPE"]=="TEXT")
		{
			echo '<input type="text" class="inputtext" size="'.((IntVal($props["SIZE1"])>0)?$props["SIZE1"]:30).'" maxlength="250" value="'.htmlspecialchars($props["DEFAULT_VALUE"]).'" name="ORDER_PROP_'.$props["ID"].'">';
		}
		elseif ($props["TYPE"]=="SELECT")
		{
			echo '<select name="ORDER_PROP_'.$props["ID"].'" size="'.((IntVal($props["SIZE1"])>0)?$props["SIZE1"]:1).'">';
			$db_vars = CSaleOrderPropsVariant::GetList(($by="SORT"), ($order="ASC"), Array("ORDER_PROPS_ID"=>$props["ID"]));
			while ($vars = $db_vars->Fetch())
			{
				echo '<option value="'.$vars["VALUE"].'"'.(($vars["VALUE"]==$props["DEFAULT_VALUE"])?" selected":"").'>'.htmlspecialchars($vars["NAME"]).'</option>';
			}
			echo '</select>';
		}
		elseif ($props["TYPE"]=="MULTISELECT")
		{
			echo '<select multiple name="ORDER_PROP_'.$props["ID"].'[]" size="'.((IntVal($props["SIZE1"])>0)?$props["SIZE1"]:5).'">';
			$arDefVal = Split(",", $props["DEFAULT_VALUE"]);
			for ($i = 0; $i<count($arDefVal); $i++)
				$arDefVal[$i] = Trim($arDefVal[$i]);

			$db_vars = CSaleOrderPropsVariant::GetList(($by="SORT"), ($order="ASC"), Array("ORDER_PROPS_ID"=>$props["ID"]));
			while ($vars = $db_vars->Fetch())
			{
				echo '<option value="'.$vars["VALUE"].'"'.(in_array($vars["VALUE"], $arDefVal)?" selected":"").'>'.htmlspecialchars($vars["NAME"]).'</option>';
			}
			echo '</select>';
		}
		elseif ($props["TYPE"]=="TEXTAREA")
		{
			echo '<textarea rows="'.((IntVal($props["SIZE2"])>0)?$props["SIZE2"]:4).'" cols="'.((IntVal($props["SIZE1"])>0)?$props["SIZE1"]:40).'" name="ORDER_PROP_'.$props["ID"].'">'.htmlspecialchars($props["DEFAULT_VALUE"]).'</textarea>';
		}
		elseif ($props["TYPE"]=="LOCATION")
		{
			echo '<select name="ORDER_PROP_'.$props["ID"].'" size="'.((IntVal($props["SIZE1"])>0)?$props["SIZE1"]:1).'">';
			$db_vars = CSaleLocation::GetList(Array("SORT"=>"ASC", "COUNTRY_NAME_LANG"=>"ASC", "CITY_NAME_LANG"=>"ASC"), array(), LANGUAGE_ID);
			while ($vars = $db_vars->Fetch())
			{
				echo '<option value="'.$vars["ID"].'"'.((IntVal($vars["ID"])==IntVal($props["DEFAULT_VALUE"]))?" selected":"").'>'.htmlspecialchars($vars["COUNTRY_NAME"]." - ".$vars["CITY_NAME"]).'</option>';
			}
			echo '</select>';
		}
		elseif ($props["TYPE"]=="RADIO")
		{
			$db_vars = CSaleOrderPropsVariant::GetList(($by="SORT"), ($order="ASC"), Array("ORDER_PROPS_ID"=>$props["ID"]));
			while ($vars = $db_vars->Fetch())
			{
				echo '<input type="radio" name="ORDER_PROP_'.$props["ID"].'" value="'.$vars["VALUE"].'"'.(($vars["VALUE"]==$props["DEFAULT_VALUE"])?" checked":"").'>'.htmlspecialchars($vars["NAME"]).'<br>';
			}
		}

		if (strlen($props["DESCRIPTION"])>0)
		{
			echo "<br><small>".$props["DESCRIPTION"]."</small>";
		}

		echo "<br>";
	}
	while ($props = $db_props->Fetch());
}
?>