ilSoapUtils Class Reference

Soap utitliy functions. More...

Inheritance diagram for ilSoapUtils:

Collaboration diagram for ilSoapUtils:

Public Member Functions
	ignoreUserAbort ()
	disableSOAPCheck ()
	distributeMails (string $sid, string $a_mail_xml)
	saveTempFileAsMediaObject (string $sid, string $name, string $tmp_name)
	getMobsOfObject (string $sid, string $a_type, int $a_id)
	ilCloneDependencies (string $sid, int $copy_identifier, bool $is_initialized=false)
	ilClone (string $sid, int $copy_identifier)
	deleteExpiredDualOptInUserObjects (string $sid, int $usr_id)
	Method for soap webservice: deleteExpiredDualOptInUserObjects This service will run in background. More...
Public Member Functions inherited from ilSoapAdministration
	__construct (bool $use_nusoap=true)
	getMessage ()
	appendMessage (string $a_str)
	setMessageCode (string $a_code)
	getMessageCode ()
	reInitUser ()
	isFault ($object)
	getInstallationInfoXML ()
	getClientInfoXML (string $clientid)

Protected Member Functions
	rewriteActionForNode (ilCopyWizardOptions $cpo, array $node, array $options)
	findMappedReferenceForNode (\ilCopyWizardOptions $cpo, array $node)
Protected Member Functions inherited from ilSoapAdministration
	checkSession (string $sid)
	explodeSid (string $sid)
	setMessage (string $a_str)
	initAuth (string $sid)
	initIlias ()
	initAuthenticationObject ()
	raiseError (string $a_message, $a_code)
	checkObjectAccess (int $ref_id, array $expected_type, string $permission, bool $returnObject=false)
	check access for ref id: expected type, permission, return object instance if returnobject is true More...

Private Member Functions
	callNextNode (string $sid, ilCopyWizardOptions $cp_options)
	callNextDependency (string $sid, ilCopyWizardOptions $cp_options)
	cloneNode (array $node, ilCopyWizardOptions $cp_options)
	cloneDependencies (array $node, ilCopyWizardOptions $cp_options)
	internalLinkNode (array $node, ilCopyWizardOptions $cp_options)
	linkNode (array $node, ilCopyWizardOptions $cp_options)

Additional Inherited Members
Data Fields inherited from ilSoapAdministration
const	NUSOAP = 1
const	PHP5 = 2
int	$error_method
	Defines type of error handling (PHP5 || NUSOAP) More...
Protected Attributes inherited from ilSoapAdministration
bool	$soap_check = true
string	$message = ''
string	$message_code = ''

Detailed Description

Soap utitliy functions.

Author

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

Definition at line 32 of file class.ilSoapUtils.php.

Member Function Documentation

callNextDependency()

ilSoapUtils::callNextDependency ( string  $sid, ilCopyWizardOptions  $cp_options  )

private

Definition at line 360 of file class.ilSoapUtils.php.

                                                                                     : void
    {
        $cp_options->dropFirstDependenciesNode();
 
        if ($cp_options->isSOAPEnabled()) {
            // Start next soap call
            include_once 'Services/WebServices/SOAP/classes/class.ilSoapClient.php';
            $soap_client = new ilSoapClient();
            $soap_client->setResponseTimeout(1);
            $soap_client->enableWSDL(true);
            $soap_client->init();
            $soap_client->call('ilCloneDependencies', array($sid, $cp_options->getCopyId()));
        } else {
            ilLoggerFactory::getLogger('obj')->warning('SOAP clone call failed. Calling clone method manually');
            $cp_options->read();
            include_once('./webservice/soap/include/inc.soap_functions.php');
            $res = ilSoapFunctions::ilCloneDependencies($sid, $cp_options->getCopyId());
        }
    }

References $res, ilCopyWizardOptions\dropFirstDependenciesNode(), ilCopyWizardOptions\getCopyId(), ilLoggerFactory\getLogger(), ilSoapFunctions\ilCloneDependencies(), ilCopyWizardOptions\isSOAPEnabled(), and ilCopyWizardOptions\read().

Referenced by ilCloneDependencies().

Here is the call graph for this function:

Here is the caller graph for this function:

callNextNode()

ilSoapUtils::callNextNode ( string  $sid, ilCopyWizardOptions  $cp_options  )

private

Definition at line 337 of file class.ilSoapUtils.php.

                                                                               : void
    {
        global $DIC;
 
        $ilLog = $DIC->logger()->obj();
 
        $cp_options->dropFirstNode();
        if ($cp_options->isSOAPEnabled()) {
            // Start next soap call
            include_once 'Services/WebServices/SOAP/classes/class.ilSoapClient.php';
            $soap_client = new ilSoapClient();
            $soap_client->setResponseTimeout(1);
            $soap_client->enableWSDL(true);
            $soap_client->init();
            $soap_client->call('ilClone', array($sid, $cp_options->getCopyId()));
        } else {
            ilLoggerFactory::getLogger('obj')->warning('SOAP clone call failed. Calling clone method manually');
            $cp_options->read();
            include_once('./webservice/soap/include/inc.soap_functions.php');
            $res = ilSoapFunctions::ilClone($sid, $cp_options->getCopyId());
        }
    }

References $DIC, $res, ilCopyWizardOptions\dropFirstNode(), ilCopyWizardOptions\getCopyId(), ilLoggerFactory\getLogger(), ilSoapFunctions\ilClone(), ilCopyWizardOptions\isSOAPEnabled(), and ilCopyWizardOptions\read().

Referenced by ilClone().

Here is the call graph for this function:

Here is the caller graph for this function:

cloneDependencies()

ilSoapUtils::cloneDependencies ( array  $node, ilCopyWizardOptions  $cp_options  )

private

Definition at line 427 of file class.ilSoapUtils.php.

                                                                                    : void
    {
        global $DIC;
 
        $ilLog = $DIC['ilLog'];
 
        $source_id = (int) $node['child'];
        $mappings = $cp_options->getMappings();
 
        if (!isset($mappings[$source_id])) {
            ilLoggerFactory::getLogger('obj')->debug('Omitting node ' . $source_id . ', ' . $node['title'] . ', ' . $node['type'] . '. No mapping found.');
            return;
        }
        $target_id = $mappings[$source_id];
 
        $orig = ilObjectFactory::getInstanceByRefId($source_id);
        $orig->cloneDependencies($target_id, $cp_options->getCopyId());
    }

References $DIC, $target_id, ilCopyWizardOptions\getCopyId(), ilObjectFactory\getInstanceByRefId(), ilLoggerFactory\getLogger(), ilCopyWizardOptions\getMappings(), and ILIAS\Repository\int().

Referenced by ilCloneDependencies().

Here is the call graph for this function:

Here is the caller graph for this function:

cloneNode()

ilSoapUtils::cloneNode ( array  $node, ilCopyWizardOptions  $cp_options  )

private

Definition at line 380 of file class.ilSoapUtils.php.

                                                                            : int
    {
        global $DIC;
 
        $ilLog = $DIC['ilLog'];
        $tree = $DIC['tree'];
        $ilAccess = $DIC['ilAccess'];
        $rbacreview = $DIC['rbacreview'];
        $source_id = (int) $node['child'];
        $parent_id = (int) $node['parent'];
        $options = $cp_options->getOptions((int) $node['child']);
        $mappings = $cp_options->getMappings();
 
        if (!$ilAccess->checkAccess('copy', '', (int) $node['child'])) {
            ilLoggerFactory::getLogger('obj')->error('No copy permission granted: ' . $source_id . ', ' . $node['title'] . ', ' . $node['type']);
            return 0;
        }
        if (!isset($mappings[$parent_id])) {
            ilLoggerFactory::getLogger('obj')->info('Omitting node ' . $source_id . ', ' . $node['title'] . ', ' . $node['type'] . '. No target found.');
            return 0;
        }
        $target_id = $mappings[$parent_id];
 
        if (!$tree->isInTree($target_id)) {
            ilLoggerFactory::getLogger('obj')->notice('Omitting node ' . $source_id . ', ' . $node['title'] . ', ' . $node['type'] . '. Object has been deleted.');
            return 0;
        }
 
        $orig = ilObjectFactory::getInstanceByRefId($source_id);
        $new_obj = $orig->cloneObject((int) $target_id, $cp_options->getCopyId());
 
        if (!is_object($new_obj)) {
            ilLoggerFactory::getLogger('obj')->error('Error copying ' . $source_id . ', ' . $node['title'] . ', ' . $node['type'] . '. No target found.');
            return 0;
        }
 
        // rbac log
        include_once "Services/AccessControl/classes/class.ilRbacLog.php";
        $rbac_log_roles = $rbacreview->getParentRoleIds($new_obj->getRefId(), false);
        $rbac_log = ilRbacLog::gatherFaPa($new_obj->getRefId(), array_keys($rbac_log_roles), true);
        ilRbacLog::add(ilRbacLog::COPY_OBJECT, $new_obj->getRefId(), $rbac_log, true);
 
        // Finally add new mapping entry
        $cp_options->appendMapping($source_id, $new_obj->getRefId());
        return $new_obj->getRefId();
    }

References $DIC, $target_id, ilRbacLog\add(), ilCopyWizardOptions\appendMapping(), ilRbacLog\COPY_OBJECT, ilRbacLog\gatherFaPa(), ilCopyWizardOptions\getCopyId(), ilObjectFactory\getInstanceByRefId(), ilLoggerFactory\getLogger(), ilCopyWizardOptions\getMappings(), ilCopyWizardOptions\getOptions(), and ILIAS\Repository\int().

Referenced by ilClone().

Here is the call graph for this function:

Here is the caller graph for this function:

deleteExpiredDualOptInUserObjects()

ilSoapUtils::deleteExpiredDualOptInUserObjects	(	string	$sid,
		int	$usr_id
	)

Method for soap webservice: deleteExpiredDualOptInUserObjects This service will run in background.

The client has not to wait for response.

Definition at line 546 of file class.ilSoapUtils.php.

                                                                               : bool
    {
        $this->initAuth($sid);
        $this->initIlias();
 
        // Session check not possible -> anonymous user is the trigger
 
        global $DIC;
 
        $ilDB = $DIC->database();
        $ilLog = $DIC->logger()->user();
 
        $ilLog->debug('Started deletion of inactive user objects with expired confirmation hash values (dual opt in) ...');
        require_once 'Services/Registration/classes/class.ilRegistrationSettings.php';
        $oRegSettigs = new ilRegistrationSettings();
        $query = '';
 
        /*
         * Fetch the current actuator user object first, because this user will try to perform very probably
         * a new registration with the same login name in a few seconds ;-)
         *
         */
        if ($usr_id > 0) {
            $query .= 'SELECT usr_id, create_date, reg_hash FROM usr_data '
                . 'WHERE active = 0 '
                . 'AND reg_hash IS NOT NULL '
                . 'AND usr_id = ' . $ilDB->quote($usr_id, 'integer') . ' ';
            $query .= 'UNION ';
        }
 
        $query .= 'SELECT usr_id, create_date, reg_hash FROM usr_data '
            . 'WHERE active = 0 '
            . 'AND reg_hash IS NOT NULL '
            . 'AND usr_id != ' . $ilDB->quote($usr_id, 'integer') . ' ';
 
        $res = $ilDB->query($query);
 
        $ilLog->debug($ilDB->numRows($res) . ' inactive user objects with confirmation hash values (dual opt in) found ...');
 
        /*
         * mjansen: 15.12.2010:
         * I perform the expiration check in php because of multi database support (mysql, postgresql).
         * I did not find an oracle equivalent for mysql: UNIX_TIMESTAMP()
         */
 
        $num_deleted_users = 0;
        while ($row = $ilDB->fetchAssoc($res)) {
            if ((int) $row['usr_id'] === ANONYMOUS_USER_ID || (int) $row['usr_id'] === SYSTEM_USER_ID) {
                continue;
            }
 
            if (($row['reg_hash'] ?? '') === '') {
                continue;
            }
 
            if (($row['create_date'] ?? '') !== '' &&
                $oRegSettigs->getRegistrationHashLifetime() > 0 &&
                time() - $oRegSettigs->getRegistrationHashLifetime() > strtotime($row['create_date'])) {
                $user = ilObjectFactory::getInstanceByObjId($row['usr_id'], false);
                if ($user instanceof ilObjUser) {
                    $ilLog->info('User ' . $user->getLogin() . ' (obj_id: ' . $user->getId() . ') will be deleted due to an expired registration hash ...');
                    $user->delete();
                    ++$num_deleted_users;
                }
            }
        }
 
        $ilLog->info($num_deleted_users . ' inactive user objects with expired confirmation hash values (dual opt in) deleted ...');
        $ilLog->info('Finished deletion of inactive user objects with expired confirmation hash values (dual opt in) ...');
 
        return true;
    }

References $DIC, $ilDB, $query, $res, ANONYMOUS_USER_ID, ilObjectFactory\getInstanceByObjId(), ilSoapAdministration\initAuth(), ilSoapAdministration\initIlias(), and SYSTEM_USER_ID.

Here is the call graph for this function:

disableSOAPCheck()

ilSoapUtils::disableSOAPCheck

(

)

Definition at line 39 of file class.ilSoapUtils.php.

                                      : void
    {
        $this->soap_check = false;
    }

distributeMails()

ilSoapUtils::distributeMails	(	string	$sid,
		string	$a_mail_xml
	)

Deprecated:

Returns

bool|soap_fault|SoapFault|null

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

    {
        $this->initAuth($sid);
        $this->initIlias();
 
        global $DIC;
        $logger = $DIC->logger->wsrv();
 
        if (!$this->checkSession($sid)) {
            return $this->raiseError($this->getMessage(), $this->getMessageCode());
        }
 
        include_once 'Services/Mail/classes/class.ilMail.php';
        include_once 'webservice/soap/classes/class.ilSoapMailXmlParser.php';
 
        $parser = new ilSoapMailXmlParser($a_mail_xml);
        try {
            // Check if wellformed
            libxml_use_internal_errors(true);
            $ok = simplexml_load_string($a_mail_xml);
            if (!$ok) {
                $error = '';
                foreach (libxml_get_errors() as $err) {
                    $error .= ($err->message . ' ');
                }
                return $this->raiseError($error, 'CLIENT');
            }
            $parser->start();
        } catch (InvalidArgumentException|ilSaxParserException $e) {
            $logger->warning($e->getMessage());
            return $this->raiseError($e->getMessage(), 'CLIENT');
        }
        $mails = $parser->getMails();
        $ilUser = $DIC->user();
 
        foreach ($mails as $mail) {
            include_once './Services/Mail/classes/class.ilFileDataMail.php';
            $file = new ilFileDataMail($ilUser->getId());
            $attachments = [];
            foreach ((array) $mail['attachments'] as $attachment) {
                $file->storeAsAttachment($attachment['name'], $attachment['content']);
                $attachments[] = ilFileUtils::_sanitizeFilemame($attachment['name']);
            }
 
            $mail_obj = new ilMail($ilUser->getId());
            $mail_obj->setSaveInSentbox(true);
            $mail_obj->saveAttachments($attachments);
            $mail_obj->enqueue(
                implode(',', (array) $mail['to']),
                implode(',', (array) $mail['cc']),
                implode(',', (array) $mail['bcc']),
                $mail['subject'],
                implode("\n", (array) $mail['body']),
                $attachments,
                (bool) $mail['usePlaceholders']
            );
 
            foreach ($attachments as $att) {
                $file->unlinkFile($att);
            }
            $mail_obj->persistToStage(
                $ilUser->getId(),
                [],
                '',
                '',
                '',
                '',
                ''
            );
        }
        return true;
    }

References $DIC, Vendor\Package\$e, $ilUser, ilFileUtils\_sanitizeFilemame(), ilSoapAdministration\checkSession(), ilSoapAdministration\getMessage(), ilSoapAdministration\getMessageCode(), ilSoapAdministration\initAuth(), ilSoapAdministration\initIlias(), and ilSoapAdministration\raiseError().

Here is the call graph for this function:

findMappedReferenceForNode()

ilSoapUtils::findMappedReferenceForNode ( \ilCopyWizardOptions  $cpo, array  $node  )

protected

Definition at line 308 of file class.ilSoapUtils.php.

                                                                                         : ?int
    {
        global $DIC;
 
        $logger = $DIC->logger()->obj();
        $tree = $DIC->repositoryTree();
        $root = $cpo->getRootNode();
        $obj_id = (int) $node['obj_id'];
 
        $mappings = $cpo->getMappings();
        foreach (\ilObject::_getAllReferences($obj_id) as $ref_id => $also_ref_id) {
            $logger->debug('Validating node: ' . $ref_id . ' and root ' . $root);
            $logger->dump($DIC->repositoryTree()->getRelation($ref_id, $root));
 
            if ($DIC->repositoryTree()->getRelation($ref_id, $root) !== \ilTree::RELATION_CHILD) {
                $logger->debug('Ignoring non child relation');
                continue;
            }
            // check if mapping is already available
            $logger->dump($mappings);
            if (array_key_exists($ref_id, $mappings)) {
                $logger->debug('Found existing mapping for linked node.');
                return $mappings[$ref_id];
            }
        }
        $logger->info('Nothing found');
        return null;
    }

References $DIC, $ref_id, ilObject\_getAllReferences(), ilCopyWizardOptions\getMappings(), ilCopyWizardOptions\getRootNode(), ILIAS\Repository\int(), and ilTree\RELATION_CHILD.

Referenced by internalLinkNode(), and rewriteActionForNode().

Here is the call graph for this function:

Here is the caller graph for this function:

getMobsOfObject()

ilSoapUtils::getMobsOfObject	(	string	$sid,
		string	$a_type,
		int	$a_id
	)

Returns

int[]|soap_fault|SoapFault|null

Definition at line 140 of file class.ilSoapUtils.php.

    {
        $this->initAuth($sid);
        $this->initIlias();
 
        if (!$this->checkSession($sid)) {
            return $this->raiseError($this->getMessage(), $this->getMessageCode());
        }
 
        include_once "./Services/MediaObjects/classes/class.ilObjMediaObject.php";
        return ilObjMediaObject::_getMobsOfObject($a_type, $a_id);
    }

References ilObjMediaObject\_getMobsOfObject(), ilSoapAdministration\checkSession(), ilSoapAdministration\getMessage(), ilSoapAdministration\getMessageCode(), ilSoapAdministration\initAuth(), ilSoapAdministration\initIlias(), and ilSoapAdministration\raiseError().

Here is the call graph for this function:

ignoreUserAbort()

ilSoapUtils::ignoreUserAbort

(

)

Definition at line 34 of file class.ilSoapUtils.php.

                                     : int
    {
        return ignore_user_abort(true);
    }

ilClone()

ilSoapUtils::ilClone	(	string	$sid,
		int	$copy_identifier
	)

Returns

bool|int|soap_fault|SoapFault|null

Definition at line 220 of file class.ilSoapUtils.php.

    {
        $this->initAuth($sid);
        $this->initIlias();
 
        if (!$this->checkSession($sid)) {
            ilLoggerFactory::getLogger('obj')->error('Object cloning failed. Invalid session given: ' . $this->getMessage());
        }
 
        global $DIC;
 
        $ilUser = $DIC->user();
 
        include_once('Services/CopyWizard/classes/class.ilCopyWizardOptions.php');
        $cp_options = ilCopyWizardOptions::_getInstance($copy_identifier);
 
        // Check owner of copy procedure
        if (!$cp_options->checkOwner($ilUser->getId())) {
            ilLoggerFactory::getLogger('obj')->error('Permission check failed for user id: ' . $ilUser->getId() . ', copy id: ' . $copy_identifier);
            return false;
        }
 
        // Fetch first node
        if (($node = $cp_options->fetchFirstNode()) === null) {
            ilLoggerFactory::getLogger('obj')->info('Finished copy step 1. Starting copying of object dependencies...');
            return $this->ilCloneDependencies($sid, $copy_identifier, true);
        }
        // Check options of this node
        $options = $cp_options->getOptions((int) $node['child']);
 
        $action = $this->rewriteActionForNode($cp_options, $node, $options);
 
        $new_ref_id = 0;
        switch ($action) {
            case ilCopyWizardOptions::COPY_WIZARD_OMIT:
                ilLoggerFactory::getLogger('obj')->debug(': Omitting node: ' . $node['obj_id'] . ', ' . $node['title'] . ', ' . $node['type']);
                // set mapping to zero
                $cp_options->appendMapping($node['child'], 0);
                $this->callNextNode($sid, $cp_options);
                break;
 
            case ilCopyWizardOptions::COPY_WIZARD_COPY:
 
                ilLoggerFactory::getLogger('obj')->debug('Start cloning node: ' . $node['obj_id'] . ', ' . $node['title'] . ', ' . $node['type']);
                $new_ref_id = $this->cloneNode($node, $cp_options);
                $this->callNextNode($sid, $cp_options);
                break;
 
            case ilCopyWizardOptions::COPY_WIZARD_LINK:
                ilLoggerFactory::getLogger('obj')->debug('Start linking node: ' . $node['obj_id'] . ', ' . $node['title'] . ', ' . $node['type']);
                $new_ref_id = $this->linkNode($node, $cp_options);
                $this->callNextNode($sid, $cp_options);
                break;
 
            case \ilCopyWizardOptions::COPY_WIZARD_LINK_TO_TARGET:
                ilLoggerFactory::getLogger('obj')->debug('Start creating internal link for: ' . $node['obj_id'] . ', ' . $node['title'] . ', ' . $node['type']);
                $new_ref_id = $this->internalLinkNode($node, $cp_options);
                $this->callNextNode($sid, $cp_options);
                break;
 
            default:
                ilLoggerFactory::getLogger('obj')->warning('No valid action type given for: ' . $node['obj_id'] . ', ' . $node['title'] . ', ' . $node['type']);
                $this->callNextNode($sid, $cp_options);
                break;
 
        }
        return $new_ref_id;
    }

References $DIC, $ilUser, ilCopyWizardOptions\_getInstance(), callNextNode(), ilSoapAdministration\checkSession(), cloneNode(), ilCopyWizardOptions\COPY_WIZARD_COPY, ilCopyWizardOptions\COPY_WIZARD_LINK, ilCopyWizardOptions\COPY_WIZARD_OMIT, ilLoggerFactory\getLogger(), ilSoapAdministration\getMessage(), ilCloneDependencies(), ilSoapAdministration\initAuth(), ilSoapAdministration\initIlias(), internalLinkNode(), linkNode(), and rewriteActionForNode().

Here is the call graph for this function:

ilCloneDependencies()

ilSoapUtils::ilCloneDependencies	(	string	$sid,
		int	$copy_identifier,
		bool	$is_initialized = false
	)

Returns

bool|soap_fault|SoapFault|null

Definition at line 156 of file class.ilSoapUtils.php.

    {
        if (!$is_initialized) {
            $this->initAuth($sid);
            $this->initIlias();
 
            if (!$this->checkSession($sid)) {
                return $this->raiseError($this->getMessage(), $this->getMessageCode());
            }
        }
 
        global $DIC;
 
        $ilLog = $DIC['ilLog'];
        $ilUser = $DIC['ilUser'];
 
        include_once('Services/CopyWizard/classes/class.ilCopyWizardOptions.php');
        $cp_options = ilCopyWizardOptions::_getInstance($copy_identifier);
 
        // Check owner of copy procedure
        if (!$cp_options->checkOwner($ilUser->getId())) {
            ilLoggerFactory::getLogger('obj')->error('Permission check failed for user id: ' . $ilUser->getId() . ', copy id: ' . $copy_identifier);
            return false;
        }
 
        // Fetch first node
        if (($node = $cp_options->fetchFirstDependenciesNode()) === null) {
            $cp_options->deleteAll();
            ilLoggerFactory::getLogger('obj')->info('Finished copy step 2. Copy completed');
            return true;
        }
 
        // Check options of this node
        $options = $cp_options->getOptions((int) $node['child']);
        $new_ref_id = 0;
        switch ($options['type']) {
            case ilCopyWizardOptions::COPY_WIZARD_OMIT:
                ilLoggerFactory::getLogger('obj')->debug(': Omitting node: ' . $node['obj_id'] . ', ' . $node['title'] . ', ' . $node['type']);
                $this->callNextDependency($sid, $cp_options);
                break;
 
            case ilCopyWizardOptions::COPY_WIZARD_LINK:
                ilLoggerFactory::getLogger('obj')->debug(': Start cloning dependencies for node: ' . $node['obj_id'] . ', ' . $node['title'] . ', ' . $node['type']);
                $this->cloneDependencies($node, $cp_options);
                $this->callNextDependency($sid, $cp_options);
                break;
 
            case ilCopyWizardOptions::COPY_WIZARD_COPY:
                ilLoggerFactory::getLogger('obj')->debug(': Start cloning dependencies: ' . $node['obj_id'] . ', ' . $node['title'] . ', ' . $node['type']);
                $this->cloneDependencies($node, $cp_options);
                $this->callNextDependency($sid, $cp_options);
                break;
 
            default:
                ilLoggerFactory::getLogger('obj')->warning('No valid action type given for node: ' . $node['obj_id'] . ', ' . $node['title'] . ', ' . $node['type']);
                $this->callNextDependency($sid, $cp_options);
                break;
        }
        return true;
    }

References $DIC, $ilUser, ilCopyWizardOptions\_getInstance(), callNextDependency(), ilSoapAdministration\checkSession(), cloneDependencies(), ilCopyWizardOptions\COPY_WIZARD_COPY, ilCopyWizardOptions\COPY_WIZARD_LINK, ilCopyWizardOptions\COPY_WIZARD_OMIT, ilLoggerFactory\getLogger(), ilSoapAdministration\getMessage(), ilSoapAdministration\getMessageCode(), ilSoapAdministration\initAuth(), ilSoapAdministration\initIlias(), and ilSoapAdministration\raiseError().

Referenced by ilClone().

Here is the call graph for this function:

Here is the caller graph for this function:

internalLinkNode()

ilSoapUtils::internalLinkNode ( array  $node, ilCopyWizardOptions  $cp_options  )

private

Definition at line 446 of file class.ilSoapUtils.php.

                                                                                   : int
    {
        global $DIC;
 
        $ilAccess = $DIC->access();
        $logger = $DIC->logger()->obj();
        $rbacreview = $DIC->rbac()->review();
        $tree = $DIC->repositoryTree();
        $mappings = $cp_options->getMappings();
 
        $source_id = $this->findMappedReferenceForNode($cp_options, $node);
        try {
            $orig = ilObjectFactory::getInstanceByRefId((int) $source_id);
            if (!$orig instanceof \ilObject) {
                $logger->error('Cannot create object instance.');
                return 0;
            }
        } catch (\ilObjectNotFoundException $e) {
            $logger->error('Cannot create object instance for ref_id: ' . $source_id);
            $logger->error($e->getMessage());
            return 0;
        }
 
        // target (parent id) is the mapped parent id of the current node
        $node_parent = $node['parent'];
        if (!array_key_exists($node_parent, $mappings)) {
            $logger->error('Cannot new parent id for node: ' . $node['parent']);
            return 0;
        }
        $parent_id = $mappings[$node_parent];
 
        $new_ref_id = $orig->createReference();
        $orig->putInTree($parent_id);
        $orig->setPermissions($parent_id);
 
        if (!($new_ref_id)) {
            $logger->warning('Creating internal link failed.');
            return 0;
        }
 
        // rbac log
        $rbac_log_roles = $rbacreview->getParentRoleIds($new_ref_id, false);
        $rbac_log = ilRbacLog::gatherFaPa($new_ref_id, array_keys($rbac_log_roles), true);
        ilRbacLog::add(ilRbacLog::LINK_OBJECT, $new_ref_id, $rbac_log, true);
 
        // Finally add new mapping entry
        $cp_options->appendMapping($node['child'], $new_ref_id);
 
        $logger->notice('Added mapping for ' . $node['child'] . ' ' . $new_ref_id);
        return $new_ref_id;
    }

References $DIC, Vendor\Package\$e, ilRbacLog\add(), ilCopyWizardOptions\appendMapping(), findMappedReferenceForNode(), ilRbacLog\gatherFaPa(), ilObjectFactory\getInstanceByRefId(), ilCopyWizardOptions\getMappings(), and ilRbacLog\LINK_OBJECT.

Referenced by ilClone().

Here is the call graph for this function:

Here is the caller graph for this function:

linkNode()

ilSoapUtils::linkNode ( array  $node, ilCopyWizardOptions  $cp_options  )

private

Definition at line 498 of file class.ilSoapUtils.php.

                                                                           : int
    {
        global $DIC;
 
        $ilLog = $DIC['ilLog'];
        $ilAccess = $DIC['ilAccess'];
        $rbacreview = $DIC['rbacreview'];
 
        $source_id = (int) $node['child'];
        $parent_id = (int) $node['parent'];
        $options = $cp_options->getOptions((int) $node['child']);
        $mappings = $cp_options->getMappings();
 
        if (!$ilAccess->checkAccess('delete', '', (int) $node['child'])) {
            ilLoggerFactory::getLogger('obj')->warning('No delete permission granted: ' . $source_id . ', ' . $node['title'] . ', ' . $node['type']);
            return 0;
        }
        if (!isset($mappings[$parent_id])) {
            ilLoggerFactory::getLogger('obj')->warning('Omitting node ' . $source_id . ', ' . $node['title'] . ', ' . $node['type'] . '. No target found.');
            return 0;
        }
        $target_id = $mappings[$parent_id];
 
        $orig = ilObjectFactory::getInstanceByRefId($source_id);
        $new_ref_id = $orig->createReference();
        $orig->putInTree($target_id);
        $orig->setPermissions($target_id);
 
        if (!($new_ref_id)) {
            ilLoggerFactory::getLogger('obj')->error('Error linking ' . $source_id . ', ' . $node['title'] . ', ' . $node['type'] . '. No target found.');
            return 0;
        }
 
        // rbac log
        include_once "Services/AccessControl/classes/class.ilRbacLog.php";
        $rbac_log_roles = $rbacreview->getParentRoleIds($new_ref_id, false);
        $rbac_log = ilRbacLog::gatherFaPa($new_ref_id, array_keys($rbac_log_roles), true);
        ilRbacLog::add(ilRbacLog::LINK_OBJECT, $new_ref_id, $rbac_log, true);
 
        // Finally add new mapping entry
        $cp_options->appendMapping($source_id, $new_ref_id);
        return $new_ref_id;
    }

References $DIC, $target_id, ilRbacLog\add(), ilCopyWizardOptions\appendMapping(), ilRbacLog\gatherFaPa(), ilObjectFactory\getInstanceByRefId(), ilLoggerFactory\getLogger(), ilCopyWizardOptions\getMappings(), ilCopyWizardOptions\getOptions(), ILIAS\Repository\int(), and ilRbacLog\LINK_OBJECT.

Referenced by ilClone().

Here is the call graph for this function:

Here is the caller graph for this function:

rewriteActionForNode()

ilSoapUtils::rewriteActionForNode ( ilCopyWizardOptions  $cpo, array  $node, array  $options  )

protected

Definition at line 289 of file class.ilSoapUtils.php.

                                                                                                  : int
    {
        $default_mode = \ilCopyWizardOptions::COPY_WIZARD_UNDEFINED;
        if (array_key_exists('type', $options)) {
            $default_mode = (int) $options['type'];
        }
        if (
            array_key_exists('child', $node) &&
            $cpo->isRootNode((int) $node['child'])
        ) {
            return $default_mode;
        }
 
        if ($this->findMappedReferenceForNode($cpo, $node) && $default_mode == \ilCopyWizardOptions::COPY_WIZARD_COPY) {
            return \ilCopyWizardOptions::COPY_WIZARD_LINK_TO_TARGET;
        }
        return $default_mode;
    }

References ilCopyWizardOptions\COPY_WIZARD_COPY, ilCopyWizardOptions\COPY_WIZARD_UNDEFINED, findMappedReferenceForNode(), ILIAS\Repository\int(), and ilCopyWizardOptions\isRootNode().

Referenced by ilClone().

Here is the call graph for this function:

Here is the caller graph for this function:

saveTempFileAsMediaObject()

ilSoapUtils::saveTempFileAsMediaObject	(	string	$sid,
		string	$name,
		string	$tmp_name
	)

Returns

ilObjMediaObject|soap_fault|SoapFault|null

Definition at line 124 of file class.ilSoapUtils.php.

    {
        $this->initAuth($sid);
        $this->initIlias();
 
        if (!$this->checkSession($sid)) {
            return $this->raiseError($this->getMessage(), $this->getMessageCode());
        }
 
        include_once "./Services/MediaObjects/classes/class.ilObjMediaObject.php";
        return ilObjMediaObject::_saveTempFileAsMediaObject($name, $tmp_name);
    }

References $name, ilObjMediaObject\_saveTempFileAsMediaObject(), ilSoapAdministration\checkSession(), ilSoapAdministration\getMessage(), ilSoapAdministration\getMessageCode(), ilSoapAdministration\initAuth(), ilSoapAdministration\initIlias(), and ilSoapAdministration\raiseError().

Here is the call graph for this function:

---

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

• webservice/soap/classes/class.ilSoapUtils.php