Export

The export feature is part of the export/import utility in iKnowBase. With the export feature you can define and build transport sets and export data. Components, metadata, and content can be exported. The import feature lets you import previously exported data.

The export/import utility in iKnowBase also supports export and import of Oracle Portal data, which you will need if your iKnowBase application uses Oracle Portal as a frontend. Before you can generate the iKnowBase export set, you must create and export the appropriate Oracle Portal export set.

Properties

This section describes the properties of an export definition, as shown on the corresponding Edit pane.

Edit Tab

The Edit tab contains general information about the domain.

Property Description
Name

Type a name for the export.

Description

Type the description of the export.

Compability version

The version of database objects to be extracted. Database objects or attributes that are incompatible with the version will not be extracted and might fail under import.
Legal values for this parameter are as follows:

Value Description
COMPATIBLE the version of the metadata corresponds to the database compatibility level and the compatibility release level for feature (as given in the V$COMPATIBILITY view).
LATEST the version of the metadata corresponds to the database version.
A specific database version for example, ‘10.0.0’. In Oracle Database10g, this value cannot be lower than 10.0.0.
none If the database version is 10G, version will be set to 10.1. If higher, version will be set to LATEST
Path to dump log

The path name to the export log, on the database server.

Export set type

When you create a new export definition you must select between Transport Set or Patch Set. A Patch set is available from all components where you can add an instance of the component directly to the patch set. Patch sets should also have Export objects without references checked so only the object itself is exported and not all the references.

Data pump file

Name of the created dump file and URL to download it. Only visible after running the export.

Export status

The status of the export transport set:

Status Description
CREATED The transport set is created, but not yet built or exported.
BUILD_STARTED Building of the transport set is started.
BUILD_DONE The transport set is built.
BUILD_FAILED Building the transport set failed. Check the log
EXPORT_DUMP_BEGIN Export of the transport set is started.
EXPORT_DUMP_COMPLETED The data is exported.
EXPORT_DUMP_FAILED Export of the transport set failed. Check the log
Date

Date of the last status change

Last built date

Date of the last time the transport set was built (by pressing the button Build dataset)

Last exported date

Date of the last time the transport set was exported (by pressing the button Export)

iKnowBase version

Displays the iKnowBase repository version. Make sure the import side has the same version of iKnowBase before importing.

Scheduled job status

It the job is running in batch mode, the job status is displayed here.

Select objects

Display all object types possible to export. Select one, and you then can choose single instances of the object type.
The table storing all selections is EXP_IMP_OBJ_SELECTION. A hint; if you are about to export loads of documents and you can identify these documents by a select, is to insert them into this table manually instead of selection one by one. The syntax will be like this :

insert into exp_imp_obj_selection (export_guid, table_name, object_guid)
select '<the export Guid>','DOCUMENT',document_guid from document where <condition>;
Select document

Use the picklist to select documents to export.

Select dimensions

Use the picklist to select dimensions to export.

Select acls

Use the picklist to select access control lists (ACL) to export.

Export object without references

Select this check box if you want to export the object itself without all references, only the ones owned by the object (like detail data, labels and template text)

Export user data

Select this check box if the export should include members in acls and groups.

Portal transport set

Select the appropriate Oracle Portal transport set.

Only applicable if your iKnowBase application is using Oracle Portal as the frontend.

Note: You must first create and export an Oracle Portal export set to make it available to this Export definition.

Exclude data from subsystem

Select subsystems you do not want data from. If the export set contains data from a excluded subsystem it will be skipped and expected to exist on the target site.

Exclude data without subsystem

Select this check box if you want to ignore data without any subsystem set.

Preset import rules for selected objects

When the dataset is built, you can add import rules for each object before you export the dataset. The values can be changed on the import side.

Name

Displays names of the database tables which are included in the import.

Description

Displays descriptions of the database tables which are included in the import.

Rows#

Displays the total number of rows in the transport set.

Replace on import?

Check to insert non-existing and update existing rows for the given table. Uncheck to insert non-existing rows and discard existing rows.

Delete details and load again

Check to delete all existing data related to the objects to be imported from the given table, and then insert all rows from the import set.

Overview – tables Tab

The Overview – tables tab contains information on tables chosen for export. The content of this tab is available after the transport set is built or data exported.

Property Description
Name

Displays the name of the tables which holds data to be exported for the selected objects (with dependencies).

Description

Displays the descriptions for the tables.

Rows#

Displays the number of rows to be exported per table.

Debug and error log Tab

This tab contains information on actual export process. The content of this tab is available after the building of the transport set or export of data is started.

Property Description
Text

Displays the messages generated during the last build or export.

Timestamp

Displays the timestamp for the messages.

Message type

Displays the message types.

Additional information

Displays additional information.

Export tree Tab

This tab contains information on all exported objects. The content of this tab is available after the building of the transport set or export of data is started.

Property Description
Name

Displays a graph of all the objects included in the export.

Note: It includes all the objects that the selected objects are dependent of.

Tasks

Adding Objects to an Export Tab

To add objects (e.g. components configured in Development Studio or database tables) to an export, perform the following steps:

  1. On the edit tab of the Edit pane for the export, select the appropriate object type in the select objects dropdown. The region select objects which displays a list of all existing objects of the given type appears.
  2. In the select objects region, click on the checkboxes for the objects that you want to include in the export.
  3. Click Apply or OK. The selected objects are added to the export definition, and will appear as selected objects in the region selected objects and tables in the transport set in the Edit pane.

Note: You can add objects of multiple object types to an export. After you have added objects of one object type and saved the export, you can repeat the steps above for a different object type.

To remove an object from an export definition, perform the following steps:

  1. On the Edit pane for the export, click on the checkbox for the object you want to remove in the region selected objects and tables in the transport set.
  2. Click Save. The object is removed from the list.

Adding Documents to an Export

To add documents to an export, perform the following steps:

  1. On the Edit tab of the Edit pane for the export, click the document archive link next to select documents. The document archive opens in a new browser window.
  2. In the document archive, find and select the documents to be included in the export.
  3. Click OK. The list of documents to include in the export will appear next to select documents in the Edit pane. Note: It is possible to remove a document by clicking on the X icon in front of the document.
  4. On the Edit pane for the export, click on Apply. The selected documents are added to the export definition, and will appear as selected objects in the region Selected objects and tables in the transport set in the Edit pane.

To remove a document from an export definition, perform the following steps:

  1. On the Edit pane for the export, click on the checkbox for the document you want to remove in the region Selected objects and tables in the transport set.
  2. Click Save. The document is removed from the list.

Exporting Data for iKnowBase PageEngine use

To export data for use with the iKnowBase Page Engine, perform the steps below. For exporting data for Oracle Portal, see the next chapter:

  1. Create an export definition, defining which data you want to export.
  2. Click on the Build dataset button on the Edit pane of the export definition. The dataset is built, and a debug and error log becomes available on the Debug and error log tab. An overview of how many rows from which tables will be exported becomes available on the Overview � tables tab and a graphical overview of object dependencies becomes available on the Export tree tab.
  3. If you want to define import rules for each table (replace on import/delete details) you can preset values before you export the file.
  4. Check the Debug and error logs tab.
  5. When the dataset is built, click on the Export button on the Edit pane of the export definition. The specified data is exported to the server data pump directory. The exported data file will be named EXP-SchemaName-ExportDefGuid-ExportDefName.dmp, where SchemaName is the name of the database schema, ExportDefGuid is the guid of the export definition, and ExportDefName is the name of the export definition. An iKnowBase document with the information type “iKnowBase Transport Set” with the dump file will be created. It will be given the title Export(DMP), where Export is the name of export definition. A debug and error log becomes available on the Debug and error log tab. An overview of how many rows from which tables are exported becomes available on the Overview – tables tab and a graphical overview of object dependencies becomes available on the Export tree tab.
  6. Download the dump file through the web interface, or retrieve it directly from the database server.

Exporting Data with Oracle Portal Data

To export data with Oracle Portal data, perform the following steps:

  1. In Oracle Portal, create an export set. Select the pages and page groups to include in the export set. Select “Export now” on the final step.
  2. Download the Oracle Portal .bat or .sh file.
  3. Run the Oracle Portal file to generate the dump file. Example: call <script-file>.bat -mode export -s portal -p <portal password> -c <sid> -d myexport.dmp
  4. Create an export definition, defining which data you want to export, including the Oracle Portal export set you created in the first step.
  5. Click on the Build dataset button on the Edit pane of the export definition. The dataset is built, and a debug and error log becomes available on the Debug and error log tab. An overview of how many rows from which tables will be exported becomes available on the Overview � tables tab and a graphical overview of object dependencies becomes available on the Export tree tab.
  6. If you want to define import rules for each table (replace on import/delete details) you can preset values before you export the file. When you rebuild the dataset, these settings has to be set again.
  7. Check the debug and error logs.
  8. When the dataset is built, click on the Export button on the Edit pane of the export definition. The specified data is exported to the server data pump directory. The exported data file will be named EXP-SchemaName-ExportDefGuid-ExportDefName.dmp, where SchemaName is the name of the database schema, ExportDefGuid is the guid of the export definition, and ExportDefName is the name of the export definition. An iKnowBase document with the information type “iKnowBase Transport Set” with the dump file will be created. It will be given the title Export(DMP), where Export is the name of export definition. A debug and error log becomes available on the Debug and error log tab. An overview of how many rows from which tables are exported becomes available on the Overview – tables tab and a graphical overview of object dependencies becomes available on the Export tree tab.
  9. Download the dump file through the web interface, or retrieve it directly from the database server.