ilOerHarvester Class Reference

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

Collaboration diagram for ilOerHarvester:

Public Member Functions
	__construct (ilCronJobResult $result)
	ilOerHarvester constructor. More...
	run ()
	run harvester More...

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

Private Attributes
	$logger = null
	$cronresult = null
	$settings = null

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 11 of file class.ilOerHarvester.php.

Constructor & Destructor Documentation

__construct()

ilOerHarvester::__construct

(

ilCronJobResult

$result

)

ilOerHarvester constructor.

Parameters

\ilCronJobResult

$result

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

References $DIC, $result, ilOerHarvesterSettings\getInstance(), and settings().

    {
        global $DIC;

        $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 77 of file class.ilOerHarvester.php.

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

Referenced by run().

    {
        $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

Delete deprecated.

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

References ilMDRights\_lookupDescription(), ilObject\_lookupObjId(), deleteObject(), ilOerHarvesterObjectStatus\lookupHarvested(), and settings().

Referenced by run().

    {
        $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 (   $a_ref_id )

protected

Delete object.

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

References ilObjectFactory\getInstanceByRefId(), and ilOerHarvesterObjectStatus\lookupObjIdByHarvestingId().

Referenced by deleteDeprecated().

    {
        $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();
    }

Here is the call graph for this function:

Here is the caller graph for this function:

filter()

ilOerHarvester::filter (   $a_collectable_obj_ids )

protected

Parameters

int[]

$a_collectable_obj_ids

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

References $DIC, $tree, ilObject\_getAllReferences(), and ilLogLevel\DEBUG.

Referenced by run().

    {
        global $DIC;

        $tree = $DIC->repositoryTree();

        $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 (!$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 (   $a_collectable_obj_ids )

protected

Parameters

int[]

$a_collectable_obj_ids

Returns

bool

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

References ilObject\_getAllReferences(), ilObjectFactory\getInstanceByRefId(), and harvestObject().

Referenced by run().

    {
        $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

Harvest object.

Parameters

$ref_id

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

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

Referenced by harvest().

    {
        $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

(

)

run harvester

Returns

ilCronJobResult

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

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

    {
        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

ilOerHarvester::$cronresult = null

private

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

Referenced by run().

$logger

ilOerHarvester::$logger = null

private

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

$settings

ilOerHarvester::$settings = null

private

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

---

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

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