Collaboration diagram for ilLTIConsumerResultService:

Public Member Functions
	getMasteryScore ()

	setMasteryScore (float $mastery_score)

	getAvailability ()

	setAvailability (int $availability)

	isAvailable ()

	__construct ()
	Constructor: general initialisations. More...

	handleRequest ()
	Handle an incoming request from the LTI tool provider. More...

Protected Member Functions
	readResult ($request)
	Read a stored result. More...

	replaceResult ($request)
	Replace a stored result. More...

	deleteResult ($request)
	Delete a stored result. More...

	loadResponse ($a_name)
	Load the XML template for the response. More...

	respondUnsupported ()
	Send a response that the operation is not supported This depends on the status of the object. More...

	respondUnknown ()
	Send a "unknown operation" response. More...

	respondBadRequest ($message=null)
	Send a "bad request" response. More...

	respondUnauthorized ($message=null)
	Send an "unauthorized" response. More...

	updateLP ()

Protected Attributes
	$result = null

	$availability = 0

	$mastery_score = 1

	$fields = array()

	$message_ref_id = ''

	$operation = ''

Private Member Functions
	readProperties ($a_obj_id)
	Read the LTI Consumer object properties. More...

	readFields ($a_obj_id)
	Read the LTI Consumer object fields. More...

	checkSignature ($a_key, $a_secret)
	Check the reqest signature. More...

Detailed Description

Definition at line 14 of file class.ilLTIConsumerResultService.php.

Constructor & Destructor Documentation

◆ __construct()

ilLTIConsumerResultService::__construct ( )

Constructor: general initialisations.

Definition at line 100 of file class.ilLTIConsumerResultService.php.

101 {

102 }

Member Function Documentation

◆ checkSignature()

ilLTIConsumerResultService::checkSignature	(	$a_key,
		$a_secret
	)

private

Check the reqest signature.

Returns: mixed Exception or true

Definition at line 392 of file class.ilLTIConsumerResultService.php.

    {
        require_once('./Modules/LTIConsumer/lib/OAuth.php');
        require_once('./Modules/LTIConsumer/lib/TrivialOAuthDataStore.php');
 
        $store = new TrivialOAuthDataStore();
        $store->add_consumer($this->fields['KEY'], $this->fields['SECRET']);
 
        $server = new OAuthServer($store);
        $method = new OAuthSignatureMethod_HMAC_SHA1();
        $server->add_signature_method($method);
 
        $request = OAuthRequest::from_request();
        try {
            $server->verify_request($request);
        } catch (Exception $e) {
            return $e;
        }
        return true;
    }

References Vendor\Package\$e, $server, $store, fields, and OAuthRequest\from_request().

Referenced by handleRequest().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteResult()

ilLTIConsumerResultService::deleteResult ( $request )

protected

Delete a stored result.

Parameters

SimpleXMLElement $request

Definition at line 233 of file class.ilLTIConsumerResultService.php.

    {
        $this->result->result = null;
        $this->result->save();
 
        #$lp_status = ilLTIConsumerLPStatus::LP_STATUS_IN_PROGRESS_NUM;
        #$lp_percentage = 0;
        #ilLTIConsumerLPStatus::trackResult($this->result->usr_id, $this->result->obj_id, $lp_status, $lp_percentage);
 
        $code = "success";
        $severity = "status";
 
        $response = $this->loadResponse('deleteResult.xml');
        $response = str_replace('{message_id}', md5(rand(0, 999999999)), $response);
        $response = str_replace('{message_ref_id}', $this->message_ref_id, $response);
        $response = str_replace('{operation}', $this->operation, $response);
        $response = str_replace('{code}', $code, $response);
        $response = str_replace('{severity}', $severity, $response);
 
        header('Content-type: application/xml');
        echo $response;
    }

References $response, and loadResponse().

Referenced by handleRequest().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAvailability()

ilLTIConsumerResultService::getAvailability ( )

Returns: int

Definition at line 71 of file class.ilLTIConsumerResultService.php.

                                      : int
    {
        return $this->availability;
    }

References $availability.

◆ getMasteryScore()

ilLTIConsumerResultService::getMasteryScore ( )

Returns: float

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

                                      : float
    {
        return $this->mastery_score;
    }

References $mastery_score.

◆ handleRequest()

ilLTIConsumerResultService::handleRequest ( )

Handle an incoming request from the LTI tool provider.

Definition at line 107 of file class.ilLTIConsumerResultService.php.

    {
        try {
            // get the request as xml
            $xml = simplexml_load_file('php://input');
            $this->message_ref_id = (string) $xml->imsx_POXHeader->imsx_POXRequestHeaderInfo->imsx_messageIdentifier;
            $request = current($xml->imsx_POXBody->children());
            $this->operation = str_replace('Request', '', $request->getName());
 
            $token = ilCmiXapiAuthToken::getInstanceByToken($request->resultRecord->sourcedGUID->sourcedId);
 
            $this->result = ilLTIConsumerResult::getByKeys($token->getObjId(), $token->getUsrId(), false);
            if (empty($this->result)) {
                $this->respondUnauthorized("lti_consumer_results_id not found!");
                return;
            }
 
 
            // check the object status
            $this->readProperties($this->result->obj_id);
 
            if (!$this->isAvailable()) {
                $this->respondUnsupported();
                return;
            }
 
            // Verify the signature
            $this->readFields($this->result->obj_id);
            $result = $this->checkSignature($this->fields['KEY'], $this->fields['SECRET']);
            if ($result instanceof Exception) {
                $this->respondUnauthorized($result->getMessage());
                return;
            }
 
            // Dispatch the operation
            switch ($this->operation) {
                case 'readResult':
                    $this->readResult($request);
                    break;
 
                case 'replaceResult':
                    $this->replaceResult($request);
                    $this->updateLP();
                    break;
 
                case 'deleteResult':
                    $this->deleteResult($request);
                    $this->updateLP();
                    break;
 
                default:
                    $this->respondUnknown();
                    break;
            }
        } catch (Exception $exception) {
            $this->respondBadRequest($exception->getMessage());
        }
    }

References $result, $token, $xml, checkSignature(), deleteResult(), fields, ilLTIConsumerResult\getByKeys(), ilCmiXapiAuthToken\getInstanceByToken(), isAvailable(), readFields(), readProperties(), readResult(), replaceResult(), respondBadRequest(), respondUnauthorized(), respondUnknown(), respondUnsupported(), and updateLP().

Here is the call graph for this function:

◆ isAvailable()

ilLTIConsumerResultService::isAvailable ( )

Returns: bool

Definition at line 87 of file class.ilLTIConsumerResultService.php.

                                  : bool
    {
        if ($this->availability == 0) {
            return false;
        }
        return true;
    }

Referenced by handleRequest().

Here is the caller graph for this function:

◆ loadResponse()

ilLTIConsumerResultService::loadResponse ( $a_name )

protected

Load the XML template for the response.

Parameters

string file name

Returns: string file content

Definition at line 262 of file class.ilLTIConsumerResultService.php.

    {
        return file_get_contents('./Modules/LTIConsumer/responses/' . $a_name);
    }

Referenced by deleteResult(), readResult(), replaceResult(), respondUnknown(), and respondUnsupported().

Here is the caller graph for this function:

◆ readFields()

ilLTIConsumerResultService::readFields ( $a_obj_id )

private

Read the LTI Consumer object fields.

Parameters

integer $a_obj_id

Definition at line 361 of file class.ilLTIConsumerResultService.php.

    {
        global $DIC;
 
        $query = "
                        SELECT lti_ext_provider.provider_key, lti_ext_provider.provider_secret, lti_consumer_settings.launch_key, lti_consumer_settings.launch_secret
                        FROM lti_ext_provider, lti_consumer_settings
                        WHERE lti_ext_provider.id = lti_consumer_settings.provider_id
                        AND lti_consumer_settings.obj_id = %s
                ";
        
        $res = $DIC->database()->queryF($query, array('integer'), array($a_obj_id));
        
        while ($row = $DIC->database()->fetchAssoc($res)) {
            if (strlen($row["launch_key"] > 0)) {
                $this->fields["KEY"] = $row["launch_key"];
            } else {
                $this->fields["KEY"] = $row["provider_key"];
            }
            if (strlen($row["launch_key"] > 0)) {
                $this->fields["SECRET"] = $row["launch_secret"];
            } else {
                $this->fields["SECRET"] = $row["provider_secret"];
            }
        }
    }

References $DIC, $query, $res, and fields.

Referenced by handleRequest().

Here is the caller graph for this function:

◆ readProperties()

ilLTIConsumerResultService::readProperties ( $a_obj_id )

private

Read the LTI Consumer object properties.

Parameters

integer $a_obj_id

Definition at line 336 of file class.ilLTIConsumerResultService.php.

    {
        global $DIC;
 
        $query = "
                        SELECT lti_ext_provider.availability, lti_consumer_settings.mastery_score 
                        FROM lti_ext_provider, lti_consumer_settings
                        WHERE lti_ext_provider.id = lti_consumer_settings.provider_id
                        AND lti_consumer_settings.obj_id = %s
                ";
        
        $res = $DIC->database()->queryF($query, array('integer'), array($a_obj_id));
 
        if ($row = $DIC->database()->fetchAssoc($res)) {
            //$this->properties = $row;
            $this->setAvailability((int) $row['availability']);
            $this->setMasteryScore((float) $row['mastery_score']);
        }
    }

References $DIC, $query, $res, setAvailability(), and setMasteryScore().

Referenced by handleRequest().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ readResult()

ilLTIConsumerResultService::readResult ( $request )

protected

Read a stored result.

Parameters

SimpleXMLElement $request

Definition at line 170 of file class.ilLTIConsumerResultService.php.

    {
        $response = $this->loadResponse('readResult.xml');
        $response = str_replace('{message_id}', md5(rand(0, 999999999)), $response);
        $response = str_replace('{message_ref_id}', $this->message_ref_id, $response);
        $response = str_replace('{operation}', $this->operation, $response);
        $response = str_replace('{result}', $this->result->result, $response);
 
        header('Content-type: application/xml');
        echo $response;
    }

References $response, and loadResponse().

Referenced by handleRequest().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ replaceResult()

ilLTIConsumerResultService::replaceResult ( $request )

protected

Replace a stored result.

Parameters

SimpleXMLElement $request

Definition at line 186 of file class.ilLTIConsumerResultService.php.

    {
        $result = (string) $request->resultRecord->result->resultScore->textString;
        if (!is_numeric($result)) {
            $code = "failure";
            $severity = "status";
            $description = "The result is not a number.";
        } elseif ($result < 0 or $result > 1) {
            $code = "failure";
            $severity = "status";
            $description = "The result is out of range from 0 to 1.";
        } else {
            $this->result->result = (float) $result;
            $this->result->save();
 
            #if ($result >= $this->getMasteryScore())
            #{
            #    $lp_status = ilLTIConsumerLPStatus::LP_STATUS_COMPLETED_NUM;
            #}
            #else
            #{
            #    $lp_status = ilLTIConsumerLPStatus::LP_STATUS_FAILED_NUM;
            #}
            #$lp_percentage = 100 * $result;
            #ilLTIConsumerLPStatus::trackResult($this->result->usr_id, $this->result->obj_id, $lp_status, $lp_percentage);
 
            $code = "success";
            $severity = "status";
            $description = sprintf("Score for %s is now %s", $this->result->id, $this->result->result);
        }
 
        $response = $this->loadResponse('replaceResult.xml');
        $response = str_replace('{message_id}', md5(rand(0, 999999999)), $response);
        $response = str_replace('{message_ref_id}', $this->message_ref_id, $response);
        $response = str_replace('{operation}', $this->operation, $response);
        $response = str_replace('{code}', $code, $response);
        $response = str_replace('{severity}', $severity, $response);
        $response = str_replace('{description}', $description, $response);
 
        header('Content-type: application/xml');
        echo $response;
    }

References $response, $result, if, and loadResponse().

Referenced by handleRequest().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ respondBadRequest()

ilLTIConsumerResultService::respondBadRequest ( $message = null )

protected

Send a "bad request" response.

Parameters

string response message

Definition at line 302 of file class.ilLTIConsumerResultService.php.

    {
        header('HTTP/1.1 400 Bad Request');
        header('Content-type: text/plain');
        if (isset($message)) {
            echo $message;
        } else {
            echo 'This is not a well-formed LTI Basic Outcomes Service request.';
        }
    }

References $message.

Referenced by handleRequest().

Here is the caller graph for this function:

◆ respondUnauthorized()

ilLTIConsumerResultService::respondUnauthorized ( $message = null )

protected

Send an "unauthorized" response.

Parameters

string response message

Definition at line 319 of file class.ilLTIConsumerResultService.php.

    {
        header('HTTP/1.1 401 Unauthorized');
        header('Content-type: text/plain');
        if (isset($message)) {
            echo $message;
        } else {
            echo 'This request could not be authorized.';
        }
    }

References $message.

Referenced by handleRequest().

Here is the caller graph for this function:

◆ respondUnknown()

ilLTIConsumerResultService::respondUnknown ( )

protected

Send a "unknown operation" response.

Definition at line 286 of file class.ilLTIConsumerResultService.php.

    {
        $response = $this->loadResponse('unknown.xml');
        $response = str_replace('{message_id}', md5(rand(0, 999999999)), $response);
        $response = str_replace('{message_ref_id}', $this->message_ref_id, $response);
        $response = str_replace('{operation}', $this->operation, $response);
 
        header('Content-type: application/xml');
        echo $response;
    }

References $response, and loadResponse().

Referenced by handleRequest().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ respondUnsupported()

ilLTIConsumerResultService::respondUnsupported ( )

protected

Send a response that the operation is not supported This depends on the status of the object.

Definition at line 272 of file class.ilLTIConsumerResultService.php.

    {
        $response = $this->loadResponse('unsupported.xml');
        $response = str_replace('{message_id}', md5(rand(0, 999999999)), $response);
        $response = str_replace('{message_ref_id}', $this->message_ref_id, $response);
        $response = str_replace('{operation}', $this->operation, $response);
 
        header('Content-type: application/xml');
        echo $response;
    }

References $response, and loadResponse().

Referenced by handleRequest().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setAvailability()

ilLTIConsumerResultService::setAvailability ( int $availability )

Parameters

int $availability

Definition at line 79 of file class.ilLTIConsumerResultService.php.

    {
        $this->availability = $availability;
    }

References $availability.

Referenced by readProperties().

Here is the caller graph for this function:

◆ setMasteryScore()

ilLTIConsumerResultService::setMasteryScore ( float $mastery_score )

Parameters

float $mastery_score

Definition at line 63 of file class.ilLTIConsumerResultService.php.

    {
        $this->mastery_score = $mastery_score;
    }

References $mastery_score.

Referenced by readProperties().

Here is the caller graph for this function:

◆ updateLP()

ilLTIConsumerResultService::updateLP ( )

protected

Definition at line 413 of file class.ilLTIConsumerResultService.php.

    {
        if (!($this->result instanceof ilLTIConsumerResult)) {
            return;
        }
        
        ilLPStatusWrapper::_updateStatus($this->result->getObjId(), $this->result->getUsrId());
    }