2021-06-17 13:55:45 +02:00
|
|
|
|
// swad_group_database.h: types of groups and groups operations with database
|
|
|
|
|
|
|
|
|
|
#ifndef _SWAD_GRP_DB
|
|
|
|
|
#define _SWAD_GRP_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-2021 Antonio Ca<EFBFBD>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 ***********************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
2021-06-17 19:39:08 +02:00
|
|
|
|
#include "swad_group.h"
|
2021-06-17 13:55:45 +02:00
|
|
|
|
|
|
|
|
|
/*****************************************************************************/
|
2021-07-08 15:00:17 +02:00
|
|
|
|
/**************************** Public prototypes ******************************/
|
2021-06-17 13:55:45 +02:00
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
|
|
|
|
void Grp_DB_LockTables (void);
|
|
|
|
|
void Grp_DB_UnlockTables (void);
|
|
|
|
|
|
2021-06-17 19:39:08 +02:00
|
|
|
|
long Grp_DB_CreateGroupType (const struct GroupType *GrpTyp);
|
|
|
|
|
void Grp_DB_CreateGroup (const struct Grp_Groups *Grps);
|
|
|
|
|
|
2021-06-24 20:32:25 +02:00
|
|
|
|
unsigned Grp_DB_GetDataOfGroupTypeByCod (MYSQL_RES **mysql_res,long GrpTypCod);
|
|
|
|
|
unsigned Grp_DB_GetMultipleEnrolmentOfAGroupType (MYSQL_RES **mysql_res,long GrpTypCod);
|
|
|
|
|
unsigned Grp_DB_GetDataOfGroupByCod (MYSQL_RES **mysql_res,long GrpCod);
|
|
|
|
|
|
2021-06-17 19:39:08 +02:00
|
|
|
|
bool Grp_DB_CheckIfGrpExists (long GrpCod);
|
|
|
|
|
bool Grp_DB_CheckIfGrpBelongsToCrs (long GrpCod,long CrsCod);
|
|
|
|
|
|
|
|
|
|
bool Grp_DB_CheckIfGrpTypNameExistsInCurrentCrs (const char *GrpTypName,long GrpTypCod);
|
|
|
|
|
bool Grp_DB_CheckIfGrpNameExistsForGrpTyp (long GrpTypCod,const char *GrpName,long GrpCod);
|
|
|
|
|
|
|
|
|
|
unsigned Grp_DB_CountNumUsrsInGrp (Rol_Role_t Role,long GrpCod);
|
|
|
|
|
unsigned Grp_DB_CountNumUsrsInNoGrpsOfType (Rol_Role_t Role,long GrpTypCod);
|
2021-11-03 11:35:21 +01:00
|
|
|
|
long Grp_DB_GetRamdomStdFromGrp (long GrpCod);
|
2021-10-04 14:36:35 +02:00
|
|
|
|
unsigned Grp_DB_GetUsrsFromCurrentGrpExceptMe (MYSQL_RES **mysql_res);
|
|
|
|
|
unsigned Grp_DB_GetTchsFromCurrentGrpExceptMe (MYSQL_RES **mysql_res);
|
2021-06-17 19:39:08 +02:00
|
|
|
|
|
|
|
|
|
bool Grp_DB_CheckIfIBelongToGrpsOfType (long GrpTypCod);
|
2021-06-24 20:32:25 +02:00
|
|
|
|
bool Grp_DB_CheckIfIBelongToGrp (long GrpCod);
|
2021-11-05 23:41:26 +01:00
|
|
|
|
bool Grp_DB_CheckIfUsrSharesAnyOfMyGrpsInCurrentCrs (long UsrCod);
|
2021-06-17 13:55:45 +02:00
|
|
|
|
|
2021-11-08 19:16:51 +01:00
|
|
|
|
unsigned Grp_DB_GetGrpTypesWithGrpsInCrs (MYSQL_RES **mysql_res,long CrsCod);
|
|
|
|
|
unsigned Grp_DB_GetAllGrpTypesInCrs (MYSQL_RES **mysql_res,long CrsCod);
|
2021-06-18 18:39:21 +02:00
|
|
|
|
|
|
|
|
|
unsigned Grp_DB_GetGrpTypesInCurrentCrsToBeOpened (MYSQL_RES **mysql_res);
|
|
|
|
|
|
2021-06-17 13:55:45 +02:00
|
|
|
|
unsigned Grp_DB_CountNumGrpsInCurrentCrs (void);
|
|
|
|
|
unsigned Grp_DB_CountNumGrpsInThisCrsOfType (long GrpTypCod);
|
2021-11-08 19:16:51 +01:00
|
|
|
|
unsigned Grp_DB_GetGrpsInCrs (MYSQL_RES **mysql_res,long CrsCod);
|
2021-06-17 13:55:45 +02:00
|
|
|
|
unsigned Grp_DB_GetGrpsOfType (MYSQL_RES **mysql_res,long GrpTypCod);
|
|
|
|
|
|
2021-06-25 20:05:58 +02:00
|
|
|
|
unsigned Grp_DB_GetLstCodGrpsInAllCrssUsrBelongs (MYSQL_RES **mysql_res,long UsrCod);
|
|
|
|
|
unsigned Grp_DB_GetLstCodGrpsOfAnyTypeInCurrentCrsUsrBelongs (MYSQL_RES **mysql_res,long UsrCod);
|
|
|
|
|
unsigned Grp_DB_GetLstCodGrpsOfATypeInCurrentCrsUsrBelongs (MYSQL_RES **mysql_res,long UsrCod,long GrpTypCod);
|
|
|
|
|
unsigned Grp_DB_GetLstCodGrpsWithFileZonesInCurrentCrsIBelong (MYSQL_RES **mysql_res);
|
|
|
|
|
unsigned Grp_DB_GetNamesGrpsUsrBelongsTo (MYSQL_RES **mysql_res,
|
|
|
|
|
long UsrCod,long GrpTypCod);
|
|
|
|
|
|
2021-06-17 19:39:08 +02:00
|
|
|
|
long Grp_DB_GetGrpTypeFromGrp (long GrpCod);
|
|
|
|
|
|
|
|
|
|
bool Grp_DB_CheckIfAssociatedToGrp (const char *Table,const char *Field,
|
|
|
|
|
long Cod,long GrpCod);
|
|
|
|
|
bool Grp_DB_CheckIfAssociatedToGrps (const char *Table,const char *Field,long Cod);
|
|
|
|
|
|
2021-06-29 11:07:08 +02:00
|
|
|
|
void Grp_DB_ChangeMandatoryEnrolmentOfAGrpTyp (long GrpTypCod,
|
|
|
|
|
bool NewMandatoryEnrolment);
|
|
|
|
|
void Grp_DB_ChangeMultipleEnrolmentOfAGrpTyp (long GrpTypCod,
|
|
|
|
|
bool NewMultipleEnrolment);
|
|
|
|
|
void Grp_DB_ChangeOpeningTimeOfAGrpTyp (long GrpTypCod,
|
|
|
|
|
bool MustBeOpened,time_t OpenTimeUTC);
|
2021-06-18 18:39:21 +02:00
|
|
|
|
void Grp_DB_ClearMustBeOpened (long GrpTypCod);
|
2021-06-28 14:49:50 +02:00
|
|
|
|
void Grp_DB_OpenGrpsOfType (long GrpTypCod);
|
2021-06-29 11:07:08 +02:00
|
|
|
|
|
2021-06-28 14:49:50 +02:00
|
|
|
|
void Grp_DB_OpenGrp (long GrpCod);
|
|
|
|
|
void Grp_DB_CloseGrp (long GrpCod);
|
|
|
|
|
void Grp_DB_EnableFileZonesGrp (long GrpCod);
|
|
|
|
|
void Grp_DB_DisableFileZonesGrp (long GrpCod);
|
|
|
|
|
void Grp_DB_ChangeGrpTypOfGrp (long GrpCod,long NewGrpTypCod);
|
2021-06-29 11:07:08 +02:00
|
|
|
|
void Grp_DB_ChangeRoomOfGrp (long GrpCod,long NewRooCod);
|
2021-10-13 22:52:59 +02:00
|
|
|
|
void Grp_DB_ResetRoomInGrps (long RooCod);
|
2021-06-29 11:07:08 +02:00
|
|
|
|
void Grp_DB_ChangeMaxStdsOfGrp (long GrpCod,unsigned NewMaxStds);
|
2021-06-18 18:39:21 +02:00
|
|
|
|
|
2021-06-25 20:05:58 +02:00
|
|
|
|
bool Grp_DB_CheckIfAvailableGrpTyp (long GrpTypCod);
|
|
|
|
|
|
2021-06-18 18:59:36 +02:00
|
|
|
|
void Grp_DB_RenameGrpTyp (long GrpTypCod,
|
|
|
|
|
const char NewNameGrpTyp[Grp_MAX_BYTES_GROUP_TYPE_NAME + 1]);
|
|
|
|
|
void Grp_DB_RenameGrp (long GrpCod,
|
|
|
|
|
const char NewNameGrp[Grp_MAX_BYTES_GROUP_NAME + 1]);
|
|
|
|
|
|
2021-06-17 19:39:08 +02:00
|
|
|
|
void Grp_DB_AddUsrToGrp (long UsrCod,long GrpCod);
|
|
|
|
|
|
2021-06-18 18:39:21 +02:00
|
|
|
|
void Grp_DB_RemoveUsrFromGrp (long UsrCod,long GrpCod);
|
2021-06-17 19:39:08 +02:00
|
|
|
|
void Grp_DB_RemUsrFromAllGrpsInCrs (long UsrCod,long CrsCod);
|
|
|
|
|
void Grp_DB_RemUsrFromAllGrps (long UsrCod);
|
|
|
|
|
|
2021-06-28 14:49:50 +02:00
|
|
|
|
void Grp_DB_RemoveUsrsFromGrpsOfCrs (long CrsCod);
|
|
|
|
|
void Grp_DB_RemoveUsrsFromGrpsOfType (long GrpTypCod);
|
|
|
|
|
void Grp_DB_RemoveUsrsFromGrp (long GrpCod);
|
|
|
|
|
|
2021-06-18 18:59:36 +02:00
|
|
|
|
void Grp_DB_RemoveGrpTypesInCrs (long CrsCod);
|
2021-06-28 14:49:50 +02:00
|
|
|
|
void Grp_DB_RemoveGrpType (long GrpTypCod);
|
|
|
|
|
|
|
|
|
|
void Grp_DB_RemoveGrpsInCrs (long CrsCod);
|
|
|
|
|
void Grp_DB_RemoveGrpsOfType (long GrpTypCod);
|
|
|
|
|
void Grp_DB_RemoveGrp (long GrpCod);
|
2021-06-18 18:59:36 +02:00
|
|
|
|
|
2021-06-17 13:55:45 +02:00
|
|
|
|
#endif
|