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;
}
?>

Пользовательские комментарии

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.

Наверх