ilOerHarvester Class Reference

Cron job for definition for oer harvesting. More...

Collaboration diagram for ilOerHarvester:

Public Member Functions
	__construct (ilCronJobResult $result)
	run ()

Protected Member Functions
	collect ()
	Collect all obj_ids with copyright settings which are collectable. More...
	filter (array $a_collectable_obj_ids)
	harvest (array $a_collectable_obj_ids)
	harvestObject (ilObject $object)
	deleteObject (int $a_ref_id)
	deleteDeprecated ()

Protected Attributes
ilTree	$tree

Private Attributes
ilLogger	$logger
ilCronJobResult	$cronresult
ilOerHarvesterSettings	$settings

Detailed Description

Cron job for definition for oer harvesting.

Author

Stefan Meyer smeye.nosp@m.r.il.nosp@m.ias@g.nosp@m.mx.d.nosp@m.e

Definition at line 13 of file class.ilOerHarvester.php.

Constructor & Destructor Documentation

__construct()

ilOerHarvester::__construct

(

ilCronJobResult

$result

)

Definition at line 23 of file class.ilOerHarvester.php.

References $DIC, ilOerHarvesterSettings\getInstance(), ILIAS\Repository\logger(), and ILIAS\Repository\settings().

    {
        global $DIC;

        $this->tree = $DIC->repositoryTree();
        $this->logger = $DIC->logger()->meta();
        $this->cronresult = $result;
        $this->settings = ilOerHarvesterSettings::getInstance();
    }

Here is the call graph for this function:

Member Function Documentation

collect()

ilOerHarvester::collect ( )

protected

Collect all obj_ids with copyright settings which are collectable.

Returns

int[]

Definition at line 64 of file class.ilOerHarvester.php.

References ilLogLevel\DEBUG, ILIAS\Repository\logger(), ilMDRights\lookupRightsByTypeAndCopyright(), and ILIAS\Repository\settings().

Referenced by run().

                                : array
    {
        $collectable_types = $this->settings->getHarvestingTypes();
        $copyright_ids = $this->settings->getCopyRightTemplatesInLomFormat();

        $collectable_obj_ids = ilMDRights::lookupRightsByTypeAndCopyright(
            $collectable_types,
            $copyright_ids
        );

        $this->logger->debug('Found ' . count($collectable_types) . ' collectable objects.');
        $this->logger->dump($collectable_obj_ids, ilLogLevel::DEBUG);

        return $collectable_obj_ids;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

deleteDeprecated()

ilOerHarvester::deleteDeprecated ( )

protected

Definition at line 175 of file class.ilOerHarvester.php.

References $ref_id, ilMDRights\_lookupDescription(), ilObject\_lookupObjId(), deleteObject(), ILIAS\Repository\logger(), ilOerHarvesterObjectStatus\lookupHarvested(), and ILIAS\Repository\settings().

Referenced by run().

                                         : int
    {
        $num_deleted = 0;
        foreach (ilOerHarvesterObjectStatus::lookupHarvested() as $ref_id) {
            $obj_id = ilObject::_lookupObjId($ref_id);

            // blocked items are always deleted
            $status = new ilOerHarvesterObjectStatus($obj_id);
            if ($status->isBlocked()) {
                $this->logger->debug('Deleting blocked object ressource.');
                $this->deleteObject($ref_id);
                $num_deleted++;
                continue;
            }

            $copyright = ilMDRights::_lookupDescription($obj_id, $obj_id);
            $is_valid = false;
            foreach ($this->settings->getCopyRightTemplatesInLomFormat() as $cp) {
                if (strcmp($copyright, $cp) === 0) {
                    $is_valid = true;
                }
            }

            if (!$is_valid) {
                $this->logger->debug('Deleting deprecated object with ref_id: ' . $ref_id);
                $this->deleteObject($ref_id);
                $num_deleted++;
            }
        }
        return $num_deleted;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

deleteObject()

ilOerHarvester::deleteObject ( int  $a_ref_id )

protected

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

References ilObjectFactory\getInstanceByRefId(), ILIAS\Repository\logger(), and ilOerHarvesterObjectStatus\lookupObjIdByHarvestingId().

Referenced by deleteDeprecated().

                                                  : bool
    {
        $object = ilObjectFactory::getInstanceByRefId($a_ref_id, false);

        if (!$object instanceof ilObject) {
            $this->logger->warning('Found invalid reference: ' . $a_ref_id);
            return false;
        }
        $this->logger->debug('Deleting reference...');
        $object->delete();

        $status = new ilOerHarvesterObjectStatus(
            ilOerHarvesterObjectStatus::lookupObjIdByHarvestingId($a_ref_id)
        );
        $status->delete();
        return true;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

filter()

ilOerHarvester::filter ( array  $a_collectable_obj_ids )

protected

Parameters

int[]

$a_collectable_obj_ids

Returns

int[]

Definition at line 84 of file class.ilOerHarvester.php.

References $ref_id, ilObject\_getAllReferences(), ilLogLevel\DEBUG, and ILIAS\Repository\logger().

Referenced by run().

                                                           : array
    {
        $filtered = [];
        foreach ($a_collectable_obj_ids as $obj_id) {
            $status = new ilOerHarvesterObjectStatus($obj_id);
            if ($status->isCreated()) {
                $this->logger->debug('Object already created: ' . $obj_id);
                continue;
            }
            if ($status->isBlocked()) {
                $this->logger->debug('Object creation is blocked: ' . $obj_id);
                continue;
            }

            $exists = false;
            foreach (ilObject::_getAllReferences($obj_id) as $ref_id => $tmp) {
                if (!$this->tree->isDeleted($ref_id)) {
                    $exists = true;
                }
            }
            if (!$exists) {
                $this->logger->notice('Ignoring deleted object: ' . $obj_id);
                continue;
            }
            $filtered[] = $obj_id;
        }

        $this->logger->debug('Result after filtering.');
        $this->logger->dump($filtered, ilLogLevel::DEBUG);

        return $filtered;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

harvest()

ilOerHarvester::harvest ( array  $a_collectable_obj_ids )

protected

Parameters

int[]

$a_collectable_obj_ids

Definition at line 120 of file class.ilOerHarvester.php.

References $ref_id, ilObject\_getAllReferences(), ilObjectFactory\getInstanceByRefId(), harvestObject(), and ILIAS\Repository\logger().

Referenced by run().

                                                            : int
    {
        $num = 0;
        foreach ($a_collectable_obj_ids as $obj_id) {
            $ref_ids = ilObject::_getAllReferences($obj_id);
            $ref_id = end($ref_ids);

            $object = ilObjectFactory::getInstanceByRefId($ref_id, false);

            if (!$object instanceof ilObject) {
                $this->logger->warning('Found invalid reference: ' . $ref_id);
            }
            $this->logger->debug('Creating new reference for object: ' . $obj_id);
            $this->harvestObject($object);
            $num++;
        }
        return $num;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

harvestObject()

ilOerHarvester::harvestObject ( ilObject  $object )

protected

Definition at line 139 of file class.ilOerHarvester.php.

References ilObject\createReference(), ilObject\getId(), ILIAS\Repository\logger(), ilObject\putInTree(), ilOerHarvesterObjectStatus\setHarvestRefId(), ilObject\setPermissions(), and ILIAS\Repository\settings().

Referenced by harvest().

                                                      : bool
    {
        $this->logger->debug('Create new reference');
        $new_ref_id = $object->createReference();
        $this->logger->debug('Put in tree');
        $object->putInTree($this->settings->getTarget());
        $this->logger->debug('Set pernissions');
        $object->setPermissions($this->settings->getTarget());

        $this->logger->debug('Set status');
        $status = new ilOerHarvesterObjectStatus($object->getId());
        $status->setHarvestRefId($new_ref_id);
        $status->setBlocked(false);
        $status->save();

        return true;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

run()

ilOerHarvester::run

(

)

Definition at line 33 of file class.ilOerHarvester.php.

References $cronresult, Vendor\Package\$e, $message, collect(), deleteDeprecated(), filter(), harvest(), ilCronJobResult\setStatus(), ilCronJobResult\STATUS_FAIL, ilCronJobResult\STATUS_NO_ACTION, and ilCronJobResult\STATUS_OK.

                         : ilCronJobResult
    {
        try {
            $obj_ids = $this->collect();
            $obj_ids = $this->filter($obj_ids);
            $num = $this->harvest($obj_ids);

            $message = 'Created ' . $num . ' new objects. <br />';

            $deleted = $this->deleteDeprecated();

            $message .= 'Deleted ' . $deleted . ' deprecated objects.';

            if (!$deleted && !$num) {
                $this->cronresult->setStatus(ilCronJobResult::STATUS_NO_ACTION);
            } else {
                $this->cronresult->setStatus(ilCronJobResult::STATUS_OK);
            }
            $this->cronresult->setMessage($message);
            return $this->cronresult;
        } catch (Exception $e) {
            $this->cronresult->setStatus(ilCronJobResult::STATUS_FAIL);
            $this->cronresult->setMessage($e->getMessage());
            return $this->cronresult;
        }
    }

Here is the call graph for this function:

Field Documentation

$cronresult

ilCronJobResult ilOerHarvester::$cronresult

private

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

Referenced by run().

$logger

ilLogger ilOerHarvester::$logger

private

Definition at line 15 of file class.ilOerHarvester.php.

$settings

ilOerHarvesterSettings ilOerHarvester::$settings

private

Definition at line 19 of file class.ilOerHarvester.php.

$tree

ilTree ilOerHarvester::$tree

protected

Definition at line 21 of file class.ilOerHarvester.php.

---

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

• Services/MetaData/OerHarvester/classes/class.ilOerHarvester.php