ilECSObjectSettings Class Reference

Handles object exports to ECS. More...

Inheritance diagram for ilECSObjectSettings:

Collaboration diagram for ilECSObjectSettings:

Public Member Functions
	__construct (ilObject $a_content_object)
	Constructor. More...
	getContentObject ()
	Get content object. More...
	addSettingsToForm (ilPropertyFormGUI $a_form, $a_type)
	Fill ECS export settings "multiple servers". More...
	getSettingsSection (FieldFactory $field_factory, Refinery $refinery)
	saveSettingsSection (array $section)
	handleSettingsUpdate (ilPropertyFormGUI $form)
	Update ECS Export Settings. More...
	handleContentUpdate ()
	Update ECS Content. More...
	doDelete (ilECSSetting $a_server, ilECSExport $a_export_settings)
	Delete ECS resource. More...

Static Public Member Functions
static	getInstanceByObject (ilObject $a_content_obj)
	Get settings handler for repository object. More...
static	_handleDelete (array $a_subbtree_nodes)
	handle delete Objects that are moved to the trash call ECS-Remove More...

Data Fields
const	MAIL_SENDER = 6

Protected Member Functions
	getECSObjectType ()
	Get ECS resource identifier, e.g. More...
	isActive ()
	Is ECS (for current object) active? More...
	ecsCanBeActivatedForObject (ilECSExportManager $export_manager, array $exportable_participants)
	getTrafoForECSExportSection (Refinery $refinery)
	getValueForECSExportOptionalGroup (ilECSExportManager $export_manager, array $potential_receivers)
	handleSettingsForServer (ilECSSetting $a_server, bool $a_export, array $a_mids)
	Save ECS settings (add- update- deleteResource) More...
	doAdd (ilECSSetting $a_server, ilECSExport $a_export_settings, array $a_mids)
	Add resource to ECS. More...
	doUpdate (ilECSSetting $a_server, ilECSExport $a_export_settings, array $a_mids=null)
	Update ECS resource. More...
	getParticipants (int $a_server_id, int $a_econtent_id)
	Get participants for server and ecs resource. More...
	sendNewContentNotification (ilECSSetting $a_server, $a_econtent_id)
	send notifications about new EContent More...
	handlePermissionUpdate (ilECSSetting $server)
	Handle permission update. More...
	getJsonCore (string $a_etype)
	Build core json structure. More...
	addMetadataToJson (object $a_json, ilECSSetting $a_server, array $a_definition)
	Add advanced metadata to json (export) More...
	buildJson (ilECSSetting $a_server)
	Build resource-specific json. More...

Protected Attributes
ilObject	$content_obj

Private Member Functions
	handleSettings (bool $ecs_export, array $selected_receivers)

Private Attributes
ilLogger	$logger
ilLanguage	$lng
ilTree	$tree
ilRbacAdmin	$rbacAdmin
ilGlobalTemplateInterface	$main_tpl

Detailed Description

Handles object exports to ECS.

Author

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

Definition at line 31 of file class.ilECSObjectSettings.php.

Constructor & Destructor Documentation

__construct()

ilECSObjectSettings::__construct

(

ilObject

$a_content_object

)

Constructor.

Parameters

ilObject

$a_content_object

Definition at line 48 of file class.ilECSObjectSettings.php.

References $DIC, ILIAS\Repository\lng(), and ILIAS\Repository\logger().

    {
        global $DIC;
        $this->main_tpl = $DIC->ui()->mainTemplate();

        $this->lng = $DIC->language();
        $this->logger = $DIC->logger()->obj();
        $this->tree = $DIC->repositoryTree();
        $this->rbacAdmin = $DIC->rbac()->admin();

        $this->content_obj = $a_content_object;
    }

Here is the call graph for this function:

Member Function Documentation

_handleDelete()

static ilECSObjectSettings::_handleDelete ( array  $a_subbtree_nodes )

static

handle delete Objects that are moved to the trash call ECS-Remove

See also

ilRepUtil

Definition at line 547 of file class.ilECSObjectSettings.php.

References $server, ILIAS\LTI\ToolProvider\$settings, ilECSExportManager\getInstance(), ilECSServerSettings\getInstance(), ilObjectFactory\getInstanceByRefId(), and ilECSSetting\getInstanceByServerId().

Referenced by ilRepUtil\deleteObjects().

                                                                 : void
    {
        // active?
        if (!ilECSServerSettings::getInstance()->activeServerExists()) {
            return;
        }
        $exportManager = ilECSExportManager::getInstance();
        $exported = $exportManager->getExportedIds();
        foreach ($a_subbtree_nodes as $node) {
            if (in_array(
                $node['obj_id'],
                $exported,
                true
            ) && $content_obj = ilObjectFactory::getInstanceByRefId($node['child'], false)) {
                $settings = self::getInstanceByObject($content_obj);

                // Read export server ids
                foreach ($exportManager->getExportServerIds($node['obj_id']) as $sid) {
                    $server = ilECSSetting::getInstanceByServerId($sid);
                    $export_settings = new ilECSExport($sid, $content_obj->getId());
                    if ($settings) {
                        $settings->doDelete($server, $export_settings);
                    }
                }
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

addMetadataToJson()

ilECSObjectSettings::addMetadataToJson ( object  $a_json, ilECSSetting  $a_server, array  $a_definition  )

protected

Add advanced metadata to json (export)

Definition at line 705 of file class.ilECSObjectSettings.php.

References $id, buildJson(), ilECSUtils\getAdvancedMDValuesForObjId(), ilECSDataMappingSettings\getInstanceByServerId(), ilECSSetting\getServerId(), ILIAS\Repository\int(), ilECSDataMappingSetting\MAPPING_EXPORT, ilECSUtils\TYPE_ARRAY, ilECSUtils\TYPE_INT, ilECSUtils\TYPE_STRING, and ilECSUtils\TYPE_TIMEPLACE.

Referenced by ilECSCourseSettings\buildJson().

                                                                                                     : void
    {
        $mappings = ilECSDataMappingSettings::getInstanceByServerId($a_server->getServerId());

        $values = ilECSUtils::getAdvancedMDValuesForObjId($this->content_obj->getId());

        foreach ($a_definition as $id => $type) {
            if (is_array($type)) {
                [$type , $target] = $type;
            } else {
                $target = $id;
            }

            if ($field = $mappings->getMappingByECSName(ilECSDataMappingSetting::MAPPING_EXPORT, $id)) {
                $value = $values[$field] ?? '';

                switch ($type) {
                    case ilECSUtils::TYPE_ARRAY:
                        $a_json->{$target} = explode(',', $value);
                        break;

                    case ilECSUtils::TYPE_INT:
                        $a_json->{$target} = (int) $value;
                        break;

                    case ilECSUtils::TYPE_STRING:
                        $a_json->{$target} = (string) $value;
                        break;

                    case ilECSUtils::TYPE_TIMEPLACE:
                        if (!isset($a_json->{$target})) {
                            $a_json->{$target} = new ilECSTimePlace();
                        }
                        $a_json->{$target}->{'set' . ucfirst($id)}($value);
                        break;
                }
            }
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

addSettingsToForm()

ilECSObjectSettings::addSettingsToForm	(	ilPropertyFormGUI	$a_form,
			$a_type
	)

Fill ECS export settings "multiple servers".

to be used in ilObject->initEditForm()

Definition at line 126 of file class.ilECSObjectSettings.php.

References ILIAS\LTI\ToolProvider\$details, ilPropertyFormGUI\addItem(), ecsCanBeActivatedForObject(), getECSObjectType(), ilECSExportManager\getInstance(), ilECSEContentDetails\getInstanceFromServer(), ILIAS\Repository\lng(), ilFormPropertyGUI\setRequired(), ilRadioOption\setValue(), and ilCheckboxGroupInputGUI\setValue().

                                                                         : bool
    {
        $export_manager = ilECSExportManager::getInstance();
        $exportable_participants = (new ilECSParticipantSettingsRepository())->getExportableParticipants($a_type);
        $obj_id = $this->content_obj->getId();

        if (!$this->ecsCanBeActivatedForObject($export_manager, $exportable_participants)) {
            return false;
        }

        $this->lng->loadLanguageModule('ecs');

        // show ecs property form section
        $ecs = new ilFormSectionHeaderGUI();
        $ecs->setTitle($this->lng->txt('ecs_' . $a_type . '_export'));
        $a_form->addItem($ecs);


        // release or not
        $exp = new ilRadioGroupInputGUI($this->lng->txt('ecs_' . $a_type . '_export_obj_settings'), 'ecs_export');
        $exp->setRequired(true);
        $exp->setValue($export_manager->_isExported($obj_id) ? "1" : "0");
        $off = new ilRadioOption($this->lng->txt('ecs_' . $a_type . '_export_disabled'), "0");
        $exp->addOption($off);
        $on = new ilRadioOption($this->lng->txt('ecs_' . $a_type . '_export_enabled'), "1");
        $exp->addOption($on);
        $a_form->addItem($exp);

        // Show all exportable participants
        $publish_for = new ilCheckboxGroupInputGUI($this->lng->txt('ecs_publish_for'), 'ecs_sid');

        // @TODO: Active checkboxes for recipients
        //$publish_for->setValue((array) $members);

        // Read receivers
        $receivers = array();
        foreach ($export_manager->getExportServerIds($obj_id) as $sid) {
            $exp = new ilECSExport($sid, $obj_id);

            $participants = null;
            $details = ilECSEContentDetails::getInstanceFromServer(
                $sid,
                $exp->getEContentId(),
                $this->getECSObjectType()
            );
            if ($details instanceof ilECSEContentDetails) {
                $participants = $details->getReceivers();
            }
            if ($participants) {
                foreach ($participants as $mid) {
                    $receivers[] = $sid . '_' . $mid;
                }
            }
        }
        $publish_for->setValue($receivers);

        foreach ($exportable_participants as $pInfo) {
            $partSetting = new ilECSParticipantSetting($pInfo['sid'], $pInfo['mid']);

            $com = new ilCheckboxOption(
                $partSetting->getCommunityName() . ': ' . $partSetting->getTitle(),
                'sid_mid'
            );
            $com->setValue($pInfo['sid'] . '_' . $pInfo['mid']);
            $publish_for->addOption($com);
        }
        $on->addSubItem($publish_for);
        return true;
    }

Here is the call graph for this function:

buildJson()

ilECSObjectSettings::buildJson ( ilECSSetting  $a_server )

abstractprotected

Build resource-specific json.

Returns

mixed

Referenced by addMetadataToJson(), doAdd(), and doUpdate().

Here is the caller graph for this function:

doAdd()

ilECSObjectSettings::doAdd ( ilECSSetting  $a_server, ilECSExport  $a_export_settings, array  $a_mids  )

protected

Add resource to ECS.

Definition at line 454 of file class.ilECSObjectSettings.php.

References buildJson(), getECSObjectType(), handlePermissionUpdate(), ilECSConnector\HEADER_MEMBERSHIPS, ILIAS\Repository\logger(), ilECSExport\save(), sendNewContentNotification(), ilECSExport\setEContentId(), and ilECSExport\setExported().

Referenced by handleSettingsForServer().

                                                                                                   : void
    {
        $this->logger->info(__METHOD__ . ': Starting ECS add resource...');

        $json = $this->buildJson($a_server);

        $connector = new ilECSConnector($a_server);
        $connector->addHeader(ilECSConnector::HEADER_MEMBERSHIPS, implode(',', $a_mids));
        $econtent_id = $connector->addResource(
            $this->getECSObjectType(),
            json_encode($json, JSON_THROW_ON_ERROR)
        );

        // status changed
        $a_export_settings->setExported(true);
        $a_export_settings->setEContentId($econtent_id);
        $a_export_settings->save();

        $this->handlePermissionUpdate($a_server);

        // Send mail
        $this->sendNewContentNotification($a_server, $econtent_id);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

doDelete()

ilECSObjectSettings::doDelete	(	ilECSSetting	$a_server,
		ilECSExport	$a_export_settings
	)

Delete ECS resource.

as it is called from self::_handleDelete() it has to be public...

Exceptions

ilECSConnectorException

Definition at line 518 of file class.ilECSObjectSettings.php.

References ilECSExport\getEContentId(), getECSObjectType(), ilECSExport\isExported(), ILIAS\Repository\logger(), ilECSExport\save(), and ilECSExport\setExported().

Referenced by handleSettingsForServer().

                                                                                    : void
    {
        // already exported?
        if ($a_export_settings->isExported()) {
            $econtent_id = $a_export_settings->getEContentId();
            if (!$econtent_id) {
                $this->logger->warning(__METHOD__ . ': Missing eid. Aborting.');
                throw new ilECSConnectorException('Missing ECS content ID. Aborting.');
            }
            $connector = new ilECSConnector($a_server);

            $this->logger->info(__METHOD__ . ': Start deleting ECS content...');
            $connector->deleteResource(
                $this->getECSObjectType(),
                $econtent_id
            );

            // status changed
            $a_export_settings->setExported(false);
            $a_export_settings->save();
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

doUpdate()

ilECSObjectSettings::doUpdate ( ilECSSetting  $a_server, ilECSExport  $a_export_settings, array  $a_mids = null  )

protected

Update ECS resource.

Parameters

ilECSSetting	$a_server
ilECSExport	$a_export_settings
array	$a_mids

Exceptions

ilECSConnectorException

Definition at line 486 of file class.ilECSObjectSettings.php.

References buildJson(), ilECSExport\getEContentId(), getECSObjectType(), getParticipants(), ilECSSetting\getServerId(), handlePermissionUpdate(), ilECSConnector\HEADER_MEMBERSHIPS, and ILIAS\Repository\logger().

Referenced by handleContentUpdate(), and handleSettingsForServer().

                                                                                                             : void
    {
        $econtent_id = $a_export_settings->getEContentId();
        if (!$econtent_id) {
            $this->logger->warning(__METHOD__ . ': Missing eid. Aborting.');
            throw new ilECSConnectorException('Missing ECS content ID. Aborting.');
        }
        $connector = new ilECSConnector($a_server);

        if (!$a_mids) {
            $a_mids = $this->getParticipants($a_server->getServerId(), $econtent_id);
        }
        $this->logger->info(__METHOD__ . ': Start updating ECS content - ' . print_r($a_mids, true));
        $connector->addHeader(ilECSConnector::HEADER_MEMBERSHIPS, implode(',', (array) $a_mids));

        $json = $this->buildJson($a_server);
        $connector->updateResource(
            $this->getECSObjectType(),
            $econtent_id,
            json_encode($json, JSON_THROW_ON_ERROR)
        );

        $this->handlePermissionUpdate($a_server);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

ecsCanBeActivatedForObject()

ilECSObjectSettings::ecsCanBeActivatedForObject ( ilECSExportManager  $export_manager, array  $exportable_participants  )

protected

Definition at line 235 of file class.ilECSObjectSettings.php.

References ilECSExportManager\_isExported(), getContentObject(), isActive(), and ILIAS\Repository\logger().

Referenced by addSettingsToForm(), and getSettingsSection().

     : bool {
        $this->logger->debug('Show ecs settings.');
        if (!$this->isActive()) {
            $this->logger->debug('Object type is not active. => no settings.');
            return false;
        }

        $obj_id = $this->content_obj->getId();

        // Return if no participant is enabled for export and the current object is not released
        if (!$this->getContentObject()->withReferences()) {
            $this->logger->debug('Called without references. => no settings.');
            return false;
        }

        if (!$exportable_participants && !$export_manager->_isExported($obj_id)) {
            $this->logger->debug('Object type is not exportable. => no settings.');
            return false;
        }
        if (
            $this->tree->checkForParentType($this->tree->getParentId($this->getContentObject()->getRefId()), 'crs', false) ||
            $this->tree->checkForParentType($this->tree->getParentId($this->getContentObject()->getRefId()), 'grp', false)
        ) {
            $this->logger->debug('Parent crs/grp in path. => no settings.');
            return false;
        }

        return true;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getContentObject()

ilECSObjectSettings::getContentObject

(

)

Get content object.

Returns

ilObject

Definition at line 95 of file class.ilECSObjectSettings.php.

References $content_obj, and getECSObjectType().

Referenced by ilECSCourseSettings\buildJson(), ecsCanBeActivatedForObject(), and getJsonCore().

                                      : \ilObject
    {
        return $this->content_obj;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getECSObjectType()

ilECSObjectSettings::getECSObjectType ( )

abstractprotected

Get ECS resource identifier, e.g.

"/campusconnect/courselinks"

Referenced by addSettingsToForm(), doAdd(), doDelete(), doUpdate(), getContentObject(), getParticipants(), getValueForECSExportOptionalGroup(), and sendNewContentNotification().

Here is the caller graph for this function:

getInstanceByObject()

static ilECSObjectSettings::getInstanceByObject ( ilObject  $a_content_obj )

static

Get settings handler for repository object.

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

References ilObject\getType().

                                                                       : ?ilECSObjectSettings
    {
        switch ($a_content_obj->getType()) {
            case 'crs':
                return new ilECSCourseSettings($a_content_obj);

            case 'cat':
                return new ilECSCategorySettings($a_content_obj);

            case 'file':
                return new ilECSFileSettings($a_content_obj);

            case 'glo':
                return new ilECSGlossarySettings($a_content_obj);

            case 'grp':
                return new ilECSGroupSettings($a_content_obj);

            case 'lm':
                return new ilECSLearningModuleSettings($a_content_obj);

            case 'wiki':
                return new ilECSWikiSettings($a_content_obj);
        }
        return null;
    }

Here is the call graph for this function:

getJsonCore()

ilECSObjectSettings::getJsonCore ( string  $a_etype )

protected

Build core json structure.

Definition at line 688 of file class.ilECSObjectSettings.php.

References getContentObject(), and IL_INST_ID.

Referenced by ilECSGroupSettings\buildJson(), ilECSGlossarySettings\buildJson(), ilECSWikiSettings\buildJson(), ilECSLearningModuleSettings\buildJson(), ilECSCategorySettings\buildJson(), ilECSFileSettings\buildJson(), ilECSTestSettings\buildJson(), and ilECSCourseSettings\buildJson().

                                                   : object
    {
        $json = new stdClass();
        $json->lang = 'en_EN'; // :TODO: obsolet?
        $json->id = 'il_' . IL_INST_ID . '_' . $this->getContentObject()->getType() . '_' . $this->getContentObject()->getId();
        $json->etype = $a_etype;
        $json->title = $this->content_obj->getTitle();
        $json->abstract = $this->content_obj->getLongDescription();

        $json->url = ilLink::_getLink($this->content_obj->getRefId(), $this->content_obj->getType());

        return $json;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getParticipants()

ilECSObjectSettings::getParticipants ( int  $a_server_id, int  $a_econtent_id  )

protected

Get participants for server and ecs resource.

Definition at line 578 of file class.ilECSObjectSettings.php.

References ILIAS\LTI\ToolProvider\$details, getECSObjectType(), and ilECSEContentDetails\getInstanceFromServer().

Referenced by doUpdate().

                                                                            : array
    {
        $receivers = array();
        foreach ((array) $a_server_id as $sid) {
            $participants = null;
            $details = ilECSEContentDetails::getInstanceFromServer($sid, $a_econtent_id, $this->getECSObjectType());
            if ($details instanceof ilECSEContentDetails) {
                $participants = $details->getReceivers();
            }
            if ($participants) {
                foreach ($participants as $mid) {
                    $receivers[] = $mid;
                }
            }
        }
        return $receivers;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getSettingsSection()

ilECSObjectSettings::getSettingsSection	(	FieldFactory	$field_factory,
		Refinery	$refinery
	)

Definition at line 196 of file class.ilECSObjectSettings.php.

References ILIAS\UI\Implementation\Component\Input\$inputs, ecsCanBeActivatedForObject(), ilECSExportManager\getInstance(), getTrafoForECSExportSection(), getValueForECSExportOptionalGroup(), ILIAS\Repository\lng(), ILIAS\UI\Implementation\Component\Input\ViewControl\withAdditionalTransformation(), and ILIAS\UI\Implementation\Component\Input\withValue().

     : ?Section {
        $type = $this->content_obj->getType();
        $export_manager = ilECSExportManager::getInstance();
        $exportable_participants = (new ilECSParticipantSettingsRepository())->getExportableParticipants($type);

        if (!$this->ecsCanBeActivatedForObject($export_manager, $exportable_participants)) {
            return null;
        }

        $this->lng->loadLanguageModule('ecs');
        $trafo = $this->getTrafoForECSExportSection($refinery);

        $potential_receivers = [];

        foreach ($exportable_participants as $participant) {
            $participant_setting = new ilECSParticipantSetting($participant['sid'], $participant['mid']);
            $potential_receivers[$participant['sid'] . '_' . $participant['mid']] = $field_factory->checkbox(
                $participant_setting->getCommunityName() . ': ' . $participant_setting->getTitle()
            );
        }

        $value = $this->getValueForECSExportOptionalGroup(
            $export_manager,
            array_keys($potential_receivers)
        );

        $inputs['ecs_export'] = $field_factory->optionalGroup(
            $potential_receivers,
            $this->lng->txt('ecs_' . $type . '_export_obj_settings')
        )
            ->withValue($value);

        return $field_factory->section($inputs, $this->lng->txt('ecs_' . $type . '_export'))
            ->withAdditionalTransformation($trafo);
    }

Here is the call graph for this function:

getTrafoForECSExportSection()

ilECSObjectSettings::getTrafoForECSExportSection ( Refinery  $refinery )

protected

Definition at line 268 of file class.ilECSObjectSettings.php.

Referenced by getSettingsSection().

                                                                      : Transformation
    {
        return $refinery->custom()->transformation(
            function (?array $vs): array {
                if ($vs['ecs_export'] === null) {
                    return [
                        'is_exported' => false
                    ];
                }

                return [
                    'is_exported' => true,
                    'values' => array_keys($vs['ecs_export'])
                ];
            }
        );
    }

Here is the caller graph for this function:

getValueForECSExportOptionalGroup()

ilECSObjectSettings::getValueForECSExportOptionalGroup ( ilECSExportManager  $export_manager, array  $potential_receivers  )

protected

Definition at line 286 of file class.ilECSObjectSettings.php.

References ILIAS\LTI\ToolProvider\$details, ILIAS\LTI\ToolProvider\$key, getECSObjectType(), ilECSExportManager\getExportServerIds(), and ilECSEContentDetails\getInstanceFromServer().

Referenced by getSettingsSection().

     : ?array {
        $obj_id = $this->content_obj->getId();
        $active_receivers = null;
        foreach ($export_manager->getExportServerIds($obj_id) as $sid) {
            $exp = new ilECSExport($sid, $obj_id);

            $participants = null;
            $details = ilECSEContentDetails::getInstanceFromServer(
                $sid,
                $exp->getEContentId(),
                $this->getECSObjectType()
            );
            if ($details instanceof ilECSEContentDetails) {
                $participants = $details->getReceivers();
            }
            if ($participants === null) {
                continue;
            }
            foreach ($participants as $mid) {
                $active_receivers[$sid . '_' . $mid] = true;
            }
        }

        if ($active_receivers === null) {
            return null;
        }

        $missing_keys = (array_diff($potential_receivers, array_keys($active_receivers)));
        foreach ($missing_keys as $key) {
            $active_receivers[$key] = false;
        }

        return $active_receivers;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

handleContentUpdate()

ilECSObjectSettings::handleContentUpdate

(

)

Update ECS Content.

to be used AFTER metadata-/content-updates

Definition at line 425 of file class.ilECSObjectSettings.php.

References $server, doUpdate(), ilECSExportManager\getInstance(), ilECSSetting\getInstanceByServerId(), isActive(), and ILIAS\Repository\logger().

                                         : bool
    {
        if (!$this->isActive()) {
            return true;
        }
        $exportManager = ilECSExportManager::getInstance();
        $export_servers = $exportManager->getExportServerIds($this->content_obj->getId());
        foreach ($export_servers as $server_id) {
            $server = ilECSSetting::getInstanceByServerId($server_id);
            if ($server->isEnabled()) {
                try {
                    $export_settings = new ilECSExport($server_id, $this->content_obj->getId());

                    // already exported, update ecs
                    if ($export_settings->isExported()) {
                        $this->doUpdate($server, $export_settings);
                    }
                } catch (ilECSConnectorException $exc) {
                    $this->logger->warning(__METHOD__ . ': Cannot handle ECS content update. ' . $exc->getMessage());
                    return false;
                }
            }
        }
        return true;
    }

Here is the call graph for this function:

handlePermissionUpdate()

ilECSObjectSettings::handlePermissionUpdate ( ilECSSetting  $server )

protected

Handle permission update.

Definition at line 670 of file class.ilECSObjectSettings.php.

References ilRbacReview\_getOperationIdsByName(), ilECSSetting\getGlobalRole(), and ILIAS\Repository\logger().

Referenced by doAdd(), and doUpdate().

                                                                   : void
    {
        if (
            ($this->content_obj->getType() === 'crs') ||
            ($this->content_obj->getType() === 'grp')
        ) {
            $this->logger->info(__METHOD__ . ': Permission update for courses/groups');
            $this->rbacAdmin->grantPermission(
                $server->getGlobalRole(),
                ilRbacReview::_getOperationIdsByName(array('join','visible')),
                $this->content_obj->getRefId()
            );
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

handleSettings()

ilECSObjectSettings::handleSettings ( bool  $ecs_export, array  $selected_receivers  )

private

Definition at line 344 of file class.ilECSObjectSettings.php.

References $server, ilECSSetting\getInstanceByServerId(), handleSettingsForServer(), and isActive().

Referenced by handleSettingsUpdate(), and saveSettingsSection().

     : bool {
        if (!$this->isActive()) {
            return true;
        }

        // Parse post data
        $mids = array();
        foreach ((array) $selected_receivers as $sid_mid) {
            $tmp = explode('_', $sid_mid);
            if(1 === count($tmp)) {
                $mids[$tmp[0]][] = $tmp[0];
            } else {
                $mids[$tmp[0]][] = $tmp[1];
            }
        }

        try {
            // Update for each server
            foreach ((new ilECSParticipantSettingsRepository())->getServersContaingExports() as $server_id) {
                $server = ilECSSetting::getInstanceByServerId($server_id);
                if ($server->isEnabled()) {
                    // Export
                    $export = true;
                    if (!$ecs_export) {
                        $export = false;
                    }
                    if (
                        !isset($mids[$server_id]) ||
                        !is_array($mids[$server_id]) ||
                        !count($mids[$server_id])) {
                        $export = false;
                    }
                    $this->handleSettingsForServer(
                        $server,
                        $export,
                        $mids[$server_id] ?? []
                    );
                }
            }
        } catch (ilECSConnectorException $exc) {
            $this->main_tpl->setOnScreenMessage('failure', 'Error exporting to ECS server: ' . $exc->getMessage());
            return false;
        }
        return true;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

handleSettingsForServer()

ilECSObjectSettings::handleSettingsForServer ( ilECSSetting  $a_server, bool  $a_export, array  $a_mids  )

protected

Save ECS settings (add- update- deleteResource)

Parameters

array

array of participant mids

Exceptions

ilECSConnectorException

Definition at line 399 of file class.ilECSObjectSettings.php.

References doAdd(), doDelete(), doUpdate(), and ilECSSetting\getServerId().

Referenced by handleSettings().

                                                                                                     : void
    {
        $export_settings = new ilECSExport($a_server->getServerId(), $this->content_obj->getId());

        // already exported?
        if ($export_settings->isExported()) {
            // still exportable: update ecs
            if ($a_export) {
                $this->doUpdate($a_server, $export_settings, $a_mids);
            }
            // not exportable anymore
            else {
                $this->doDelete($a_server, $export_settings);
            }
        }
        // not exported yet
        elseif ($a_export) {
            $this->doAdd($a_server, $export_settings, $a_mids);
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

handleSettingsUpdate()

ilECSObjectSettings::handleSettingsUpdate

(

ilPropertyFormGUI

$form

)

Update ECS Export Settings.

Processes post data from addSettingstoForm() to be used in ilObject->update() AFTER object data has been updated

Definition at line 335 of file class.ilECSObjectSettings.php.

References ilPropertyFormGUI\getInput(), and handleSettings().

                                                                 : bool
    {
        return $this->handleSettings(
            (bool) $form->getInput("ecs_export"),
            (array) $form->getInput("ecs_sid")
        );
    }

Here is the call graph for this function:

isActive()

ilECSObjectSettings::isActive ( )

protected

Is ECS (for current object) active?

Definition at line 108 of file class.ilECSObjectSettings.php.

References ilECSServerSettings\getInstance().

Referenced by ecsCanBeActivatedForObject(), handleContentUpdate(), and handleSettings().

                                 : bool
    {
        if (ilECSServerSettings::getInstance()->activeServerExists()) {
            // imported objects cannot be exported => why not
            #if(!ilECSImportManager::getInstance()->lookupServerId($this->content_obj->getId()))
            {
                return true;
            }
        }

        return false;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

saveSettingsSection()

ilECSObjectSettings::saveSettingsSection

(

array

$section

)

Definition at line 324 of file class.ilECSObjectSettings.php.

References handleSettings().

                                                       : bool
    {
        return $this->handleSettings($section['is_exported'], $section['values']);
    }

Here is the call graph for this function:

sendNewContentNotification()

ilECSObjectSettings::sendNewContentNotification ( ilECSSetting  $a_server,   $a_econtent_id  )

protected

send notifications about new EContent

Definition at line 599 of file class.ilECSObjectSettings.php.

References ILIAS\LTI\ToolProvider\$details, Vendor\Package\$e, $lang, $message, ilMail\_getAutoGeneratedMessageString(), ilLanguageFactory\_getLanguage(), ilLink\_getStaticLink(), ilECSSetting\getApprovalRecipients(), ilECSSetting\getApprovalRecipientsAsString(), getECSObjectType(), ilECSCommunityReader\getInstanceByServerId(), ilECSEContentDetails\getInstanceFromServer(), ilECSSetting\getServerId(), and ILIAS\Repository\logger().

Referenced by doAdd().

                                                                                         : bool
    {
        if (!count($rcps = $a_server->getApprovalRecipients())) {
            return true;
        }

        $lang = ilLanguageFactory::_getLanguage();
        $lang->loadLanguageModule('ecs');

        // @TODO: read mail
        $mail = new ilMail(self::MAIL_SENDER);
        $message = $lang->txt('ecs_export_created_body_a') . "\n\n";
        $message .= $lang->txt('title') . ': ' . $this->content_obj->getTitle() . "\n";
        if (($desc = $this->content_obj->getDescription()) !== '') {
            $message .= $lang->txt('desc') . ': ' . $desc . "\n";
        }

        // Participant info
        $message .= ("\n" . $lang->txt('ecs_published_for'));

        try {
            $found = false;

            $receivers = null;
            $details = ilECSEContentDetails::getInstanceFromServer(
                $a_server->getServerId(),
                $a_econtent_id,
                $this->getECSObjectType()
            );
            if ($details instanceof ilECSEContentDetails) {
                $receivers = $details->getReceivers();
            }
            if ($receivers) {
                foreach ($receivers as $member) {
                    $found = true;

                    $part = ilECSCommunityReader::getInstanceByServerId($a_server->getServerId())->getParticipantByMID($member);

                    $message .= ("\n\n" . $part->getParticipantName() . "\n");
                    $message .= ($part->getDescription());
                }
            }
            if ($found) {
                $message .= "\n\n";
            } else {
                $message .= (' ' . $lang->txt('ecs_not_published') . "\n\n");
            }
        } catch (ilECSConnectorException $e) {
            $this->logger->warning(__METHOD__ . ': Cannot read approvements.');
            return false;
        }

        $href = ilLink::_getStaticLink($this->content_obj->getRefId(), 'crs', true);
        $message .= $lang->txt("perma_link") . ': ' . $href . "\n\n";
        $message .= ilMail::_getAutoGeneratedMessageString();

        $mail->enqueue(
            $a_server->getApprovalRecipientsAsString(),
            '',
            '',
            $lang->txt('ecs_new_approval_subject'),
            $message,
            array()
        );

        return true;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$content_obj

ilObject ilECSObjectSettings::$content_obj

protected

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

Referenced by getContentObject().

$lng

ilLanguage ilECSObjectSettings::$lng

private

Definition at line 36 of file class.ilECSObjectSettings.php.

$logger

ilLogger ilECSObjectSettings::$logger

private

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

$main_tpl

ilGlobalTemplateInterface ilECSObjectSettings::$main_tpl

private

Definition at line 41 of file class.ilECSObjectSettings.php.

$rbacAdmin

ilRbacAdmin ilECSObjectSettings::$rbacAdmin

private

Definition at line 38 of file class.ilECSObjectSettings.php.

$tree

ilTree ilECSObjectSettings::$tree

private

Definition at line 37 of file class.ilECSObjectSettings.php.

MAIL_SENDER

const ilECSObjectSettings::MAIL_SENDER = 6

Definition at line 40 of file class.ilECSObjectSettings.php.

---

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

• Services/WebServices/ECS/classes/class.ilECSObjectSettings.php