ilExerciseTutorFeedbackFileMigration Class Reference

Inheritance diagram for ilExerciseTutorFeedbackFileMigration:

Collaboration diagram for ilExerciseTutorFeedbackFileMigration:

Public Member Functions
	getLabel ()
	getDefaultAmountOfStepsPerRun ()
	Tell the default amount of steps to be executed for one run of the migration. More...
	getPreconditions (Environment $environment)
	Objectives the migration depend on. More...
	prepare (Environment $environment)
	Prepare the migration by means of some environment. More...
	step (Environment $environment)
	Run one step of the migration. More...
	getRemainingAmountOfSteps ()
	Count up how many "things" need to be migrated. More...

Protected Member Functions
	buildAbsolutPath (int $exec_id, int $assignment_id, int $user_id)

Protected Attributes
ilResourceStorageMigrationHelper	$helper

Additional Inherited Members
Data Fields inherited from ILIAS\Setup\Migration
const	INFINITE = -1

Detailed Description

Definition at line 28 of file class.ilExerciseTutorFeedbackFileMigration.php.

Member Function Documentation

buildAbsolutPath()

ilExerciseTutorFeedbackFileMigration::buildAbsolutPath ( int  $exec_id, int  $assignment_id, int  $user_id  )

protected

Definition at line 102 of file class.ilExerciseTutorFeedbackFileMigration.php.

References CLIENT_DATA_DIR, and ilFileSystemAbstractionStorage\createPathFromId().

Referenced by step().

                                                                                       : string
    {
        return CLIENT_DATA_DIR
            . '/ilExercise/'
            . \ilFileSystemAbstractionStorage::createPathFromId(
                $exec_id,
                "exc"
            ) . "/feedb_$assignment_id/$user_id";
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getDefaultAmountOfStepsPerRun()

ilExerciseTutorFeedbackFileMigration::getDefaultAmountOfStepsPerRun

(

)

Tell the default amount of steps to be executed for one run of the migration.

Return Migration::INFINITE if all units should be migrated at once.

Implements ILIAS\Setup\Migration.

Definition at line 37 of file class.ilExerciseTutorFeedbackFileMigration.php.

                                                   : int
    {
        return 1000;
    }

getLabel()

ilExerciseTutorFeedbackFileMigration::getLabel

(

)

Returns

string - a meaningful and concise description for your migration.

Implements ILIAS\Setup\Migration.

Definition at line 32 of file class.ilExerciseTutorFeedbackFileMigration.php.

                              : string
    {
        return "Migration of tutor feedback files to the resource storage service.";
    }

getPreconditions()

ilExerciseTutorFeedbackFileMigration::getPreconditions

(

Environment

$environment

)

Objectives the migration depend on.

Exceptions

UnachievableException

if the objective is not achievable

Returns

Objective[]

Implements ILIAS\Setup\Migration.

Definition at line 42 of file class.ilExerciseTutorFeedbackFileMigration.php.

                                                              : array
    {
        return \ilResourceStorageMigrationHelper::getPreconditions();
    }

getRemainingAmountOfSteps()

ilExerciseTutorFeedbackFileMigration::getRemainingAmountOfSteps

(

)

Count up how many "things" need to be migrated.

This helps the admin to decide how big he can create the steps and also how long a migration takes

Implements ILIAS\Setup\Migration.

Definition at line 92 of file class.ilExerciseTutorFeedbackFileMigration.php.

References Vendor\Package\$d, and $r.

                                               : int
    {
        $r = $this->helper->getDatabase()->query(
            "SELECT count(*) AS amount FROM exc_assignment ass JOIN object_data ob ON ass.exc_id = ob.obj_id JOIN exc_mem_ass_status st ON st.ass_id = ass.id WHERE st.feedback_rcid IS NULL OR st.feedback_rcid = ''"
        );
        $d = $this->helper->getDatabase()->fetchObject($r);

        return (int) $d->amount;
    }

prepare()

ilExerciseTutorFeedbackFileMigration::prepare

(

Environment

$environment

)

Prepare the migration by means of some environment.

This is not supposed to modify the environment, but will be run to prime the migration object to run step and getRemainingAmountOfSteps afterwards.

Implements ILIAS\Setup\Migration.

Definition at line 47 of file class.ilExerciseTutorFeedbackFileMigration.php.

                                                     : void
    {
        $this->helper = new \ilResourceStorageMigrationHelper(
            new \ilExcTutorFeedbackFileStakeholder(),
            $environment
        );
    }

step()

ilExerciseTutorFeedbackFileMigration::step

(

Environment

$environment

)

Run one step of the migration.

Implements ILIAS\Setup\Migration.

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

References Vendor\Package\$d, $r, $user_id, buildAbsolutPath(), and ILIAS\Repository\int().

                                                  : void
    {
        $db = $this->helper->getDatabase();
        $r = $this->helper->getDatabase()->query(
            "SELECT ass.id, ass.exc_id, ob.owner, st.usr_id FROM exc_assignment ass JOIN object_data ob ON ass.exc_id = ob.obj_id JOIN exc_mem_ass_status st ON st.ass_id = ass.id WHERE st.feedback_rcid IS NULL OR st.feedback_rcid = '' LIMIT 1;"
        );
        $d = $this->helper->getDatabase()->fetchObject($r);
        $exec_id = (int) $d->exc_id;
        $assignment_id = (int) $d->id;
        $resource_owner_id = (int) $d->owner;
        $user_id = (int) $d->usr_id;
        $base_path = $this->buildAbsolutPath($exec_id, $assignment_id, $user_id);
        if (is_dir($base_path)) {
            $collection_id = $this->helper->moveFilesOfPathToCollection(
                $base_path,
                $resource_owner_id
            );
        } else {
            $collection = $this->helper->getCollectionBuilder()->new($resource_owner_id);
            if ($this->helper->getCollectionBuilder()->store($collection)) {
                $collection_id = $collection->getIdentification()->serialize();
            } else {
                throw new ilException("Could not build collection");
            }
        }
        $this->helper->getDatabase()->update(
            'exc_mem_ass_status',
            [
                'feedback_rcid' => ['text', $collection_id]
            ],
            [
                'ass_id' => ['integer', $assignment_id],
                'usr_id' => ['integer', $user_id]
            ]
        );
    }

Here is the call graph for this function:

Field Documentation

$helper

ilResourceStorageMigrationHelper ilExerciseTutorFeedbackFileMigration::$helper

protected

Definition at line 30 of file class.ilExerciseTutorFeedbackFileMigration.php.

---

The documentation for this class was generated from the following file:

• components/ILIAS/Exercise/classes/Setup/class.ilExerciseTutorFeedbackFileMigration.php