SetStatus

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

bool
CFormResult::SetStatus(
	int result_id,
	int status_id,
	string check_rights = "Y"
)

Устанавливает новый статус для результата. Возвращает "true" в случае успеха, в противном случае - "false". Метод нестатический.

Параметры метода

Параметр	Описание
result_id	ID результата.
status_id	ID нового статуса.
check_rights	Флаг необходимости проверки прав текущего пользователя. Возможны следующие значения: Y - права необходимо проверить; N - права не нужно проверять. Для успешной установки нового статуса для указанного результата необходимо обладать следующими правами: На веб-форму к которой принадлежит редактируемый результат: [20] Работа со всеми результатами в соответствии с их статусами или, в случае, если вы являетесь создателем удаляемого результата, достаточно права: [15] Работа со своим результатом в соответствии с его статусом На статус, в котором находится редактируемый результат, необходимо иметь право: [EDIT] редактирование На новый статус status_id необходимо иметь право: [MOVE] перевод результатов в данный статус Параметр необязательный. По умолчанию - "Y" (права необходимо проверить).

Параметр

Описание

result_id

ID результата.

status_id

ID нового статуса.

check_rights

Флаг необходимости проверки прав текущего пользователя. Возможны следующие значения:

Y - права необходимо проверить;
N - права не нужно проверять.

Для успешной установки нового статуса для указанного результата необходимо обладать следующими правами:

На веб-форму к которой принадлежит редактируемый результат:

[20] Работа со всеми результатами в соответствии с их статусами

или, в случае, если вы являетесь создателем удаляемого результата, достаточно права:

[15] Работа со своим результатом в соответствии с его статусом
На статус, в котором находится редактируемый результат, необходимо иметь право:

[EDIT] редактирование
На новый статус status_id необходимо иметь право:

[MOVE] перевод результатов в данный статус

Параметр необязательный. По умолчанию - "Y" (права необходимо проверить).

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

<?
$RESULT_ID = 189; // ID результата
$STATUS_ID = 1; // ID статуса "Опубликовано"

// установим новый статус для результата
// с проверкой прав текущего пользователя
if (CFormResult::SetStatus($RESULT_ID, $STATUS_ID))
{
	echo "Статус #".$STATUS_ID." для результата #".$RESULT_ID." успешно установлен.";
}
else // ошибка
{
	global $strError;
	echo $strError;
}
?>