Oracle® Data Integrator Java API Reference
11g Release 1 (11.1.1.3.0)

E17060-01

oracle.odi.impexp.support
Class ImportServiceImpl

java.lang.Object
  extended by oracle.odi.impexp.support.ImportServiceImpl
All Implemented Interfaces:
IImportService

public final class ImportServiceImpl
extends java.lang.Object
implements IImportService

Default IImportService implementation.

Since:
11.1.1.3.0

Field Summary
 
Fields inherited from interface oracle.odi.impexp.IImportService
IMPORT_MODE_DUPLICATION, IMPORT_MODE_SYNONYM_INSERT, IMPORT_MODE_SYNONYM_INSERT_UPDATE, IMPORT_MODE_SYNONYM_UPDATE
 
Constructor Summary
ImportServiceImpl(OdiInstance pOdiInstance)
          Constructs an ImportServiceImpl object.
 
Method Summary
 void importExecutionEnvironmentFromFolder(int pImportMode, java.lang.String pFolderPath, boolean pDeclareMissingRepository)
          Imports a previously exported execution environment objects set from a given folder.
Execution Environment objects include : Technologies, Connections, Contexts, Agents, Generic Actions
 void importExecutionEnvironmentFromZipFile(int pImportMode, java.lang.String pZipFilePath, boolean pDeclareMissingRepository)
          Imports a previously exported execution environment objects set from a given zip file.
Execution Environment objects include : Technologies, Connections, Contexts, Agents, Generic Actions
 void importLogicalTopologyFromFolder(int pImportMode, java.lang.String pFolderPath, boolean pDeclareMissingRepository)
          Imports a previously exported Logical topology objects set from a given folder.
Logical Topology objects include : Technologies, Logical Agents, Logical Schemas, Actions Groups, Actions, Datatypes, Datatype Conversions
 void importLogicalTopologyFromZipFile(int pImportMode, java.lang.String pZipFilePath, boolean pDeclareMissingRepository)
          Imports a previously exported logical topology objects set from a given zip file.
Logical Topology objects include : Technologies, Logical Agents, Logical Schemas, Actions Groups, Actions, Datatypes, Datatype Conversions
 void importMasterFromFolder(int pImportMode, java.lang.String pFolderPath, boolean pDeclareMissingRepository)
          Imports a previously exported master objects set from a given folder.
Master objects include : Objects, Methods, Profiles, Users, Languages, Versions, Solutions, Open Tools, Password rules & polices, Entities, Links, Fields, Lookups
 void importMasterFromZipFile(int pImportMode, java.lang.String pZipFilePath, boolean pDeclareMissingRepository)
          Imports a previously exported master objects set from a given zip file.
Master objects include : Objects, Methods, Profiles, Users, Languages, Versions, Solutions, Open Tools, Password rules & polices, Entities, Links, Fields, Lookups
 void importObjectFromXml(int pImportMode, java.lang.String pFileName, boolean pDeclareMissingRepository)
          This method imports an object from an OracleDI export file (XML).
 void importObjectFromXml(int pImportMode, java.lang.String pFileName, IImportRoot pObjectParent, boolean pDeclareMissingRepository)
          This method imports an object from an OracleDI export file (XML) under a parent object.
 void importReplaceProcedure(OdiProcedure pOdiProcedure, java.lang.String pXmlFilePath, boolean pDeclareMissingRepository)
          Replace an existing procedure with a procedure previously exported procedure in a XML file.
 void importReplaceScenario(OdiScenario pOdiScenario, java.lang.String pXmlFilePath, boolean pDeclareMissingRepository)
          Replace an existing scenario with a procedure previously exported procedure in a XML file.
 void importSecurityFromFolder(int pImportMode, java.lang.String pFolderPath, boolean pDeclareMissingRepository)
          Imports a previously exported security objects set from a given folder.
Security objects include : Objects, Methods, Users, Profiles, Instances of Objects, Hosts, Password rules & policies
 void importSecurityFromZipFile(int pImportMode, java.lang.String pZipFilePath, boolean pDeclareMissingRepository)
          Imports a previously exported security objects set from a given zip file.
Security objects include : Objects, Methods, Users, Profiles, Instances of Objects, Hosts, Password rules & policies
 void importSolution(int pImportMode, java.lang.String pZipFile, boolean pDeclareMissingRepository)
          Imports a solution and all its component objects from a zip file.
 void importTopologyFromFolder(int pImportMode, java.lang.String pFolderPath, boolean pDeclareMissingRepository)
          Imports a previously exported topology objects set from a given folder.
Topology objects include : Entity IDs, Local Repositories, Connections, Hosts, Logical Agents, Agents, Generic Actions, Technologies, Datatypes, Datatypes conversions
 void importTopologyFromZipFile(int pImportMode, java.lang.String pZipFilePath, boolean pDeclareMissingRepository)
          Imports a previously exported topology objects set from a given zip file.
Topology objects include : Entity IDs, Local Repositories, Connections, Hosts, Logical Agents, Agents, Generic Actions, Technologies, Datatypes, Datatypes conversions
 void importWorkRepositoryFromFolder(int pImportMode, java.lang.String pFolderPath, boolean pDeclareMissingRepository)
          This method imports a previously exported work repository from a given folder.
 void importWorkRepositoryFromZipFile(int pImportMode, java.lang.String pZipFilePath, boolean pDeclareMissingRepository)
          This method imports a previously exported work repository from a given zip file.
 void reimportTopologyReferenceData()
          Re-import the default Topology data (ODI Technologies, DataTypes, DataType Conversions and Languages) definitions delivered with the release.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ImportServiceImpl

public ImportServiceImpl(OdiInstance pOdiInstance)
Constructs an ImportServiceImpl object.

Parameters:
pOdiInstance - an OdiInstance object
Method Detail

importExecutionEnvironmentFromFolder

public void importExecutionEnvironmentFromFolder(int pImportMode,
                                                 java.lang.String pFolderPath,
                                                 boolean pDeclareMissingRepository)
                                          throws OdiImportException
Description copied from interface: IImportService
Imports a previously exported execution environment objects set from a given folder.
Execution Environment objects include : Technologies, Connections, Contexts, Agents, Generic Actions

This method will execute in the surrounding transaction and all pending persisted changes will be flushed before import.

Specified by:
importExecutionEnvironmentFromFolder in interface IImportService
Parameters:
pImportMode - Insert, Insert-update, Update or Duplication mode.
pFolderPath - the folder containing all the XML files you want to import.
pDeclareMissingRepository - In synonym import, if the original repository of the original object is missing, if true, it will be referenced ; if false, the import will fail.
Throws:
OdiImportException - if the import fails.

importExecutionEnvironmentFromZipFile

public void importExecutionEnvironmentFromZipFile(int pImportMode,
                                                  java.lang.String pZipFilePath,
                                                  boolean pDeclareMissingRepository)
                                           throws OdiImportException
Description copied from interface: IImportService
Imports a previously exported execution environment objects set from a given zip file.
Execution Environment objects include : Technologies, Connections, Contexts, Agents, Generic Actions

This method will execute in the surrounding transaction and all pending persisted changes will be flushed before import.

Specified by:
importExecutionEnvironmentFromZipFile in interface IImportService
Parameters:
pImportMode - Insert, Insert-update, Update or Duplication mode.
pZipFilePath - the Zip file containing all the XML files you want to import.
pDeclareMissingRepository - In synonym import, if the original repository of the original object is missing, if true, it will be referenced ; if false, the import will fail.
Throws:
OdiImportException - if the import fails.

importLogicalTopologyFromFolder

public void importLogicalTopologyFromFolder(int pImportMode,
                                            java.lang.String pFolderPath,
                                            boolean pDeclareMissingRepository)
                                     throws OdiImportException
Description copied from interface: IImportService
Imports a previously exported Logical topology objects set from a given folder.
Logical Topology objects include : Technologies, Logical Agents, Logical Schemas, Actions Groups, Actions, Datatypes, Datatype Conversions

This method will execute in the surrounding transaction and all pending persisted changes will be flushed before import.

Specified by:
importLogicalTopologyFromFolder in interface IImportService
Parameters:
pImportMode - Insert, Insert-update, Update or Duplication mode.
pFolderPath - the folder containing all the XML files you want to import.
pDeclareMissingRepository - In synonym import, if the original repository of the original object is missing, if true, it will be referenced ; if false, the import will fail.
Throws:
OdiImportException - if the import fails.

importLogicalTopologyFromZipFile

public void importLogicalTopologyFromZipFile(int pImportMode,
                                             java.lang.String pZipFilePath,
                                             boolean pDeclareMissingRepository)
                                      throws OdiImportException
Description copied from interface: IImportService
Imports a previously exported logical topology objects set from a given zip file.
Logical Topology objects include : Technologies, Logical Agents, Logical Schemas, Actions Groups, Actions, Datatypes, Datatype Conversions

This method will execute in the surrounding transaction and all pending persisted changes will be flushed before import.

Specified by:
importLogicalTopologyFromZipFile in interface IImportService
Parameters:
pImportMode - Insert, Insert-update, Update or Duplication mode.
pZipFilePath - the Zip file containing all the XML files you want to import.
pDeclareMissingRepository - In synonym import, if the original repository of the original object is missing, if true, it will be referenced ; if false, the import will fail.
Throws:
OdiImportException - if the import fails.

importMasterFromFolder

public void importMasterFromFolder(int pImportMode,
                                   java.lang.String pFolderPath,
                                   boolean pDeclareMissingRepository)
                            throws OdiImportException
Description copied from interface: IImportService
Imports a previously exported master objects set from a given folder.
Master objects include : Objects, Methods, Profiles, Users, Languages, Versions, Solutions, Open Tools, Password rules & polices, Entities, Links, Fields, Lookups

This method will execute in the surrounding transaction and all pending persisted changes will be flushed before import.

Specified by:
importMasterFromFolder in interface IImportService
Parameters:
pImportMode - Insert, Insert-update, Update or Duplication mode.
pFolderPath - the folder containing all the XML files you want to import.
pDeclareMissingRepository - In synonym import, if the original repository of the original object is missing, if true, it will be referenced ; if false, the import will fail.
Throws:
OdiImportException - if the import fails.

importMasterFromZipFile

public void importMasterFromZipFile(int pImportMode,
                                    java.lang.String pZipFilePath,
                                    boolean pDeclareMissingRepository)
                             throws OdiImportException
Description copied from interface: IImportService
Imports a previously exported master objects set from a given zip file.
Master objects include : Objects, Methods, Profiles, Users, Languages, Versions, Solutions, Open Tools, Password rules & polices, Entities, Links, Fields, Lookups

This method will execute in the surrounding transaction and all pending persisted changes will be flushed before import.

Specified by:
importMasterFromZipFile in interface IImportService
Parameters:
pImportMode - Insert, Insert-update, Update or Duplication mode.
pZipFilePath - the Zip file containing all the XML files you want to import.
pDeclareMissingRepository - In synonym import, if the original repository of the original object is missing, if true, it will be referenced ; if false, the import will fail.
Throws:
OdiImportException - if the import fails.

importObjectFromXml

public void importObjectFromXml(int pImportMode,
                                java.lang.String pFileName,
                                boolean pDeclareMissingRepository)
                         throws OdiImportException,
                                java.io.IOException
Description copied from interface: IImportService
This method imports an object from an OracleDI export file (XML).

This method will execute in the surrounding transaction and all pending persisted changes will be flushed before import.

Specified by:
importObjectFromXml in interface IImportService
Parameters:
pImportMode - Insert, Insert-update, Update or Duplication mode.
pFileName - the OracleDI XML export file.
pDeclareMissingRepository - In synonym import, if the original repository of the original object is missing, if true, it will be referenced ; if false, the import will fail.
Throws:
OdiImportException - if the import fails.
java.io.IOException - if the file doesn't exist

importObjectFromXml

public void importObjectFromXml(int pImportMode,
                                java.lang.String pFileName,
                                IImportRoot pObjectParent,
                                boolean pDeclareMissingRepository)
                         throws OdiImportNotSupportedException,
                                OdiImportException,
                                java.io.IOException
Description copied from interface: IImportService

This method imports an object from an OracleDI export file (XML) under a parent object. The parent object must be persisted. The parent object will be refreshed. When importing a KM, the import mode must be IImportService.IMPORT_MODE_DUPLICATION, otherwise it will throw an IllegalArgumentException

This method will execute in the surrounding transaction and all pending persisted changes will be flushed before import.

Specified by:
importObjectFromXml in interface IImportService
Parameters:
pImportMode - Insert, Insert-update, Update or Duplication mode.
pFileName - the OracleDI XML export file.
pObjectParent - the object under which the object in the XML file will be imported
pDeclareMissingRepository - In synonym import, if the original repository of the original object is missing, if true, it will be referenced ; if false, the import will fail.
Throws:
OdiImportNotSupportedException - if the IImportRoot doesn't support this import.
OdiImportException - if the import fails.
java.io.IOException - if the file doesn't exist

importReplaceProcedure

public void importReplaceProcedure(OdiProcedure pOdiProcedure,
                                   java.lang.String pXmlFilePath,
                                   boolean pDeclareMissingRepository)
                            throws OdiImportException
Description copied from interface: IImportService
Replace an existing procedure with a procedure previously exported procedure in a XML file.

Specified by:
importReplaceProcedure in interface IImportService
Parameters:
pOdiProcedure - the odiProcedure to replace
pXmlFilePath - the previously exported procedure xml file path.
pDeclareMissingRepository - if the original repository of the original object is missing, if true, it will be referenced ; if false, the import will fail.
Throws:
OdiImportException - if the import fails

importReplaceScenario

public void importReplaceScenario(OdiScenario pOdiScenario,
                                  java.lang.String pXmlFilePath,
                                  boolean pDeclareMissingRepository)
                           throws OdiImportException
Description copied from interface: IImportService
Replace an existing scenario with a procedure previously exported procedure in a XML file.

Specified by:
importReplaceScenario in interface IImportService
Parameters:
pOdiScenario - the odiScenario to replace
pXmlFilePath - the previously exported scenario xml file path.
pDeclareMissingRepository - if the original repository of the original object is missing, if true, it will be referenced ; if false, the import will fail.
Throws:
OdiImportException - if the import fails

importSecurityFromFolder

public void importSecurityFromFolder(int pImportMode,
                                     java.lang.String pFolderPath,
                                     boolean pDeclareMissingRepository)
                              throws OdiImportException
Description copied from interface: IImportService
Imports a previously exported security objects set from a given folder.
Security objects include : Objects, Methods, Users, Profiles, Instances of Objects, Hosts, Password rules & policies

This method will execute in the surrounding transaction and all pending persisted changes will be flushed before import.

Specified by:
importSecurityFromFolder in interface IImportService
Parameters:
pImportMode - Insert, Insert-update, Update or Duplication mode
pFolderPath - the folder containing all the XML files you want to import.
pDeclareMissingRepository - In synonym import, if the original repository of the original object is missing, if true, it will be referenced ; if false, the import will fail.
Throws:
OdiImportException - if the import fails.

importSecurityFromZipFile

public void importSecurityFromZipFile(int pImportMode,
                                      java.lang.String pZipFilePath,
                                      boolean pDeclareMissingRepository)
                               throws OdiImportException
Description copied from interface: IImportService
Imports a previously exported security objects set from a given zip file.
Security objects include : Objects, Methods, Users, Profiles, Instances of Objects, Hosts, Password rules & policies

This method will execute in the surrounding transaction and all pending persisted changes will be flushed before import.

Specified by:
importSecurityFromZipFile in interface IImportService
Parameters:
pImportMode - Insert, Insert-update, Update or Duplication mode
pZipFilePath - the Zip file containing all the XML files you want to import.
pDeclareMissingRepository - In synonym import, if the original repository of the original object is missing, if true, it will be referenced ; if false, the import will fail.
Throws:
OdiImportException - if the import fails.

importSolution

public void importSolution(int pImportMode,
                           java.lang.String pZipFile,
                           boolean pDeclareMissingRepository)
                    throws OdiImportException
Description copied from interface: IImportService
Imports a solution and all its component objects from a zip file.

This method will execute in the surrounding transaction and all pending persisted changes will be flushed before import.

Specified by:
importSolution in interface IImportService
Parameters:
pImportMode - Insert, Insert-update, Update or Duplication mode.
pZipFile - the Zip file containing the solution you want to import.
pDeclareMissingRepository - In synonym import, if the original repository of the original object is missing, if true, it will be referenced ; if false, the import will fail.
Throws:
OdiImportException - if the import fails.

importTopologyFromFolder

public void importTopologyFromFolder(int pImportMode,
                                     java.lang.String pFolderPath,
                                     boolean pDeclareMissingRepository)
                              throws OdiImportException
Description copied from interface: IImportService
Imports a previously exported topology objects set from a given folder.
Topology objects include : Entity IDs, Local Repositories, Connections, Hosts, Logical Agents, Agents, Generic Actions, Technologies, Datatypes, Datatypes conversions

This method will execute in the surrounding transaction and all pending persisted changes will be flushed before import.

Specified by:
importTopologyFromFolder in interface IImportService
Parameters:
pImportMode - Insert, Insert-update, Update or Duplication mode.
pFolderPath - the folder containing all the XML files you want to import.
pDeclareMissingRepository - In synonym import, if the original repository of the original object is missing, if true, it will be referenced ; if false, the import will fail.
Throws:
OdiImportException - if the import fails.

importTopologyFromZipFile

public void importTopologyFromZipFile(int pImportMode,
                                      java.lang.String pZipFilePath,
                                      boolean pDeclareMissingRepository)
                               throws OdiImportException
Description copied from interface: IImportService
Imports a previously exported topology objects set from a given zip file.
Topology objects include : Entity IDs, Local Repositories, Connections, Hosts, Logical Agents, Agents, Generic Actions, Technologies, Datatypes, Datatypes conversions

This method will execute in the surrounding transaction and all pending persisted changes will be flushed before import.

Specified by:
importTopologyFromZipFile in interface IImportService
Parameters:
pImportMode - Insert, Insert-update, Update or Duplication mode.
pZipFilePath - the Zip file containing all the XML files you want to import.
pDeclareMissingRepository - In synonym import, if the original repository of the original object is missing, if true, it will be referenced ; if false, the import will fail.
Throws:
OdiImportException - if the import fails.

importWorkRepositoryFromFolder

public void importWorkRepositoryFromFolder(int pImportMode,
                                           java.lang.String pFolderPath,
                                           boolean pDeclareMissingRepository)
                                    throws OdiImportException
Description copied from interface: IImportService
This method imports a previously exported work repository from a given folder.

This method will execute in the surrounding transaction and all pending persisted changes will be flushed before import.

Specified by:
importWorkRepositoryFromFolder in interface IImportService
Parameters:
pImportMode - Insert, Insert-update, Update or Duplication mode.
pFolderPath - the folder containing all the XML files you want to import.
pDeclareMissingRepository - In synonym import, if the original repository of the original object is missing, if true, it will be referenced ; if false, the import will fail.
Throws:
OdiImportException - if the import failed

importWorkRepositoryFromZipFile

public void importWorkRepositoryFromZipFile(int pImportMode,
                                            java.lang.String pZipFilePath,
                                            boolean pDeclareMissingRepository)
                                     throws OdiImportException
Description copied from interface: IImportService
This method imports a previously exported work repository from a given zip file.

This method will execute in the surrounding transaction and all pending persisted changes will be flushed before import.

Specified by:
importWorkRepositoryFromZipFile in interface IImportService
Parameters:
pImportMode - Insert, Insert-update, Update or Duplication mode.
pZipFilePath - the Zip file containing all the XML files you want to import.
pDeclareMissingRepository - In synonym import, if the original repository of the original object is missing, if true, it will be referenced ; if false, the import will fail.
Throws:
OdiImportException - if the import failed

reimportTopologyReferenceData

public void reimportTopologyReferenceData()
                                   throws OdiImportException
Description copied from interface: IImportService
Re-import the default Topology data (ODI Technologies, DataTypes, DataType Conversions and Languages) definitions delivered with the release. The modification made on these objects in the repository will be lost. Topology objects that were created manually will not be modified.

Specified by:
reimportTopologyReferenceData in interface IImportService
Throws:
OdiImportException - if the import fails

Oracle® Data Integrator Java API Reference
11g Release 1 (11.1.1.3.0)

E17060-01

Copyright © 2010, Oracle and/or its affiliates. All rights reserved.