class.ilECSCategoryMapping.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
class ilECSCategoryMapping
{
    private static ?array $cached_active_rules = null;
 
    public static function getActiveRules(): array
    {
        global $DIC;
 
        $ilDB = $DIC['ilDB'];
        $rules = [];
        $res = $ilDB->query('SELECT mapping_id FROM ecs_container_mapping');
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
            $rules[] = new ilECSCategoryMappingRule((int) $row->mapping_id);
        }
        return $rules;
    }
 
    public static function getMatchingCategory(int $a_server_id, array $a_matchable_content): ?int
    {
        global $DIC;
 
        $logger = $DIC->logger()->wsrv();
 
        if (is_null(self::$cached_active_rules)) {
            self::$cached_active_rules = self::getActiveRules();
        }
        foreach (self::$cached_active_rules as $rule) {
            if ($rule->matches($a_matchable_content)) {
                $logger->info(__METHOD__ . ': Found assignment for field type: ' . $rule->getFieldName());
                return $rule->getContainerId();
            }
            $logger->error(__METHOD__ . ': Category assignment failed for field: ' . $rule->getFieldName());
        }
        // Return default container
        $logger->info(__METHOD__ . ': Using default container');
 
        return ilECSSetting::getInstanceByServerId($a_server_id)->getImportId();
    }
 
    public static function handleUpdate(int $a_obj_id, int $a_server_id, array $a_matchable_content): bool
    {
        global $DIC;
 
        $tree = $DIC->repositoryTree();
        $logger = $DIC->logger()->wsrv();
 
        $cat = self::getMatchingCategory($a_server_id, $a_matchable_content);
 
        $a_ref_id = current(ilObject::_getAllReferences($a_obj_id));
        $references = ilObject::_getAllReferences(ilObject::_lookupObjId($a_ref_id));
        $all_cats = self::lookupHandledCategories();
 
        $exists = false;
        foreach (array_keys($references) as $ref_id) {
            if ($tree->getParentId($ref_id) === $cat) {
                $exists = true;
            }
        }
        $logger->info(__METHOD__ . ': Creating/Deleting references...');
 
        if (!$exists) {
            $logger->info(__METHOD__ . ': Add new reference. STEP 1');
 
            if ($obj_data = ilObjectFactory::getInstanceByRefId($a_ref_id, false)) {
                $obj_data->createReference();
                $obj_data->putInTree($cat);
                $obj_data->setPermissions($cat);
                $logger->info(__METHOD__ . ': Add new reference.');
            }
        }
        // Now delete old references
        foreach (array_keys($references) as $ref_id) {
            $parent = $tree->getParentId($ref_id);
            if ($parent === $cat) {
                continue;
            }
            if (!in_array($parent, $all_cats, true)) {
                continue;
            }
            if ($to_delete = ilObjectFactory::getInstanceByRefId($ref_id)) {
                $to_delete->delete();
                $logger->write(__METHOD__ . ': Deleted deprecated reference.');
            }
        }
        return true;
    }
 
    public static function lookupHandledCategories(): array
    {
        global $DIC;
 
        $ilDB = $DIC->database();
 
        $ref_ids = [];
        $res = $ilDB->query("SELECT container_id FROM ecs_container_mapping ");
        while ($row = $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)) {
            $ref_ids[] = $row->container_id;
        }
        return $ref_ids;
    }
 
    public static function getPossibleFields(): array
    {
        global $DIC;
 
        $lng = $DIC['lng'];
 
        $options = array(
            "community" => $lng->txt("ecs_field_community"),
            "part_id" => $lng->txt("ecs_field_part_id"),
            "type" => $lng->txt("type")
        );
 
        // will be handled by server soon?
 
        // only courses for now
        $course_fields = ilECSUtils::_getOptionalECourseFields();
        foreach ($course_fields as $field) {
            $options[$field] = $lng->txt("obj_rcrs") . " - " . $lng->txt("ecs_field_" . $field);
        }
 
        return $options;
    }
}