Collaboration diagram for ilECSUtils:

Static Public Member Functions
static	_getOptionalEContentFields ()
	get optional econtent fields These fields might be mapped against AdvancedMetaData field definitions More...

static	_getOptionalECourseFields ()
	get optional econtent fields These fields might be mapped against AdvancedMetaData field definitions More...

static	getPossibleRemoteTypes (bool $a_with_captions=false)
	Get all possible remote object types. More...

static	getPossibleReleaseTypes (bool $a_with_captions=false)
	Get all possible release object types. More...

static	getEContentDefinition (string $a_resource_id)
	Get econtent / metadata definition. More...

static	getMatchableContent (string $a_resource_id, int $a_server_id, object $a_ecs_content, int $a_owner)
	Convert ECS content to rule matchable values. More...

static	getAdvancedMDValuesForObjId (int $a_obj_id)
	Get advanced metadata values for object id. More...

Data Fields
const	TYPE_ARRAY = 1

const	TYPE_INT = 2

const	TYPE_STRING = 3

const	TYPE_TIMEPLACE = 4

Detailed Description

Author: Stefan Meyer meyer.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Definition at line 24 of file class.ilECSUtils.php.

Member Function Documentation

◆ _getOptionalEContentFields()

static ilECSUtils::_getOptionalEContentFields ( )

static

get optional econtent fields These fields might be mapped against AdvancedMetaData field definitions

Definition at line 35 of file class.ilECSUtils.php.

                                                       : array
    {
        // :TODO: ?
        $def = self::getEContentDefinition('/campusconnect/courselinks');
        return array_keys($def);
    }

References getEContentDefinition().

Referenced by ilECSSettingsGUI\initMappingsForm().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _getOptionalECourseFields()

static ilECSUtils::_getOptionalECourseFields ( )

static

get optional econtent fields These fields might be mapped against AdvancedMetaData field definitions

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

                                                      : array
    {
        // :TODO: ?
        $def = self::getEContentDefinition('/campusconnect/courselinks');
        return array_keys($def);
    }

References getEContentDefinition().

Referenced by ilECSCategoryMapping\getPossibleFields(), and ilECSSettingsGUI\initMappingsForm().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAdvancedMDValuesForObjId()

static ilECSUtils::getAdvancedMDValuesForObjId ( int $a_obj_id )

static

Get advanced metadata values for object id.

Definition at line 208 of file class.ilECSUtils.php.

                                                                     : array
    {
        $res = array();
 
        // getting all records
        foreach (ilAdvancedMDValues::getInstancesForObjectId($a_obj_id) as $a_values) {
            // this correctly binds group and definitions
            $a_values->read();
 
            // getting elements for record
            $defs = $a_values->getDefinitions();
            foreach ($a_values->getADTGroup()->getElements() as $element_id => $element) {
                if (!$element->isNull()) {
                    // :TODO: using this for a "flat" presentation
                    $res[$element_id] = $defs[$element_id]->getValueForXML($element);
                } else {
                    // :TODO: is this needed?
                    $res[$element_id] = null;
                }
            }
        }
 
        return $res;
    }

References $res, and ilAdvancedMDValues\getInstancesForObjectId().

Referenced by ilECSObjectSettings\addMetadataToJson(), ilECSSettingsGUI\exportImported(), ilECSSettingsGUI\exportReleased(), ilECSExportedContentTableGUI\fillRow(), and ilECSImportedContentTableGUI\fillRow().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getEContentDefinition()

static ilECSUtils::getEContentDefinition ( string $a_resource_id )

static

Get econtent / metadata definition.

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

                                                                       : array
    {
        switch ($a_resource_id) {
            case '/campusconnect/courselinks':
                return array(
                    'study_courses' => self::TYPE_ARRAY,
                    'lecturer' => self::TYPE_ARRAY,
                    'courseType' => self::TYPE_STRING,
                    'courseID' => self::TYPE_INT,
                    'credits' => self::TYPE_INT,
                    'semester_hours' => self::TYPE_INT,
                    'term' => self::TYPE_STRING,
                    'begin' => array(self::TYPE_TIMEPLACE, 'timePlace'),
                    'end' => array(self::TYPE_TIMEPLACE, 'timePlace'),
                    'room' => array(self::TYPE_TIMEPLACE, 'timePlace'),
                    'cycle' => array(self::TYPE_TIMEPLACE, 'timePlace')
                );
 
            case '/campusconnect/categories':
            case '/campusconnect/files':
            case '/campusconnect/glossaries':
            case '/campusconnect/groups':
            case '/campusconnect/learningmodules':
            case '/campusconnect/wikis':
                // no metadata mapping yet
            default:
                return [];
        }
    }

Referenced by _getOptionalEContentFields(), _getOptionalECourseFields(), ilECSCourseSettings\buildJson(), getMatchableContent(), and ilObjRemoteCourse\updateCustomFromECSContent().

Here is the caller graph for this function:

◆ getMatchableContent()

static ilECSUtils::getMatchableContent	(	string	$a_resource_id,
		int	$a_server_id,
		object	$a_ecs_content,
		int	$a_owner
	)

static

Convert ECS content to rule matchable values.

Definition at line 133 of file class.ilECSUtils.php.

                                                                                                                            : array
    {
        // see ilECSCategoryMapping::getPossibleFields();
        $res = array();
        $res["part_id"] = array($a_owner, ilECSCategoryMappingRule::ATTR_INT);
        $res["community"] = array(ilECSCommunitiesCache::getInstance()->lookupTitle($a_server_id, $a_owner),
            ilECSCategoryMappingRule::ATTR_STRING);
 
        $definition = self::getEContentDefinition($a_resource_id);
 
        $timePlace = null;
        $value = null;
        foreach ($definition as $id => $type) {
            if (is_array($type)) {
                [$type, $target] = $type;
            } else {
                $target = $id;
            }
            switch ($type) {
                case self::TYPE_ARRAY:
                    if (isset($a_ecs_content->{$target})) {
                        $value = array(implode(',', (array) $a_ecs_content->{$target}), ilECSCategoryMappingRule::ATTR_ARRAY);
                    } else {
                        $value = [];
                    }
                    break;
 
                case self::TYPE_INT:
                    if (isset($a_ecs_content->{$target})) {
                        $value = array((int) $a_ecs_content->{$target}, ilECSCategoryMappingRule::ATTR_INT);
                    } else {
                        $value = 0;
                    }
                    break;
 
                case self::TYPE_STRING:
                    if (isset($a_ecs_content->{$target})) {
                        $value = array((string) $a_ecs_content->{$target}, ilECSCategoryMappingRule::ATTR_STRING);
                    } else {
                        $value = "";
                    }
                    break;
 
                case self::TYPE_TIMEPLACE:
                    if (!is_object($timePlace)) {
                        $timePlace = new ilECSTimePlace();
                        if (isset($a_ecs_content->{$target}) && is_object($a_ecs_content->{$target})) {
                            $timePlace->loadFromJSON($a_ecs_content->{$target});
                        }
                    }
                    switch ($id) {
                        case 'begin':
                        case 'end':
                            $value = array($timePlace->{'getUT' . ucfirst($id)}(),
                                ilECSCategoryMappingRule::ATTR_INT);
                            break;
 
                        case 'room':
                        case 'cycle':
                            $value = array($timePlace->{'get' . ucfirst($id)}(),
                                ilECSCategoryMappingRule::ATTR_STRING);
                            break;
                    }
                    break;
            }
 
            $res[$id] = $value;
        }
 
        return $res;
    }

References $id, $res, ilECSCategoryMappingRule\ATTR_ARRAY, ilECSCategoryMappingRule\ATTR_INT, ilECSCategoryMappingRule\ATTR_STRING, getEContentDefinition(), ilECSCommunitiesCache\getInstance(), TYPE_ARRAY, and TYPE_INT.

Referenced by ilRemoteObjectBase\createFromECSEContent(), and ilRemoteObjectBase\updateFromECSContent().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPossibleReleaseTypes()

static ilECSUtils::getPossibleReleaseTypes ( bool $a_with_captions = false )

static

Get all possible release object types.

Definition at line 78 of file class.ilECSUtils.php.

                                                                                 : array
    {
        global $DIC;
 
        $lng = $DIC['lng'];
 
        $all = array("crs", "cat", "file", "glo", "grp", "lm", "wiki");
 
        if (!$a_with_captions) {
            return $all;
        }
 
        $res = array();
        foreach ($all as $id) {
            $res[$id] = $lng->txt("obj_" . $id);
        }
        return $res;
    }

References $DIC, $id, $lng, and $res.

Referenced by ilECSParticipantSettingsGUI\initFormSettings(), and ilECSSettingsGUI\released().

Here is the caller graph for this function:

◆ getPossibleRemoteTypes()

static ilECSUtils::getPossibleRemoteTypes ( bool $a_with_captions = false )

static

Get all possible remote object types.

Definition at line 56 of file class.ilECSUtils.php.

                                                                                : array
    {
        global $DIC;
 
        $lng = $DIC['lng'];
 
        $all = array("rcrs", "rcat", "rfil", "rglo", "rgrp", "rlm", "rwik");
 
        if (!$a_with_captions) {
            return $all;
        }
 
        $res = array();
        foreach ($all as $id) {
            $res[$id] = $lng->txt("obj_" . $id);
        }
        return $res;
    }