/** * Creates a Tracker Object * * @param SimpleXMLElement $xml containing the structure of the imported tracker * @param int $groupId - id of the project into which the tracker is imported * @param string $name of the tracker given by the user * @param string $description of the tracker given by the user * @param string $itemname - short_name of the tracker given by the user * * @return Tracker Object */ protected function getInstanceFromXML($xml, $groupId, $name, $description, $itemname) { // set general settings // real id will be set during Database update $att = $xml->attributes(); $row = array('id' => 0, 'name' => $name, 'group_id' => $groupId, 'description' => $description, 'item_name' => $itemname, 'submit_instructions' => (string) $xml->submit_instructions, 'browse_instructions' => (string) $xml->browse_instructions, 'status' => '', 'deletion_date' => '', 'color' => (string) $xml->color); $row['allow_copy'] = isset($att['allow_copy']) ? (int) $att['allow_copy'] : 0; $row['instantiate_for_new_projects'] = isset($att['instantiate_for_new_projects']) ? (int) $att['instantiate_for_new_projects'] : 0; $row['log_priority_changes'] = isset($att['log_priority_changes']) ? (int) $att['log_priority_changes'] : 0; $row['stop_notification'] = isset($att['stop_notification']) ? (int) $att['stop_notification'] : 0; $tracker = $this->tracker_factory->getInstanceFromRow($row); // set canned responses if (isset($xml->cannedResponses)) { foreach ($xml->cannedResponses->cannedResponse as $index => $response) { $tracker->cannedResponses[] = $this->canned_response_factory->getInstanceFromXML($response); } } // set formElements foreach ($xml->formElements->formElement as $index => $elem) { $tracker->formElements[] = $this->formelement_factory->getInstanceFromXML($tracker, $elem, $this->xmlFieldsMapping); } // set semantics if (isset($xml->semantics)) { foreach ($xml->semantics->semantic as $xml_semantic) { $semantic = $this->semantic_factory->getInstanceFromXML($xml_semantic, $this->xmlFieldsMapping, $tracker); if ($semantic) { $tracker->semantics[] = $semantic; } } } /* * Legacy compatibility * * All new Tuleap versions will not export dependencies but rules instead. * However, we still want to be able to import old xml files. * * SimpleXML does not allow for nodes to be moved so have to recursively * generate rules from the dependencies data. */ if (isset($xml->dependencies)) { $list_rules = null; if (!isset($xml->rules)) { $list_rules = $xml->addChild('rules')->addChild('list_rules'); } elseif (!isset($xml->rules->list_rules)) { $list_rules = $xml->rules->addChild('list_rules', $xml->dependencies); } if ($list_rules !== null) { foreach ($xml->dependencies->rule as $old_rule) { $source_field_attributes = $old_rule->source_field->attributes(); $target_field_attributes = $old_rule->target_field->attributes(); $source_value_attributes = $old_rule->source_value->attributes(); $target_value_attributes = $old_rule->target_value->attributes(); $new_rule = $list_rules->addChild('rule', $old_rule); $new_rule->addChild('source_field')->addAttribute('REF', $source_field_attributes['REF']); $new_rule->addChild('target_field')->addAttribute('REF', $target_field_attributes['REF']); $new_rule->addChild('source_value')->addAttribute('REF', $source_value_attributes['REF']); $new_rule->addChild('target_value')->addAttribute('REF', $target_value_attributes['REF']); } } } //set field rules if (isset($xml->rules)) { $tracker->rules = $this->rule_factory->getInstanceFromXML($xml->rules, $this->xmlFieldsMapping, $tracker); } // set report if (isset($xml->reports)) { foreach ($xml->reports->report as $report) { $tracker->reports[] = $this->report_factory->getInstanceFromXML($report, $this->xmlFieldsMapping, $groupId); } } //set workflow if (isset($xml->workflow->field_id)) { $tracker->workflow = $this->workflow_factory->getInstanceFromXML($xml->workflow, $this->xmlFieldsMapping, $tracker); } //set permissions if (isset($xml->permissions->permission)) { $allowed_tracker_perms = array(Tracker::PERMISSION_ADMIN, Tracker::PERMISSION_FULL, Tracker::PERMISSION_SUBMITTER, Tracker::PERMISSION_ASSIGNEE, Tracker::PERMISSION_SUBMITTER_ONLY); $allowed_field_perms = array('PLUGIN_TRACKER_FIELD_READ', 'PLUGIN_TRACKER_FIELD_UPDATE', 'PLUGIN_TRACKER_FIELD_SUBMIT'); foreach ($xml->permissions->permission as $permission) { switch ((string) $permission['scope']) { case 'tracker': //tracker permissions $ugroup = (string) $permission['ugroup']; $type = (string) $permission['type']; if (isset($GLOBALS['UGROUPS'][$ugroup]) && in_array($type, $allowed_tracker_perms)) { $tracker->setCachePermission($GLOBALS['UGROUPS'][$ugroup], $type); } break; case 'field': //field permissions $ugroup = (string) $permission['ugroup']; $REF = (string) $permission['REF']; $type = (string) $permission['type']; if (isset($this->xmlFieldsMapping[$REF]) && isset($GLOBALS['UGROUPS'][$ugroup]) && in_array($type, $allowed_field_perms)) { $this->xmlFieldsMapping[$REF]->setCachePermission($GLOBALS['UGROUPS'][$ugroup], $type); } break; default: break; } } } return $tracker; }