webservice/soap/classes/class.ilSoapFileAdministration.php

Go to the documentation of this file.

<?php
  /*
   +-----------------------------------------------------------------------------+
   | ILIAS open source                                                           |
   +-----------------------------------------------------------------------------+
   | Copyright (c) 1998-2006 ILIAS open source, University of Cologne            |
   |                                                                             |
   | This program is free software; you can redistribute it and/or               |
   | modify it under the terms of the GNU General Public License                 |
   | as published by the Free Software Foundation; either version 2              |
   | of the License, or (at your option) any later version.                      |
   |                                                                             |
   | This program is distributed in the hope that it will be useful,             |
   | but WITHOUT ANY WARRANTY; without even the implied warranty of              |
   | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               |
   | GNU General Public License for more details.                                |
   |                                                                             |
   | You should have received a copy of the GNU General Public License           |
   | along with this program; if not, write to the Free Software                 |
   | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA. |
   +-----------------------------------------------------------------------------+
  */


include_once './webservice/soap/classes/class.ilSoapAdministration.php';

class ilSoapFileAdministration extends ilSoapAdministration
{
        function ilSoapFileAdministration()
        {
                parent::ilSoapAdministration();
        }

        function addFile ($sid, $target_id, $file_xml) {

            if(!$this->__checkSession($sid))
                {
                        return $this->__raiseError($this->sauth->getMessage(),$this->sauth->getMessageCode());
                }
        include_once './include/inc.header.php';
        global $rbacsystem, $tree, $ilLog;

        if(!$target_obj =& ilObjectFactory::getInstanceByRefId($target_id,false))
                {
                        return $this->__raiseError('No valid target given.', 'Client');
                }


                if(ilObject::_isInTrash($target_id))
                {
                        return $this->__raiseError("Parent with ID $target_id has been deleted.", 'CLIENT_TARGET_DELETED');
                }

                // Check access
                $allowed_types = array('cat','grp','crs','fold');
                if(!in_array($target_obj->getType(), $allowed_types))
                {
                        return $this->__raiseError('No valid target type. Target must be reference id of "course, group, category or folder"', 'Client');
                }

            if(!$rbacsystem->checkAccess('create',$target_id,"file"))
                {
                        return $this->__raiseError('No permission to create Files in target  '.$target_id.'!', 'Client');
                }

        // create object, put it into the tree and use the parser to update the settings
                include_once './Modules/File/classes/class.ilFileXMLParser.php';
                include_once './Modules/File/classes/class.ilFileException.php';
                include_once './Modules/File/classes/class.ilObjFile.php';

                $file = new ilObjFile();
    try
        {

                $fileXMLParser = new ilFileXMLParser($file, $file_xml);

                if ($fileXMLParser->start()) 
                {
          $file->create();
                $file->createReference();
                $file->putInTree($target_id);
                $file->setPermissions($target_id);

                // we now can save the file contents since we know the obj id now.
                $fileXMLParser->setFileContents();

          return $file->getRefId();
        } else 
        {
                return $this->__raiseError("Could not add file", "Server");
        } 
        } catch(ilFileException $exception) {
          return $this->__raiseError($exception->getMessage(), $exception->getCode() == ilFileException::$ID_MISMATCH ? "Client" : "Server");
        }
           }


        function updateFile ($sid, $ref_id, $file_xml) {
            if(!$this->__checkSession($sid))
                {
                        return $this->__raiseError($this->sauth->getMessage(),$this->sauth->getMessageCode());
                }
        include_once './include/inc.header.php';
        global $rbacsystem, $tree, $ilLog;

                if(ilObject::_isInTrash($ref_id))
                {
                        return $this->__raiseError('Cannot perform update since file has been deleted.', 'CLIENT_OBJECT_DELETED');
                }
        // get obj_id
                if(!$obj_id = ilObject::_lookupObjectId($ref_id))
                {
                        return $this->__raiseError('No File found for id: '.$ref_id,
                                                                           'Client');
                }

                // Check access
                $permission_ok = false;
                foreach($ref_ids = ilObject::_getAllReferences($obj_id) as $ref_id)
                {
                        if($rbacsystem->checkAccess('edit',$ref_id))
                        {
                                $permission_ok = true;
                                break;
                        }
                }

                if(!$permission_ok)
                {
                        return $this->__raiseError('No permission to edit the File with id: '.$ref_id,
                                                                           'Server');
                }


                $file = ilObjectFactory::getInstanceByObjId($obj_id, false);

                if (!is_object($file) || $file->getType()!= "file")
                {
            return $this->__raiseError('Wrong obj id or type for File with id '.$ref_id,
                                                                           'Server');
                }

                include_once './Modules/File/classes/class.ilFileXMLParser.php';
                include_once './Modules/File/classes/class.ilFileException.php';
        $fileXMLParser = new ilFileXMLParser($file, $file_xml, $obj_id);

        try
        {

            if ($fileXMLParser->start())
            {
                $fileXMLParser->updateFileContents();

                return  $file->update();
            }
        } catch(ilFileException $exception) {
           return $this->__raiseError($exception->getMessage(),
                                                                           $exception->getCode() == ilFileException::$ID_MISMATCH ? "Client" : "Server");
        }
        return false;
    }

        function getFileXML ($sid, $ref_id, $attachFileContentsMode) {
            if(!$this->__checkSession($sid))
                {
                        return $this->__raiseError($this->sauth->getMessage(),$this->sauth->getMessageCode());
                }
                if(!strlen($ref_id))
                {
                        return $this->__raiseError('No ref id given. Aborting!',
                                                                           'Client');
                }
            include_once './include/inc.header.php';
                global $rbacsystem, $tree, $ilLog;


                // get obj_id
                if(!$obj_id = ilObject::_lookupObjectId($ref_id))
                {
                        return $this->__raiseError('No File found for id: '.$ref_id,
                                                                           'Client');
                }

                if(ilObject::_isInTrash($ref_id))
                {
                        return $this->__raiseError("Object with ID $ref_id has been deleted.", 'Client');
                }

                // Check access
                $permission_ok = false;
                foreach($ref_ids = ilObject::_getAllReferences($obj_id) as $ref_id)
                {
                        if($rbacsystem->checkAccess('read',$ref_id))
                        {
                                $permission_ok = true;
                                break;
                        }
                }

                if(!$permission_ok)
                {
                        return $this->__raiseError('No permission to edit the object with id: '.$ref_id,
                                                                           'Server');
                }

                $file = ilObjectFactory::getInstanceByObjId($obj_id, false);

                if (!is_object($file) || $file->getType()!= "file")
                {
            return $this->__raiseError('Wrong obj id or type for File with id '.$ref_id,
                                                                           'Server');
                }
            // store into xml result set
                include_once './Modules/File/classes/class.ilFileXMLWriter.php';

                // create writer
                $xmlWriter = new ilFileXMLWriter();
                $xmlWriter->setFile($file);
                $xmlWriter->setAttachFileContents($attachFileContentsMode);
                $xmlWriter->start();

                return $xmlWriter->getXML();
        }
}
?>