PROCEDURE Error_NoQuestionList(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает exception «Список вопросов не существует».

PROCEDURE Error_NoQuestion(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает exception «Вопрос не существует».

PROCEDURE Error_NoAnswerVariant(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает exception «Вариант ответа на вопрос не существует».

PROCEDURE Error_SurveyPeriodsOverlap(iQuestionListRgnID PLS_INTEGER, iQuestionListID PLS_INTEGER, iRegionID PLS_INTEGER);

Вызывает exception «Обнаружено пересечение периодов проведения соцопроса в районе».

PROCEDURE Error_SurveyIsNotActive(iQuestionListRgnID PLS_INTEGER, iQuestionListID PLS_INTEGER, iRegionID PLS_INTEGER, dDate DATE);

Вызывает exception «Социологический опрос неактивен на дату».

PROCEDURE Error_NoSession(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает exception «Сессия не найдена».

PROCEDURE Error_SessionIsNotActive(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает exception «Сессия завершена».

PROCEDURE Error_SessionIsLocked(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает exception «Сессия заблокирована».

PROCEDURE Error_InvalidAnswerVariant(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает exception «Недопустимый вариант ответа на вопрос».

PROCEDURE Error_AnswerVariantsAreLocked(iRegionID PLS_INTEGER, iSessionID PLS_INTEGER);

Вызывает exception «Варианты ответа на вопрос заблокированы».

FUNCTION QuestionListExists(iRegionID PLS_INTEGER, iID PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает 1, если список вопросов существует, иначе 0.

FUNCTION QuestionExists(iRegionID PLS_INTEGER, iID PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает 1, если вопрос существует, иначе 0.

FUNCTION AnswerVariantExists(iRegionID PLS_INTEGER, iID PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает 1, если вариант ответа на вопрос существует, иначе 0.

PROCEDURE CheckQuestionListExists(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Проверяет существование списка вопросов и при его отсутствии вызывает exception.

PROCEDURE CheckQuestionExists(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Проверяет существование вопроса и при его отсутствии вызывает exception.

PROCEDURE CheckAnswerVariantExists(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Проверяет существование варианта ответа и при его отсутствии вызывает exception.

PROCEDURE VerifyQuestionListPeriods(iQuestionListRgnID PLS_INTEGER, iQuestionListID PLS_INTEGER, iRegionID PLS_INTEGER := NULL);

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

• iQuestionListRgnID, iQuestionListID - ключ списка вопросов;
  
• iRegionID - ID района, в котором выполняется проверка (если null, то во всех районах).

PROCEDURE CheckQuestionListIsActive(iQuestionListRgnID PLS_INTEGER, iQuestionListID PLS_INTEGER, iRegionID PLS_INTEGER, dDate DATE);

Проверяет, что социологический опрос существует и активен на дату dDate в районе iRegionID.

FUNCTION SessionStart(iQuestionListRgnID PLS_INTEGER, iQuestionListID PLS_INTEGER, iRegionID PLS_INTEGER, iStrict PLS_INTEGER) RETURN PLS_INTEGER;

Создаёт новую сессию проведения опроса и возвращает ID созданной записи сессии.
Параметры:

• iQuestionListRgnID, iQuestionListID - ключ опросника;
  
• iRegionID - ID района, в котором проводится опрос;
  
• iStrict - определяет поведение при отсутствии опросника или в случае, если опрос на текущую дату неактивен.

FUNCTION SessionEnd(iRegionID PLS_INTEGER, iID PLS_INTEGER, iStrict PLS_INTEGER) RETURN PLS_INTEGER;

Завершает указанную сессию.
Параметры:

• iRegionID, iID - ключ сессии;
  
• iStrict - определяет поведение при возникновении ошибки.
  

Возвращает (только при iStrict=0):

• 0 - сессия завершена успешно;
  
• 1 - сессия не существует;
  
• 2 - сессия уже закрыта;
  
• 3 - ошибочная дата закрытия сессии (текущая дата раньше даты открытия сессии);
  
• 4 - сессия заблокирована.
  

При iStrict<>0 всегда возвращает 0, либо вызывает exception.

PROCEDURE CloseActiveSessions(iQuestionListRgnID PLS_INTEGER := NULL, iQuestionListID PLS_INTEGER := NULL, iRegionID PLS_INTEGER := NULL, nMinIdleTime NUMBER := 0);

Завершает все активные сессии, удовлетворяющие заданным параметрам.
Параметры:

• iQuestionListRgnID, iQuestionListID - ключ списка вопросов (если null, то независимо от списка вопросов);
  
• iRegionID - ID района, в котором закрываются сессии (если null, то во всех);
  
• nMinIdleTime - минимальное время неактивности закрываемых сессий в часах (если 0, то все).

FUNCTION SaveAnswer(iRegionID PLS_INTEGER, iSessionID PLS_INTEGER, iAnswerID PLS_INTEGER, iStrict PLS_INTEGER) RETURN PLS_INTEGER;

Сохраняет указанный вариант ответа для вопроса, допускающего выбор только одного варианта ответа.
Параметры:

• iRegionID, iSessionID - ключ сессии;
  
• iAnswerID - ID варианта ответа;
  
• iStrict - определяет поведение при возникновении ошибки.
  

Возвращает (только при iStrict=0):

• 0 - вариант ответа выбран успешно;
  
• 1 - сессия не существует;
  
• 2 - сессия закрыта;
  
• 3 - вариант ответа не существует;
  
• 4 - недопустимый вариант ответа на вопрос;
  
• 5 - ответы на вопрос заблокированы.
  

При iStrict<>0 всегда возвращает 0, либо вызывает exception.