10 Importing and Exporting Data

For design-time data, use the Oracle B2B interface to import and export B2B repositories.

This chapter contains the following topics:

See Chapter 18, "B2B Command Line Tools," for information on importing and exporting data using ant.

10.1 Importing and Exporting the Design-Time Repository

Oracle B2B design-time data can be exported and saved to a ZIP file. The ZIP file can be imported back into Oracle B2B so that the data is available in the B2B interface. This is useful when migrating data from a test environment to a production environment.

Caution:

Do not manually edit exported files. If you do so, Oracle B2B cannot guarantee their integrity.

You can exporting data from other areas of the Oracle B2B interface also:

You can also import sample files that use the following document types: Custom, EDI EDIFACT, EDI X12, HL7, and RosettaNet. See "Oracle B2B Samples" for the download location and information about the scenarios presented in the samples.

Figure 10-1 shows where you import and export design-time data.

Figure 10-1 Importing and Exporting Data

Import/export
Description of "Figure 10-1 Importing and Exporting Data"

When you import metadata, the updates to your existing B2B are incremental unless you select the Replace Existing Metadata option. To delete all existing data before importing metadata, use the Purge tab under the Administration link. See Chapter 13, "Purging Data," for more information.

Caution:

Complete export operations without interruption or idle time. Leaving the browser idle for more than a few minutes during export operations can cause file corruption.

To import data:

  1. Click the Administration link.

  2. Click the Import/Export tab.

  3. Click Browse to find the metadata repository ZIP file.

    The default name for exported metadata is MDS_EXPORT_DD_MM_YEAR.zip.

    If you are importing a ZIP file that contains multiple ZIP files within it, you must unzip the containing file and import each ZIP file separately. Individual ZIP files are created when you export multiple agreements at the same time.

  4. If you select Replace Existing Metadata, then current metadata in the Metadata Service (MDS) repository is overwritten. If it is not selected, then only new data is copied to the MDS repository.

  5. Click Import.

    Depending on the size of the design-time repository contents, this process can take time.

To export data:

Caution:

Do not manually edit exported files.
  1. Click the Administration link.

  2. Click the Import/Export tab.

  3. Select Entire Repository or Active Agreements.

    The entire repository includes all data in the B2B design-time repository—agreements in all states, all trading partner configurations, and so on.

    Active agreements are all deployed agreements that are not inactive, retired, or purged.

  4. (Optional) Narrow the list of agreements by using the Search option.

    1. Select Agreement or Document Type.

    2. Enter part or all of an agreement name or document type name and click Search.

    3. Click Search.

    4. Select one or more agreements from the search results.

      If you select multiple agreements, each agreement is exported in its own ZIP file, and all the individual ZIP files are contained in the export ZIP file.

  5. Click Export.

  6. Select Open or Save.

    The system-provided file name is MDS_EXPORT_DD_MM_YYYY.zip. You can choose whether you want to open the file or save it, in which case you can specify a file name and download location.

    Export dialog
    Description of the illustration bb_export1.gif

10.2 What Is Copied When You Import or Export from the Import/Export Tab

Clicking Import imports whatever is in the export file (that is, the file that was previously exported), which can possibly include B2BUser and ParameterValue objects. A warning message is displayed to indicate that, if the file contains credential- and policy-related data, then the credential and policy stores must also be imported.

User information is not copied when you export a repository. Use the command line utility to export user data. See "Exporting Data" for more information. ParameterValue objects for passwords are copied when you export a repository.

The B2B import and export functionality is separate from the credential store and policy store import and export functionality. Use the Oracle WebLogic Server tools to import and export identity, credential, and policy stores.

Passwords are not copied when you import a repository. Passwords must be re-created in the destination B2B instance. Passwords are not copied when you export the design-time repository.

If you export the design-time repository and then continue to make changes to the repository contents in the Oracle B2B interface, and if you later import the exported file (the contents of which are now older), then updates are as follows:

  • If Replace Existing Metadata is not checked during import, then new data created in the Oracle B2B interface after the file was exported is left untouched.

  • If Replace Existing Metadata is checked during import, then data updated or deleted after the file was exported is overwritten with the older contents of the imported file.

If an import fails, then the changes are rolled back and the design-time repository remains unchanged. A message appears indicating that the import was unsuccessful.

10.3 About the Exported File

Design-time repository contents that are exported to a file represent a copy of the current data. This file is no longer accessible for changes with the Oracle B2B user interface until it is imported back into Oracle B2B. Do not manually edit exported files.