Description of class class. More...

Inheritance diagram for ilExerciseManagementCollectFilesJob:

Collaboration diagram for ilExerciseManagementCollectFilesJob:

Public Member Functions
	__construct ()
	Constructor. More...

	getInputTypes ()

	getOutputType ()

	isStateless ()

	run (array $input, Observer $observer)
	run the job More...

	copyFileToSubDirectory ($a_directory, $a_file)
	Copy a file in the Feedback_files directory TODO use the new filesystem. More...

	getExpectedTimeOfTaskInSeconds ()
	Returns int the amount of seconds this task usually taskes. If your task-duration scales with the the amount of data, try to set a possible high value of try to calculate it. If a task duration exceeds this value, it will be displayed as "possibly failed" to the user More...

	collectSubmissionFiles ()
	Store the zip file which contains all submission files in the target directory. More...

	getExtraColumnsForSubmissionFiles ($a_obj_id, $a_ass_id)
	Get the number of max amount of files submitted by a single user in the assignment. More...

	addLink ($a_row, $a_col, $a_submission_file)
	Mapping the links to use them on the excel. More...

	getAssignmentMembersIds ()

Public Member Functions inherited from ILIAS\BackgroundTasks\Implementation\Tasks\AbstractJob
	getInput ()
	Returns mixed returns the input array More...

Public Member Functions inherited from ILIAS\BackgroundTasks\Implementation\Tasks\AbstractTask
	setInput (array $values)

	getOutput ()

	getInput ()

	getType ()

	unfoldTask ()
	Unfold the task. More...

	getRemoveOption ()
	Returns Option An Option to remove the current task and do some cleanup if possible. This Option is displayed if the Bucket is completed. You do not have to provide an additional Option to remove in your UserInteraction, the remove-Option is added to the list of Options (last position) See also self::getAbortOption(); More...

	getAbortOption ()
	Returns Option In case a Job is failed or did not respond for some time, an Abort-Option is displayed. There is already a Standard-Abort-Option registered, you can override with your own and do some cleanup if possible. More...

Data Fields
const	FBK_DIRECTORY = "Feedback_files"

const	LINK_COLOR = "0,0,255"

const	BG_COLOR = "255,255,255"

const	PARTICIPANT_LASTNAME_COLUMN = 0

const	PARTICIPANT_FIRSTNAME_COLUMN = 1

const	PARTICIPANT_LOGIN_COLUMN = 2

const	SUBMISSION_DATE_COLUMN = 3

const	FIRST_DEFAULT_SUBMIT_COLUMN = 4

const	FIRST_DEFAULT_REVIEW_COLUMN = 5

Data Fields inherited from ILIAS\BackgroundTasks\Implementation\Tasks\AbstractTask
const	MAIN_REMOVE = 'bt_main_remove'

const	MAIN_ABORT = 'bt_main_abort'

Protected Member Functions
	addColumnTitles ()
	Set the Excel column titles. More...

	createUniqueTempDirectory ()

	createTargetDirectory ()
	Create the directory with the assignment title. More...

	createSubmissionsDirectory ()
	Create the directory with the assignment title. More...

	isExcelNeeded ($a_ass_type, $a_has_fbk)

	addCriteriaToExcel ($feedback_giver, $participant_id, $row, $col)
	Add criteria data to the excel. More...

	getFeedbackDirectory (int $participant_id, int $feedback_giver)
	see also bug https://mantis.ilias.de/view.php?id=30999 More...

	collectAssignmentData ($assignment_id)

Protected Member Functions inherited from ILIAS\BackgroundTasks\Implementation\Tasks\AbstractTask
	checkTypes ($values)

	extractType ($value)

Protected Attributes
	$target_directory

	$submissions_directory

	$assignment

	$user_id

	$exercise_id

	$exercise_ref_id

	$temp_dir

	$lng

	$sanitized_title

	$excel

	$criteria_items

	$title_columns

	$ass_types_with_files

	$participant_id

Protected Attributes inherited from ILIAS\BackgroundTasks\Implementation\Tasks\AbstractTask
	$input = []

	$output

Private Attributes
	$logger = null

Detailed Description

Description of class class.

Author: Jesús López lopez.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Definition at line 17 of file class.ilExerciseManagementCollectFilesJob.php.

Constructor & Destructor Documentation

◆ __construct()

ilExerciseManagementCollectFilesJob::__construct ( )

Constructor.

Definition at line 55 of file class.ilExerciseManagementCollectFilesJob.php.

References $DIC, ilExAssignment\TYPE_BLOG, ilExAssignment\TYPE_PORTFOLIO, ilExAssignment\TYPE_UPLOAD, and ilExAssignment\TYPE_UPLOAD_TEAM.

     {
         global $DIC;
         $this->lng = $DIC->language();
         $this->lng->loadLanguageModule('exc');
         //TODO will be deprecated when use the new assignment type interface
         $this->ass_types_with_files = array(
             ilExAssignment::TYPE_UPLOAD,
             ilExAssignment::TYPE_UPLOAD_TEAM,
             ilExAssignment::TYPE_BLOG,
             ilExAssignment::TYPE_PORTFOLIO
         );
         $this->logger = $DIC->logger()->exc();
     }

Member Function Documentation

◆ addColumnTitles()

ilExerciseManagementCollectFilesJob::addColumnTitles ( )

protected

Set the Excel column titles.

Definition at line 165 of file class.ilExerciseManagementCollectFilesJob.php.

Referenced by collectAssignmentData().

     {
         $col = 0;
         foreach ($this->title_columns as $title) {
             $this->excel->setCell(1, $col, $title);
             $col++;
         }
     }

Here is the caller graph for this function:

◆ addCriteriaToExcel()

ilExerciseManagementCollectFilesJob::addCriteriaToExcel	(	$feedback_giver,
		$participant_id,
		$row,
		$col
	)

protected

Add criteria data to the excel.

Parameters

$feedback_giver
$participant_id
$row
$col

Definition at line 270 of file class.ilExerciseManagementCollectFilesJob.php.

References $participant_id, copyFileToSubDirectory(), getFeedbackDirectory(), ilExcCriteria\getInstanceById(), ilExcCriteria\getInstanceByType(), and ilRating\getRatingForUserAndObject().

Referenced by collectAssignmentData().

     {
         $submission = new ilExSubmission($this->assignment, $participant_id);
 
         //Possible TODO: This getPeerReviewValues doesn't return always the same array structure then the client classes have
         //to deal with this. Use only one data structure will avoid this extra work.
         //values can be [19] => "blablablab" or ["text"] => "blablabla"
         $values = $submission->getPeerReview()->getPeerReviewValues($feedback_giver, $participant_id);
 
         foreach ($this->criteria_items as $item) {
             $col++;
 
             //Criteria without catalog doesn't have ID nor TITLE. The criteria instance is given via "type" ilExcCriteria::getInstanceByType
             $crit_id = $item->getId();
             $crit_type = $item->getType();
             $crit_title = $item->getTitle();
             if ($crit_title == "") {
                 $crit_title = $item->getTranslatedType();
             }
 
             if (!in_array($crit_title, $this->title_columns)) {
                 $this->title_columns[] = $crit_title;
             }
             switch ($crit_type) {
                 case 'bool':
                     if ($values[$crit_id] == 1) {
                         $this->excel->setCell($row, $col, $this->lng->txt("yes"));
                     } elseif ($values[$crit_id] == -1) {
                         $this->excel->setCell($row, $col, $this->lng->txt("no"));
                     }
                     break;
                 case 'rating':
                     /*
                      * Get the rating data from the DB in the current less expensive way.
                      * assignment_id -> used in il_rating.obj_id
                      * object type as string ->  used in il_rating.obj_type
                      * participant id -> il_rating.sub_obj_id
                      * "peer_" + criteria_id -> il_rating.sub_obj_type (peer or e.g. peer_12)
                      * peer id -> il_rating.user_id
                      */
                     // Possible TODO: refactor ilExAssignment->getPeerReviewCriteriaCatalogueItems somehow to avoid client
                     // classes to deal with ilExCriteria instances with persistence (by id) or instances on the fly (by type)
                     $sub_obj_type = "peer";
                     if ($crit_id) {
                         $sub_obj_type .= "_" . $crit_id;
                     }
                     $rating = ilRating::getRatingForUserAndObject(
                         $this->assignment->getId(),
                         'ass',
                         $participant_id,
                         $sub_obj_type,
                         $feedback_giver
                     );
                     if ($rating_int = round((int) $rating)) {
                         $this->excel->setCell($row, $col, $rating_int);
                     }
                     break;
                 case 'text':
                     //again another check for criteria id (if instantiated via type)
                     if ($crit_id) {
                         $this->excel->setCell($row, $col, $values[$crit_id]);
                     } else {
                         $this->excel->setCell($row, $col, $values['text']);
                     }
                     break;
                 case 'file':
                     if ($crit_id) {
                         $crit_file_obj = ilExcCriteriaFile::getInstanceById($crit_id);
                     } else {
                         $crit_file_obj = ilExcCriteriaFile::getInstanceByType($crit_type);
                     }
                     $crit_file_obj->setPeerReviewContext($this->assignment, $feedback_giver, $participant_id);
                     $files = $crit_file_obj->getFiles();
 
                     $extra_crit_column = 0;
                     foreach ($files as $file) {
                         if ($extra_crit_column) {
                             $this->title_columns[] = $crit_title . "_" . $extra_crit_column;
                         }
                         $extra_crit_column++;
                         $dir = $this->getFeedbackDirectory($participant_id, $feedback_giver);
                         $this->copyFileToSubDirectory($dir, $file);
                         $this->excel->setCell($row, $col, "./" . $dir . DIRECTORY_SEPARATOR . basename($file));
                         $this->excel->addLink($row, $col, './' . $dir . DIRECTORY_SEPARATOR . basename($file));
                         $this->excel->setColors($this->excel->getCoordByColumnAndRow($col, $row), self::BG_COLOR, self::LINK_COLOR);
                     }
                     break;
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ addLink()

ilExerciseManagementCollectFilesJob::addLink	(	$a_row,
		$a_col,
		$a_submission_file
	)

Mapping the links to use them on the excel.

Parameters

$a_row	int
$a_col	int
$a_submission	ilExSubmission
$a_submission_file	array

Definition at line 406 of file class.ilExerciseManagementCollectFilesJob.php.

References $user_id, ilExSubmission\getDirectoryNameFromUserData(), ilExAssignment\TYPE_BLOG, ilExAssignment\TYPE_PORTFOLIO, and ilExAssignment\TYPE_UPLOAD.

Referenced by collectAssignmentData().

     {
         $user_id = $a_submission_file['user_id'];
         $targetdir = ilExSubmission::getDirectoryNameFromUserData($user_id);
 
         $filepath = './' . $this->lng->txt("exc_ass_submission_zip") . DIRECTORY_SEPARATOR . $targetdir . DIRECTORY_SEPARATOR;
         switch ($this->assignment->getType()) {
             case ilExAssignment::TYPE_UPLOAD:
                 $filepath .= $a_submission_file['filetitle'];
                 break;
 
             case ilExAssignment::TYPE_BLOG:
                 $wsp_tree = new ilWorkspaceTree($user_id);
                 // #12939
                 if (!$wsp_tree->getRootId()) {
                     $wsp_tree->createTreeForUser($user_id);
                 }
                 $node = $wsp_tree->getNodeData((int) $a_submission_file['filetitle']);
                 $filepath .= "blog_" . $node['obj_id'] . DIRECTORY_SEPARATOR . "index.html";
                 break;
 
             case ilExAssignment::TYPE_PORTFOLIO:
                 $filepath .= "prt_" . $a_submission_file['filetitle'] . DIRECTORY_SEPARATOR . "index.html";
                 break;
 
             default:
                 $filepath = "";
         }
         $this->excel->addLink($a_row, $a_col, $filepath);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ collectAssignmentData()

ilExerciseManagementCollectFilesJob::collectAssignmentData ( $assignment_id )

protected

Definition at line 438 of file class.ilExerciseManagementCollectFilesJob.php.

References $i, $participant_id, ilObjUser\_lookupName(), addColumnTitles(), addCriteriaToExcel(), addLink(), collectSubmissionFiles(), createSubmissionsDirectory(), createTargetDirectory(), createUniqueTempDirectory(), ilUtil\getASCIIFilename(), getAssignmentMembersIds(), getExtraColumnsForSubmissionFiles(), isExcelNeeded(), ilExAssignment\TYPE_BLOG, ilExAssignment\TYPE_PORTFOLIO, ilExAssignment\TYPE_TEXT, and ilExAssignment\TYPE_UPLOAD.

Referenced by run().

     {
         $ass_has_feedback = false;
         $ass_has_criteria = false;
 
         //assignment object
         $this->assignment = new ilExAssignment($assignment_id);
         $assignment_type = $this->assignment->getType();
 
         //Sanitized title for excel file and target directory.
         $this->sanitized_title = ilUtil::getASCIIFilename($this->assignment->getTitle());
 
         // directories
         if (!isset($this->temp_dir)) {
             $this->createUniqueTempDirectory();
         }
         $this->createTargetDirectory();
 
         //Collect submission files if needed by assignment type.
         if (in_array($assignment_type, $this->ass_types_with_files)) {
             $this->createSubmissionsDirectory();
             $this->collectSubmissionFiles();
         }
 
         if ($this->assignment->getPeerReview()) {
             $ass_has_feedback = true;
             //obj to get the reviews in the foreach below.
             $peer_review = new ilExPeerReview($this->assignment);
             //default start column for revisions.
             $first_excel_column_for_review = self::FIRST_DEFAULT_REVIEW_COLUMN;
         }
 
         if ($this->isExcelNeeded($assignment_type, $ass_has_feedback)) {
             // PhpSpreadsheet object
             $this->excel = new ilExcel();
 
             //Excel sheet title
             $this->excel->addSheet($this->sanitized_title);
 
             //add common excel Columns
             #25585
             $this->title_columns = array(
                 $this->lng->txt('lastname'),
                 $this->lng->txt('firstname'),
                 $this->lng->txt('login'),
                 $this->lng->txt('exc_last_submission')
             );
             switch ($assignment_type) {
                 case ilExAssignment::TYPE_TEXT:
                     $this->title_columns[] = $this->lng->txt("exc_submission_text");
                     break;
                 case ilExAssignment::TYPE_UPLOAD:
                     $num_columns_submission = $this->getExtraColumnsForSubmissionFiles($this->exercise_id, $assignment_id);
                     if ($num_columns_submission > 1) {
                         for ($i = 1; $i <= $num_columns_submission; $i++) {
                             $this->title_columns[] = $this->lng->txt("exc_submission_file") . " " . $i;
                         }
                     } else {
                         $this->title_columns[] = $this->lng->txt("exc_submission_file");
                     }
 
                     $first_excel_column_for_review += $num_columns_submission - 1;
                     break;
                 default:
                     $this->title_columns[] = $this->lng->txt("exc_submission");
                     break;
             }
             if ($ass_has_feedback) {
                 $this->title_columns[] = $this->lng->txt("exc_peer_review_giver");
                 $this->title_columns[] = $this->lng->txt('exc_last_submission');
             }
 
             //criteria
             //Notice:getPeerReviewCriteriaCatalogueItems can return just an empty instance without data.
             if ($this->criteria_items = $this->assignment->getPeerReviewCriteriaCatalogueItems()) {
                 $ass_has_criteria = true;
             }
 
             if ($this->participant_id > 0) {
                 $participants = array($this->participant_id);
             } else {
                 $participants = $this->getAssignmentMembersIds();
             }
 
             $filter = new ilExerciseMembersFilter($this->exercise_ref_id, $participants, $this->user_id);
             $participants = $filter->filterParticipantsByAccess();
 
             $row = 2;
             // Fill the excel
             foreach ($participants as $participant_id) {
                 $submission = new ilExSubmission($this->assignment, $participant_id);
                 $submission_files = $submission->getFiles();
 
                 if ($submission_files) {
                     $participant_name = ilObjUser::_lookupName($participant_id);
                     $this->excel->setCell($row, self::PARTICIPANT_LASTNAME_COLUMN, $participant_name['lastname']);
                     $this->excel->setCell($row, self::PARTICIPANT_FIRSTNAME_COLUMN, $participant_name['firstname']);
                     $this->excel->setCell($row, self::PARTICIPANT_LOGIN_COLUMN, $participant_name['login']);
 
                     //Get the submission Text
                     if (!in_array($assignment_type, $this->ass_types_with_files)) {
                         foreach ($submission_files as $submission_file) {
                             $this->excel->setCell($row, self::SUBMISSION_DATE_COLUMN, $submission_file['timestamp']);
                             $this->excel->setCell($row, self::FIRST_DEFAULT_SUBMIT_COLUMN, $submission_file['atext']);
                         }
                     } else {
                         $col = self::FIRST_DEFAULT_SUBMIT_COLUMN;
                         foreach ($submission_files as $submission_file) {
                             $this->excel->setCell($row, self::SUBMISSION_DATE_COLUMN, $submission_file['timestamp']);
 
                             if ($assignment_type == ilExAssignment::TYPE_PORTFOLIO || $assignment_type == ilExAssignment::TYPE_BLOG) {
                                 $this->excel->setCell($row, $col, $this->lng->txt("open"));
                             } else {
                                 $this->excel->setCell($row, $col, $submission_file['filetitle']);
                             }
                             $this->excel->setColors($this->excel->getCoordByColumnAndRow($col, $row), self::BG_COLOR, self::LINK_COLOR);
                             $this->addLink($row, $col, $submission_file);
                             $col++; //does not affect blogs and portfolios.
                         }
                     }
 
                     if ($ass_has_feedback) {
                         if ($col < $first_excel_column_for_review) {
                             $col = $first_excel_column_for_review;
                         }
                         $reviews = $peer_review->getPeerReviewsByPeerId($participant_id);
 
                         //extra lines
                         $current_review_row = 0;
                         foreach ($reviews as $review) {
                             //not all reviews are done, we check it via date of review.
                             if ($review['tstamp']) {
                                 $current_review_row++;
                                 if ($current_review_row > 1) {
                                     for ($i = 0; $i < $first_excel_column_for_review; $i++) {
                                         $cell_to_copy = $this->excel->getCell($row, $i);
                                         $this->excel->setCell($row + 1, $i, $cell_to_copy);
                                         if ($i >= self::FIRST_DEFAULT_SUBMIT_COLUMN) {
                                             $this->excel->setColors($this->excel->getCoordByColumnAndRow($i, $row + 1), self::BG_COLOR, self::LINK_COLOR);
                                         }
                                     }
                                     ++$row;
                                 }
                                 
                                 $feedback_giver = $review['giver_id']; // user who made the review.
 
                                 $feedback_giver_name = ilObjUser::_lookupName($feedback_giver);
 
                                 $this->excel->setCell(
                                     $row,
                                     $col,
                                     $feedback_giver_name['lastname'] . ", " . $feedback_giver_name['firstname'] . " [" . $feedback_giver_name['login'] . "]"
                                 );
 
                                 $this->excel->setCell($row, $col + 1, $review['tstamp']);
 
                                 if ($ass_has_criteria) {
                                     $this->addCriteriaToExcel($feedback_giver, $participant_id, $row, $col + 1);
                                 }
                             }
                         }
                     }
 
                     $row++;
                 }
             }
 
             $this->addColumnTitles();
             $this->excel->writeToFile($this->target_directory . "/" . $this->sanitized_title);
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ collectSubmissionFiles()

ilExerciseManagementCollectFilesJob::collectSubmissionFiles ( )

Store the zip file which contains all submission files in the target directory.

TODO -> put the reference of the original code. Possible TODO -> extract this to another BT job.

Definition at line 213 of file class.ilExerciseManagementCollectFilesJob.php.

References $exercise, ilObject\_exists(), ilExSubmission\downloadAllAssignmentFiles(), and ilObjectFactory\getInstanceByObjId().

Referenced by collectAssignmentData().

     {
         $members = array();
 
         $exercise = new ilObjExercise($this->exercise_id, false);
 
         if ($this->participant_id > 0) {
             $exc_members_id = array($this->participant_id);
         } else {
             $exc_members_id = $exercise->members_obj->getMembers();
         }
 
         $filter = new ilExerciseMembersFilter($this->exercise_ref_id, $exc_members_id, $this->user_id);
         $exc_members_id = $filter->filterParticipantsByAccess();
 
         foreach ($exc_members_id as $member_id) {
             $submission = new ilExSubmission($this->assignment, $member_id);
             $submission->updateTutorDownloadTime();
 
             // get member object (ilObjUser)
             if (ilObject::_exists($member_id)) {
                 // adding file metadata
                 foreach ($submission->getFiles() as $file) {
                     $members[$file["user_id"]]["files"][$file["returned_id"]] = $file;
                 }
 
                 $tmp_obj = &ilObjectFactory::getInstanceByObjId($member_id);
                 $members[$member_id]["name"] = $tmp_obj->getFirstname() . " " . $tmp_obj->getLastname();
                 unset($tmp_obj);
             }
         }
 
         ilExSubmission::downloadAllAssignmentFiles($this->assignment, $members, $this->submissions_directory);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ copyFileToSubDirectory()

ilExerciseManagementCollectFilesJob::copyFileToSubDirectory	(	$a_directory,
		$a_file
	)

Copy a file in the Feedback_files directory TODO use the new filesystem.

Parameters

$a_directory	string
$a_file	string

Definition at line 138 of file class.ilExerciseManagementCollectFilesJob.php.

References ilUtil\makeDirParents().

Referenced by addCriteriaToExcel().

     {
         $dir = $this->target_directory . "/" . $a_directory;
 
         if (!is_dir($dir)) {
             ilUtil::makeDirParents($dir);
         }
 
         copy($a_file, $dir . "/" . basename($a_file));
 
         /*global $DIC;
         $fs = $DIC->filesystem();
 
         $fs->storage()->copy($a_file, $this->temp_dir."/".basename($a_file));*/
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createSubmissionsDirectory()

ilExerciseManagementCollectFilesJob::createSubmissionsDirectory ( )

protected

Create the directory with the assignment title.

Definition at line 201 of file class.ilExerciseManagementCollectFilesJob.php.

References ilUtil\createDirectory().

Referenced by collectAssignmentData().

     {
         $this->logger->dump("lang key => " . $this->lng->getLangKey());
         $this->submissions_directory = $this->target_directory . DIRECTORY_SEPARATOR . $this->lng->txt("exc_ass_submission_zip");
         ilUtil::createDirectory($this->submissions_directory);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createTargetDirectory()

ilExerciseManagementCollectFilesJob::createTargetDirectory ( )

protected

Create the directory with the assignment title.

Definition at line 187 of file class.ilExerciseManagementCollectFilesJob.php.

References $sanitized_title, ilExSubmission\getDirectoryNameFromUserData(), and ilUtil\makeDirParents().

Referenced by collectAssignmentData().

     {
         $path = $this->temp_dir . DIRECTORY_SEPARATOR;
         if ($this->participant_id > 0) {
             $user_dir = ilExSubmission::getDirectoryNameFromUserData($this->participant_id);
             $path .= $user_dir . DIRECTORY_SEPARATOR;
         }
         $this->target_directory = $path . $this->sanitized_title;
 
         ilUtil::makeDirParents($this->target_directory);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createUniqueTempDirectory()

ilExerciseManagementCollectFilesJob::createUniqueTempDirectory ( )

protected

Todo:: refactor to new file system access Create unique temp directory

Definition at line 178 of file class.ilExerciseManagementCollectFilesJob.php.

References ilUtil\ilTempnam(), and ilUtil\makeDirParents().

Referenced by collectAssignmentData().

     {
         $this->temp_dir = ilUtil::ilTempnam();
         ilUtil::makeDirParents($this->temp_dir);
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAssignmentMembersIds()

ilExerciseManagementCollectFilesJob::getAssignmentMembersIds ( )

Definition at line 611 of file class.ilExerciseManagementCollectFilesJob.php.

References $DIC, and $ilDB.

Referenced by collectAssignmentData().

     {
         global $DIC;
 
         $ilDB = $DIC->database();
         $members = array();
 
         $set = $ilDB->query("SELECT usr_id" .
             " FROM exc_mem_ass_status" .
             " WHERE ass_id = " . $ilDB->quote($this->assignment->getId(), "integer"));
 
         while ($rec = $ilDB->fetchAssoc($set)) {
             $members[] = $rec['usr_id'];
         }
 
         return $members;
     }

Here is the caller graph for this function:

◆ getExpectedTimeOfTaskInSeconds()

ilExerciseManagementCollectFilesJob::getExpectedTimeOfTaskInSeconds ( )

Returns: int the amount of seconds this task usually taskes. If your task-duration scales with the the amount of data, try to set a possible high value of try to calculate it. If a task duration exceeds this value, it will be displayed as "possibly failed" to the user

Implements ILIAS\BackgroundTasks\Task\Job.

Definition at line 157 of file class.ilExerciseManagementCollectFilesJob.php.

     {
         return 30;
     }

◆ getExtraColumnsForSubmissionFiles()

ilExerciseManagementCollectFilesJob::getExtraColumnsForSubmissionFiles	(	$a_obj_id,
		$a_ass_id
	)

Get the number of max amount of files submitted by a single user in the assignment.

Used to add columns to the excel.

Parameters

$a_obj_id
$a_ass_id

Returns: mixed

Definition at line 379 of file class.ilExerciseManagementCollectFilesJob.php.

References $DIC, $ilDB, $participant_id, and $query.

Referenced by collectAssignmentData().

     {
         global $DIC;
         $ilDB = $DIC->database();
 
         $and = "";
         if ($this->participant_id > 0) {
             $and = " AND user_id = " . $this->participant_id;
         }
 
         $query = "SELECT MAX(max_num) AS max" .
             " FROM (SELECT COUNT(user_id) AS max_num FROM exc_returned" .
             " WHERE obj_id=" . $a_obj_id . ". AND ass_id=" . $a_ass_id . $and . " AND mimetype IS NOT NULL" .
             " GROUP BY user_id) AS COUNTS";
 
         $set = $ilDB->query($query);
         $row = $ilDB->fetchAssoc($set);
         return $row['max'];
     }

Here is the caller graph for this function:

◆ getFeedbackDirectory()

ilExerciseManagementCollectFilesJob::getFeedbackDirectory	(	int	$participant_id,
		int	$feedback_giver
	)

protected

Definition at line 364 of file class.ilExerciseManagementCollectFilesJob.php.

References ilExSubmission\getDirectoryNameFromUserData().

Referenced by addCriteriaToExcel().

                                                                                       : string
     {
         $dir = self::FBK_DIRECTORY . DIRECTORY_SEPARATOR .
             "to_" . ilExSubmission::getDirectoryNameFromUserData($participant_id) . DIRECTORY_SEPARATOR .
             "from_" . ilExSubmission::getDirectoryNameFromUserData($feedback_giver);
         return $dir;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getInputTypes()

ilExerciseManagementCollectFilesJob::getInputTypes ( )

Returns: array

Implements ILIAS\BackgroundTasks\Task.

Definition at line 73 of file class.ilExerciseManagementCollectFilesJob.php.

     {
         return
             [
                 new SingleType(IntegerValue::class),
                 new SingleType(IntegerValue::class),
                 new SingleType(IntegerValue::class),
                 new SingleType(IntegerValue::class),
                 new SingleType(IntegerValue::class)
             ];
     }

◆ getOutputType()

ilExerciseManagementCollectFilesJob::getOutputType ( )

Returns: SingleType

Implements ILIAS\BackgroundTasks\Task.

Definition at line 88 of file class.ilExerciseManagementCollectFilesJob.php.

     {
         return new SingleType(StringValue::class);
     }

◆ isExcelNeeded()

ilExerciseManagementCollectFilesJob::isExcelNeeded	(	$a_ass_type,
		$a_has_fbk
	)

protected

Parameters

$a_ass_type	string
$a_has_fbk	bool

Returns: bool

Definition at line 253 of file class.ilExerciseManagementCollectFilesJob.php.

References ilExAssignment\TYPE_TEXT, and ilExAssignment\TYPE_UPLOAD_TEAM.

Referenced by collectAssignmentData().

     {
         if ($a_ass_type == ilExAssignment::TYPE_TEXT) {
             return true;
         } elseif ($a_has_fbk && $a_ass_type != ilExAssignment::TYPE_UPLOAD_TEAM) {
             return true;
         }
         return false;
     }

Here is the caller graph for this function:

◆ isStateless()

ilExerciseManagementCollectFilesJob::isStateless ( )

Returns: bool returns true iff the job's output ONLY depends on the input. Stateless task results may be cached!

Implements ILIAS\BackgroundTasks\Task\Job.

Definition at line 93 of file class.ilExerciseManagementCollectFilesJob.php.

     {
         return true;
     }

◆ run()

ilExerciseManagementCollectFilesJob::run	(	array	$input,
		Observer	$observer
	)

run the job

Parameters

array	$input
Observer	$observer

Returns: StringValue

Implements ILIAS\BackgroundTasks\Task\Job.

Definition at line 104 of file class.ilExerciseManagementCollectFilesJob.php.

References $assignment, $out, $participant_id, $target_directory, collectAssignmentData(), ilExSubmission\getDirectoryNameFromUserData(), and ilExAssignment\getInstancesByExercise().

     {
         $this->exercise_id = $input[0]->getValue();
         $this->exercise_ref_id = $input[1]->getValue();
         $assignment_id = $input[2]->getValue();
         $participant_id = $input[3]->getValue();
         $this->user_id = $input[4]->getValue();
 
         //if we have assignment
         if ($assignment_id > 0) {
             $this->collectAssignmentData($assignment_id);
             $final_directory = $this->target_directory;
         }
 
         if ($participant_id > 0) {
             $this->participant_id = $participant_id;
             $assignments = ilExAssignment::getInstancesByExercise($this->exercise_id);
             foreach ($assignments as $assignment) {
                 $this->collectAssignmentData($assignment->getId());
             }
             $final_directory = $this->temp_dir . DIRECTORY_SEPARATOR . ilExSubmission::getDirectoryNameFromUserData($participant_id);
         }
 
         $out = new StringValue();
         $out->setValue($final_directory);
         return $out;
     }