diff --git a/pages/ajax.csvimport.php b/pages/ajax.csvimport.php new file mode 100644 index 000000000..05851feeb --- /dev/null +++ b/pages/ajax.csvimport.php @@ -0,0 +1,230 @@ + '-- select one --'); + $aChoices[':none:'] = '------ n/a ------'; + $aChoices['id'] = 'id (Primary Key)'; + foreach(MetaModel::ListAttributeDefs($sClassName) as $sAttCode => $oAttDef) + { + if ($oAttDef->IsExternalKey()) + { + $aChoices[$sAttCode] = $oAttDef->GetLabel(); + // Get fields of the external class that are considered as reconciliation keys + $sTargetClass = $oAttDef->GetTargetClass(); + foreach(MetaModel::ListAttributeDefs($sTargetClass) as $sTargetAttCode => $oTargetAttDef) + { + if (MetaModel::IsReconcKey($sTargetClass, $sTargetAttCode)) + { + $aChoices[$sAttCode.'->'.$sTargetAttCode] = $oAttDef->GetLabel().'->'.$oTargetAttDef->GetLabel(); + } + } + } + else if ($oAttDef->IsWritable() && ($sAttCode != 'finalclass')) // finalclass should not be considered as 'writable' isn't it ? + { + $aChoices[$sAttCode] = $oAttDef->GetLabel(); + } + } + asort($aChoices); + + $sHtml = "\n"; + return $sHtml; +} + +require_once('../application/startup.inc.php'); +session_start(); +if (isset($_SESSION['auth_user'])) +{ + $sAuthUser = $_SESSION['auth_user']; + $sAuthPwd = $_SESSION['auth_pwd']; + // Attempt to login, fails silently + UserRights::Login($sAuthUser, $sAuthPwd); +} +else +{ + // No session information + echo "

No session information

\n"; +} + + +$oContext = new UserContext(); +$sOperation = utils::ReadParam('operation', ''); + +switch($sOperation) +{ + case 'parser_preview': + $oPage = new ajax_page(""); + $oPage->no_cache(); + $sSeparator = utils::ReadParam('separator', ','); + if ($sSeparator == 'tab') $sSeparator = "\t"; + $sTextQualifier = utils::ReadParam('qualifier', '"'); + $iLinesToSkip = utils::ReadParam('nb_lines_skipped', 0); + $bFirstLineAsHeader = utils::ReadParam('header_line', true); + $sData = stripslashes(utils::ReadParam('csvdata', true)); + $oCSVParser = new CSVParser($sData, $sSeparator, $sTextQualifier); + $aData = $oCSVParser->ToArray($iLinesToSkip); + $iTarget = count($aData); + if ($iTarget == 0) + { + $oPage->p("Empty data set..., please provide some data!"); + } + else + { + $sMaxLen = (strlen(''.$iTarget) < 3) ? 3 : strlen(''.$iTarget); // Pad line numbers to the appropriate number of chars, but at least 3 + $sFormat = '%0'.$sMaxLen.'d'; + $oPage->p("

Data Preview

\n"); + $oPage->p("
\n"); + $oPage->add(""); + $iMaxIndex= 10; // Display maximum 10 lines for the preview + $index = 1; + foreach($aData as $aRow) + { + $sCSSClass = 'csv_row'.($index % 2); + if ( ($bFirstLineAsHeader) && ($index == 1)) + { + $oPage->add("\n"); + $iNbCols = count($aRow); + + } + else + { + if ($index == 1) $iNbCols = count($aRow); + $oPage->add("\n"); + } + $index++; + if ($index > $iMaxIndex) break; + } + $oPage->add("
".sprintf($sFormat, $index).""); + $oPage->add(implode('', $aRow)); + $oPage->add("
".sprintf($sFormat, $index).""); + $oPage->add(implode('', $aRow)); + $oPage->add("
\n"); + $oPage->add("
\n"); + if($iNbCols == 1) + { + $oPage->p(' Error: The data contains only one column. Did you select the appropriate separator character ?'); + } + else + { + $oPage->p(' '); + } + } + break; + + case 'display_mapping_form': + $oPage = new ajax_page(""); + $oPage->no_cache(); + $sSeparator = utils::ReadParam('separator', ','); + $sTextQualifier = utils::ReadParam('qualifier', '"'); + $iLinesToSkip = utils::ReadParam('nb_lines_skipped', 0); + $bFirstLineAsHeader = utils::ReadParam('header_line', true); + $sData = stripslashes(utils::ReadParam('csvdata', true)); + $sClassName = utils::ReadParam('class_name', ''); + + $oCSVParser = new CSVParser($sData, $sSeparator, $sTextQualifier); + $aData = $oCSVParser->ToArray($iLinesToSkip); + $iTarget = count($aData); + if ($iTarget == 0) + { + $oPage->p("Empty data set..., please provide some data!"); + } + else + { + $oPage->add(""); + $index = 1; + $aFirstLine = $aData[0]; // Use the first row to determine the number of columns + $iStartLine = 0; + $iNbColumns = count($aFirstLine); + if ($bFirstLineAsHeader) + { $iStartLine = 1; + foreach($aFirstLine as $sField) + { + $aHeader[] = $sField; + } + } + else + { + // Build some conventional name for the fields: field1...fieldn + $index= 1; + foreach($aFirstLine as $sField) + { + $aHeader[] = 'Field'+$index; + $index++; + } + } + $oPage->add("
\n"); + $oPage->add(''); + $oPage->add(""); + $oPage->add(''); + foreach($aHeader as $sField) + { + $oPage->add(''); + $oPage->add(""); + $oPage->add(''); + $oPage->add(''); + $oPage->add(''); + $oPage->add(''); + $oPage->add(''); + $oPage->add(''); + $index++; + } + $oPage->add("
FieldsMapping Search ?Data line 1Data line 2
$sField'.GetMappingForField($sClassName, $sField, $index).' '.(isset($aData[$iStartLine][$index]) ? htmlentities($aData[$iStartLine][$index-1]) : ' ').''.(isset($aData[$iStartLine+1][$index]) ? htmlentities($aData[$iStartLine+1][$index-1]) : ' ').'
\n"); + } + break; + + case 'get_csv_template': + $sClassName = utils::ReadParam('class_name'); + $oSearch = new DBObjectSearch($sClassName); + $oSearch->AddCondition('id', 0); // Make sure we create an empty set + $oSet = new CMDBObjectSet($oSearch); + $sCSV = cmdbAbstractObject::GetSetAsCSV($oSet); + $aCSV = explode("\n", $sCSV); + // If there are more than one line, let's assume that the first line is a comment and skip it. + if (count($aCSV) > 1) + { + $sResult = $aCSV[1]; + } + else + { + $sResult = $sCSV; + } + + $sClassDisplayName = MetaModel::GetName($sClassName); + $sDisposition = utils::ReadParam('disposition', 'inline'); + if ($sDisposition == 'attachment') + { + $oPage = new CSVPage(""); + $oPage->add_header("Content-disposition: attachment; filename=\"{$sClassDisplayName}.csv\""); + $oPage->no_cache(); + $oPage->add($sResult); + } + else + { + $oPage = new ajax_page(""); + $oPage->no_cache(); + $oPage->add('


'.$sClassDisplayName.'.csv

'); + $oPage->add('

'); + } + break; +} +$oPage->output(); +?> diff --git a/pages/csvimport.php b/pages/csvimport.php index 7fb11789b..20af65f81 100644 --- a/pages/csvimport.php +++ b/pages/csvimport.php @@ -1,678 +1,914 @@ - '); - -/////////////////////////////////////////////////////////////////////////////// -// External key/field naming conventions (sharing the naming space with std attributes -/////////////////////////////////////////////////////////////////////////////// - -function IsExtKeyField($sColDesc) -{ - return ($iPos = strpos($sColDesc, EXTKEY_SEP)); -} - -function GetExtKeyFieldCodes($sColDesc) -{ - $iPos = strpos($sColDesc, EXTKEY_SEP); - return array( - substr($sColDesc, 0, $iPos), - substr($sColDesc, $iPos + strlen(EXTKEY_SEP)) - ); -} - -function MakeExtFieldLabel($sClass, $sExtKeyAttCode, $sForeignAttCode) -{ - $oExtKeyAtt = MetaModel::GetAttributeDef($sClass, $sExtKeyAttCode); - if ($sForeignAttCode == 'id') - { - $sForeignAttLabel = 'id'; - } - else - { - $oForeignAtt = MetaModel::GetAttributeDef($oExtKeyAtt->GetTargetClass(), $sForeignAttCode); - $sForeignAttLabel = $oForeignAtt->GetLabel(); - } - - return $oExtKeyAtt->GetLabel().EXTKEY_LABELSEP.$sForeignAttLabel; -} - -function MakeExtFieldSelectValue($sAttCode, $sExtAttCode) -{ - return $sAttCode.EXTKEY_SEP.$sExtAttCode; -} - -/////////////////////////////////////////////////////////////////////////////// -/////////////////////////////////////////////////////////////////////////////// - - -function ShowTableForm($oPage, $oCSVParser, $sClass) -{ - $aData = $oCSVParser->ToArray(1, null, 3); - $aColToRow = array(); - foreach($aData as $aRow) - { - foreach ($aRow as $sFieldId=>$sValue) - { - $aColToRow[$sFieldId][] = $sValue; - } - } - - $aFields = array(); - foreach($oCSVParser->ListFields() as $iFieldIndex=>$sFieldName) - { - $sFieldName = trim($sFieldName); - - $aOptions = array(); - $aOptions['id'] = array( - 'LabelHtml' => "Private key", - 'LabelRef' => "Private key", - 'IsReconcKey' => false, - 'Tip' => '', - ); - - $sFoundAttCode = ""; // quick and dirty way to remind if a match has been found and suggest a reconciliation key if possible - foreach(MetaModel::ListAttributeDefs($sClass) as $sAttCode=>$oAtt) - { - if ($oAtt->IsExternalField()) continue; - - $bIsThatField = (strcasecmp($sFieldName, $oAtt->GetLabel()) == 0); - $sFoundAttCode = (MetaModel::IsValidFilterCode($sClass, $sAttCode) && $bIsThatField) ? $sAttCode : $sFoundAttCode; - - if ($oAtt->IsExternalKey()) - { - // An external key might be loaded by - // the pkey or a reconciliation key - // - $aOptions[MakeExtFieldSelectValue($sAttCode, 'id')] = array( - 'LabelHtml' => "".$oAtt->GetLabel()." (id)", - 'LabelRef' => $oAtt->GetLabel(), - 'IsReconcKey' => MetaModel::IsReconcKey($sClass, $sAttCode), - 'Tip' => '', - ); - - $sRemoteClass = $oAtt->GetTargetClass(); - foreach(MetaModel::GetReconcKeys($sRemoteClass) as $sExtAttCode) - { - $sValue = MakeExtFieldSelectValue($sAttCode, $sExtAttCode); - - // Create two entries: - // - generic syntax (ext key label -> remote field label) - // - if an ext field exists that corresponds to it, allow its label - $sLabel1 = MakeExtFieldLabel($sClass, $sAttCode, $sExtAttCode); - - $bFoundTwin = false; - foreach (MetaModel::GetExternalFields($sClass, $sAttCode) as $oExtFieldAtt) - { - if ($oExtFieldAtt->GetExtAttCode() == $sExtAttCode) - { - $aOptions[$sValue] = array( - 'LabelHtml' => htmlentities($oExtFieldAtt->GetLabel()), - 'LabelRef' => $oExtFieldAtt->GetLabel(), - 'IsReconcKey' => false, - 'Tip' => "equivalent to '".htmlentities($sLabel1)."'", - ); - $bFoundTwin = true; - $sLabel2 = $oExtFieldAtt->GetLabel(); - break; - } - } - - $aOptions[$sValue] = array( - 'LabelHtml' => htmlentities($sLabel1), - 'LabelRef' => $sLabel1, - 'IsReconcKey' => false, - 'Tip' => $bFoundTwin ? "equivalent to '".htmlentities($sLabel2)."'" : "", - ); - } - } - else - { - $aOptions[$sAttCode] = array( - 'LabelHtml' => htmlentities($oAtt->GetLabel()), - 'LabelRef' => $oAtt->GetLabel(), - 'IsReconcKey' => MetaModel::IsReconcKey($sClass, $sAttCode), - 'Tip' => '', - ); - } - } - - // Find the best match - $iMin = strlen($sFieldName); - $sBestValue = null; - foreach ($aOptions as $sValue => $aData) - { - $iDist = levenshtein(strtolower($sFieldName), strtolower($aData['LabelRef'])); - if (($iDist != -1) && ($iDist < $iMin)) - { - $iMin = $iDist; - $sBestValue = $sValue; - } - } - - $sSelField = ""; - $aFields["field$iFieldIndex"]["label"] = $sSelField; - - $sCHECKED = ($sFieldName == "id" || MetaModel::IsReconcKey($sClass, $sFoundAttCode)) ? " CHECKED" : ""; - $aFields["field$iFieldIndex"]["label"] .= ""; - - if (array_key_exists($iFieldIndex, $aColToRow)) - { - $aFields["field$iFieldIndex"]["value"] = $aColToRow[$iFieldIndex]; - } - else - { - // Houston... - } - } - $oPage->details($aFields); -} - - -function ProcessData($oPage, $sClass, $oCSVParser, $aFieldMap, $aIsReconcKey, CMDBChange $oChange = null) -{ - // Note: $oChange can be null, in which case the aim is to check what would be done - - // Setup field mapping: sort out between values and other specific columns - // - $aReconcilKeys = array(); - $aAttList = array(); - $aExtKeys = array(); - foreach($aFieldMap as $sFieldId=>$sColDesc) - { - $iFieldId = (int) substr($sFieldId, strlen("field")); - - if (array_key_exists($sFieldId, $aIsReconcKey)) - { - // This column will be used as a reconciliation key - - if (IsExtKeyField($sColDesc)) - { - list($sAttCode, $sExtReconcKeyAttCode) = GetExtKeyFieldCodes($sColDesc); - } - else - { - $sAttCode = $sColDesc; - } - $aReconcilKeys[$sAttCode] = $iFieldId; - } - - if ($sColDesc == "id") - { - $aAttList['id'] = $iFieldId; - } - elseif ($sColDesc == "__none__") - { - // Skip ! - } - elseif (IsExtKeyField($sColDesc)) - { - // This field is value to search on, to find a value for an external key - list($sExtKeyAttCode, $sExtReconcKeyAttCode) = GetExtKeyFieldCodes($sColDesc); - if ($sExtReconcKeyAttCode == 'id') - { - $aAttList[$sExtKeyAttCode] = $iFieldId; - } - $aExtKeys[$sExtKeyAttCode][$sExtReconcKeyAttCode] = $iFieldId; - } - else - { - // $sColDesc is an attribute code - $aAttList[$sColDesc] = $iFieldId; - } - } - - // Setup result presentation - // - $aDisplayConfig = array(); - $aDisplayConfig["__RECONCILIATION__"] = array("label"=>"Reconciliation", "description"=>""); - $aDisplayConfig["__STATUS__"] = array("label"=>"Import status", "description"=>""); - if (array_key_exists('id', $aAttList)) - { - $sPKeyCol = 'col'.$aAttList['id']; - $aDisplayConfig[$sPKeyCol] = array("label"=>"id", "description"=>""); - } - foreach($aReconcilKeys as $sAttCode => $iCol) - { - if ($sAttCode == 'id') continue; - - $sLabel = MetaModel::GetAttributeDef($sClass, $sAttCode)->GetLabel(); - $aDisplayConfig["col$iCol"] = array("label"=>"$sLabel", "description"=>""); - } - foreach($aExtKeys as $sAttCode=>$aKeyConfig) - { - $oExtKeyAtt = MetaModel::GetAttributeDef($sClass, $sAttCode); - $sLabel = $oExtKeyAtt->GetLabel(); - $aDisplayConfig[$sAttCode] = array("label"=>"$sLabel", "description"=>""); - foreach ($aKeyConfig as $sForeignAttCode => $iCol) - { - // The foreign attribute is one of our reconciliation key - - $sLabel = MakeExtFieldLabel($sClass, $sAttCode, $sForeignAttCode); - $aDisplayConfig["col$iCol"] = array("label"=>"$sLabel", "description"=>""); - } - } - foreach ($aAttList as $sAttCode => $iCol) - { - if ($sAttCode != 'id') - { - $sLabel = MetaModel::GetAttributeDef($sClass, $sAttCode)->GetLabel(); - $aDisplayConfig["col$iCol"] = array("label"=>"$sLabel", "description"=>""); - } - } - - // Compute the results - // - $aData = $oCSVParser->ToArray(); - - $oBulk = new BulkChange( - $sClass, - $aData, - $aAttList, - array_keys($aReconcilKeys), - $aExtKeys - ); - $aRes = $oBulk->Process($oChange); - $aResultDisp = array(); // to be displayed - foreach($aRes as $iRow => $aRowData) - { - $aRowDisp = array(); - $aRowDisp["__RECONCILIATION__"] = $aRowData["__RECONCILIATION__"]; - $aRowDisp["__STATUS__"] = $aRowData["__STATUS__"]->GetDescription(true); - foreach($aRowData as $sKey => $value) - { - if ($sKey == '__RECONCILIATION__') continue; - if ($sKey == '__STATUS__') continue; - switch (get_class($value)) - { - case 'CellChangeSpec_Unchanged': - $sClass = ''; - break; - case 'CellChangeSpec_Modify': - $sClass = 'csvimport_ok'; - break; - case 'CellChangeSpec_Init': - $sClass = 'csvimport_init'; - break; - case 'CellChangeSpec_Issue': - $sClass = 'csvimport_error'; - break; - - case 'CellChangeSpec_Void': - default: - $sClass = ''; - } - if (empty($sClass)) - { - $aRowDisp[$sKey] = $value->GetDescription(true); - } - else - { - $aRowDisp[$sKey] = "
".$value->GetDescription(true)."
"; - } - } - $aResultDisp[$iRow] = $aRowDisp; - } - $oPage->table($aDisplayConfig, $aResultDisp); -} - -/////////////////////////////////////////////////////////////////////////////// -// Wizard entry points -/////////////////////////////////////////////////////////////////////////////// - -function Do_Welcome($oPage, $sClass) -{ - $sWiztep = "1_welcome"; - $oPage->p("

Bulk load from CSV data / step 1

"); - - // Reload values (in case we are reaching this page from the next one - $sCSVData = utils::ReadPostedParam('csvdata'); - $sSep = utils::ReadPostedParam('separator', ','); - $sTQualif = utils::ReadPostedParam('textqualifier', '"'); - - $aSeparators = array(',' => ', (coma)', ';' => ';', ';' => ';', '|' => '|', '#' => '#', '@' => '@', ':' => ':'); - $aTextQualifiers = array('"' => '"', "'" => "'", '`' => '`', '/' => '/'); - - $oPage->add("
"); - $oPage->MakeClassesSelect("class", $sClass, 50, UR_ACTION_BULK_MODIFY); - $oPage->add("
"); - $oPage->add(""); - $oPage->add("
"); - $oPage->add("Separator: "); - $oPage->add_select($aSeparators, 'separator', $sSep, 50); - $oPage->add("
"); - $oPage->add("Text qualifier: "); - $oPage->add_select($aTextQualifiers, 'textqualifier', $sTQualif, 50); - $oPage->add("
"); - $oPage->add(""); - $oPage->add("
\n"); - $oPage->add("
"); - - // As a help to the end-user, let's display the list of possible fields - // for a class, that can be copied/pasted into the CSV area. - $sCurrentList = ""; - $aHeadersList = array(); - foreach(MetaModel::GetClasses('bizmodel') as $sClassName) - { - $aList = MetaModel::GetZListItems($sClassName, 'details'); - $aHeader = array(); - // $aHeader[] = MetaModel::GetKeyLabel($sClassName); - $aHeader[] = 'id'; // Should be what's coded on the line above... but there is a bug - foreach($aList as $sAttCode) - { - $aHeader[] = MetaModel::GetLabel($sClassName, $sAttCode); - } - - $sAttributes = implode(",", $aHeader); - $aHeadersList[$sClassName] = $sAttributes; - - if($sClassName == $sClass) - { - // this class is currently selected - $sCurrentList = $sAttributes; - } - } - // Store all the values in a variable client-side - $aScript = array(); - foreach($aHeadersList as $sClassName => $sAttributes) - { - $aScript[] = "'$sClassName':'$sAttributes'"; - } - $oPage->add("\n"); - - $oPage->add_ready_script("$('#select_class').change( function() {DisplayFields(this.value);} );"); - $oPage->add("
"); - $oPage->add("Fields for this object
"); - -} - -function Do_Format($oPage, $sClass) -{ - $oPage->p("

Bulk load from CSV data / step 2

"); - $sWiztep = "2_format"; - - $sCSVData = utils::ReadPostedParam('csvdata'); - $sSep = utils::ReadPostedParam('separator'); - $sTQualif = utils::ReadPostedParam('textqualifier'); - $oCSVParser = new CSVParser($sCSVData, $sSep, $sTQualif); - $iSkip = 1; - - // No data ? - $aData = $oCSVParser->ToArray(); - $iTarget = count($aData); - if ($iTarget == 0) - { - $oPage->p("Empty data set..., please provide some data!"); - $oPage->add("\n"); - return; - } - - // Expected format - to be improved - $oPage->p("Separator: '$sSep'"); - $oPage->p("Text qualifier: '$sTQualif'"); - $oPage->p("The first line will be skipped (considered as being the list of fields)"); - - $oPage->p("Target: $iTarget rows"); - - $oPage->add("
"); - ShowTableForm($oPage, $oCSVParser, $sClass); - $oPage->add(""); - $oPage->add(""); - $oPage->add(""); - $oPage->add(""); - $oPage->add(""); - - $oPage->add(""); - $oPage->add(""); - $oPage->add(""); - $oPage->add("
"); -} - -function DoProcessOrVerify($oPage, $sClass, CMDBChange $oChange = null) -{ - $sCSVData = utils::ReadPostedParam('csvdata'); - $sSep = utils::ReadPostedParam('separator'); - $sTQualif = utils::ReadPostedParam('textqualifier'); - $iSkip = utils::ReadPostedParam('skiplines'); - $aFieldMap = utils::ReadPostedParam('fmap'); - $aIsReconcKey = utils::ReadPostedParam('iskey'); - - if (empty($aIsReconcKey)) - { - $oPage->p("Error: no reconciliation key has been specified. Please specify which field(s) will be used to identify the object"); - - $oPage->add("\n"); - $oPage->add("\n"); - return; - } - - $oCSVParser = new CSVParser($sCSVData, $sSep, $sTQualif); - $aData = $oCSVParser->ToArray($iSkip, null); - $iTarget = count($aData); - - $oPage->p("

Goal summary

"); - $oPage->p("Target: $iTarget rows"); - - $aSampleData = $oCSVParser->ToArray($iSkip, array_keys($aFieldMap), 5); - - $aDisplayConfig = array(); - $aExtKeys = array(); - foreach ($aFieldMap as $sFieldId=>$sColDesc) - { - if (array_key_exists($sFieldId, $aIsReconcKey)) - { - $sReconcKey = "
[key]"; - } - else - { - $sReconcKey = ""; - } - - if ($sColDesc == "id") - { - $aDisplayConfig[$sFieldId] = array("label"=>"Private key $sReconcKey", "description"=>""); - } - elseif ($sColDesc == "__none__") - { - // Skip ! - } - else if (MetaModel::IsValidAttCode($sClass, $sColDesc)) - { - $sAttCode = $sColDesc; - $sLabel = MetaModel::GetAttributeDef($sClass, $sAttCode)->GetLabel(); - $aDisplayConfig[$sFieldId] = array("label"=>"$sLabel$sReconcKey", "description"=>""); - if (MetaModel::IsValidKeyAttCode($sClass, $sAttCode)) - { - $aExtKeys[] = $sAttCode; - } - } - elseif (IsExtKeyField($sColDesc)) - { - list($sExtKeyAttCode, $sForeignAttCode) = GetExtKeyFieldCodes($sColDesc); - $sLabel = MakeExtFieldLabel($sClass, $sExtKeyAttCode, $sForeignAttCode); - $aDisplayConfig[$sFieldId] = array("label"=>"$sLabel$sReconcKey", "description"=>""); - $aExtKeys[] = $sExtKeyAttCode; - } - else - { - // ??? - $aDisplayConfig[$sFieldId] = array("label"=>"-?-?-$sColDesc-?-?-", "description"=>""); - } - } - - $oPage->table($aDisplayConfig, $aSampleData); - - if ($oChange) - { - $oPage->p("

Processing...

"); - } - else - { - $oPage->p("

Column consistency

"); - $aMissingKeys = array(); - foreach (MetaModel::GetExternalKeys($sClass) as $sExtKeyAttCode => $oExtKey) - { - if (!in_array($sExtKeyAttCode, $aExtKeys) && !$oExtKey->IsNullAllowed()) - { - $aMissingKeys[$sExtKeyAttCode] = $oExtKey; - } - } - if (count($aMissingKeys) > 0) - { - $oPage->p("Warning: the objects could not be created, due to some missing mandatory external keys in the field list: "); - $oPage->add(""); - } - else - { - $oPage->p("ok - required external keys (if any) have been found in the field list"); - } - $oPage->p("Note: the procedure will fail if any line has not the same number of columns as the first line"); - - $oPage->p("

Check...

"); - } - ProcessData($oPage, $sClass, $oCSVParser, $aFieldMap, $aIsReconcKey, $oChange); - - $oPage->add("
"); - $oPage->add(""); - $oPage->add(""); - $oPage->add(""); - $oPage->add(""); - $oPage->add(""); - $oPage->add_input_hidden("fmap", $aFieldMap); - $oPage->add_input_hidden("iskey", $aIsReconcKey); - - return true; -} - -function Do_Verify($oPage, $sClass) -{ - $oPage->p("

Bulk load from CSV data / step 3

"); - $sWiztep = "3_verify"; - - if (DoProcessOrVerify($oPage, $sClass, null)) - { - // FORM started by DoProcessOrVerify... - $oPage->add(""); - $oPage->add(""); - $oPage->add(""); - $oPage->add("
"); - } -} - -function Do_Execute($oPage, $sClass) -{ - $oPage->p("

Bulk load from CSV data / step 4

"); - $sWiztep = "4_execute"; - - $oMyChange = MetaModel::NewObject("CMDBChange"); - $oMyChange->Set("date", time()); - $iUser = UserRights::GetContactId(); - if ($iUser != null) - { - // Ok, that's dirty, I admit :-) - $oUser = MetaModel::GetObject('bizContact', $iUser); - $sUser = $oUser->GetName(); - $oMyChange->Set("userinfo", "CSV Import, by ".$sUser); - } - else - { - $oMyChange->Set("userinfo", "CSV Import"); - } - $iChangeId = $oMyChange->DBInsert(); - - if (DoProcessOrVerify($oPage, $sClass, $oMyChange)) - { - // FORM started by DoProcessOrVerify... - $oPage->add(""); - $oPage->add(""); - $oPage->add(""); - } -} - - -/////////////////////////////////////////////////////////////////////////////////////////////////// -// -// M a i n P r o g r a m -// -/////////////////////////////////////////////////////////////////////////////////////////////////// - -$sFromWiztep = utils::ReadPostedParam('fromwiztep', ''); -$sClass = utils::ReadPostedParam('class', ''); -$sTodo = utils::ReadPostedParam('todo', ''); - -switch($sFromWiztep) -{ - case '': - Do_Welcome($oPage, $sClass); - break; - - case '1_welcome': - if ($sTodo == "Next") Do_Format($oPage, $sClass); - else trigger_error("Wrong argument todo='$sTodo'", E_USER_ERROR); - break; - - case '2_format': - if ($sTodo == "Next") Do_Verify($oPage, $sClass); - else Do_Welcome($oPage, $sClass); - break; - - case '3_verify': - if ($sTodo == "Next") Do_Execute($oPage, $sClass); - else Do_Format($oPage, $sClass); - break; - - case '4_execute': - if ($sTodo == "Next") trigger_error("Wrong argument todo='$sTodo'", E_USER_ERROR); - else Do_Verify($oPage, $sClass); - break; - - default: - trigger_error("Wrong argument fromwiztep='$sFromWiztep'", E_USER_ERROR); -} - -$oPage->output(); -?> + + * @author Denis Flaven + * @license http://www.opensource.org/licenses/lgpl-3.0.html LGPL + * @link http://www.combodo.com/itop iTop + */ +require_once('../application/application.inc.php'); +require_once('../application/itopwebpage.class.inc.php'); + +require_once('../application/startup.inc.php'); + +require_once('../application/loginwebpage.class.inc.php'); +LoginWebPage::DoLogin(); // Check user rights and prompt if needed + +$oContext = new UserContext(); +$oAppContext = new ApplicationContext(); +$currentOrganization = utils::ReadParam('org_id', 1); +$iStep = utils::ReadParam('step', 1); + +$oPage = new iTopWebPage("iTop - Bulk import", $currentOrganization); + +/** + * Helper function to build a select from the list of valid classes for a given action + * @param string $sName The name of the select in the HTML form + * @param string $sDefaulfValue The defaut value (i.e the value selected by default) + * @param integer $iWidthPx The width (in pixels) of the drop-down list + * @param integer $iActionCode The ActionCode (from UserRights) to check for authorization for the classes + * @return string The HTML fragment corresponding to the select tag + */ +function GetClassesSelect($sName, $sDefaultValue, $iWidthPx, $iActionCode = null) +{ + $sHtml = ""; + return $sHtml; +} + +/** + * Helper to 'check' an input in an HTML form if the current value equals the value given + * @param mixed $sCurrentValue The current value to be chacked against the value of the input + * @param mixed $sProposedValue The value of the input + * @return string Either ' checked' or an empty string + */ +function IsChecked($sCurrentValue, $sProposedValue) +{ + return ($sCurrentValue == $sProposedValue) ? ' checked' : ''; +} + +/** + * Get the user friendly name for an 'extended' attribute code i.e 'name', becomes 'Name' and 'org_id->name' becomes 'Organization->Name' + * @param string $sClassName The name of the class + * @param string $sAttCodeEx Either an attribute code of ext_key_name->att_code + * @return string A user friendly format of the string: AttributeName or AttributeName->ExtAttributeName + */ +function GetFriendlyAttCodeName($sClassName, $sAttCodeEx) +{ + $sFriendlyName = ''; + if (preg_match('/(.+)->(.+)/', $sAttCodeEx, $aMatches) > 0) + { + $Attribute = $aMatches[1]; + $sField = $aMatches[2]; + $oAttDef = MetaModel::GetAttributeDef($sClassName, $Attribute); + if ($oAttDef->IsExternalKey()) + { + $sTargetClass = $oAttDef->GetTargetClass(); + $oTargetAttDef = MetaModel::GetAttributeDef($sTargetClass, $sField); + $sFriendlyName = $oAttDef->GetLabel().'->'.$oTargetAttDef->GetLabel(); + } + else + { + // hum, hum... should never happen, we'd better raise an exception + throw(new Exception("Internal error: '$sAttCodeEx' is an incorrect code because '$sAttribute' is NOT an external key of the class '$sClassName'.")); + } + + } + else + { + if ($sAttCodeEx == 'id') + { + $sFriendlyName = 'id (Primary Key)'; + } + else + { + $oAttDef = MetaModel::GetAttributeDef($sClassName, $sAttCodeEx); + $sFriendlyName = $oAttDef->GetLabel(); + } + } + return $sFriendlyName; +} + +/** + * Returns the number of occurences of each char from the set in the specified string + * @param string $sString The input data + * @param array $aSet The set of characters to count + * @return hash 'char' => nb of occurences + */ +function CountCharsFromSet($sString, $aSet) +{ + $aResult = array(); + $aCount = count_chars($sString); + foreach($aSet as $sChar) + { + $aResult[$sChar] = isset($aCount[ord($sChar)]) ? $aCount[ord($sChar)] : 0; + } + return $aResult; +} + +/** + * Return the most frequent (and regularly occuring) character among the given set, in the specified lines + * @param array $aCSVData The input data, one entry per line + * @param array $aPossibleSeparators The list of characters to count + * @return string The most frequent character from the set + */ +function GuessFromFrequency($aCSVData, $aPossibleSeparators) +{ + $iLine = 0; + $iMaxLine = 20; // Process max 20 lines to guess the parameters + foreach($aPossibleSeparators as $sSep) + { + $aGuesses[$sSep]['total'] = $aGuesses[$sSep]['max'] = 0; + $aGuesses[$sSep]['min'] = 999; + } + $aStats = array(); + while(($iLine < count($aCSVData)) && ($iLine < $iMaxLine) ) + { + if (strlen($aCSVData[$iLine]) > 0) + { + $aStats[$iLine] = CountCharsFromSet($aCSVData[$iLine], $aPossibleSeparators); + } + $iLine++; + } + $iLine = 1; + foreach($aStats as $aLineStats) + { + foreach($aPossibleSeparators as $sSep) + { + $aGuesses[$sSep]['total'] += $aLineStats[$sSep]; + if ($aLineStats[$sSep] > $aGuesses[$sSep]['max']) $aGuesses[$sSep]['max'] = $aLineStats[$sSep]; + if ($aLineStats[$sSep] < $aGuesses[$sSep]['min']) $aGuesses[$sSep]['min'] = $aLineStats[$sSep]; + } + $iLine++; + } + + $aScores = array(); + foreach($aGuesses as $sSep => $aData) + { + $aScores[$sSep] = $aData['total'] + $aData['max'] - $aData['min']; + } + arsort($aScores, SORT_NUMERIC); // Sort the array, higher scores first + $aKeys = array_keys($aScores); + $sSeparator = $aKeys[0]; // Take the first key, the one with the best score + return $sSeparator; +} + +/** + * Try to predict the CSV parameters based on the input data + * @param string $sCSVData The input data + * @return hash 'separator' => the_guessed_separator, 'qualifier' => the_guessed_text_qualifier + */ +function GuessParameters($sCSVData) +{ + $aData = explode("\n", $sCSVData); + $sSeparator = GuessFromFrequency($aData, array("\t", ',', ';', '|')); // Guess the most frequent (and regular) character on each line + $sQualifier = GuessFromFrequency($aData, array('"', "'")); // Guess the most frequent (and regular) character on each line + + return array('separator' => $sSeparator, 'qualifier' => $sQualifier); +} + +/** + * Process the CSV data, for real or as a simulation + * @param WebPage $oPage The page used to display the wizard + * @param UserContext $oContext The current user context + * @param bool $bSimulate Whether or not to simulate the data load + * @return array The CSV lines in error that were rejected from the load (with the header line - if any) or null + */ +function ProcessCSVData(WebPage $oPage, UserContext $oContext, $bSimulate = true) +{ + $aResult = array(); + $sCSVData = utils::ReadParam('csvdata', ''); + $sCSVDataTruncated = utils::ReadParam('csvdata_truncated', ''); + $sSeparator = utils::ReadParam('separator', ','); + $sTextQualifier = utils::ReadParam('text_qualifier', '"'); + $bHeaderLine = (utils::ReadParam('header_line', '0') == 1); + $iRealSkippedLines = $iSkippedLines = utils::ReadParam('nb_skipped_lines', '0'); + $sClassName = utils::ReadParam('class_name', ''); + $aFieldsMapping = utils::ReadParam('field', array()); + $aSearchFields = utils::ReadParam('search_field', array()); + $iCurrentStep = $bSimulate ? 4 : 5; + + // Parse the data set + $oCSVParser = new CSVParser($sCSVData, $sSeparator, $sTextQualifier); + $aData = $oCSVParser->ToArray($iSkippedLines); + if ($bHeaderLine) + { + $aResult[] = $sTextQualifier.implode($sTextQualifier.$sSeparator.$sTextQualifier, array_shift($aData)).$sTextQualifier; // Remove the first line and store it in case of error + $iRealSkippedLines++; + } + + // Format for the line numbers + $sMaxLen = (strlen(''.count($aData)) < 3) ? 3 : strlen(''.count($aData)); // Pad line numbers to the appropriate number of chars, but at least 3 + + // Compute the list of search/reconciliation criteria + $aSearchKeys = array(); + foreach($aSearchFields as $index => $sDummy) + { + $sSearchField = $aFieldsMapping[$index]; + $aMatches = array(); + if (preg_match('/(.+)->(.+)/', $sSearchField, $aMatches) > 0) + { + $sSearchField = $aMatches[1]; + $aSearchKeys[$aMatches[1]] = ''; + } + else + { + $aSearchKeys[$sSearchField] = ''; + } + if (!MetaModel::IsValidFilterCode($sClassName, $sSearchField)) + { + // Remove invalid or unmapped search fields + $aSearchFields[$index] = null; + unset($aSearchKeys[$sSearchField]); + } + } + + // Compute the list of fields and external keys to process + $aExtKeys = array(); + $aAttributes = array(); + $aExternalKeysByColumn = array(); + foreach($aFieldsMapping as $iNumber => $sAttCode) + { + $iIndex = $iNumber-1; + if (!empty($sAttCode) && ($sAttCode != ':none:') && ($sAttCode != 'finalclass')) + { + if (preg_match('/(.+)->(.+)/', $sAttCode, $aMatches) > 0) + { + $sAttribute = $aMatches[1]; + $sField = $aMatches[2]; + $aExtKeys[$sAttribute][$sField] = $iIndex; + $aExternalKeysByColumn[$iIndex] = $sAttribute; + } + else + { + if ($sAttCode == 'id') + { + $aAttributes['id'] = $iIndex; + } + else + { + $oAttDef = MetaModel::GetAttributeDef($sClassName, $sAttCode); + if ($oAttDef->IsExternalKey()) + { + $aExtKeys[$sAttCode]['id'] = $iIndex; + $aExternalKeysByColumn[$iIndex] = $sAttCode; + } + else + { + $aAttributes[$sAttCode] = $iIndex; + } + } + } + } + } + + $oMyChange = null; + if (!$bSimulate) + { + // We're doing it for real, let's create a change + $oMyChange = MetaModel::NewObject("CMDBChange"); + $oMyChange->Set("date", time()); + if (UserRights::GetUser() != UserRights::GetRealUser()) + { + $sUserString = UserRights::GetRealUser()." on behalf of ".UserRights::GetUser(); + } + else + { + $sUserString = UserRights::GetUser(); + } + $oMyChange->Set("userinfo", $sUserString); + } + + $oBulk = new BulkChange( + $sClassName, + $aData, + $aAttributes, + $aExtKeys, + array_keys($aSearchKeys) + ); + + $oPage->add(''); + $aRes = $oBulk->Process($oMyChange); + + $sHtml = ''; + $sHtml .= ''; + $sHtml .= ''; + $sHtml .= ''; + foreach($aFieldsMapping as $iNumber => $sAttCode) + { + if (!empty($sAttCode) && ($sAttCode != ':none:') && ($sAttCode != 'finalclass')) + { + $sHtml .= ""; + } + } + $sHtml .= ''; + $sHtml .= ''; + $iLine = 0; + + $iErrors = 0; + $iCreated = 0; + $iModified = 0; + $iUnchanged = 0; + + foreach($aData as $aRow) + { + $oStatus = $aRes[$iLine]['__STATUS__']; + $sUrl = ''; + $sMessage = ''; + $sCSSRowClass = ''; + $sCSSMessageClass = 'cell_ok'; + switch(get_class($oStatus)) + { + case 'RowStatus_NoChange': + $iUnchanged++; + $sFinalClass = $aRes[$iLine]['finalclass']; + $oObj = $oContext->GetObject($sFinalClass, $aRes[$iLine]['id']->GetValue()); + $sUrl = $oObj->GetHyperlink(); + $sStatus = ''; + $sCSSRowClass = 'row_unchanged'; + break; + + case 'RowStatus_Modify': + $iModified++; + $sFinalClass = $aRes[$iLine]['finalclass']; + $oObj = $oContext->GetObject($sFinalClass, $aRes[$iLine]['id']->GetValue()); + $sUrl = $oObj->GetHyperlink(); + $sStatus = ''; + $sCSSRowClass = 'row_modified'; + break; + + case 'RowStatus_NewObj': + $iCreated++; + $sFinalClass = $aRes[$iLine]['finalclass']; + $sStatus = ''; + $sCSSRowClass = 'row_added'; + if ($bSimulate) + { + $sMessage = 'Object will be created'; + } + else + { + $sFinalClass = $aRes[$iLine]['finalclass']; + $oObj = $oContext->GetObject($sFinalClass, $aRes[$iLine]['id']->GetValue()); + $sUrl = $oObj->GetHyperlink(); + $sMessage = 'Object created'; + } + break; + + case 'RowStatus_Issue': + $iErrors++; + $sMessage .= $oPage->GetP($oStatus->GetDescription()); + $sStatus = ''; + $sCSSMessageClass = 'cell_error'; + $sCSSRowClass = 'row_error'; + $aResult[] = $sTextQualifier.implode($sTextQualifier.$sSeparator.$sTextQualifier,$aRow).$sTextQualifier; // Remove the first line and store it in case of error + break; + } + $sHtml .= ''; + $sHtml .= ""; + $sHtml .= ""; + $sHtml .= ""; + foreach($aFieldsMapping as $iNumber => $sAttCode) + { + if (!empty($sAttCode) && ($sAttCode != ':none:') && ($sAttCode != 'finalclass')) + { + $oCellStatus = $aRes[$iLine][$iNumber -1]; + $sCellMessage = ''; + if (isset($aExternalKeysByColumn[$iNumber -1])) + { + $sExtKeyName = $aExternalKeysByColumn[$iNumber -1]; + $oExtKeyCellStatus = $aRes[$iLine][$sExtKeyName]; + switch(get_class($oExtKeyCellStatus)) + { + case 'CellStatus_Issue': + $sCellMessage .= $oPage->GetP($oExtKeyCellStatus->GetDescription()); + break; + + case 'CellStatus_Ambiguous': + $sCellMessage .= $oPage->GetP($oExtKeyCellStatus->GetDescription()); + break; + + default: + // Do nothing + } + } + switch(get_class($oCellStatus)) + { + case 'CellStatus_Issue': + $sCellMessage .= $oPage->GetP($oCellStatus->GetDescription()); + $sHtml .= ''; + break; + + case 'CellStatus_Ambiguous': + $sCellMessage .= $oPage->GetP($oCellStatus->GetDescription()); + $sHtml .= ''; + break; + + case 'CellStatus_Modify': + $sHtml .= ''; + break; + + default: + $sHtml .= ''; + } + } + } + $sHtml .= ""; + $iLine++; + $sHtml .= ''; + } + $sHtml .= '
LineStatusObject".GetFriendlyAttCodeName($sClassName, $sAttCode)."Message
".sprintf("%0{$sMaxLen}d", 1+$iLine+$iRealSkippedLines)."$sStatus$sUrlERROR: '.htmlentities($aData[$iLine][$iNumber-1]).$sCellMessage.'AMBIGUOUS: '.htmlentities($aData[$iLine][$iNumber-1]).$sCellMessage.''.htmlentities($aData[$iLine][$iNumber-1]).''.htmlentities($aData[$iLine][$iNumber-1]).$sCellMessage.'$sMessage
'; + $oPage->add('
'); + $oPage->add('
'); + $oPage->add(''); + $oPage->add(''); + $oPage->add(''); + $oPage->add(''); + $oPage->add(''); + $oPage->add(''); + $oPage->add(''); + $oPage->add(''); + foreach($aFieldsMapping as $iNumber => $sAttCode) + { + $oPage->add(''); + } + foreach($aSearchFields as $index => $sDummy) + { + $oPage->add(''); + } + $aFieldsMapping = utils::ReadParam('field', array()); + $aSearchFields = utils::ReadParam('search_field', array()); + $aDisplayFilters = array(); + if ($bSimulate) + { + $aDisplayFilters['unchanged'] = '%d objects(s) will stay unchanged.'; + $aDisplayFilters['modified'] = '%d objects(s) will stay be modified.'; + $aDisplayFilters['added'] = '%d objects(s) will be added.'; + $aDisplayFilters['errors'] = '%d objects(s) will have errors.'; + } + else + { + $aDisplayFilters['unchanged'] = '%d objects(s) remained unchanged.'; + $aDisplayFilters['modified'] = '%d objects(s) were modified.'; + $aDisplayFilters['added'] = '%d objects(s) were added.'; + $aDisplayFilters['errors'] = '%d objects(s) had errors.'; + } + $oPage->add('

  '.sprintf($aDisplayFilters['unchanged'], $iUnchanged).'  '); + $oPage->add('  '.sprintf($aDisplayFilters['modified'], $iModified).'  '); + $oPage->add('  '.sprintf($aDisplayFilters['added'], $iCreated).'  '); + $oPage->add('  '.sprintf($aDisplayFilters['errors'], $iErrors).'

'); + $oPage->add('
'); + $oPage->add($sHtml); + $oPage->add('
'); + $oPage->add('

  '); + if ($bSimulate) + { + $oPage->add('

'); + } + else + { + $oPage->add('

'); + } + $oPage->add('
'); + $oPage->add('
'); + $oPage->add_script( +<<< EOF + function CSVGoBack() + { + $('input[name=step]').val($iCurrentStep-1); + $('#wizForm').submit(); + + } + + function ToggleRows(sCSSClass) + { + $('.'+sCSSClass).toggle(); + } +EOF +); + if ($iErrors > 0) + { + return $aResult; + } + else + { + return null; + } + +} +/** + * Perform the actual load of the CSV data and display the results + * @param WebPage $oPage The web page to display the wizard + * @param UserContext $oContext Current user's context + * @return void + */ +function LoadData(WebPage $oPage, UserContext $oContext) +{ + $oPage->add('

Step 5 of 5: Import completed

'); + $aResult = ProcessCSVData($oPage, $oContext, false /* simulate = false */); + if (is_array($aResult)) + { + $oPage->StartCollapsibleSection("Lines that could not be loaded:", false); + $oPage->p('The following lines have not been imported because they contain errors'); + $oPage->add(''); + $oPage->EndCollapsibleSection(); + } +} + +/** + * Simulate the load of the CSV data and display the results + * @param WebPage $oPage The web page to display the wizard + * @param UserContext $oContext Current user's context + * @return void + */ +function Preview(WebPage $oPage, UserContext $oContext) +{ + $oPage->add('

Step 4 of 5: Import simulation

'); + ProcessCSVData($oPage, $oContext, true /* simulate */); +} + +/** + * Select the mapping between the CSV column and the fields of the objects + * @param WebPage $oPage The web page to display the wizard + * @return void + */ +function SelectMapping(WebPage $oPage) +{ + $sCSVData = utils::ReadParam('csvdata', ''); + $sCSVDataTruncated = utils::ReadParam('csvdata_truncated', '');; + $sSeparator = utils::ReadParam('separator', ','); + if ($sSeparator == 'tab') $sSeparator = "\t"; + if ($sSeparator == 'other') + { + $sSeparator = utils::ReadParam('other_separator', ','); + } + $sTextQualifier = utils::ReadParam('text_qualifier', '"'); + if ($sTextQualifier == 'other') + { + $sTextQualifier = utils::ReadParam('other_qualifier', '"'); + } + $bHeaderLine = (utils::ReadParam('header_line', '0') == 1); + $iSkippedLines = 0; + if (utils::ReadParam('box_skiplines', '0') == 1) + { + $iSkippedLines = utils::ReadParam('nb_skipped_lines', '0'); + } + $sClassName = utils::ReadParam('class_name', ''); + + $oPage->add('

Step 3 of 5: Data mapping

'); + $oPage->add('
'); + $oPage->add('

Select the class to import: '); + $oPage->add(GetClassesSelect('class_name', $sClassName, 300, UR_ACTION_BULK_MODIFY).'

'); + $oPage->add('


Select a class to configure the mapping

'); + $oPage->add(''); + $oPage->add(''); + $oPage->add(''); + $oPage->add(''); + $oPage->add(''); + $oPage->add(''); + $oPage->add(''); + $oPage->add('

  '); + $oPage->add('

'); + $oPage->add('
'); + $oPage->add('
'); + $oPage->add_ready_script( +<<add_ready_script("DoMapping();"); // There is already a class selected, run the mapping + } + + $oPage->add_script( +<<IsEmpty()) + { + $sCSVData = $oDocument->GetData(); + } + break; + + default: + $sCSVData = utils::ReadParam('csvdata', '', 'post'); + } + + $aGuesses = GuessParameters($sCSVData); // Try to predict the parameters, based on the input data + + $sSeparator = utils::ReadParam('separator', $aGuesses['separator']); + if ($sSeparator == 'tab') $sSeparator = "\t"; + $sTextQualifier = utils::ReadParam('qualifier', $aGuesses['qualifier']); + $bHeaderLine = utils::ReadParam('header_line', 0); + // Create a truncated version of the data used for the fast preview + // Take about 20 lines of data... knowing that some lines may contain carriage returns + $iMaxLines = 20; + $iMaxLen = strlen($sCSVData); + $iCurPos = true; + while ( ($iCurPos > 0) && ($iMaxLines > 0)) + { + $pos = strpos($sCSVData, "\n", $iCurPos); + if ($pos !== false) + { + $iCurPos = 1+$pos; + } + else + { + $iCurPos = strlen($sCSVData); + $iMaxLines = 1; + } + $iMaxLines--; + } + $sCSVDataTruncated = substr($sCSVData, 0, $iCurPos); + + $oPage->add('

Step 2 of 5: CSV data options

'); + $oPage->add('
'); + $oPage->add('
'); + $oPage->add('
'); + $oPage->add('

Separator character:

'); + $oPage->add('

, (comma)
'); + $oPage->add(' ; (semicolon)
'); + $oPage->add(' tab
'); + $oPage->add(' other: '); + $oPage->add('

'); + $oPage->add('
'); + $oPage->add('

Text qualifier character:

'); + $oPage->add('

" (double quote)
'); + $oPage->add(' \' (simple quote)
'); + $oPage->add(' other: '); + $oPage->add('

'); + $oPage->add('
'); + $oPage->add('

Comments and header:

'); + $oPage->add('

Treat the first line as a header (column names)

'); + $oPage->add('

Skip line(s) at the beginning of the file

'); + $oPage->add('

'); + $oPage->add(''); + $oPage->add(''); + $oPage->add(''); + $oPage->add('
'); + $oPage->add('

Data Preview

'); + $oPage->add('
'); + $oPage->add(''); + $oPage->add(''); + $oPage->add(''); + $oPage->add('
'); + + $oPage->add_script( +<<add_ready_script('DoPreview();'); +} + +/** + * Prompt for the data to be loaded (either via a file or a copy/paste) + * @param WebPage $oPage The current web page + * @return void + */ +function Welcome(iTopWebPage $oPage) +{ + $oPage->add("

CSV import wizard

\n"); + $oPage->AddTabContainer('tabs1'); + + $sFileLoadHtml = '

Select the file to import:

'. + '

'. + '

'. + '

'. + '

'. + '
'; + + $oPage->AddToTab('tabs1', "Load from a file", $sFileLoadHtml); + $sCSVData = utils::ReadParam('csvdata', ''); + $sPasteDataHtml = '

Paste the data to import:

'. + '

'. + '

'. + '

'. + '

'. + '
'; + $oPage->AddToTab('tabs1', "Copy and paste data", $sPasteDataHtml); + + $sTemplateHtml = '

Pick the template do download: '; + $sTemplateHtml .= GetClassesSelect('template_class', '', 300, UR_ACTION_BULK_MODIFY); + $sTemplateHtml .= '

'; + $sTemplateHtml .= '
'; + $sTemplateHtml .= '
'; + $oPage->AddToTab('tabs1', "Templates", $sTemplateHtml); + $oPage->add_script( +<<add_ready_script( +<<output(); +?>