Inheritance diagram for ilLTIAppEventListener:

Collaboration diagram for ilLTIAppEventListener:

Static Public Member Functions

static handleEvent ($a_component, $a_event, $a_parameter)

Handle an event in a listener.

Parameters

string	$a_component	component, e.g. "Modules/Forum" or "Services/User"
string	$a_event	event e.g. "createUser", "updateUser", "deleteUser", ...
array	$a_parameter	parameter array (assoc), array("name" => ..., "phone_office" => ...)

More...

static handleCronUpdate (ilDateTime $since)

static handleOutcomeWithoutLP ($a_obj_id, $a_usr_id, $a_percentage)

Protected Member Functions
	__construct ()
	ilLTIAppEventListener constructor. More...

	handleUpdateStatus ($a_obj_id, $a_usr_id, $a_status, $a_percentage)
	Handle update status. More...

	doCronUpdate (ilDateTime $since)

	isLTIAuthMode ($auth_mode)

	tryOutcomeService ($resource, $ext_account, $a_status, $a_percentage)
	try outcome service More...

Static Protected Member Functions
static	getInstance ()

Private Attributes
	$logger = null

	$connector = null

Static Private Attributes
static	$instance = null

Detailed Description

Class ilLTIAppEventListener.

Definition at line 7 of file class.ilLTIAppEventListener.php.

Constructor & Destructor Documentation

◆ __construct()

ilLTIAppEventListener::__construct ( )

protected

ilLTIAppEventListener constructor.

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

References $DIC.

     {
         global $DIC;
 
         $this->logger = $DIC->logger()->lti();
         $this->connector = new ilLTIDataConnector();
     }

Member Function Documentation

◆ doCronUpdate()

ilLTIAppEventListener::doCronUpdate ( ilDateTime $since )

protected

Parameters

ilDateTime $since

Exceptions

ilDateTimeException

Definition at line 85 of file class.ilLTIAppEventListener.php.

References $login, ilObjUser\_checkExternalAuthAccount(), ilObjUser\_lookupId(), ilObject\_lookupObjId(), ilLPStatus\_lookupPercentage(), ilLPStatus\_lookupStatus(), and tryOutcomeService().

     {
         $this->logger->debug('Starting cron update for lti outcome service');
 
         $resources = $this->connector->lookupResourcesForAllUsersSinceDate($since);
         foreach ($resources as $consumer_ext_account => $user_resources) {
             list($consumer, $ext_account) = explode('__', $consumer_ext_account, 2);
 
             $login = ilObjUser::_checkExternalAuthAccount('lti_' . $consumer, $ext_account);
             if (!$login) {
                 $this->logger->info('No user found for lti_' . $consumer . ' -> ' . $ext_account);
                 continue;
             }
             $usr_id = ilObjUser::_lookupId($login);
             foreach ($user_resources as $resource_info) {
                 $this->logger->debug('Found resource: ' . $resource_info);
                 list($resource_id, $resource_ref_id) = explode('__', $resource_info);
 
                 // lookup lp status
                 $status = ilLPStatus::_lookupStatus(
                     ilObject::_lookupObjId($resource_ref_id),
                     $usr_id
                 );
                 $percentage = ilLPStatus::_lookupPercentage(
                     ilObject::_lookupObjId($resource_ref_id),
                     $usr_id
                 );
                 $this->tryOutcomeService($resource_id, $ext_account, $status, $percentage);
             }
         }
     }

Here is the call graph for this function:

◆ getInstance()

static ilLTIAppEventListener::getInstance ( )

staticprotected

Returns

Definition at line 39 of file class.ilLTIAppEventListener.php.

     {
         if (!self::$instance instanceof \ilLTIAppEventListener) {
             self::$instance = new self();
         }
         return self::$instance;
     }

◆ handleCronUpdate()

static ilLTIAppEventListener::handleCronUpdate ( ilDateTime $since )

static

Parameters

ilDateTime $since

Returns: bool

Exceptions

ilDateTimeException

Definition at line 194 of file class.ilLTIAppEventListener.php.

Referenced by ilLTICronOutcomeService\run().

     {
         $listener = self::getInstance();
         $listener->doCronUpdate($since);
         return true;
     }

Here is the caller graph for this function:

◆ handleEvent()

static ilLTIAppEventListener::handleEvent	(	$a_component,
		$a_event,
		$a_parameter
	)

static

Handle an event in a listener.

Parameters

string	$a_component	component, e.g. "Modules/Forum" or "Services/User"
string	$a_event	event e.g. "createUser", "updateUser", "deleteUser", ...
array	$a_parameter	parameter array (assoc), array("name" => ..., "phone_office" => ...)

Implements ilAppEventListener.

Definition at line 168 of file class.ilLTIAppEventListener.php.

References $DIC, and $logger.

     {
         global $DIC;
 
         $logger = $DIC->logger()->lti()->debug('Handling event: ' . $a_event . ' from ' . $a_component);
 
         switch ($a_component) {
             case 'Services/Tracking':
                 if ($a_event == 'updateStatus') {
                     $listener = self::getInstance();
                     $listener->handleUpdateStatus(
                         $a_parameter['obj_id'],
                         $a_parameter['usr_id'],
                         $a_parameter['status'],
                         $a_parameter['percentage']
                     );
                 }
                 break;
         }
     }

◆ handleOutcomeWithoutLP()

static ilLTIAppEventListener::handleOutcomeWithoutLP	(	$a_obj_id,
		$a_usr_id,
		$a_percentage
	)

static

Definition at line 202 of file class.ilLTIAppEventListener.php.

References $connector, $DIC, $user, ilObject\_getAllReferences(), ilObjUser\_lookupAuthMode(), ilObjUser\_lookupExternalAccount(), IMSGlobal\LTI\ToolProvider\ResourceLink\fromRecordId(), IMSGlobal\LTI\ToolProvider\User\fromResourceLink(), ilObjectLP\getInstance(), and ilLPObjSettings\LP_MODE_DEACTIVATED.

Referenced by ilSCORM2004StoreData\persistCMIData(), and ilObjSCORMTracking\storeJsApiCmi().

     {
         global $DIC;
         $score = 0;
 
         $auth_mode = ilObjUser::_lookupAuthMode($a_usr_id);
         if (strpos($auth_mode, 'lti_') === false) {
             $DIC->logger()->lti()->debug('Ignoring outcome for non-LTI-user.');
             return false;
         }
         //check if LearningPress enabled
         $olp = ilObjectLP::getInstance($a_obj_id);
         if (ilLPObjSettings::LP_MODE_DEACTIVATED != $olp->getCurrentMode())
         {
             $DIC->logger()->lti()->debug('Ignoring outcome if LP is activated.');
             return false;
         }
 
         if ($a_percentage && $a_percentage > 0) {
             $score = round($a_percentage/100, 4);
         }
 
         $connector = new ilLTIDataConnector();
         $ext_account = ilObjUser::_lookupExternalAccount($a_usr_id);
         list($lti, $consumer) = explode('_', $auth_mode);
 
         // iterate through all references
         $refs = ilObject::_getAllReferences($a_obj_id);
         foreach ((array) $refs as $ref_id) {
             $resources = $connector->lookupResourcesForUserObjectRelation(
                 $ref_id,
                 $ext_account,
                 $consumer
             );
 
             $DIC->logger()->lti()->debug('Resources for update: '.$resources);
 
             foreach ($resources as $resource) {
                 // $this->tryOutcomeService($resource, $ext_account, $a_status, $a_percentage);
                 $resource_link = \IMSGlobal\LTI\ToolProvider\ResourceLink::fromRecordId($resource, $connector);
                 if ($resource_link->hasOutcomesService()) {
                     $user = \IMSGlobal\LTI\ToolProvider\User::fromResourceLink($resource_link, $ext_account);
                     $DIC->logger()->lti()->debug('Sending score: ' . (string) $score);
                     $outcome = new \IMSGlobal\LTI\ToolProvider\Outcome($score);
 
                     $resource_link->doOutcomesService(
                         \IMSGlobal\LTI\ToolProvider\ResourceLink::EXT_WRITE,
                         $outcome,
                         $user
                     );
                 }
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ handleUpdateStatus()

ilLTIAppEventListener::handleUpdateStatus	(	$a_obj_id,
		$a_usr_id,
		$a_status,
		$a_percentage
	)

protected

Handle update status.

Definition at line 51 of file class.ilLTIAppEventListener.php.

References ilObject\_getAllReferences(), ilObjUser\_lookupAuthMode(), ilObjUser\_lookupExternalAccount(), ilLogLevel\DEBUG, isLTIAuthMode(), and tryOutcomeService().

     {
         $this->logger->debug('Handle update status');
         $auth_mode = ilObjUser::_lookupAuthMode($a_usr_id);
         if (!$this->isLTIAuthMode($auth_mode)) {
             $this->logger->debug('Ignoring update for non-LTI-user.');
             return false;
         }
         $ext_account = ilObjUser::_lookupExternalAccount($a_usr_id);
         list($lti, $consumer) = explode('_', $auth_mode);
 
         // iterate through all references
         $refs = ilObject::_getAllReferences($a_obj_id);
         foreach ((array) $refs as $ref_id) {
             $resources = $this->connector->lookupResourcesForUserObjectRelation(
                 $ref_id,
                 $ext_account,
                 $consumer
             );
 
             $this->logger->debug('Resources for update:');
             $this->logger->dump($resources, ilLogLevel::DEBUG);
 
             foreach ($resources as $resource) {
                 $this->tryOutcomeService($resource, $ext_account, $a_status, $a_percentage);
             }
         }
     }

Here is the call graph for this function:

◆ isLTIAuthMode()

ilLTIAppEventListener::isLTIAuthMode ( $auth_mode )

protected

Parameters

$a_usr_id

Returns: bool

Definition at line 121 of file class.ilLTIAppEventListener.php.

Referenced by handleUpdateStatus().

     {
         return strpos($auth_mode, 'lti_') === 0;
     }

Here is the caller graph for this function:

◆ tryOutcomeService()

ilLTIAppEventListener::tryOutcomeService	(	$resource,
		$ext_account,
		$a_status,
		$a_percentage
	)

protected

try outcome service

Definition at line 130 of file class.ilLTIAppEventListener.php.

References $user, IMSGlobal\LTI\ToolProvider\ResourceLink\fromRecordId(), IMSGlobal\LTI\ToolProvider\User\fromResourceLink(), ilLPStatus\LP_STATUS_COMPLETED_NUM, ilLPStatus\LP_STATUS_FAILED_NUM, and ilLPStatus\LP_STATUS_NOT_ATTEMPTED_NUM.

Referenced by doCronUpdate(), and handleUpdateStatus().

     {
         $resource_link = \IMSGlobal\LTI\ToolProvider\ResourceLink::fromRecordId($resource, $this->connector);
         if (!$resource_link->hasOutcomesService()) {
             $this->logger->debug('No outcome service available for resource id: ' . $resource);
             return false;
         }
         $this->logger->debug('Trying outcome service with status ' . $a_status . ' and percentage ' . $a_percentage);
         $user = \IMSGlobal\LTI\ToolProvider\User::fromResourceLink($resource_link, $ext_account);
 
         if ($a_status == ilLPStatus::LP_STATUS_COMPLETED_NUM) {
             $score = 1;
         } elseif (
             $a_status == ilLPStatus::LP_STATUS_FAILED_NUM ||
             $a_status == ilLPStatus::LP_STATUS_NOT_ATTEMPTED_NUM
         ) {
             $score = 0;
         } elseif (!$a_percentage) {
             $score = 0;
         } else {
             $score = (int) $a_percentage / 100;
         }
 
         $this->logger->debug('Sending score: ' . (string) $score);
 
         $outcome = new \IMSGlobal\LTI\ToolProvider\Outcome($score);
 
         $resource_link->doOutcomesService(
             \IMSGlobal\LTI\ToolProvider\ResourceLink::EXT_WRITE,
             $outcome,
             $user
         );
     }