Пример #1
0
 /**
  * Store a file referenced by $qtiResource into the final $testContent folder. If the path provided
  * by $qtiResource contains sub-directories, they will be created before copying the file (even
  * if $copy = false).
  * 
  * @param Directory $testContent The pointer to the TAO Test Content folder.
  * @param oat\taoQtiItem\model\qti\Resource|string $qtiResource The QTI resource to be copied into $testContent. If given as a string, it must be the relative (to the IMS QTI Package) path to the resource file.
  * @param string $origin The path to the directory (root folder of extracted IMS QTI package) containing the QTI resource to be copied.
  * @param boolean $copy If set to false, the file will not be actually copied.
  * @param string $rename A new filename  e.g. 'file.css' to be used at storage time.
  * @return string The path were the file was copied/has to be copied (depending on the $copy argument).
  * @throws InvalidArgumentException If one of the above arguments is invalid.
  * @throws common_Exception If the copy fails.
  */
 public static function storeQtiResource(Directory $testContent, $qtiResource, $origin, $copy = true, $rename = '')
 {
     $fss = ServiceManager::getServiceManager()->get(FileSystemService::SERVICE_ID);
     $fs = $fss->getFileSystem($testContent->getFileSystem()->getId());
     $contentPath = $testContent->getPrefix();
     $ds = DIRECTORY_SEPARATOR;
     $contentPath = rtrim($contentPath, $ds);
     if ($qtiResource instanceof Resource) {
         $filePath = $qtiResource->getFile();
     } else {
         if (is_string($qtiResource) === true) {
             $filePath = $qtiResource;
         } else {
             throw new InvalidArgumentException("The 'qtiResource' argument must be a string or a taoQTI_models_classes_QTI_Resource object.");
         }
     }
     $resourcePathinfo = pathinfo($filePath);
     if (empty($resourcePathinfo['dirname']) === false && $resourcePathinfo['dirname'] !== '.') {
         // The resource file is not at the root of the archive but in a sub-folder.
         // Let's copy it in the same way into the Test Content folder.
         $breadCrumb = $contentPath . $ds . str_replace('/', $ds, $resourcePathinfo['dirname']);
         $breadCrumb = rtrim($breadCrumb, $ds);
         $finalName = empty($rename) === true ? $resourcePathinfo['filename'] . '.' . $resourcePathinfo['extension'] : $rename;
         $finalPath = $breadCrumb . $ds . $finalName;
     } else {
         // The resource file is at the root of the archive.
         // Overwrite template test.xml (created by self::createContent() method above) file with the new one.
         $finalName = empty($rename) === true ? $resourcePathinfo['filename'] . '.' . $resourcePathinfo['extension'] : $rename;
         $finalPath = $contentPath . $ds . $finalName;
     }
     if ($copy === true) {
         $origin = str_replace('/', $ds, $origin);
         $origin = rtrim($origin, $ds);
         $sourcePath = $origin . $ds . str_replace('/', $ds, $filePath);
         if (is_readable($sourcePath) === false) {
             throw new common_Exception("An error occured while copying the QTI resource from '{$sourcePath}' to '{$finalPath}'.");
         }
         $fh = fopen($sourcePath, 'r');
         $success = $fs->writeStream($finalPath, $fh);
         fclose($fh);
         if (!$success) {
             throw new common_Exception("An error occured while copying the QTI resource from '{$sourcePath}' to '{$finalPath}'.");
         }
     }
     return $finalPath;
 }
 /**
  * Enables you to build the QTI_Resources from a manifest xml data node
  * Content Packaging 1.1)
  *
  * @access public
  * @author Joel Bout, <*****@*****.**>
  * @param  SimpleXMLElement source
  * @return array
  * @see http://www.imsglobal.org/question/qti_v2p0/imsqti_intgv2p0.html#section10003
  */
 public static function getResourcesFromManifest(SimpleXMLElement $source)
 {
     $returnValue = array();
     //check of the root tag
     if ($source->getName() != 'manifest') {
         throw new ParsingException("incorrect manifest root tag");
     }
     $resourceNodes = $source->xpath("//*[name(.)='resource']");
     foreach ($resourceNodes as $resourceNode) {
         $type = (string) $resourceNode['type'];
         if (Resource::isAssessmentItem($type)) {
             $id = (string) $resourceNode['identifier'];
             $href = isset($resourceNode['href']) ? (string) $resourceNode['href'] : '';
             $auxFiles = array();
             //parse for auxiliary files
             foreach ($resourceNode->file as $fileNode) {
                 $fileHref = (string) $fileNode['href'];
                 if ($href != $fileHref) {
                     $auxFiles[] = $fileHref;
                 }
             }
             //include dependency files in item
             foreach ($resourceNode->dependency as $dependencyNode) {
                 $ref = (string) $dependencyNode['identifierref'];
                 //find referenced files within the current manifest:
                 $refResourceNodes = $source->xpath("//*[name(.)='resource' and @identifier='" . $ref . "']");
                 foreach ($refResourceNodes as $refResourceNode) {
                     if (isset($refResourceNode['href'])) {
                         $auxFiles[] = (string) $refResourceNode['href'];
                     }
                 }
             }
             $resource = new Resource($id, $type, $href);
             $resource->setAuxiliaryFiles($auxFiles);
             $returnValue[] = $resource;
         }
     }
     return (array) $returnValue;
 }
 /**
  * Imports the auxiliary files (file elements contained in the resource test element to be imported) into
  * the TAO Test Content directory.
  *
  * If some file cannot be copied, warnings will be committed.
  *
  * @param core_kernel_file_File $testContent The pointer to the TAO Test Content directory where auxilliary files will be stored.
  * @param oat\taoQtiItem\model\qti\Resource $qtiResource The manifest resource describing the test to be imported.
  * @param string $extractionFolder The absolute path to the temporary folder containing the content of the imported IMS QTI Package Archive.
  * @param common_report_Report A report about how the importation behaved.
  */
 protected function importTestAuxiliaryFiles(core_kernel_file_File $testContent, Resource $qtiResource, $extractionFolder, common_report_Report $report)
 {
     foreach ($qtiResource->getAuxiliaryFiles() as $aux) {
         try {
             taoQtiTest_helpers_Utils::storeQtiResource($testContent, $aux, $extractionFolder);
         } catch (common_Exception $e) {
             $report->add(new common_report_Report(common_report_Report::TYPE_WARNING, __('Auxiliary file not found at location "%s".', $aux)));
         }
     }
 }
 /**
  * Import metadata to a given QTI Item.
  *
  * @param oat\taoQtiItem\model\qti\metadata\MetadataValue[] $metadataValues An array of MetadataValue objects.
  * @param Resource $qtiResource The object representing the QTI Resource, from an IMS Manifest perspective.
  * @param core_kernel_classes_Resource $resource The object representing the target QTI Item in the Ontology.
  * @param oat\taoQtiItem\model\qti\metadata\MetadataInjector[] $ontologyInjectors Implementations of MetadataInjector that will take care to inject the metadata values in the appropriate Ontology Resource Properties.
  * @throws oat\taoQtiItem\model\qti\metadata\MetadataInjectionException If an error occurs while importing the metadata.
  */
 public function importItemMetadata(array $metadataValues, Resource $qtiResource, core_kernel_classes_Resource $resource, array $ontologyInjectors = array())
 {
     // Filter metadata values for this given item.
     $identifier = $qtiResource->getIdentifier();
     if (isset($metadataValues[$identifier]) === true) {
         $values = $metadataValues[$identifier];
         foreach ($ontologyInjectors as $injector) {
             $injector->inject($resource, array($identifier => $values));
         }
     }
 }
Пример #5
0
 /**
  * Import dependencies files
  *
  * @param QtiResource $qtiItemResource
  * @param $dependencies
  * @return $this
  * @throws AssetManagerException
  */
 public function importDependencyFiles(QtiResource $qtiItemResource, $dependencies)
 {
     $qtiFile = $this->getSource() . \helpers_File::urlToPath($qtiItemResource->getFile());
     foreach ($qtiItemResource->getDependencies() as $dependenciesFile) {
         if (!isset($dependencies[$dependenciesFile])) {
             continue;
         }
         $absolutePath = $this->getAbsolutePath($dependencies[$dependenciesFile]->getFile());
         $relativePath = $this->getRelativePath($qtiFile, $absolutePath);
         try {
             $this->importAsset($absolutePath, $relativePath);
         } catch (\common_Exception $e) {
             throw new AssetManagerException('Error occurs during dependency assets handling for item: ' . $qtiItemResource->getIdentifier() . ', assetFile: ' . $relativePath, 0, $e);
         }
     }
     return $this;
 }
 /**
  * Import metadata to a given QTI Item.
  *
  * @param oat\taoQtiItem\model\qti\metadata\MetadataValue[] $metadataValues An array of MetadataValue objects.
  * @param Resource $qtiResource The object representing the QTI Resource, from an IMS Manifest perspective.
  * @param core_kernel_classes_Resource $resource The object representing the target QTI Item in the Ontology.
  * @param oat\taoQtiItem\model\qti\metadata\MetadataInjector[] $ontologyInjectors Implementations of MetadataInjector that will take care to inject the metadata values in the appropriate Ontology Resource Properties.
  * @throws oat\taoQtiItem\model\qti\metadata\MetadataInjectionException If an error occurs while importing the metadata.
  */
 public function importResourceMetadata(array $metadataValues, Resource $qtiResource, core_kernel_classes_Resource $resource, array $ontologyInjectors = array())
 {
     // Filter metadata values for this given item.
     $identifier = $qtiResource->getIdentifier();
     if (isset($metadataValues[$identifier]) === true) {
         \common_Logger::i("Preparing Metadata Values for resource '{$identifier}'...");
         $values = $metadataValues[$identifier];
         foreach ($ontologyInjectors as $injector) {
             $valuesCount = count($values);
             $injectorClass = get_class($injector);
             \common_Logger::i("Attempting to inject {$valuesCount} Metadata Values in database for resource '{$identifier}' with Metadata Injector '{$injectorClass}'.");
             $injector->inject($resource, array($identifier => $values));
         }
     }
 }
Пример #7
0
 /**
  * It is sometimes necessary to identify the link between assessmentItemRefs described in a QTI Test definition and the resources
  * describing items in IMS Manifest file. This utility method helps you to achieve this.
  * 
  * The method will return an array describing the IMS Manifest resources that were found in an IMS Manifest file on basis of
  * the assessmentItemRefs found in an AssessmentTest definition. The keys of the arrays are assessmentItemRef identifiers and
  * values are IMS Manifest Resources. 
  * 
  * If an IMS Manifest Resource cannot be found for a given assessmentItemRef, the value in the returned array will be false.
  * 
  * @param XmlDocument $test A QTI Test Definition.
  * @param taoQtiTest_models_classes_ManifestParser $manifestParser A Manifest Parser.
  * @param string $basePath The base path of the folder the IMS archive is exposed as a file system component.
  * @return array An array containing two arrays (items and dependencies) where keys are identifiers and values are oat\taoQtiItem\model\qti\Resource objects or false.
  */
 public static function buildAssessmentItemRefsTestMap(XmlDocument $test, taoQtiTest_models_classes_ManifestParser $manifestParser, $basePath)
 {
     $assessmentItemRefs = $test->getDocumentComponent()->getComponentsByClassName('assessmentItemRef');
     $map = array('items' => array(), 'dependencies' => array());
     $itemResources = $manifestParser->getResources(Resource::getItemTypes(), taoQtiTest_models_classes_ManifestParser::FILTER_RESOURCE_TYPE);
     $allResources = $manifestParser->getResources();
     // cleanup $basePath.
     $basePath = rtrim($basePath, "/\\");
     $basePath = helpers_File::truePath($basePath);
     $basePath .= DIRECTORY_SEPARATOR;
     $documentURI = preg_replace("/^file:\\/{1,3}/", '', $test->getDomDocument()->documentURI);
     $testPathInfo = pathinfo($documentURI);
     $testBasePath = tao_helpers_File::truePath($testPathInfo['dirname']) . DIRECTORY_SEPARATOR;
     foreach ($assessmentItemRefs as $itemRef) {
         // Find the QTI Resource (in IMS Manifest) related to the item ref.
         // To achieve this, we compare their path.
         $itemRefRelativeHref = str_replace('/', DIRECTORY_SEPARATOR, $itemRef->getHref());
         $itemRefRelativeHref = ltrim($itemRefRelativeHref, "/\\");
         $itemRefCanonicalHref = helpers_File::truePath($testBasePath . $itemRefRelativeHref);
         $map['items'][$itemRef->getIdentifier()] = false;
         // Compare with items referenced in the manifest.
         foreach ($itemResources as $itemResource) {
             $itemResourceRelativeHref = str_replace('/', DIRECTORY_SEPARATOR, $itemResource->getFile());
             $itemResourceRelativeHref = ltrim($itemResourceRelativeHref, "/\\");
             $itemResourceCanonicalHref = helpers_File::truePath($basePath . $itemResourceRelativeHref);
             // With some Windows flavours (Win7, Win8), the $itemRefCanonicalHref comes out with
             // a leading 'file:\' component. Let's clean this. (str_replace is binary-safe \0/)
             $os = tao_helpers_Environment::getOperatingSystem();
             if ($os === 'WINNT' || $os === 'WIN32' || $os === 'Windows') {
                 $itemRefCanonicalHref = str_replace('file:\\', '', $itemRefCanonicalHref);
                 // And moreover, it sometimes refer the temp directory as Windows\TEMP instead of Windows\Temp.
                 $itemRefCanonicalHref = str_replace('\\TEMP\\', '\\Temp\\', $itemRefCanonicalHref);
             }
             // With some MacOS flavours, the $itemRefCanonicalHref comes out with
             // a leading '/private' component. Clean it!
             if ($os === 'Darwin') {
                 $itemRefCanonicalHref = str_replace('/private', '', $itemRefCanonicalHref);
             }
             if ($itemResourceCanonicalHref == $itemRefCanonicalHref && is_file($itemResourceCanonicalHref)) {
                 // assessmentItemRef <-> IMS Manifest resource successful binding!
                 $map['items'][$itemRef->getIdentifier()] = $itemResource;
                 //get dependencies for each item
                 foreach ($itemResource->getDependencies() as $dependencyIdentifier) {
                     /** @var taoQtiTest_models_classes_QtiResource $resource */
                     foreach ($allResources as $resource) {
                         if ($dependencyIdentifier == $resource->getIdentifier()) {
                             $map['dependencies'][$dependencyIdentifier] = $resource;
                             break;
                         }
                     }
                 }
                 break;
             }
         }
     }
     return $map;
 }