mirror of https://github.com/acanas/swad-core.git
129 lines
6.0 KiB
C
129 lines
6.0 KiB
C
// swad_survey_database.h: surveys, operations with database
|
|
|
|
#ifndef _SWAD_SVY_DB
|
|
#define _SWAD_SVY_DB
|
|
/*
|
|
SWAD (Shared Workspace At a Distance in Spanish),
|
|
is a web platform developed at the University of Granada (Spain),
|
|
and used to support university teaching.
|
|
|
|
This file is part of SWAD core.
|
|
Copyright (C) 1999-2024 Antonio Cañas Vargas
|
|
|
|
This program 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.
|
|
|
|
This program 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 this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
/*****************************************************************************/
|
|
/********************************* Headers ***********************************/
|
|
/*****************************************************************************/
|
|
|
|
#include <mysql/mysql.h> // To access MySQL databases
|
|
|
|
#include "swad_constant.h"
|
|
#include "swad_date.h"
|
|
#include "swad_survey.h"
|
|
|
|
/*****************************************************************************/
|
|
/***************************** Public prototypes *****************************/
|
|
/*****************************************************************************/
|
|
|
|
//-------------------------------- Surveys ------------------------------------
|
|
long Svy_DB_CreateSurvey (const struct Svy_Survey *Svy,const char *Txt);
|
|
void Svy_DB_UpdateSurvey (const struct Svy_Survey *Svy,const char *Txt);
|
|
void Svy_DB_HideOrUnhideSurvey (long SvyCod,
|
|
HidVis_HiddenOrVisible_t HiddenOrVisible);
|
|
void Svy_DB_UpdateNumUsrsNotifiedByEMailAboutSurvey (long SvyCod,
|
|
unsigned NumUsrsToBeNotifiedByEMail);
|
|
|
|
unsigned Svy_DB_GetListSurveys (MYSQL_RES **mysql_res,
|
|
unsigned ScopesAllowed,
|
|
unsigned HiddenAllowed,
|
|
Dat_StartEndTime_t SelectedOrder);
|
|
unsigned Svy_DB_GetSurveyDataByCod (MYSQL_RES **mysql_res,long SvyCod);
|
|
void Svy_DB_GetSurveyTitle (long SvyCod,char *Title,size_t TitleSize);
|
|
unsigned Svy_DB_GetSurveyTitleAndText (MYSQL_RES **mysql_res,long SvyCod);
|
|
void Svy_DB_GetSurveyTxt (long SvyCod,char Txt[Cns_MAX_BYTES_TEXT + 1]);
|
|
bool Svy_DB_CheckIfSimilarSurveyExists (const struct Svy_Survey *Svy);
|
|
unsigned Svy_DB_GetNumCrssWithCrsSurveys (Hie_Level_t Level);
|
|
unsigned Svy_DB_GetNumCrsSurveys (MYSQL_RES **mysql_res,Hie_Level_t Level);
|
|
double Svy_DB_GetNumQstsPerCrsSurvey (Hie_Level_t Level);
|
|
unsigned Svy_DB_GetUsrsFromSurveyExceptMe (MYSQL_RES **mysql_res,long SvyCod);
|
|
|
|
void Svy_DB_RemoveSvy (long SvyCod);
|
|
void Svy_DB_RemoveSvysIn (Hie_Level_t Level,long HieCod);
|
|
|
|
//---------------------------- Surveys groups ---------------------------------
|
|
void Svy_DB_CreateGrp (long SvyCod,long GrpCod);
|
|
|
|
unsigned Svy_DB_GetGrpNamesAssociatedToSvy (MYSQL_RES **mysql_res,long SvyCod);
|
|
Usr_Can_t Svy_DB_CheckIfICanDoThisSurveyBasedOnGrps (long SvyCod);
|
|
|
|
void Svy_DB_RemoveGroupsOfType (long GrpTypCod);
|
|
void Svy_DB_RemoveGroup (long GrpCod);
|
|
void Svy_DB_RemoveGrpsAssociatedToSurvey (long SvyCod);
|
|
void Svy_DB_RemoveGrpsSvysIn (Hie_Level_t Level,long HieCod);
|
|
|
|
//--------------------------- Surveys questions -------------------------------
|
|
long Svy_DB_CreateQuestion (long SvyCod,
|
|
const struct Svy_Question *SvyQst,
|
|
const char Stem[Cns_MAX_BYTES_TEXT + 1]);
|
|
void Svy_DB_UpdateQuestion (long SvyCod,
|
|
const struct Svy_Question *SvyQst,
|
|
const char Stem[Cns_MAX_BYTES_TEXT + 1]);
|
|
void Svy_DB_ChangeIndexesQsts (long SvyCod,unsigned QstInd);
|
|
|
|
unsigned Svy_DB_GetNumQstsSvy (long SvyCod);
|
|
unsigned Svy_DB_GetSurveyQstsCodes (MYSQL_RES **mysql_res,long SvyCod);
|
|
unsigned Svy_DB_GetSurveyQsts (MYSQL_RES **mysql_res,long SvyCod);
|
|
unsigned Svy_DB_GetQstDataByCod (MYSQL_RES **mysql_res,long QstCod,long SvyCod);
|
|
unsigned Svy_DB_GetQstIndFromQstCod (long QstCod);
|
|
unsigned Svy_DB_GetLastQstInd (MYSQL_RES **mysql_res,long SvyCod);
|
|
|
|
void Svy_DB_RemoveQst (long QstCod);
|
|
void Svy_DB_RemoveQstsSvy (long SvyCod);
|
|
void Svy_DB_RemoveQstsSvysIn (Hie_Level_t Level,long HieCod);
|
|
|
|
//---------------------------- Surveys answers --------------------------------
|
|
void Svy_DB_CreateAnswer (long QstCod,unsigned AnsInd,const char *Text);
|
|
void Svy_DB_UpdateAnswerText (long QstCod,unsigned AnsInd,const char *Text);
|
|
void Svy_DB_ResetAnswersSvy (long SvyCod);
|
|
void Svy_DB_IncreaseAnswer (long QstCod,unsigned AnsInd);
|
|
|
|
bool Svy_DB_CheckIfAnswerExists (long QstCod,unsigned AnsInd);
|
|
unsigned Svy_DB_GetAnswersQst (MYSQL_RES **mysql_res,long QstCod);
|
|
Svy_AnswerType_t Svy_DB_ConvertFromStrAnsTypDBToAnsTyp (const char *StrAnsTypeDB);
|
|
|
|
void Svy_DB_RemoveAnswerQst (long QstCod,unsigned AnsInd);
|
|
void Svy_DB_RemoveAnswersQst (long QstCod);
|
|
void Svy_DB_RemoveAnswersSvy (long SvyCod);
|
|
void Svy_DB_RemoveAnswersSvysIn (Hie_Level_t Level,long HieCod);
|
|
|
|
//---------------------------- Surveys comments -------------------------------
|
|
void Svy_DB_CreateComments (long QstCod,const char *Comments);
|
|
unsigned Svy_DB_GetCommentsQst (MYSQL_RES **mysql_res,long QstCod);
|
|
|
|
void Svy_DB_RemoveCommentsQst (long QstCod);
|
|
void Svy_DB_RemoveCommentsSvy (long SvyCod);
|
|
void Svy_DB_RemoveCommentsSvysIn (Hie_Level_t Level,long HieCod);
|
|
|
|
//--------------------- Users who have answered surveys -----------------------
|
|
void Svy_DB_RegisterIHaveAnsweredSvy (long SvyCod);
|
|
|
|
bool Svy_DB_CheckIfIHaveAnsweredSvy (long SvyCod);
|
|
unsigned Svy_DB_GetNumUsrsWhoHaveAnsweredSvy (long SvyCod);
|
|
|
|
void Svy_DB_RemoveUsrsWhoHaveAnsweredSvy (long SvyCod);
|
|
void Svy_DB_RemoveUsrsWhoHaveAnsweredSvysIn (Hie_Level_t Level,long HieCod);
|
|
|
|
#endif
|