Salome HOME
updated copyright message
[modules/kernel.git] / src / SALOMEDSImpl / SALOMEDSImpl_Study.cxx
index d9dd02393ff83c7cd6bc284896e9295d4342b174..cc063bd8f74772be6699aeeb22df66b10e69b93c 100644 (file)
@@ -1,4 +1,4 @@
-// Copyright (C) 2007-2016  CEA/DEN, EDF R&D, OPEN CASCADE
+// Copyright (C) 2007-2023  CEA, EDF, OPEN CASCADE
 //
 // Copyright (C) 2003-2007  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
 // CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
@@ -29,6 +29,9 @@
 
 #include <KERNEL_version.h>
 #include <Basics_Utils.hxx>
+#include <Basics_DirUtils.hxx>
+
+#include "HDFexplorer.hxx"
 
 #include "DF_Application.hxx"
 #include "DF_ChildIterator.hxx"
@@ -41,7 +44,9 @@
 #include "SALOMEDSImpl_Tool.hxx"
 #include "SALOMEDSImpl_IParameters.hxx"
 #include "SALOMEDSImpl_ScalarVariable.hxx"
+#include "SALOMEDSImpl_SComponent.hxx"
 
+#include "HDFOI.hxx"
 #include <fstream>
 #include <sstream>
 #include <algorithm>
 #define FILEID            "FILE: "
 #define VARIABLE_SEPARATOR  ':'
 #define OPERATION_SEPARATOR '|'
+#define USE_CASE_LABEL_ID "0:2"
+
+static void SaveAttributes(const SALOMEDSImpl_SObject& SO, HDFgroup *hdf_group_sobject);
+static void ReadAttributes(SALOMEDSImpl_Study*, const SALOMEDSImpl_SObject&, HDFdataset* );
+static void BuildTree (SALOMEDSImpl_Study*, HDFgroup*);
+static void Translate_IOR_to_persistentID (const SALOMEDSImpl_SObject&,
+                                           SALOMEDSImpl_Driver*, bool isMultiFile, bool isASCII);
+static void ReadNoteBookVariables(SALOMEDSImpl_Study* theStudy, HDFgroup* theGroup);
+
+namespace {
+  class StudyUnlocker
+  {
+  public:
+    StudyUnlocker( SALOMEDSImpl_Study* study ): myStudy( study ), myLocked( false )
+    {
+      myPrevLocked = myStudy->GetProperties()->IsLocked();
+      resume();
+    }
+    ~StudyUnlocker()
+    {
+      suspend();
+    }
+    void suspend()
+    {
+      if (myLocked) {
+        myStudy->GetProperties()->SetLocked(true);
+        myPrevLocked = myLocked;
+        myLocked = false;
+      }
+    }
+    void resume()
+    {
+      if (myPrevLocked) {
+        myStudy->GetProperties()->SetLocked(false);
+        myLocked = myPrevLocked;
+        myPrevLocked = false;
+      }
+    }
+  private:
+    SALOMEDSImpl_Study* myStudy;
+    bool myLocked;
+    bool myPrevLocked;
+  };
+}
 
 //============================================================================
 /*! Function : SALOMEDSImpl_Study
  *  Purpose  : SALOMEDSImpl_Study constructor
  */
 //============================================================================
-SALOMEDSImpl_Study::SALOMEDSImpl_Study(const DF_Document* doc,
-                                       const std::string& study_name)
+SALOMEDSImpl_Study::SALOMEDSImpl_Study() : _doc(NULL)
+{
+  _appli = new DF_Application();
+  _clipboard = _appli->NewDocument("SALOME_STUDY");
+
+  Init();
+}
+
+//============================================================================
+/*! Function : ~SALOMEDSImpl_Study
+ *  Purpose  : SALOMEDSImpl_Study destructor
+ */
+//============================================================================
+SALOMEDSImpl_Study::~SALOMEDSImpl_Study()
 {
-  _name = study_name;
-  _doc = (DF_Document*)doc;
-  _Saved = false ;
+  Clear();
+  _appli->Close(_clipboard);
+  // Destroy application
+  delete _appli;
+}
+
+//============================================================================
+/*! Function : Init
+ *  Purpose  : Initialize study components
+ */
+//============================================================================
+void SALOMEDSImpl_Study::Init()
+{
+  if (_doc)
+    return; // noop: already initialized
+
+  static int _id = 0;
+  std::stringstream sstrm;
+  sstrm << ++_id;
+  _name = "Study" + std::string(sstrm.str());
+  _doc = _appli->NewDocument("SALOME_STUDY");
+  _Saved = false;
   _URL = "";
-  _StudyId = -1;
   _autoFill = false;
   _errorCode = "";
   _useCaseBuilder = new SALOMEDSImpl_UseCaseBuilder(_doc);
@@ -78,65 +157,1088 @@ SALOMEDSImpl_Study::SALOMEDSImpl_Study(const DF_Document* doc,
   //Put on the root label a StudyHandle attribute to store the address of this object
   //It will be used to retrieve the study object by DF_Label that belongs to the study
   SALOMEDSImpl_StudyHandle::Set(_doc->Main().Root(), this);
+
+  // set Study properties
+  SALOMEDSImpl_AttributeStudyProperties* aProp = GetProperties();
+
+  int month=0,day=0,year=0,hh=0,mn=0,ss=0;
+  SALOMEDSImpl_Tool::GetSystemDate(year, month, day, hh, mn, ss);
+  aProp->SetModification(SALOMEDSImpl_Tool::GetUserName(),
+                         mn, hh, day, month, year);
+  aProp->SetCreationMode(1);  //"from scratch"
+}
+
+//============================================================================
+/*! Function : Clear
+ *  Purpose  : Clear study components
+ */
+//============================================================================
+void SALOMEDSImpl_Study::Clear()
+{
+  if (_builder) delete _builder;
+  _builder = NULL;
+  if (_cb) delete _cb;
+  _cb = NULL;
+  if (_useCaseBuilder) delete _useCaseBuilder;
+  _useCaseBuilder = NULL;
+  URL("");
+  _appli->Close(_doc);
+  _doc = NULL;
+  _mapOfSO.clear();
+  _mapOfSCO.clear();
+}
+
+//============================================================================
+/*! Function : Open
+ *  Purpose  : Open a Study from it's persistent reference
+ */
+//============================================================================
+bool SALOMEDSImpl_Study::Open(const std::string& aUrl)
+{
+  // Set "C" locale temporarily to avoid possible localization problems
+  Kernel_Utils::Localizer loc;
+
+  _errorCode = "";
+
+  // open the HDFFile
+  HDFfile *hdf_file =0;
+  HDFgroup *hdf_group_study_structure =0;
+  HDFgroup *hdf_notebook_vars = 0;
+
+  char* aC_HDFUrl;
+  std::string aHDFUrl;
+  bool isASCII = false;
+  if (HDFascii::isASCII(aUrl.c_str())) {
+    isASCII = true;
+    char* aResultPath = HDFascii::ConvertFromASCIIToHDF(aUrl.c_str());
+    if ( !aResultPath )
+      return NULL;
+    aC_HDFUrl = new char[strlen(aResultPath) + 19];
+    sprintf(aC_HDFUrl, "%shdf_from_ascii.hdf", aResultPath);
+    delete [] (aResultPath);
+    aHDFUrl = aC_HDFUrl;
+    delete [] aC_HDFUrl;
+  }
+  else {
+    aHDFUrl = aUrl;
+  }
+
+  hdf_file = new HDFfile((char*)aHDFUrl.c_str());
+  try {
+    hdf_file->OpenOnDisk(HDF_RDONLY);// mpv: was RDWR, but opened file can be write-protected too
+  }
+  catch (HDFexception)
+  {
+    char *eStr;
+    eStr = new char[strlen(aUrl.c_str())+17];
+    sprintf(eStr,"Can't open file %s",aUrl.c_str());
+    delete [] eStr;
+    _errorCode = std::string(eStr);
+    return NULL;
+  }
+
+  // Assign the value of the URL in the study object
+  URL(aUrl);
+
+  SALOMEDSImpl_AttributePersistentRef::Set(_doc->Main(), aUrl);
+
+  if (!hdf_file->ExistInternalObject("STUDY_STRUCTURE")) {
+     _errorCode = "Study is empty";
+    return false;
+  }
+
+  //Create  the Structure of the Document
+  hdf_group_study_structure = new HDFgroup("STUDY_STRUCTURE",hdf_file);
+
+  try {
+    BuildTree (this, hdf_group_study_structure);
+  }
+  catch (HDFexception)
+  {
+    char *eStr = new char [strlen(aUrl.c_str())+17];
+    sprintf(eStr,"Can't open file %s", aUrl.c_str());
+    _errorCode = std::string(eStr);
+    return false;
+  }
+
+  //Read and create notebook variables
+  if(hdf_file->ExistInternalObject("NOTEBOOK_VARIABLES")) {
+    hdf_notebook_vars  = new HDFgroup("NOTEBOOK_VARIABLES",hdf_file);
+    ReadNoteBookVariables(this, hdf_notebook_vars);
+    hdf_notebook_vars =0; //will be deleted by hdf_sco_group destructor
+  }
+
+  hdf_file->CloseOnDisk();
+  hdf_group_study_structure = new HDFgroup("STUDY_STRUCTURE",hdf_file);
+
+  if (isASCII) {
+    std::vector<std::string> aFilesToRemove;
+    aFilesToRemove.push_back("hdf_from_ascii.hdf");
+    SALOMEDSImpl_Tool::RemoveTemporaryFiles(SALOMEDSImpl_Tool::GetDirFromPath(aHDFUrl), aFilesToRemove, true);
+  }
+
+  delete hdf_file; // all related hdf objects will be deleted
+
+  // unlock study if it is locked, to set components versions
+  StudyUnlocker unlock(this);
+
+  //For old studies we have to add "unknown" version tag for all stored components
+  SALOMEDSImpl_SComponentIterator itcomponent = NewComponentIterator();
+  for (; itcomponent.More(); itcomponent.Next())
+  {
+    SALOMEDSImpl_SComponent sco = itcomponent.Value();
+    std::string aCompType = sco.GetComment();
+    if ( aCompType == SALOMEDSImpl_IParameters::getDefaultVisualComponent() ) continue;
+    if ( GetProperties()->GetComponentVersions( aCompType ).empty() )
+      GetProperties()->SetComponentVersion( aCompType, "" ); // empty version means "unknown"
+  }
+
+  return true;
+}
+
+//============================================================================
+/*! Function : Save
+ *  Purpose  : Save a Study to it's persistent reference
+ */
+//============================================================================
+bool SALOMEDSImpl_Study::Save(SALOMEDSImpl_DriverFactory* aFactory,
+                              bool theMultiFile,
+                              bool theASCII)
+{
+  _errorCode = "";
+
+  std::string url = URL();
+  if (url.empty()) {
+    _errorCode = "No path specified to save the study. Nothing done";
+    return false;
+  }
+  else {
+    return Impl_SaveAs(url, aFactory, theMultiFile, theASCII);
+  }
+
+  return false;
+}
+
+//=============================================================================
+/*! Function : SaveAs
+ *  Purpose  : Save a study to the persistent reference aUrl
+ */
+//============================================================================
+bool SALOMEDSImpl_Study::SaveAs(const std::string& aUrl,
+                                SALOMEDSImpl_DriverFactory* aFactory,
+                                bool theMultiFile,
+                                bool theASCII)
+{
+  _errorCode = "";
+  return Impl_SaveAs(aUrl, aFactory, theMultiFile, theASCII);
+}
+
+//=============================================================================
+/*! Function : _SaveProperties
+ *  Purpose  : save the study properties in HDF file
+ */
+//============================================================================
+bool SALOMEDSImpl_Study::Impl_SaveProperties(HDFgroup *hdf_group)
+{
+  _errorCode = "";
+
+  HDFdataset *hdf_dataset = 0;
+  hdf_size size[1];
+  hdf_int32 name_len;
+
+  // add modifications list (user and date of save)
+  SALOMEDSImpl_AttributeStudyProperties* aProp = GetProperties();
+
+  // unlock study if it is locked, to set modification date
+  StudyUnlocker unlock(this);
+
+  int month=0,day=0,year=0,hh=0,mn=0,ss=0;
+  SALOMEDSImpl_Tool::GetSystemDate(year, month, day, hh, mn, ss);
+  aProp->SetModification(SALOMEDSImpl_Tool::GetUserName(),
+                         mn, hh, day, month, year);
+
+  // lock study back if it was locked initially, to write correct value of Locked flag
+  unlock.suspend();
+
+  std::vector<std::string> aNames;
+  std::vector<int> aMinutes, aHours, aDays, aMonths, aYears;
+
+  aProp->GetModifications(aNames, aMinutes, aHours, aDays, aMonths, aYears);
+
+  std::string units = aProp->GetUnits();
+  std::string comment = aProp->GetComment();
+
+  std::map< std::string, std::vector<std::string> > allVersions = aProp->GetComponentsVersions();
+  std::map<std::string, std::string> versions;
+
+  int aLength = 0, aLength1 = 0, anIndex, i, unitsSize = 0, commentSize = 0;
+
+  for(i=1; i<=(int)aNames.size(); i++)
+    aLength += (int)aNames[i-1].size() + 1; //!< TODO: conversion from size_t to int
+
+  std::map< std::string, std::vector<std::string> >::const_iterator it;
+  for (it = allVersions.begin(); it != allVersions.end(); ++it ) {
+    std::string vlist = "";
+    std::vector<std::string> vl = it->second;
+    std::vector<std::string>::const_iterator vlit;
+    for ( vlit = vl.begin(); vlit != vl.end(); ++vlit ) {
+      if ( vlist != "" ) vlist += ";";
+      vlist += *vlit;
+    }
+    versions[ it->first ] = vlist;
+    aLength1 += int(it->first.size() + vlist.size() + 2); //!< TODO: conversion from size_t to int
+  }
+
+  unitsSize = (int)units.size(); //!< TODO: conversion from size_t to int
+  commentSize = (int)comment.size(); //!< TODO: conversion from size_t to int
+
+  //string format:
+  //locked flag, modified flag,
+  //minutes, hours, day, months, year, user name, char(1),
+  //minutes, hours, day, months, year, user name, char(1),
+  //.....................................................,
+  //.....................................................,
+  //.....................................................,
+  //minutes, hours, day, months, year, user name, char(1), char(30) <- !!!! used to define end of section with modifications !!!!
+  //units, char(1), comment, char(30) <- !!!! used to define start of section with components' versions !!!!
+  //component=versions, char(1),
+  //component=versions, char(1),
+  //...........................,
+  //component=versions, char(1), char(0)
+
+  //string length: 1 byte = locked flag, 1 byte = modified flag, (12 + name length + 1) for each name and date, 1 byte (char(30) section delimiter)
+  // unit length + 1, comment length, "zero" byte
+
+  char* aProperty = new char[3 + aLength + 12 * aNames.size() + 1 + unitsSize + 1 + commentSize + 1 + aLength1 ];
+
+  sprintf(aProperty,"%c%c", (char)aProp->GetCreationMode(),  (aProp->IsLocked())?'l':'u');
+
+  aLength = (int)aNames.size(); //!< TODO: conversion from size_t to int
+  int a = 2;
+  for(anIndex = 0; anIndex<aLength; anIndex++) {
+    sprintf(&(aProperty[a]),"%2d%2d%2d%2d%4d%s",
+            (int)(aMinutes[anIndex]),
+            (int)(aHours[anIndex]),
+            (int)(aDays[anIndex]),
+            (int)(aMonths[anIndex]),
+            (int)(aYears[anIndex]),
+            aNames[anIndex].c_str());
+    a = (int)strlen(aProperty); //!< TODO: conversion from size_t to int
+    aProperty[a++] = 1;
+  }
+
+  //Write delimiter of the section to define end of the modifications section
+  aProperty[a++] = 30;
+
+  //Write units if need
+  if(units.size() > 0) {
+    sprintf(&(aProperty[a]),"%s",units.c_str());
+    a = (int)strlen(aProperty); //!< TODO: conversion from size_t to int
+  }
+
+  aProperty[a++] = 1;
+
+  //Write comments if need
+  if(comment.size() > 0) {
+    sprintf(&(aProperty[a]),"%s",comment.c_str());
+    a = (int)strlen(aProperty); //!< TODO: conversion from size_t to int
+  }
+
+  aProperty[a++] = 30; //delimiter of the component versions
+
+  std::map<std::string, std::string>::const_iterator versionsIt;
+  for ( versionsIt = versions.begin(); versionsIt != versions.end(); ++versionsIt ) {
+    sprintf(&(aProperty[a]),"%s=%s",
+            (char*)(versionsIt->first.c_str()),
+            (char*)(versionsIt->second.c_str()));
+    a = a + (int)versionsIt->first.size() + (int)versionsIt->second.size() + 1; //!< TODO: conversion from size_t to int
+    aProperty[a++] = 1;
+  }
+
+  aProperty[a] = 0;
+
+  name_len = (hdf_int32) a;
+  size[0] = name_len + 1 ;
+  hdf_dataset = new HDFdataset("AttributeStudyProperties",hdf_group,HDF_STRING,size,1);
+  hdf_dataset->CreateOnDisk();
+  hdf_dataset->WriteOnDisk(aProperty);
+  hdf_dataset->CloseOnDisk();
+  hdf_dataset=0; //will be deleted by hdf_sco_group destructor
+  delete [] aProperty;
+
+  aProp->SetModified(0);
+  return true;
+}
+
+//=============================================================================
+/*! Function : _SaveAs
+ *  Purpose  : save the study in HDF file
+ */
+//============================================================================
+bool SALOMEDSImpl_Study::Impl_SaveAs(const std::string& aStudyUrl,
+                                     SALOMEDSImpl_DriverFactory* aFactory,
+                                     bool theMultiFile,
+                                     bool theASCII)
+{
+  // Set "C" locale temporarily to avoid possible localization problems
+  Kernel_Utils::Localizer loc;
+
+  // HDF File will be composed of different part :
+  // * For each ComponentDataType, all data created by the component
+  //   Information in data group hdf_group_datacomponent
+  // * Study Structure -> Exactly what is contained in Document
+  //   Information in data group hdf_group_study_structure
+
+  _errorCode = "";
+
+  HDFfile *hdf_file=0;
+  HDFgroup *hdf_group_study_structure =0;
+  HDFgroup *hdf_sco_group =0;
+  HDFgroup *hdf_sco_group2 =0;
+  HDFgroup *hdf_notebook_vars =0;
+  HDFgroup *hdf_notebook_var  = 0;
+
+  HDFgroup *hdf_group_datacomponent =0;
+  HDFdataset *hdf_dataset =0;
+  hdf_size size[1];
+  hdf_int32 name_len = 0;
+  std::string component_name;
+
+  // Store previous URL
+  std::string anOldName = URL();
+
+  // Map to store components' versions
+  std::map<std::string, std::string> componentVersions;
+
+  //Create a temporary url to which the study is saved
+  std::string aUrl = SALOMEDSImpl_Tool::GetTmpDir() + SALOMEDSImpl_Tool::GetNameFromPath(aStudyUrl);
+
+  // unlock study if it is locked, as some attributes need to be modified
+  StudyUnlocker unlock(this);
+
+  SALOMEDSImpl_StudyBuilder* SB= NewBuilder();
+  std::map<std::string, SALOMEDSImpl_Driver*> aMapTypeDriver;
+
+  try {
+    // mpv 15.12.2003: for saving components we have to load all data from all modules
+    SALOMEDSImpl_SComponentIterator itcomponent = NewComponentIterator();
+    for (; itcomponent.More(); itcomponent.Next()) {
+      SALOMEDSImpl_SComponent sco = itcomponent.Value();
+      // if there is an associated Engine call its method for saving
+      std::string IOREngine;
+      try {
+        SALOMEDSImpl_Driver* aDriver = NULL;
+        std::string aCompType = sco.GetComment();
+        if (!sco.ComponentIOR(IOREngine)) {
+          if (!aCompType.empty()) {
+            aDriver = aFactory->GetDriverByType(aCompType);
+            if (aDriver != NULL) {
+              if (!SB->LoadWith(sco, aDriver)) {
+                _errorCode = SB->GetErrorCode();
+                return false;
+              }
+            }
+          }
+        }
+        else {
+          aDriver = aFactory->GetDriverByIOR(IOREngine);
+        }
+        aMapTypeDriver[aCompType] = aDriver;
+      }
+      catch(...) {
+        _errorCode = "Can not restore information to resave it";
+        return false;
+      }
+    }
+
+    // VSR: set URL to new file name
+    // VSR: remember to set previous name if save operation fails
+    URL(aStudyUrl);
+
+    // To change for Save
+    // Do not have to do a new file but just a Open??? Rewrite all information after erasing everything??
+    hdf_file = new HDFfile((char*)aUrl.c_str());
+    hdf_file->CreateOnDisk();
+
+    //-----------------------------------------------------------------------
+    // 1 - Create a groupe for each SComponent and Update the PersistanceRef
+    //-----------------------------------------------------------------------
+    hdf_group_datacomponent = new HDFgroup("DATACOMPONENT",hdf_file);
+    hdf_group_datacomponent->CreateOnDisk();
+
+    for (itcomponent.Init(); itcomponent.More(); itcomponent.Next()) {
+      SALOMEDSImpl_SComponent sco = itcomponent.Value();
+
+      std::string scoid = sco.GetID();
+      hdf_sco_group = new HDFgroup((char*)scoid.c_str(), hdf_group_datacomponent);
+      hdf_sco_group->CreateOnDisk();
+
+      std::string componentDataType = sco.ComponentDataType();
+      std::string IOREngine;
+      if (sco.ComponentIOR(IOREngine)) {
+        // Engine should be already in the map as it was to added before
+        SALOMEDSImpl_Driver* Engine = aMapTypeDriver[componentDataType];
+        if (Engine != NULL) {
+          SALOMEDSImpl_TMPFile* aStream = NULL;
+          long length = 0;
+
+          componentVersions[ componentDataType ] = Engine->Version();
+
+          if (theASCII) aStream = Engine->SaveASCII(sco,
+                                                    SALOMEDSImpl_Tool::GetDirFromPath(aUrl),
+                                                    length,
+                                                    theMultiFile);
+          else aStream = Engine->Save(sco,
+                                      SALOMEDSImpl_Tool::GetDirFromPath(aUrl),
+                                      length,
+                                      theMultiFile);
+          HDFdataset *hdf_dataset;
+          hdf_size aHDFSize[1];
+          if (length > 0) {  //The component saved some auxiliary files, then put them into HDF file
+            aHDFSize[0] = length;
+
+            HDFdataset *hdf_dataset = new HDFdataset("FILE_STREAM", hdf_sco_group, HDF_STRING, aHDFSize, 1);
+            hdf_dataset->CreateOnDisk();
+            hdf_dataset->WriteOnDisk(aStream->Data());  //Save the stream in the HDF file
+            hdf_dataset->CloseOnDisk();
+          }
+
+          if (aStream) delete aStream;
+
+          // store multifile state
+          aHDFSize[0] = 2;
+          hdf_dataset = new HDFdataset("MULTIFILE_STATE", hdf_sco_group, HDF_STRING, aHDFSize, 1);
+          hdf_dataset->CreateOnDisk();
+          hdf_dataset->WriteOnDisk((void*)(theMultiFile?"M":"S")); // save: multi or single
+          hdf_dataset->CloseOnDisk();
+          hdf_dataset=0; //will be deleted by hdf_sco_AuxFiles destructor
+          // store ASCII state
+          aHDFSize[0] = 2;
+          hdf_dataset = new HDFdataset("ASCII_STATE", hdf_sco_group, HDF_STRING, aHDFSize, 1);
+          hdf_dataset->CreateOnDisk();
+          hdf_dataset->WriteOnDisk((void*)(theASCII?"A":"B")); // save: ASCII or BINARY
+          hdf_dataset->CloseOnDisk();
+          hdf_dataset=0; //will be deleted by hdf_sco_AuxFiles destructor
+          // Creation of the persistence reference  attribute
+          Translate_IOR_to_persistentID (sco, Engine, theMultiFile, theASCII);
+        }
+      }
+      hdf_sco_group->CloseOnDisk();
+      hdf_sco_group=0; // will be deleted by hdf_group_datacomponent destructor
+    }
+    hdf_group_datacomponent->CloseOnDisk();
+    hdf_group_datacomponent =0;  // will be deleted by hdf_file destructor
+
+    //-----------------------------------------------------------------------
+    //3 - Write the Study Structure
+    //-----------------------------------------------------------------------
+    hdf_group_study_structure = new HDFgroup("STUDY_STRUCTURE",hdf_file);
+    hdf_group_study_structure->CreateOnDisk();
+    // save component attributes
+    for (itcomponent.Init(); itcomponent.More(); itcomponent.Next()) {
+      SALOMEDSImpl_SComponent SC = itcomponent.Value();
+      std::string scid = SC.GetID();
+      hdf_sco_group2 = new HDFgroup((char*)scid.c_str(), hdf_group_study_structure);
+      hdf_sco_group2->CreateOnDisk();
+      SaveAttributes(SC, hdf_sco_group2);
+      // ComponentDataType treatment
+      component_name = SC.ComponentDataType();
+      name_len = (hdf_int32)component_name.length();
+      size[0] = name_len +1 ;
+      hdf_dataset = new HDFdataset("COMPONENTDATATYPE",hdf_sco_group2,HDF_STRING,size,1);
+      hdf_dataset->CreateOnDisk();
+      hdf_dataset->WriteOnDisk((char*)component_name.c_str());
+      hdf_dataset->CloseOnDisk();
+      hdf_dataset=0; //will be deleted by hdf_sco_group destructor
+      Impl_SaveObject(SC, hdf_sco_group2);
+      hdf_sco_group2->CloseOnDisk();
+      hdf_sco_group2=0; // will be deleted by hdf_group_study_structure destructor
+    }
+    //-----------------------------------------------------------------------
+    //4 - Write the Study UseCases Structure
+    //-----------------------------------------------------------------------
+    SALOMEDSImpl_SObject aSO = FindObjectID(USE_CASE_LABEL_ID);
+    if (aSO) {
+      HDFgroup *hdf_soo_group = new HDFgroup(USE_CASE_LABEL_ID,hdf_group_study_structure);
+      hdf_soo_group->CreateOnDisk();
+      SaveAttributes(aSO, hdf_soo_group);
+      Impl_SaveObject(aSO, hdf_soo_group);
+      hdf_soo_group->CloseOnDisk();
+      hdf_soo_group=0; // will be deleted by hdf_group_study_structure destructor
+    }
+    //-----------------------------------------------------------------------
+    //5 - Write the NoteBook Variables
+    //-----------------------------------------------------------------------
+
+    //5.1 Create group to store all note book variables
+    hdf_notebook_vars = new HDFgroup("NOTEBOOK_VARIABLES",hdf_file);
+    hdf_notebook_vars->CreateOnDisk();
+
+    std::string varValue;
+    std::string varType;
+    std::string varIndex;
+
+    for (int i=0 ;i < (int)myNoteBookVars.size(); i++ ) {
+      // For each variable create HDF group
+      hdf_notebook_var = new HDFgroup((char*)myNoteBookVars[i]->Name().c_str(),hdf_notebook_vars);
+      hdf_notebook_var->CreateOnDisk();
+
+      // Save Variable type
+      varType = myNoteBookVars[i]->SaveType();
+      name_len = (hdf_int32) varType.length();
+      size[0] = name_len +1 ;
+      hdf_dataset = new HDFdataset("VARIABLE_TYPE",hdf_notebook_var,HDF_STRING,size,1);
+      hdf_dataset->CreateOnDisk();
+      hdf_dataset->WriteOnDisk((char*)varType.c_str());
+      hdf_dataset->CloseOnDisk();
+      hdf_dataset=0; //will be deleted by hdf_sco_group destructor
+
+      char buffer[256];
+      sprintf(buffer,"%d",i);
+      varIndex= std::string(buffer);
+      name_len = (hdf_int32) varIndex.length();
+      size[0] = name_len +1 ;
+      hdf_dataset = new HDFdataset("VARIABLE_INDEX",hdf_notebook_var,HDF_STRING,size,1);
+      hdf_dataset->CreateOnDisk();
+      hdf_dataset->WriteOnDisk((char*)varIndex.c_str());
+      hdf_dataset->CloseOnDisk();
+      hdf_dataset=0; //will be deleted by hdf_sco_group destructor
+
+      // Save Variable value
+      varValue = myNoteBookVars[i]->Save();
+      name_len = (hdf_int32) varValue.length();
+      size[0] = name_len +1 ;
+      hdf_dataset = new HDFdataset("VARIABLE_VALUE",hdf_notebook_var,HDF_STRING,size,1);
+      hdf_dataset->CreateOnDisk();
+      hdf_dataset->WriteOnDisk((char*)varValue.c_str());
+      hdf_dataset->CloseOnDisk();
+      hdf_dataset=0; //will be deleted by hdf_sco_group destructor
+      hdf_notebook_var->CloseOnDisk();
+      hdf_notebook_var = 0; //will be deleted by hdf_sco_group destructor
+    }
+    hdf_notebook_vars->CloseOnDisk();
+    hdf_notebook_vars = 0; //will be deleted by hdf_sco_group destructor
+
+    // record component versions
+    std::map<std::string, std::string>::const_iterator itVersions;
+    for ( itVersions = componentVersions.begin(); itVersions != componentVersions.end(); ++itVersions )
+      GetProperties()->SetComponentVersion( itVersions->first, itVersions->second );
+
+    // lock study back if it was locked initially, to write correct value of Locked flag
+    unlock.suspend();
+
+    //-----------------------------------------------------------------------
+    //6 - Write the Study Properties
+    //-----------------------------------------------------------------------
+    std::string study_name = Name();
+    name_len = (hdf_int32) study_name.size();
+    size[0] = name_len +1 ;
+    hdf_dataset = new HDFdataset("STUDY_NAME",hdf_group_study_structure,HDF_STRING,size,1);
+    hdf_dataset->CreateOnDisk();
+    hdf_dataset->WriteOnDisk((char*)study_name.c_str());
+    hdf_dataset->CloseOnDisk();
+    hdf_dataset=0; // will be deleted by hdf_group_study_structure destructor
+
+    Impl_SaveProperties(hdf_group_study_structure);
+    hdf_group_study_structure->CloseOnDisk();
+    hdf_file->CloseOnDisk();
+
+    hdf_group_study_structure =0; // will be deleted by hdf_file destructor
+    delete hdf_file; // recursively deletes all hdf objects...
+  }
+  catch (HDFexception) {
+    _errorCode = "HDFexception ! ";
+    URL( anOldName ); // VSR: restore previous url if operation is failed
+    return false;
+  }
+  catch (std::exception& exc) {
+    _errorCode = const_cast<char*>(exc.what());
+    URL( anOldName ); // VSR: restore previous url if operation is failed
+    return false;
+  }
+  catch (...) {
+    _errorCode = "Unknown exception ! ";
+    URL( anOldName ); // VSR: restore previous url if operation is failed
+    return false;
+  }
+  if (theASCII) { // save file in ASCII format
+    HDFascii::ConvertFromHDFToASCII(aUrl.c_str(), true);
+  }
+
+  // Now it's necessary to copy files from the temporary directory to the user defined directory.
+  // The easiest way to get a list of file in the temporary directory
+
+  std::string aCmd, aTmpFileDir = SALOMEDSImpl_Tool::GetTmpDir();
+  std::string aTmpFile = aTmpFileDir +"files";
+  std::string aStudyTmpDir = SALOMEDSImpl_Tool::GetDirFromPath(aUrl);
+
+#ifdef WIN32
+  aCmd = "dir /B \"" + aStudyTmpDir +"\" > \"" + aTmpFile + "\"";
+#else
+  aCmd ="ls -1 \"" + aStudyTmpDir +"\" > " + aTmpFile;
+#endif
+#if defined(WIN32) && defined(UNICODE)
+  std::wstring awCmd = Kernel_Utils::utf8_decode_s(aCmd);
+  _wsystem( awCmd.c_str() );
+#else  
+  system(aCmd.c_str());
+#endif
+
+  // Iterate and move files in the temporary directory
+#if defined(WIN32) && defined(UNICODE)
+  std::wstring awTmpFile = Kernel_Utils::utf8_decode_s(aTmpFile);
+  FILE* fp = _wfopen(awTmpFile.c_str(), L"rb");
+#else
+  FILE* fp = fopen(aTmpFile.c_str(), "rb");
+#endif
+  if (!fp) {
+    URL( anOldName ); // VSR: restore previous url if operation is failed
+    return false;
+  }
+  char* buffer = new char[2047];
+  int errors = 0;
+  while (!feof(fp) && !errors) {
+    if ((fgets(buffer, 2046, fp)) == NULL) break;
+    size_t aLen = strlen(buffer);
+    if (buffer[aLen-1] == '\n') buffer[aLen-1] = char(0);
+
+#ifdef WIN32    
+    // Force removing readonly attribute from a file under Windows, because of a but in the HDF
+    std::string aReadOlnyRmCmd = "attrib -r \"" + aStudyTmpDir + std::string(buffer)+ "\" > nul 2>&1";
+#ifdef UNICODE
+    std::wstring awReadOlnyRmCmd = Kernel_Utils::utf8_decode_s(aReadOlnyRmCmd);
+    _wsystem(awReadOlnyRmCmd.c_str());
+#else  
+    system(aReadOlnyRmCmd.c_str());
+#endif
+
+    aCmd = "move /Y \"" + aStudyTmpDir + std::string(buffer) + "\" \"" + SALOMEDSImpl_Tool::GetDirFromPath(aStudyUrl) +"\" > nul 2>&1";
+#else
+    aCmd = "mv -f \"" + aStudyTmpDir + std::string(buffer) + "\" \"" + SALOMEDSImpl_Tool::GetDirFromPath(aStudyUrl)+"\"";
+#endif
+#if defined(WIN32) && defined(UNICODE)
+    std::wstring awCmd = Kernel_Utils::utf8_decode_s(aCmd);
+    errors = _wsystem(awCmd.c_str());
+#else  
+    errors = system(aCmd.c_str());
+#endif
+  }
+
+  delete []buffer;
+  fclose(fp);
+
+  // Perform cleanup
+#ifdef WIN32
+#ifdef UNICODE
+  std::wstring aTmpFileToDelete = Kernel_Utils::utf8_decode_s(aTmpFile);
+#else
+  std::string aTmpFileToDelete = aTmpFile;
+#endif
+  DeleteFile(aTmpFileToDelete.c_str());
+#else
+  unlink(aTmpFile.c_str());
+#endif
+
+#ifdef WIN32
+#ifdef UNICODE
+  std::wstring aTmpFileDirToDelete = Kernel_Utils::utf8_decode_s( aTmpFileDir );
+  std::wstring aStudyTmpDirToDelete = Kernel_Utils::utf8_decode_s( aStudyTmpDir );
+#else
+  std::string aTmpFileDirToDelete = aTmpFileDir;
+  std::string aStudyTmpDirToDelete = aStudyTmpDir;
+#endif  
+  RemoveDirectory( aTmpFileDirToDelete.c_str() );
+  RemoveDirectory( aStudyTmpDirToDelete.c_str() );
+#else
+  rmdir(aTmpFileDir.c_str());
+  rmdir(aStudyTmpDir.c_str());
+#endif
+
+  if ( !errors ) {
+    // VSR: finally, if all is done without errors, mark study as Saved
+    IsSaved(true);
+  }
+
+  std::map<std::string, SALOMEDSImpl_Driver*>::iterator n2dr = aMapTypeDriver.begin();
+  for ( ; n2dr != aMapTypeDriver.end(); ++n2dr )
+    delete n2dr->second;
+
+  return !errors;
+}
+
+//============================================================================
+/*! Function : Impl_SaveObject
+ *  Purpose  :
+ */
+//============================================================================
+bool SALOMEDSImpl_Study::Impl_SaveObject(const SALOMEDSImpl_SObject& SC,
+                                         HDFgroup *hdf_group_datatype)
+{
+  _errorCode = "";
+
+  // Write in group hdf_group_datatype all information of SObject SC
+  // Iterative function to parse all SObjects under a SComponent
+
+  HDFgroup *hdf_group_sobject = 0;
+
+  DF_ChildIterator itchild(SC.GetLabel());
+  for (; itchild.More(); itchild.Next()) {
+    // mpv: don't save empty labels
+    std::vector<DF_Attribute*> attr = itchild.Value().GetAttributes();
+    if (attr.size() == 0) {  //No attributes on the label
+      DF_ChildIterator subchild(itchild.Value());
+      if (!subchild.More()) {
+        continue;
+      }
+      subchild.Init(itchild.Value(), true);
+      bool anEmpty = true;
+      for (; subchild.More() && anEmpty; subchild.Next()) {
+        std::vector<DF_Attribute*> attr2 = subchild.Value().GetAttributes();
+        if (attr2.size()) {
+          anEmpty = false;  //There are attributes on the child label
+          break;
+        }
+      }
+      if (anEmpty) continue;
+    }
+
+    SALOMEDSImpl_SObject SO = SALOMEDSImpl_Study::SObject(itchild.Value());
+
+    std::string scoid = SO.GetID();
+    hdf_group_sobject = new HDFgroup(scoid.c_str(), hdf_group_datatype);
+    hdf_group_sobject->CreateOnDisk();
+    SaveAttributes(SO, hdf_group_sobject);
+    Impl_SaveObject(SO, hdf_group_sobject);
+    hdf_group_sobject->CloseOnDisk();
+    hdf_group_sobject =0; // will be deleted by father hdf object destructor
+  }
+  return true;
+}
+
+//============================================================================
+/*! Function : CanCopy
+ *  Purpose  :
+ */
+//============================================================================
+bool SALOMEDSImpl_Study::CanCopy(const SALOMEDSImpl_SObject& theObject,
+                                 SALOMEDSImpl_Driver* theEngine)
+{
+  _errorCode = "";
+  SALOMEDSImpl_SComponent aComponent = theObject.GetFatherComponent();
+  if (!aComponent) return false;
+  if (aComponent.GetLabel() == theObject.GetLabel()) return false;
+  std::string IOREngine;
+  if (!aComponent.ComponentIOR(IOREngine)) return false;
+  if (theEngine == NULL) return false;
+  return theEngine->CanCopy(theObject);
+}
+
+//============================================================================
+/*! Function : CopyLabel
+ *  Purpose  :
+ */
+//============================================================================
+bool SALOMEDSImpl_Study::CopyLabel(SALOMEDSImpl_Driver* theEngine,
+                                   const int theSourceStartDepth,
+                                   const DF_Label& theSource,
+                                   const DF_Label& theDestinationMain)
+{
+  _errorCode = "";
+
+  int a;
+  DF_Label aTargetLabel = theDestinationMain;
+  DF_Label aAuxTargetLabel = theDestinationMain.Father().FindChild(2);
+  for(a = theSource.Depth() - theSourceStartDepth; a > 0 ; a--) {
+    DF_Label aSourceLabel = theSource;
+    for(int aNbFather = 1; aNbFather < a; aNbFather++) aSourceLabel = aSourceLabel.Father();
+    aTargetLabel = aTargetLabel.FindChild(aSourceLabel.Tag());
+    aAuxTargetLabel = aAuxTargetLabel.FindChild(aSourceLabel.Tag());
+  }
+  // iterate attributes
+  std::vector<DF_Attribute*> attrList = theSource.GetAttributes();
+  for(int i = 0, len = (int)attrList.size(); i<len; i++) { //!< TODO: conversion from size_t to int
+    DF_Attribute* anAttr = attrList[i];
+    std::string type = SALOMEDSImpl_GenericAttribute::Impl_GetType(anAttr);
+    if (type.substr(0, 17) == std::string("AttributeTreeNode")) continue; // never copy tree node attribute
+    if (type == std::string("AttributeTarget")) continue; // and target attribute
+
+    if (type == std::string("AttributeReference")) { // reference copied as Comment in aux tree
+      DF_Label aReferenced = dynamic_cast<SALOMEDSImpl_AttributeReference*>(anAttr)->Get();
+      std::string anEntry = aReferenced.Entry();
+      // store the value of name attribute of referenced label
+      SALOMEDSImpl_AttributeName* aNameAttribute;
+      if ((aNameAttribute=(SALOMEDSImpl_AttributeName*)aReferenced.FindAttribute(SALOMEDSImpl_AttributeName::GetID()))) {
+        anEntry += " ";
+        anEntry += aNameAttribute->Value();
+      }
+      SALOMEDSImpl_AttributeComment::Set(aAuxTargetLabel, anEntry);
+      continue;
+    }
+
+    if (type == std::string("AttributeIOR")) { // IOR => ID and TMPFile of Engine
+      std::string anEntry = theSource.Entry();
+      SALOMEDSImpl_SObject aSO = FindObjectID(anEntry);
+      int anObjID;
+      long aLen;
+      SALOMEDSImpl_TMPFile* aStream = theEngine->CopyFrom(aSO, anObjID, aLen);
+      std::string aResStr("");
+      for(a = 0; a < aLen; a++) {
+        aResStr += (char)(aStream->Get(a));
+      }
+
+      if(aStream) delete aStream;
+
+      SALOMEDSImpl_AttributeInteger::Set(aAuxTargetLabel, anObjID);
+      SALOMEDSImpl_AttributeName::Set(aAuxTargetLabel, aResStr);
+      continue;
+    }
+    DF_Attribute* aNewAttribute = anAttr->NewEmpty();
+    aTargetLabel.AddAttribute(aNewAttribute);
+    anAttr->Paste(aNewAttribute);
+  }
+
+  return true;
+}
+
+//============================================================================
+/*! Function : Copy
+ *  Purpose  :
+ */
+//============================================================================
+bool SALOMEDSImpl_Study::Copy(const SALOMEDSImpl_SObject& theObject,
+                                    SALOMEDSImpl_Driver* theEngine)
+{
+  _errorCode = "";
+
+  // adoptation for alliances datamodel copy: without IOR attributes !!!
+  bool aStructureOnly; // copy only SObjects and attributes without component help
+  aStructureOnly = !theObject.GetLabel().IsAttribute(SALOMEDSImpl_AttributeIOR::GetID());
+
+  if (!_doc) {
+    _errorCode = "Document is null";
+    return false;
+  }
+
+  //Clear the clipboard
+  _clipboard->Main().Root().ForgetAllAttributes(true);
+  _appli->Close(_clipboard);
+  _clipboard = _appli->NewDocument("SALOME_STUDY");
+
+  // set component data type to the name attribute of root label
+  if (!aStructureOnly) {
+    SALOMEDSImpl_AttributeComment::Set(_clipboard->Main().Root(),
+                                       theEngine->ComponentDataType());
+  }
+  // iterate all theObject's label children
+  DF_Label aStartLabel = theObject.GetLabel();
+  int aSourceStartDepth = aStartLabel.Depth();
+
+  // copy main source label
+  CopyLabel(theEngine, aSourceStartDepth, aStartLabel, _clipboard->Main());
+
+  // copy all subchildren of the main source label (all levels)
+  DF_ChildIterator anIterator(aStartLabel, true);
+  for(; anIterator.More(); anIterator.Next()) {
+    CopyLabel(theEngine, aSourceStartDepth, anIterator.Value(), _clipboard->Main());
+  }
+
+  return true;
 }
 
-
 //============================================================================
-/*! Function : ~SALOMEDSImpl_Study
- *  Purpose  : SALOMEDSImpl_Study destructor
+/*! Function : CanPaste
+ *  Purpose  :
  */
 //============================================================================
-SALOMEDSImpl_Study::~SALOMEDSImpl_Study()
+bool SALOMEDSImpl_Study::CanPaste(const SALOMEDSImpl_SObject& theObject,
+                                         SALOMEDSImpl_Driver* theEngine)
 {
-  delete _builder;
-  delete _cb;
-  delete _useCaseBuilder;
+  _errorCode = "";
+
+  if (!_clipboard) {
+    _errorCode = "Clipboard is null";
+    return false;
+  }
+
+  SALOMEDSImpl_AttributeComment* aCompName = NULL;
+  if (!(aCompName=(SALOMEDSImpl_AttributeComment*)_clipboard->Main().Root().FindAttribute(SALOMEDSImpl_AttributeComment::GetID()))) {
+    _errorCode = "Clipboard has no component type";
+    return false;
+  }
+  SALOMEDSImpl_AttributeInteger* anObjID;
+  if (!(anObjID=(SALOMEDSImpl_AttributeInteger*)_clipboard->Main().Father().FindChild(2).FindAttribute(SALOMEDSImpl_AttributeInteger::GetID()))) {
+    _errorCode = "Clipboard has no object id";
+    return false;
+  }
+  SALOMEDSImpl_SComponent aComponent = theObject.GetFatherComponent();
+  if (!aComponent) {
+    _errorCode = "Object doesn't belong to component";
+    return false;
+  }
+
+  std::string IOREngine;
+  if (!aComponent.ComponentIOR(IOREngine)) {
+    _errorCode = "component has no IOR";
+    return false;
+  }
+  return theEngine->CanPaste(aCompName->Value(), anObjID->Value());
 }
 
 //============================================================================
-/*! Function : GetPersistentReference
- *  Purpose  : Get persistent reference of study (idem URL())
+/*! Function : PasteLabel
+ *  Purpose  :
  */
 //============================================================================
-std::string SALOMEDSImpl_Study::GetPersistentReference()
+DF_Label SALOMEDSImpl_Study::PasteLabel(SALOMEDSImpl_Driver* theEngine,
+                                        const DF_Label& theSource,
+                                        const DF_Label& theDestinationStart,
+                                        const bool isFirstElement)
 {
   _errorCode = "";
-  return URL();
+
+  // get corresponding source, target and auxiliary labels
+  DF_Label aTargetLabel = theDestinationStart;
+
+  DF_Label aAuxSourceLabel = theSource.Root().FindChild(2);
+  int a;
+  if (!isFirstElement) {
+    for(a = theSource.Depth() - 1; a > 0 ; a--) {
+      DF_Label aSourceLabel = theSource;
+      for(int aNbFather = 1; aNbFather < a; aNbFather++) aSourceLabel = aSourceLabel.Father();
+      aTargetLabel = aTargetLabel.FindChild(aSourceLabel.Tag());
+      aAuxSourceLabel = aAuxSourceLabel.FindChild(aSourceLabel.Tag());
+    }
+    SALOMEDSImpl_SObject so = GetSObject(aTargetLabel);
+    addSO_Notification(so);
+  }
+
+  // check auxiliary label for TMPFile => IOR
+  SALOMEDSImpl_AttributeName* aNameAttribute = NULL;
+  if ((aNameAttribute=(SALOMEDSImpl_AttributeName*)aAuxSourceLabel.FindAttribute(SALOMEDSImpl_AttributeName::GetID()))) {
+    SALOMEDSImpl_AttributeInteger* anObjID = (SALOMEDSImpl_AttributeInteger*)aAuxSourceLabel.FindAttribute(SALOMEDSImpl_AttributeInteger::GetID());
+    SALOMEDSImpl_AttributeComment* aComponentName = (SALOMEDSImpl_AttributeComment*)theSource.Root().FindAttribute(SALOMEDSImpl_AttributeComment::GetID());
+    std::string aCompName = aComponentName->Value();
+
+    if (theEngine->CanPaste(aCompName, anObjID->Value())) {
+      std::string aTMPStr = aNameAttribute->Value();
+      int aLen = (int)aTMPStr.size(); //!< TODO: conversion from size_t to int
+      unsigned char* aStream = NULL;
+      if(aLen > 0) {
+        aStream = new unsigned char[aLen+10];
+        for(a = 0; a < aLen; a++) {
+          aStream[a] = aTMPStr[a];
+        }
+      }
+
+      std::string anEntry = aTargetLabel.Entry();
+      SALOMEDSImpl_SObject aPastedSO = FindObjectID(anEntry);
+
+      if (isFirstElement) {
+        std::string aDestEntry = theEngine->PasteInto(aStream,
+                                                      aLen,
+                                                      anObjID->Value(),
+                                                      aPastedSO.GetFatherComponent());
+        aTargetLabel = DF_Label::Label(theDestinationStart, aDestEntry);
+      } else
+        theEngine->PasteInto(aStream, aLen, anObjID->Value(), aPastedSO);
+
+      if(aStream != NULL) delete []aStream;
+    }
+  }
+
+  // iterate attributes
+  std::vector<DF_Attribute*> attrList = theSource.GetAttributes();
+  for(int i = 0, len = (int)attrList.size(); i<len; i++) { //!< TODO: conversion from size_t to int
+    DF_Attribute* anAttr = attrList[i];
+    if (aTargetLabel.FindAttribute(anAttr->ID())) {
+      aTargetLabel.ForgetAttribute(anAttr->ID());
+    }
+    DF_Attribute* aNewAttribute = anAttr->NewEmpty();
+    aTargetLabel.AddAttribute(aNewAttribute);
+    anAttr->Paste(aNewAttribute);
+  }
+
+  // check auxiliary label for Comment => reference or name attribute of the referenced object
+  SALOMEDSImpl_AttributeComment* aCommentAttribute = NULL;
+  if ((aCommentAttribute=(SALOMEDSImpl_AttributeComment*)aAuxSourceLabel.FindAttribute(SALOMEDSImpl_AttributeComment::GetID()))) {
+    char * anEntry = new char[aCommentAttribute->Value().size() + 1];
+    strcpy(anEntry, std::string(aCommentAttribute->Value()).c_str());
+    char* aNameStart = strchr(anEntry, ' ');
+    if (aNameStart) {
+      *aNameStart = '\0';
+      aNameStart++;
+    }
+    // copy to the same study, reanimate reference
+    DF_Label aRefLabel = DF_Label::Label(aTargetLabel, anEntry);
+    SALOMEDSImpl_AttributeReference::Set(aTargetLabel, aRefLabel);
+    // target attributes structure support
+    SALOMEDSImpl_AttributeTarget::Set(aRefLabel)->Add(SALOMEDSImpl_Study::SObject(aTargetLabel));
+
+    delete [] anEntry;
+  }
+
+  return aTargetLabel;
 }
+
 //============================================================================
-/*! Function : GetTransientReference
- *  Purpose  : Get IOR of the Study (registred in Document in doc->Root)
+/*! Function : Paste
+ *  Purpose  :
  */
 //============================================================================
-std::string SALOMEDSImpl_Study::GetTransientReference()
+SALOMEDSImpl_SObject SALOMEDSImpl_Study::Paste(const SALOMEDSImpl_SObject& theObject,
+                                               SALOMEDSImpl_Driver* theEngine)
 {
   _errorCode = "";
-  std::string IOR = "";
 
-  SALOMEDSImpl_AttributeIOR* Att;
-  DF_Label _lab = _doc->Root();
-  if ((Att=(SALOMEDSImpl_AttributeIOR*)_lab.FindAttribute(SALOMEDSImpl_AttributeIOR::GetID()))) {
-    IOR = Att->Value();
+  SALOMEDSImpl_SObject so;
+
+  // if study is locked, then paste can't be done
+  if (GetProperties()->IsLocked()) {
+    _errorCode = "LockProtection";
+    throw LockProtection("LockProtection");
   }
-  else {
-    _errorCode = "IOR is empty";
+
+  // if there is no component name, then paste only SObjects and attributes: without component help
+  SALOMEDSImpl_AttributeComment* aComponentName = NULL;
+  bool aStructureOnly = !(aComponentName=(SALOMEDSImpl_AttributeComment*)_clipboard->Main().Root().FindAttribute(SALOMEDSImpl_AttributeComment::GetID()));
+
+  // CAF document of current study usage
+  if (!_doc) {
+    _errorCode = "Document is null";
+    return so;
   }
 
-  return IOR;
-}
+  SALOMEDSImpl_SComponent aComponent = theObject.GetFatherComponent();
 
-void SALOMEDSImpl_Study::SetTransientReference(const std::string& theIOR)
-{
-  _errorCode = "";
+  // fill root inserted SObject
+  DF_Label aStartLabel;
+  if (aStructureOnly) {
+    DF_Label anObjectLabel = DF_Label::Label(_doc->Main(), theObject.GetID());
+    aStartLabel = PasteLabel(theEngine, _clipboard->Main(), anObjectLabel, false);
+  } else {
+    DF_Label aComponentLabel = DF_Label::Label(_doc->Main(), aComponent.GetID());
+    aStartLabel = PasteLabel(theEngine, _clipboard->Main(), aComponentLabel, true);
+  }
 
-  SALOMEDSImpl_AttributeStudyProperties* aProp = GetProperties();
-  int aLocked = aProp->IsLocked();
-  if (aLocked) aProp->SetLocked(false);
+  // paste all sublebels
+  DF_ChildIterator anIterator(_clipboard->Main(), true);
+  for(; anIterator.More(); anIterator.Next()) {
+    PasteLabel(theEngine, anIterator.Value(), aStartLabel, false);
+  }
 
-  // Assign the value of the IOR in the study->root
-  SALOMEDSImpl_AttributeIOR::Set(_doc->Main().Root(), theIOR);
+  return SALOMEDSImpl_Study::SObject(aStartLabel);
+}
 
-  if (aLocked) aProp->SetLocked(true);
+//============================================================================
+/*! Function : GetPersistentReference
+ *  Purpose  : Get persistent reference of study (idem URL())
+ */
+//============================================================================
+std::string SALOMEDSImpl_Study::GetPersistentReference()
+{
+  _errorCode = "";
+  return URL();
 }
 
 //============================================================================
@@ -374,11 +1476,11 @@ SALOMEDSImpl_SObject SALOMEDSImpl_Study::FindObjectByPath(const std::string& the
 
   std::string aPath(thePath), aToken;
   SALOMEDSImpl_SObject aSO;
-  int aLength = aPath.size();
+  int aLength = (int)aPath.size(); //!< TODO: conversion from size_t to int
   bool isRelative = false;
 
   if(aLength == 0) {  //Empty path - return the current context
-    return GetSObject(_current);
+    return aSO;
   }
 
   if(aPath[0] != '/')  //Relative path
@@ -389,8 +1491,7 @@ SALOMEDSImpl_SObject SALOMEDSImpl_Study::FindObjectByPath(const std::string& the
   SALOMEDSImpl_AttributeName* anAttr;
 
   if(isRelative) {
-    if(_current.IsNull()) return aSO;
-    anIterator.Init(_current, false);
+    return aSO;
   }
   else {
     if(aPath.size() == 1 && aPath[0] == '/') {    //Root
@@ -400,7 +1501,7 @@ SALOMEDSImpl_SObject SALOMEDSImpl_Study::FindObjectByPath(const std::string& the
   }
 
   std::vector<std::string> vs = SALOMEDSImpl_Tool::splitString(aPath, '/');
-  for(int i = 0, len = vs.size(); i<len; i++) {
+  for(int i = 0, len = (int)vs.size(); i<len; i++) { //!< TODO: conversion from size_t to int
 
     aToken = vs[i];
     if(aToken.size() == 0) break;
@@ -479,212 +1580,6 @@ std::string SALOMEDSImpl_Study::GetObjectPathByIOR(const std::string& theIOR)
   return GetObjectPath(so);
 }
 
-
-//============================================================================
-/*! Function : SetContext
- *  Purpose  : Sets the current context
- */
-//============================================================================
-bool SALOMEDSImpl_Study::SetContext(const std::string& thePath)
-{
-  _errorCode = "";
-  if(thePath.empty()) {
-    _errorCode = "InvalidPath";
-    return false;
-  }
-
-  std::string aPath(thePath), aContext("");
-  bool isInvalid = false;
-  SALOMEDSImpl_SObject aSO;
-
-  if(aPath[0] != '/') { //Relative path
-    aContext = GetContext();
-    aContext += '/';
-    aContext += aPath;
-  }
-  else
-    aContext = aPath;
-
-  try {
-    aSO = FindObjectByPath(aContext);
-  }
-  catch( ... ) {
-    isInvalid = true;
-  }
-
-  if(isInvalid || !aSO) {
-    _errorCode = "InvalidContext";
-    return false;
-  }
-
-  DF_Label aLabel = aSO.GetLabel();
-  if(aLabel.IsNull()) {
-    _errorCode = "InvalidContext";
-    return false;
-  }
-  else
-    _current = aLabel;  //Set the current context
-
-  return true;
-}
-
-//============================================================================
-/*! Function : GetContext
- *  Purpose  : Gets the current context
- */
-//============================================================================
-std::string SALOMEDSImpl_Study::GetContext()
-{
-  _errorCode = "";
-
-  if(_current.IsNull()) {
-    _errorCode = "InvaidContext";
-    return "";
-  }
-  SALOMEDSImpl_SObject so = GetSObject(_current);
-  return GetObjectPath(so);
-}
-
-//============================================================================
-/*! Function : GetObjectNames
- *  Purpose  : method to get all object names in the given context (or in the current context, if 'theContext' is empty)
- */
-//============================================================================
-std::vector<std::string> SALOMEDSImpl_Study::GetObjectNames(const std::string& theContext)
-{
-  _errorCode = "";
-
-  std::vector<std::string> aResultSeq;
-  DF_Label aLabel;
-  if (theContext.empty()) {
-    aLabel = _current;
-  } else {
-    DF_Label aTmp = _current;
-    SetContext(theContext);
-    aLabel = _current;
-    _current = aTmp;
-  }
-  if (aLabel.IsNull()) {
-    _errorCode = "InvalidContext";
-    return aResultSeq;
-  }
-
-  DF_ChildIterator anIter (aLabel, true); // iterate all subchildren at all sublevels
-  for (; anIter.More(); anIter.Next()) {
-    DF_Label aLabel = anIter.Value();
-    SALOMEDSImpl_AttributeName* aName;
-    if ((aName=(SALOMEDSImpl_AttributeName*)aLabel.FindAttribute(SALOMEDSImpl_AttributeName::GetID())))
-      aResultSeq.push_back(aName->Value());
-  }
-
-  return aResultSeq;
-}
-
-//============================================================================
-/*! Function : GetDirectoryNames
- *  Purpose  : method to get all directory names in the given context (or in the current context, if 'theContext' is empty)
- */
-//============================================================================
-std::vector<std::string> SALOMEDSImpl_Study::GetDirectoryNames(const std::string& theContext)
-{
-  _errorCode = "";
-
-  std::vector<std::string> aResultSeq;
-  DF_Label aLabel;
-  if (theContext.empty()) {
-    aLabel = _current;
-  } else {
-    DF_Label aTmp = _current;
-    SetContext(theContext);
-    aLabel = _current;
-    _current = aTmp;
-  }
-  if (aLabel.IsNull()) {
-    _errorCode = "InvalidContext";
-    return aResultSeq;
-  }
-
-  DF_ChildIterator anIter (aLabel, true); // iterate first-level children at all sublevels
-  for (; anIter.More(); anIter.Next()) {
-    DF_Label aLabel = anIter.Value();
-    SALOMEDSImpl_AttributeLocalID* anID;
-    if ((anID=(SALOMEDSImpl_AttributeLocalID*)aLabel.FindAttribute(SALOMEDSImpl_AttributeLocalID::GetID()))) {
-      if (anID->Value() == DIRECTORYID) {
-        SALOMEDSImpl_AttributeName* aName;
-        if ((aName=(SALOMEDSImpl_AttributeName*)aLabel.FindAttribute(SALOMEDSImpl_AttributeName::GetID()))) {
-          aResultSeq.push_back(aName->Value());
-        }
-      }
-    }
-  }
-
-  return aResultSeq;
-}
-
-//============================================================================
-/*! Function : GetFileNames
- *  Purpose  : method to get all file names in the given context (or in the current context, if 'theContext' is empty)
- */
-//============================================================================
-std::vector<std::string> SALOMEDSImpl_Study::GetFileNames(const std::string& theContext)
-{
-  _errorCode = "";
-
-  std::vector<std::string> aResultSeq;
-  DF_Label aLabel;
-  if (theContext.empty()) {
-    aLabel = _current;
-  } else {
-    DF_Label aTmp = _current;
-    SetContext(theContext);
-    aLabel = _current;
-    _current = aTmp;
-  }
-  if (aLabel.IsNull()) {
-    _errorCode = "InvalidContext";
-    return aResultSeq;
-  }
-
-  DF_ChildIterator anIter (aLabel, true); // iterate all subchildren at all sublevels
-  for (; anIter.More(); anIter.Next()) {
-    DF_Label aLabel = anIter.Value();
-    SALOMEDSImpl_AttributeLocalID* anID;
-    if ((anID=(SALOMEDSImpl_AttributeLocalID*)aLabel.FindAttribute(SALOMEDSImpl_AttributeLocalID::GetID()))) {
-      if (anID->Value() == FILELOCALID) {
-        SALOMEDSImpl_AttributePersistentRef* aName;
-        if ((aName=(SALOMEDSImpl_AttributePersistentRef*)aLabel.FindAttribute(SALOMEDSImpl_AttributePersistentRef::GetID()))) {
-          std::string aFileName = aName->Value();
-          if (aFileName.size() > 0)
-            aResultSeq.push_back(aFileName.substr(strlen(FILEID), aFileName.size()));
-        }
-      }
-    }
-  }
-
-  return aResultSeq;
-}
-
-//============================================================================
-/*! Function : GetComponentNames
- *  Purpose  : method to get all components names
- */
-//============================================================================
-std::vector<std::string> SALOMEDSImpl_Study::GetComponentNames(const std::string& theContext)
-{
-  _errorCode = "";
-
-  std::vector<std::string> aResultSeq;
-  DF_ChildIterator anIter(_doc->Main(), false); // iterate all subchildren at first level
-  for(; anIter.More(); anIter.Next()) {
-    DF_Label aLabel = anIter.Value();
-    SALOMEDSImpl_AttributeName* aName;
-    if ((aName=(SALOMEDSImpl_AttributeName*)aLabel.FindAttribute(SALOMEDSImpl_AttributeName::GetID())))
-      aResultSeq.push_back(aName->Value());
-  }
-
-  return aResultSeq;
-}
-
 //============================================================================
 /*! Function : NewChildIterator
  *  Purpose  : Create a ChildIterator from an SObject
@@ -733,7 +1628,7 @@ SALOMEDSImpl_StudyBuilder* SALOMEDSImpl_Study::NewBuilder()
 std::string SALOMEDSImpl_Study::Name()
 {
   _errorCode = "";
-  return _name;
+  return Kernel_Utils::GetBaseName( _name, false );
 }
 
 //============================================================================
@@ -805,6 +1700,7 @@ void SALOMEDSImpl_Study::URL(const std::string& url)
 {
   _errorCode = "";
   _URL = url;
+  _name = url;
 
   /*jfa: Now name of SALOMEDS study will correspond to name of SalomeApp study
   std::string tmp(_URL);
@@ -817,7 +1713,6 @@ void SALOMEDSImpl_Study::URL(const std::string& url)
       adr = strtok(NULL, "/");
     }
   Name(aName);*/
-  Name(url);
 }
 
 
@@ -924,7 +1819,7 @@ std::string SALOMEDSImpl_Study::_GetStudyVariablesScript()
   std::string set_method = _GetNoteBookAccessor()+".set(";
   std::string varName;
   std::string varValue;
-  for(int i = 0 ; i < myNoteBookVars.size();i++ ) {
+  for(int i = 0 ; i < (int)myNoteBookVars.size();i++ ) {
     varName = myNoteBookVars[i]->Name();
     varValue = myNoteBookVars[i]->SaveToScript();
     dump+=set_method+"\""+varName+"\", "+varValue+")\n";
@@ -942,10 +1837,10 @@ std::string SALOMEDSImpl_Study::_GetStudyVariablesScript()
  *  Purpose  :
  */
 //============================================================================
-std::string SALOMEDSImpl_Study::_GetNoteBookAccess(const std::string& theStudyVar)
+std::string SALOMEDSImpl_Study::_GetNoteBookAccess()
 {
   std::string notebook = "import salome_notebook\n";
-  notebook += _GetNoteBookAccessor() + " = salome_notebook.NoteBook(" + theStudyVar + ")" ;
+  notebook += _GetNoteBookAccessor() + " = salome_notebook.NoteBook()" ;
   return notebook;
 }
 
@@ -955,18 +1850,6 @@ bool SALOMEDSImpl_Study::IsLocked()
   return GetProperties()->IsLocked();
 }
 
-int SALOMEDSImpl_Study::StudyId()
-{
-  _errorCode = "";
-  return _StudyId;
-}
-
-void SALOMEDSImpl_Study::StudyId(int id)
-{
-  _errorCode = "";
-  _StudyId = id;
-}
-
 void SALOMEDSImpl_Study::UpdateIORLabelMap(const std::string& anIOR,const std::string& anEntry)
 {
   _errorCode = "";
@@ -986,7 +1869,7 @@ void SALOMEDSImpl_Study::DeleteIORLabelMapItem(const std::string& anIOR)
     }
 }
 
-SALOMEDSImpl_Study* SALOMEDSImpl_Study::GetStudy(const DF_Label& theLabel)
+SALOMEDSImpl_Study* SALOMEDSImpl_Study::GetStudyImpl(const DF_Label& theLabel)
 {
   SALOMEDSImpl_StudyHandle* Att;
   if ((Att=(SALOMEDSImpl_StudyHandle*)theLabel.Root().FindAttribute(SALOMEDSImpl_StudyHandle::GetID()))) {
@@ -997,19 +1880,19 @@ SALOMEDSImpl_Study* SALOMEDSImpl_Study::GetStudy(const DF_Label& theLabel)
 
 SALOMEDSImpl_SObject SALOMEDSImpl_Study::SObject(const DF_Label& theLabel)
 {
-  return GetStudy(theLabel)->GetSObject(theLabel);
+  return GetStudyImpl(theLabel)->GetSObject(theLabel);
 }
 
 SALOMEDSImpl_SComponent SALOMEDSImpl_Study::SComponent(const DF_Label& theLabel)
 {
-  return GetStudy(theLabel)->GetSComponent(theLabel);
+  return GetStudyImpl(theLabel)->GetSComponent(theLabel);
 }
 
 
 void SALOMEDSImpl_Study::IORUpdated(const SALOMEDSImpl_AttributeIOR* theAttribute)
 {
   std::string aString = theAttribute->Label().Entry();
-  GetStudy(theAttribute->Label())->UpdateIORLabelMap(theAttribute->Value(), aString);
+  GetStudyImpl(theAttribute->Label())->UpdateIORLabelMap(theAttribute->Value(), aString);
 }
 
 std::vector<SALOMEDSImpl_SObject> SALOMEDSImpl_Study::FindDependances(const SALOMEDSImpl_SObject& anObject)
@@ -1041,7 +1924,7 @@ std::string SALOMEDSImpl_Study::GetLastModificationDate()
   std::vector<int> aMinutes, aHours, aDays, aMonths, aYears;
   aProp->GetModifications(aNames, aMinutes, aHours, aDays, aMonths, aYears);
 
-  int aLastIndex = aNames.size()-1;
+  int aLastIndex = (int)aNames.size()-1; //!< TODO: conversion from size_t to int
   char aResult[20];
   sprintf(aResult, "%2.2d/%2.2d/%4.4d %2.2d:%2.2d",
           (int)(aDays[aLastIndex]),(int)(aMonths[aLastIndex]), (int)(aYears[aLastIndex]),
@@ -1059,7 +1942,7 @@ std::vector<std::string> SALOMEDSImpl_Study::GetModificationsDate()
   std::vector<int> aMinutes, aHours, aDays, aMonths, aYears;
   aProp->GetModifications(aNames, aMinutes, aHours, aDays, aMonths, aYears);
 
-  int anIndex, aLength = aNames.size();
+  int anIndex, aLength = (int)aNames.size(); //!< TODO: conversion from size_t to int
   std::vector<std::string> aDates;
 
   for (anIndex = 1; anIndex < aLength; anIndex++) {
@@ -1085,23 +1968,6 @@ SALOMEDSImpl_UseCaseBuilder* SALOMEDSImpl_Study::GetUseCaseBuilder()
   return _useCaseBuilder;
 }
 
-
-//============================================================================
-/*! Function : Close
- *  Purpose  :
- */
-//============================================================================
-void SALOMEDSImpl_Study::Close()
-{
-  _errorCode = "";
-  _notifier = 0;
-  _doc->GetApplication()->Close(_doc);
-  _doc = NULL;
-  _mapOfSO.clear();
-  _mapOfSCO.clear();
-}
-
-
 //============================================================================
 /*! Function : GetSComponent
  *  Purpose  :
@@ -1219,25 +2085,30 @@ bool SALOMEDSImpl_Study::DumpStudy(const std::string& thePath,
   }
 
   std::vector<std::string> aSeq;
-  std::string aCompType, aFactoryType;
+  std::string aFactoryType;
 
   //Build a list of all components in the Study
   SALOMEDSImpl_SComponentIterator itcomponent = NewComponentIterator();
 
-  for (; itcomponent.More(); itcomponent.Next()) {
-    SALOMEDSImpl_SComponent sco = itcomponent.Value();
-    aCompType = sco.ComponentDataType();
-   if (aCompType == "GEOM")
-      aSeq.insert(aSeq.begin(), aCompType);
-    else
-      aSeq.push_back(aCompType);
+  for (; itcomponent.More(); itcomponent.Next())
+    aSeq.push_back(itcomponent.Value().ComponentDataType());
+
+  std::vector<std::string>::iterator it;
+  if ( (it = std::find( aSeq.begin(), aSeq.end(), "GEOM" )) != aSeq.end() ) {
+    aSeq.erase( it );
+    aSeq.insert(aSeq.begin(), "GEOM" );
+  }
+  if ( (it = std::find( aSeq.begin(), aSeq.end(), "SHAPER" )) != aSeq.end() ) {
+    aSeq.erase( it );
+    aSeq.insert(aSeq.begin(), "SHAPER" );
   }
+
   // re-arrange modules in the sequence, if specific order is given via SALOME_MODULES_ORDER environment variable.
   if ( getenv("SALOME_MODULES_ORDER") != 0 ) {
     std::string order = getenv("SALOME_MODULES_ORDER");
     std::vector<std::string> mlist;
     while ( !order.empty() ) {
-      size_t idx = order.find( "," );
+      size_t idx = order.find( ":" );
       std::string m = order.substr(0, idx);
       order = order.substr( ( idx == std::string::npos ) ? order.size() : idx+1 );
       if ( m.empty() || std::find( mlist.begin(), mlist.end(), m ) != mlist.end() ) continue;
@@ -1263,7 +2134,12 @@ bool SALOMEDSImpl_Study::DumpStudy(const std::string& thePath,
 
   //Create a file that will contain a main Study script
   std::fstream fp;
+#if defined(WIN32) && defined(UNICODE)
+  std::wstring aConverterFN = Kernel_Utils::utf8_decode_s(aFileName);
+  fp.open(aConverterFN.c_str(), std::ios::out);
+#else
   fp.open(aFileName.c_str(), std::ios::out);
+#endif
 
 #ifdef WIN32
   bool isOpened = fp.is_open();
@@ -1275,6 +2151,7 @@ bool SALOMEDSImpl_Study::DumpStudy(const std::string& thePath,
     _errorCode = std::string("Can't create a file ")+aFileName;
     return false;
   }
+  _dumpPath = thePath;
 
   std::stringstream sfp;
 
@@ -1290,18 +2167,14 @@ bool SALOMEDSImpl_Study::DumpStudy(const std::string& thePath,
   sfp << "import sys" << std::endl;
   sfp << "import " << aBatchModeScript << std::endl << std::endl;
 
-  std::string aStudyVar = "salome.myStudy";
   // initialization function
   sfp << aBatchModeScript << ".salome_init()" << std::endl;
-  if ( !isMultiFile ) {
-    sfp << "theStudy = " << aStudyVar << std::endl << std::endl;
-    aStudyVar = "theStudy";
-  }
+
   // notebook initialization
-  sfp << _GetNoteBookAccess(aStudyVar) << std::endl;
+  sfp << _GetNoteBookAccess() << std::endl;
 
   // extend sys.path with the directory where the script is being dumped to
-  sfp << "sys.path.insert( 0, r\'" << thePath << "\')" << std::endl << std::endl;
+  sfp << "sys.path.insert(0, r\'" << thePath << "\')" << std::endl << std::endl;
 
   // dump NoteBook variables
   sfp << _GetStudyVariablesScript();
@@ -1320,10 +2193,10 @@ bool SALOMEDSImpl_Study::DumpStudy(const std::string& thePath,
 
   // dump all components and create the components specific scripts
   bool isOk = true;
-  int aLength = aSeq.size();
+  int aLength = (int)aSeq.size(); //!< TODO: conversion from size_t to int
   for(int i = 1; i <= aLength; i++) {
 
-    aCompType = aSeq[i-1];
+    std::string aCompType = aSeq[i-1];
     SALOMEDSImpl_SComponent sco = FindComponent(aCompType);
     SALOMEDSImpl_Driver* aDriver = NULL;
     // if there is an associated Engine call its method for saving
@@ -1356,19 +2229,19 @@ bool SALOMEDSImpl_Study::DumpStudy(const std::string& thePath,
 
     bool isValidScript;
     long aStreamLength  = 0;
-    SALOMEDSImpl_TMPFile* aStream = aDriver->DumpPython(this, isPublished, isMultiFile, isValidScript, aStreamLength);
+    SALOMEDSImpl_TMPFile* aStream = aDriver->DumpPython(isPublished, isMultiFile, isValidScript, aStreamLength);
     if ( !isValidScript )
       isOk = false;
 
     std::stringstream sfp2;
-    
+
     //Output the Python script generated by the component in the newly created file.
     if ( isMultiFile )
       sfp2 << GetDumpStudyComment( aCompType.c_str() ) << std::endl;
     else
       sfp2 << GetComponentHeader( aCompType.c_str() ) << std::endl;
     sfp2 << aStream->Data();
-    
+
     if ( isMultiFile ) {
       //Create a file that will contain the component specific script
       std::fstream fp2;
@@ -1381,24 +2254,29 @@ bool SALOMEDSImpl_Study::DumpStudy(const std::string& thePath,
       aScriptName += theBaseName;
       aScriptName += "_";
       aScriptName += aCompType;
-      
+
       aFileName += aScriptName+ std::string(".py");
       aSeqOfFileNames.push_back(aFileName);
-      
+
+#if defined(WIN32) && defined(UNICODE)
+      std::wstring aConverterFN2 = Kernel_Utils::utf8_decode_s(aFileName);
+      fp2.open(aConverterFN2.c_str(), std::ios::out);
+#else
       fp2.open(aFileName.c_str(), std::ios::out);
-      
+#endif
+
 #ifdef WIN32
       isOpened = fp2.is_open();
 #else
       isOpened = fp2.rdbuf()->is_open();
 #endif
-      
+
       if(!isOpened) {
         _errorCode = std::string("Can't create a file ")+aFileName;
         SALOMEDSImpl_Tool::RemoveTemporaryFiles(thePath, aSeqOfFileNames, false);
         return false;
       }
-     
+
       // replace '\t' symbols
       fp2 << replace_tabs( sfp2.str() );
 
@@ -1406,7 +2284,7 @@ bool SALOMEDSImpl_Study::DumpStudy(const std::string& thePath,
 
       //Add to the main script a call to RebuildData of the generated by the component the Python script
       sfp << "import " << aScriptName << std::endl;
-      sfp << aScriptName << ".RebuildData(" << aBatchModeScript << ".myStudy)" << std::endl;
+      sfp << aScriptName << ".RebuildData()" << std::endl;
     }
     else
       sfp << sfp2.str();
@@ -1416,7 +2294,7 @@ bool SALOMEDSImpl_Study::DumpStudy(const std::string& thePath,
 
   sfp << std::endl;
   sfp << "if salome.sg.hasDesktop():" << std::endl;
-  sfp << "\tsalome.sg.updateObjBrowser(1)" << std::endl;
+  sfp << "\tsalome.sg.updateObjBrowser()" << std::endl;
 
   if(isDumpVisuals) { //Output the call to Session's method restoreVisualState
     sfp << "\tiparameters.getSession().restoreVisualState(1)" << std::endl;
@@ -1424,12 +2302,21 @@ bool SALOMEDSImpl_Study::DumpStudy(const std::string& thePath,
 
   // replace '\t' symbols
   fp << replace_tabs( sfp.str() );
-  
+
   fp.close();
 
+  _dumpPath.clear();
+
   return isOk;
 }
 
+// Returns the folder of the python script which is currently dumped
+std::string SALOMEDSImpl_Study::GetDumpPath()
+{
+  return _dumpPath;
+}
+
+
 //=======================================================================
 //function : GetDumpStudyComment
 //purpose  : return a header comment for a DumpStudy script
@@ -1438,7 +2325,7 @@ bool SALOMEDSImpl_Study::DumpStudy(const std::string& thePath,
 std::string SALOMEDSImpl_Study::GetDumpStudyComment(const char* theComponentName)
 {
   std::stringstream txt;
-  txt << "# -*- coding: utf-8 -*-" << std::endl << std::endl;
+  txt << "#!/usr/bin/env python" << std::endl << std::endl;
   txt << "###" << std::endl;
   txt << "### This file is generated automatically by SALOME v"
       << KERNEL_VERSION_STR
@@ -1498,7 +2385,7 @@ void dumpSO(const SALOMEDSImpl_SObject& theSO,
   std::string aTab(Tab), anID(theSO.GetID());
   fp << aTab << anID << std::endl;
   std::vector<DF_Attribute*> attribs = theSO.GetLabel().GetAttributes();
-  for(int i = 0; i<attribs.size(); i++) {
+  for(int i = 0; i<(int)attribs.size(); i++) {
     SALOMEDSImpl_GenericAttribute* anAttr = dynamic_cast<SALOMEDSImpl_GenericAttribute*>(attribs[i]);
 
     if(!anAttr) {
@@ -1645,7 +2532,7 @@ bool SALOMEDSImpl_Study::IsStudyLocked()
 void SALOMEDSImpl_Study::UnLockStudy(const char* theLockerID)
 {
   std::vector<std::string>::iterator vsI = _lockers.begin();
-  int length = _lockers.size();
+  int length = (int)_lockers.size(); //!< TODO: conversion from size_t to int
   bool isFound = false;
   std::string id(theLockerID);
   for(int i = 0; i<length; i++, vsI++) {
@@ -1734,7 +2621,7 @@ void SALOMEDSImpl_Study::SetStringVariable(const std::string& theVarName,
 //============================================================================
 void SALOMEDSImpl_Study::SetStringVariableAsDouble(const std::string& theVarName,
                                                    const double theValue,
-                                                   const SALOMEDSImpl_GenericVariable::VariableTypes theType)
+                                                   const SALOMEDSImpl_GenericVariable::VariableTypes /*theType*/)
 {
   SALOMEDSImpl_GenericVariable* aGVar = GetVariable(theVarName);
   if(SALOMEDSImpl_ScalarVariable* aSVar = dynamic_cast<SALOMEDSImpl_ScalarVariable*>(aGVar))
@@ -1810,7 +2697,7 @@ std::vector<std::string> SALOMEDSImpl_Study::GetVariableNames() const
 {
   std::vector<std::string> aResult;
 
-  for(int i = 0; i < myNoteBookVars.size(); i++)
+  for(int i = 0; i < (int)myNoteBookVars.size(); i++)
     aResult.push_back(myNoteBookVars[i]->Name());
 
   return aResult;
@@ -1834,7 +2721,7 @@ void SALOMEDSImpl_Study::AddVariable(SALOMEDSImpl_GenericVariable* theVariable)
 SALOMEDSImpl_GenericVariable* SALOMEDSImpl_Study::GetVariable(const std::string& theName) const
 {
   SALOMEDSImpl_GenericVariable* aResult = NULL;
-  for(int i = 0; i < myNoteBookVars.size();i++) {
+  for(int i = 0; i < (int)myNoteBookVars.size();i++) {
     if(theName.compare(myNoteBookVars[i]->Name()) == 0) {
       aResult = myNoteBookVars[i];
       break;
@@ -1932,10 +2819,10 @@ bool SALOMEDSImpl_Study::FindVariableAttribute(SALOMEDSImpl_StudyBuilder* theStu
       std::string aString = aStringAttr->Value();
 
       std::vector< std::vector<std::string> > aSections = ParseVariables( aString );
-      for( int i = 0, n = aSections.size(); i < n; i++ )
+      for( int i = 0, n = (int)aSections.size(); i < n; i++ ) //!< TODO: conversion from size_t to int
       {
         std::vector<std::string> aVector = aSections[i];
-        for( int j = 0, m = aVector.size(); j < m; j++ )
+        for( int j = 0, m = (int)aVector.size(); j < m; j++ ) //!< TODO: conversion from size_t to int
         {
           std::string aStr = aVector[j];
           if( aStr.compare( theName ) == 0 )
@@ -1988,10 +2875,10 @@ void SALOMEDSImpl_Study::ReplaceVariableAttribute(SALOMEDSImpl_StudyBuilder* the
       std::string aNewString, aCurrentString = aStringAttr->Value();
 
       std::vector< std::vector<std::string> > aSections = ParseVariables( aCurrentString );
-      for( int i = 0, n = aSections.size(); i < n; i++ )
+      for( int i = 0, n = (int)aSections.size(); i < n; i++ ) //!< TODO: conversion from size_t to int
       {
         std::vector<std::string> aVector = aSections[i];
-        for( int j = 0, m = aVector.size(); j < m; j++ )
+        for( int j = 0, m = (int)aVector.size(); j < m; j++ ) //!< TODO: conversion from size_t to int
         {
           std::string aStr = aVector[j];
           if( aStr.compare( theSource ) == 0 )
@@ -2105,7 +2992,7 @@ bool SALOMEDSImpl_Study::removeSO_Notification (const SALOMEDSImpl_SObject& theS
                pass the mofification reason
  */
 //============================================================================
-bool SALOMEDSImpl_Study::modifySO_Notification (const SALOMEDSImpl_SObject& theSObject, int reason) 
+bool SALOMEDSImpl_Study::modifySO_Notification (const SALOMEDSImpl_SObject& theSObject, int reason)
 {
   if(_notifier)
     return _notifier->modifySO_Notification(theSObject, reason);
@@ -2118,7 +3005,7 @@ bool SALOMEDSImpl_Study::modifySO_Notification (const SALOMEDSImpl_SObject& theS
  *  Purpose  : register a notifier
  */
 //============================================================================
-void SALOMEDSImpl_Study::setNotifier(SALOMEDSImpl_AbstractCallback* notifier) 
+void SALOMEDSImpl_Study::setNotifier(SALOMEDSImpl_AbstractCallback* notifier)
 {
   _notifier=notifier;
 }
@@ -2165,3 +3052,212 @@ void SALOMEDSImpl_Study::UnRegisterGenObj(const std::string& theIOR, DF_Label la
   if ( SALOMEDSImpl_AbstractCallback* goRegister = getGenObjRegister( label.GetDocument() ))
     goRegister->UnRegisterGenObj( theIOR );
 }
+
+//#######################################################################################################
+//#                                     STATIC PRIVATE FUNCTIONS
+//#######################################################################################################
+
+//============================================================================
+/*! Function : SaveAttributes
+ *  Purpose  : Save attributes for object
+ */
+//============================================================================
+static void SaveAttributes(const SALOMEDSImpl_SObject& aSO, HDFgroup *hdf_group_sobject)
+{
+  hdf_size size[1];
+  std::vector<DF_Attribute*> attrList = aSO.GetLabel().GetAttributes();
+  DF_Attribute* anAttr = NULL;
+  for(int i = 0, len = (int)attrList.size(); i<len; i++) { //!< TODO: conversion from size_t to int
+    anAttr = attrList[i];
+    //The following attributes are not supposed to be written to the file
+    std::string type = SALOMEDSImpl_GenericAttribute::Impl_GetType(anAttr);
+    if(type == std::string("AttributeIOR")) continue; //IOR attribute is not saved
+    std::string aSaveStr =anAttr->Save();
+    //cout << "Saving: " << aSO.GetID() << " type: "<< type<<"|" << endl;
+    size[0] = (hdf_int32) strlen(aSaveStr.c_str()) + 1;
+    HDFdataset *hdf_dataset = new HDFdataset((char*)type.c_str(), hdf_group_sobject, HDF_STRING,size, 1);
+    hdf_dataset->CreateOnDisk();
+    hdf_dataset->WriteOnDisk((char*)aSaveStr.c_str());
+    hdf_dataset->CloseOnDisk();
+    hdf_dataset=0; //will be deleted by hdf_sco_group destructor
+  }
+}
+
+//===========================================================================
+//Function : ReadAttributes
+//===========================================================================
+static void ReadAttributes(SALOMEDSImpl_Study* theStudy,
+                           const SALOMEDSImpl_SObject& aSO,
+                           HDFdataset* hdf_dataset)
+{
+  hdf_dataset->OpenOnDisk();
+
+  DF_Attribute* anAttr = NULL;
+  char* current_string = new char[hdf_dataset->GetSize()+1];
+  hdf_dataset->ReadFromDisk(current_string);
+  //cout << "Reading attr type = " << hdf_dataset->GetName() << "  SO = " << aSO.GetID() << endl;
+  if (!strcmp(hdf_dataset->GetName(),"COMPONENTDATATYPE")) {
+    anAttr = theStudy->NewBuilder()->FindOrCreateAttribute(aSO, "AttributeComment");
+  }
+  else if (!strcmp(hdf_dataset->GetName(),"AttributeReference") ||
+           !strcmp(hdf_dataset->GetName(),"Reference")) { // Old format maintenance
+    theStudy->NewBuilder()->Addreference(aSO, theStudy->CreateObjectID(current_string));
+    delete [] (current_string);
+    hdf_dataset->CloseOnDisk();
+    return;
+  }
+  else {
+    anAttr = theStudy->NewBuilder()->FindOrCreateAttribute(aSO, hdf_dataset->GetName());
+  }
+
+  if (anAttr) {
+    anAttr->Load(current_string);
+  }
+
+  delete [] (current_string);
+  hdf_dataset->CloseOnDisk();
+}
+
+//============================================================================
+//Function : BuildlTree
+//============================================================================
+static void BuildTree (SALOMEDSImpl_Study* theStudy, HDFgroup* hdf_current_group)
+{
+  hdf_current_group->OpenOnDisk();
+  SALOMEDSImpl_SObject aSO;
+  char* Entry = hdf_current_group->GetName();
+  if (strcmp(Entry,"STUDY_STRUCTURE") == 0) {
+    aSO = theStudy->CreateObjectID("0:1");
+  }
+  else {
+    aSO = theStudy->CreateObjectID(Entry);
+  }
+
+  char name[HDF_NAME_MAX_LEN+1];
+  int nbsons = hdf_current_group->nInternalObjects();
+  for (int i=0; i<nbsons; i++) {
+    hdf_current_group->InternalObjectIndentify(i,name);
+    if (strncmp(name, "INTERNAL_COMPLEX",16) == 0) continue;
+    hdf_object_type type = hdf_current_group->InternalObjectType(name);
+
+    if (type == HDF_DATASET) {
+      HDFdataset* new_dataset = new HDFdataset(name,hdf_current_group);
+      ReadAttributes(theStudy,aSO,new_dataset);
+      new_dataset = 0; // will be deleted by father destructor
+    }
+    else if (type == HDF_GROUP)   {
+      HDFgroup* new_group = new HDFgroup(name,hdf_current_group);
+      BuildTree (theStudy, new_group);
+      new_group = 0; // will be deleted by father destructor
+    }
+  }
+  hdf_current_group->CloseOnDisk();
+}
+
+
+//============================================================================
+//Function : Translate_IOR_to_persistentID
+//============================================================================
+static void Translate_IOR_to_persistentID (const SALOMEDSImpl_SObject& so,
+                                           SALOMEDSImpl_Driver*        engine,
+                                           bool                        isMultiFile,
+                                           bool                        isASCII)
+{
+  DF_ChildIterator itchild(so.GetLabel());
+  std::string ior_string,  persistent_string, curid;
+
+  for (; itchild.More(); itchild.Next()) {
+    SALOMEDSImpl_SObject current = SALOMEDSImpl_Study::SObject(itchild.Value());
+    SALOMEDSImpl_AttributeIOR* IOR = NULL;
+    if ((IOR=(SALOMEDSImpl_AttributeIOR*)current.GetLabel().FindAttribute(SALOMEDSImpl_AttributeIOR::GetID()))) {
+      ior_string = IOR->Value();
+
+      persistent_string = engine->IORToLocalPersistentID (current, ior_string, isMultiFile, isASCII);
+      SALOMEDSImpl_AttributePersistentRef::Set(current.GetLabel(), persistent_string);
+    }
+    Translate_IOR_to_persistentID (current, engine, isMultiFile, isASCII);
+  }
+}
+
+void ReadNoteBookVariables(SALOMEDSImpl_Study* theStudy, HDFgroup* theGroup)
+{
+  if(!theGroup)
+    return;
+
+  HDFgroup* new_group =0;
+  HDFdataset* new_dataset =0;
+
+  char aVarName[HDF_NAME_MAX_LEN+1];
+  char *currentVarType = 0;
+  char *currentVarValue = 0;
+  char *currentVarIndex = 0;
+  int order = 0;
+  //Open HDF group with notebook variables
+  theGroup->OpenOnDisk();
+
+  //Get Nb of variables
+  int aNbVars = theGroup->nInternalObjects();
+
+  std::map<int,SALOMEDSImpl_GenericVariable*> aVarsMap;
+
+  for( int iVar=0;iVar < aNbVars;iVar++ ) {
+    theGroup->InternalObjectIndentify(iVar,aVarName);
+    hdf_object_type type = theGroup->InternalObjectType(aVarName);
+    if(type == HDF_GROUP) {
+
+      //Read Variable
+      new_group = new HDFgroup(aVarName,theGroup);
+      new_group->OpenOnDisk();
+
+      //Read Type
+      new_dataset = new HDFdataset("VARIABLE_TYPE",new_group);
+      new_dataset->OpenOnDisk();
+      currentVarType = new char[new_dataset->GetSize()+1];
+      new_dataset->ReadFromDisk(currentVarType);
+      new_dataset->CloseOnDisk();
+      new_dataset = 0; //will be deleted by hdf_sco_group destructor
+
+      //Read Order
+      if(new_group->ExistInternalObject("VARIABLE_INDEX")) {
+        new_dataset = new HDFdataset("VARIABLE_INDEX",new_group);
+        new_dataset->OpenOnDisk();
+        currentVarIndex = new char[new_dataset->GetSize()+1];
+        new_dataset->ReadFromDisk(currentVarIndex);
+        new_dataset->CloseOnDisk();
+        new_dataset = 0; //will be deleted by hdf_sco_group destructor
+        order = atoi(currentVarIndex);
+        delete [] currentVarIndex;
+      }
+      else
+        order = iVar;
+
+      //Read Value
+      new_dataset = new HDFdataset("VARIABLE_VALUE",new_group);
+      new_dataset->OpenOnDisk();
+      currentVarValue = new char[new_dataset->GetSize()+1];
+      new_dataset->ReadFromDisk(currentVarValue);
+      new_dataset->CloseOnDisk();
+      new_dataset = 0; //will be deleted by hdf_sco_group destructor
+
+      new_group->CloseOnDisk();
+      new_group = 0;  //will be deleted by hdf_sco_group destructor
+
+      SALOMEDSImpl_GenericVariable::VariableTypes aVarType =
+        SALOMEDSImpl_GenericVariable::String2VariableType(std::string(currentVarType));
+      delete [] currentVarType;
+
+      //Create variable and add it in the study
+      SALOMEDSImpl_GenericVariable* aVariable =
+        new SALOMEDSImpl_ScalarVariable(aVarType,std::string(aVarName));
+      aVariable->Load(std::string(currentVarValue));
+      aVarsMap.insert(std::make_pair(order,aVariable));
+      delete [] currentVarValue;
+    }
+  }
+
+  std::map<int,SALOMEDSImpl_GenericVariable*>::const_iterator it= aVarsMap.begin();
+  for(;it!=aVarsMap.end();it++)
+    theStudy->AddVariable((*it).second);
+
+  theGroup->CloseOnDisk();
+}