2020-05-17 02:28:30 +02:00
|
|
|
|
// swad_exam_print.h: exam prints (each copy of an exam in a session for a student)
|
2020-05-07 12:57:12 +02:00
|
|
|
|
|
|
|
|
|
#ifndef _SWAD_EXA_PRN
|
|
|
|
|
#define _SWAD_EXA_PRN
|
|
|
|
|
/*
|
|
|
|
|
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.
|
2024-02-07 00:40:28 +01:00
|
|
|
|
Copyright (C) 1999-2024 Antonio Ca<EFBFBD>as Vargas
|
2020-05-07 12:57:12 +02:00
|
|
|
|
|
|
|
|
|
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 **********************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
2020-05-17 02:28:30 +02:00
|
|
|
|
#include "swad_test_print.h"
|
|
|
|
|
|
2020-05-07 12:57:12 +02:00
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
/************************* Public types and constants ************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
2020-05-16 02:04:36 +02:00
|
|
|
|
#define ExaPrn_MAX_QUESTIONS_PER_EXAM_PRINT 100 // Absolute maximum number of questions in an exam print
|
|
|
|
|
|
2020-06-18 20:06:17 +02:00
|
|
|
|
struct ExaPrn_NumQuestions
|
|
|
|
|
{
|
|
|
|
|
unsigned All; // Total number of questions
|
2020-06-22 19:27:23 +02:00
|
|
|
|
unsigned NotBlank; // Answered questions (valid or not)
|
|
|
|
|
struct
|
|
|
|
|
{
|
|
|
|
|
struct
|
|
|
|
|
{
|
|
|
|
|
unsigned Negative;
|
|
|
|
|
unsigned Zero;
|
|
|
|
|
unsigned Positive;
|
|
|
|
|
} Wrong;
|
|
|
|
|
unsigned Correct;
|
|
|
|
|
unsigned Blank;
|
|
|
|
|
unsigned Total;
|
|
|
|
|
} Valid; // Number of valid questions
|
2020-06-18 20:06:17 +02:00
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
struct ExaPrn_Score
|
|
|
|
|
{
|
|
|
|
|
double All; // Total score of the exam print (counting valid and invalid questions)
|
|
|
|
|
double Valid; // Total score of the exam print (counting only valid questions)
|
|
|
|
|
};
|
|
|
|
|
|
2020-05-16 02:04:36 +02:00
|
|
|
|
struct ExaPrn_Print
|
|
|
|
|
{
|
2020-06-18 20:06:17 +02:00
|
|
|
|
long PrnCod; // Exam print code
|
|
|
|
|
long SesCod; // Session code associated to this print
|
|
|
|
|
long UsrCod; // User who answered the exam print
|
2020-05-16 02:04:36 +02:00
|
|
|
|
time_t TimeUTC[Dat_NUM_START_END_TIME];
|
2020-06-18 20:06:17 +02:00
|
|
|
|
bool Sent; // This exam print has been sent or not?
|
|
|
|
|
// "Sent" means that user has clicked "Send" button after finishing
|
|
|
|
|
struct ExaPrn_NumQuestions NumQsts;
|
|
|
|
|
struct ExaPrn_Score Score;
|
2020-05-16 02:04:36 +02:00
|
|
|
|
struct TstPrn_PrintedQuestion PrintedQuestions[ExaPrn_MAX_QUESTIONS_PER_EXAM_PRINT];
|
|
|
|
|
};
|
|
|
|
|
|
2020-05-07 12:57:12 +02:00
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
/***************************** Public prototypes *****************************/
|
|
|
|
|
/*****************************************************************************/
|
|
|
|
|
|
2020-05-16 02:04:36 +02:00
|
|
|
|
void ExaPrn_ResetPrint (struct ExaPrn_Print *Print);
|
|
|
|
|
|
2020-05-09 21:07:50 +02:00
|
|
|
|
void ExaPrn_ShowExamPrint (void);
|
|
|
|
|
|
2023-03-23 09:35:20 +01:00
|
|
|
|
void ExaPrn_GetPrintDataByPrnCod (struct ExaPrn_Print *Print);
|
|
|
|
|
void ExaPrn_GetPrintDataBySesCodAndUsrCod (struct ExaPrn_Print *Print);
|
2020-05-16 02:04:36 +02:00
|
|
|
|
|
|
|
|
|
void ExaPrn_GetPrintQuestionsFromDB (struct ExaPrn_Print *Print);
|
|
|
|
|
|
2020-05-09 21:07:50 +02:00
|
|
|
|
void ExaPrn_ReceivePrintAnswer (void);
|
|
|
|
|
|
2020-05-13 12:53:27 +02:00
|
|
|
|
void ExaPrn_ComputeAnswerScore (struct TstPrn_PrintedQuestion *PrintedQuestion,
|
2021-10-24 21:35:42 +02:00
|
|
|
|
struct Qst_Question *Question);
|
2020-05-13 12:53:27 +02:00
|
|
|
|
|
2020-05-07 12:57:12 +02:00
|
|
|
|
#endif
|