ILIAS\Questions\Presentation\Views\Participant Class Reference

Collaboration diagram for ILIAS\Questions\Presentation\Views\Participant:

Public Member Functions
	__construct (private readonly Language $lng, private readonly Refinery $refinery, private readonly UIFactory $ui_factory, private readonly HTTP $http, private readonly QuestionRepository $question_repository, private readonly AttemptRepository $attempt_repository, private readonly CapabilitiesFactory $capabilities_factory, array $capability_identifiers, private readonly int $owner_object_id)
	getPresentationIdentifier ()
	withShuffleQuestionOrder (bool $shuffle_question_order)
	getQuestionView (Uuid $question_id, ?Uuid $attempt_id, bool $interactive, bool $show_marks, bool $show_best_response, bool $show_feedback)
	persistResponse (Uuid $question_id, Uuid $attempt_id)
	deleteResponsesFor (Uuid $attempt_id, Uuid $question_id)

Private Attributes
readonly RequiredCapabilities	$required_capabilities
bool	$shuffle_question_order = false
array	$attempt_cache = []

Detailed Description

Definition at line 37 of file Participant.php.

Constructor & Destructor Documentation

__construct()

ILIAS\Questions\Presentation\Views\Participant::__construct	(	private readonly Language	$lng,
		private readonly Refinery	$refinery,
		private readonly UIFactory	$ui_factory,
		private readonly HTTP	$http,
		private readonly QuestionRepository	$question_repository,
		private readonly AttemptRepository	$attempt_repository,
		private readonly CapabilitiesFactory	$capabilities_factory,
		array	$capability_identifiers,
		private readonly int	$owner_object_id
	)

Parameters

list<string>>

$capability_identifiers

Definition at line 48 of file Participant.php.

      {
        $this->required_capabilities = $this->capabilities_factory->get(
            $capability_identifiers
        );
    }

Member Function Documentation

deleteResponsesFor()

ILIAS\Questions\Presentation\Views\Participant::deleteResponsesFor	(	Uuid	$attempt_id,
		Uuid	$question_id
	)

Definition at line 162 of file Participant.php.

     : void {
        $this->attempt_repository->deleteResponsesFor(
            $attempt_id,
            $this->question_repository->getForQuestionId(
                $question_id
            )
        );
    }

getPresentationIdentifier()

ILIAS\Questions\Presentation\Views\Participant::getPresentationIdentifier

(

)

Definition at line 64 of file Participant.php.

                                               : Uuid
    {
        return $this->presentation_identifier;
    }

getQuestionView()

ILIAS\Questions\Presentation\Views\Participant::getQuestionView	(	Uuid	$question_id,
		?Uuid	$attempt_id,
		bool	$interactive,
		bool	$show_marks,
		bool	$show_best_response,
		bool	$show_feedback
	)

Definition at line 77 of file Participant.php.

     : QuestionParticipantView {
        $question = $this->question_repository->getForQuestionId(
            $question_id
        );
 
        $marking_required = $this->required_capabilities->isMarkingRequired();
 
        if ($attempt_id === null
            || !isset($this->attempt_cache[$attempt_id->toString()][$question_id->toString()])) {
            $attempt = $this->attempt_repository->getAttemptFor(
                $attempt_id,
                [$question]
            );
            $attempt_id = $attempt->getId();
            $this->attempt_cache[$attempt_id->toString()][$question_id->toString()] = $attempt;
        }
 
        return $question->getParticipantView(
            $this->lng,
            $this->refinery,
            $this->ui_factory,
            $this->required_capabilities,
            $this->attempt_cache[$attempt_id->toString()][$question_id->toString()],
            $interactive,
            $show_marks && $marking_required,
            $show_best_response && $marking_required,
            $show_feedback && $this->required_capabilities->isCapabilityRequired(
                TextFeedback::getIdentifier()
            )
        );
    }

References ILIAS\Data\UUID\Uuid\toString().

Here is the call graph for this function:

persistResponse()

ILIAS\Questions\Presentation\Views\Participant::persistResponse	(	Uuid	$question_id,
		Uuid	$attempt_id
	)

Definition at line 116 of file Participant.php.

     : void {
        $question = $this->question_repository->getForQuestionId(
            $question_id
        );
 
        $attempt_data = $this->attempt_repository->getAttemptFor(
            $attempt_id,
            [$question]
        );
 
        if ($attempt_data === null) {
            throw new \UnexpectedValueException(
                'The provided attempt identifier is invalid. Response cannot be persisted.'
            );
        }
 
        $response = $this->attempt_repository->getNewResponseFor(
            $question_id,
            $attempt_id
        );
 
        $response_with_values_from_post = array_reduce(
            $question->retrieveAnswerFormResponsesFromPost(
                $this->required_capabilities,
                $this->http->wrapper()->post(),
                $response->getId()
            ),
            fn(Response $c, AnswerFormResponse $v): Response
                => $c->withAnswerFormResponse($v),
            $response
        );
 
        if ($this->required_capabilities->isMarkingRequired()) {
            $response_with_values_from_post = $question->addAwardedPointsToResponse(
                $response_with_values_from_post
            );
        }
 
        $this->attempt_repository->storeResponse(
            $response_with_values_from_post
        );
    }

withShuffleQuestionOrder()

ILIAS\Questions\Presentation\Views\Participant::withShuffleQuestionOrder

(

bool

$shuffle_question_order

)

Definition at line 69 of file Participant.php.

     : self {
        $clone = clone $this;
        $clone->shuffle_question_order = $shuffle_question_order;
        return $clone;
    }

Field Documentation

$attempt_cache

array ILIAS\Questions\Presentation\Views\Participant::$attempt_cache = []

private

Definition at line 43 of file Participant.php.

$required_capabilities

readonly RequiredCapabilities ILIAS\Questions\Presentation\Views\Participant::$required_capabilities

private

Definition at line 39 of file Participant.php.

$shuffle_question_order

bool ILIAS\Questions\Presentation\Views\Participant::$shuffle_question_order = false

private

Definition at line 41 of file Participant.php.

---

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

• components/ILIAS/Questions/src/Presentation/Views/Participant.php