Import & Export Data Tables

Overview

This topic provides maintenance tasks for the JET Data Tables, which were introduced in Oracle CPQ 20A.

It is possible to maintain Data Tables outside of CPQ, such as in Excel (.CSV) and other file formats. You can import Data Tables and their schema directly into CPQ.

Before uploading a Data Table, refer to Prepare a .CSV File for Import to set up the .CSV file with the appropriate meta data tags.

Administration

ClosedPrepare a .CSV File for Import Watch Video  Video icon

  1. Open your Excel file or create your Data Table in the .CSV file format.
  2. Enter _start meta data into cell A1.
  3. Use Row 2 for your Column Headers and Row 3 for the Data Type.

    Data types need to be either String, Integer or Float. The first letter of the data type must be capitalized, or your import will fail.
  4. Enter _end meta data into cell A5.
  5. Populate your table. It should look like this:

    Rack Domain spreadsheet example

  6. Save the file as a .CSV file format.

    • The name of your file will also be the name of your Data Table when it is imported into CPQ. If a table of the same name already exists, the data will append to the existing file.
    • Data table names can only contain alpha-numeric values and underscores. White space is not accepted.

ClosedImport a .CSV Data Table Watch Video  Video icon

Once you have properly created your .CSV file, begin the import to CPQ.

CSV tables can not be uploaded when metadata rows are missing.
  1. ClosedNavigate to the Data Table Administration page .
    1. Click Admin to go to the Admin Home Page.

    2. Click Data Tables in the Developer Tools section.

      The  Data Table Administration page opens.

  2. Select Import from the from the side navigation panel menu drop-down.

    Select Import from the drop-down menu

    The Import dialog box appears.

    Import dialog

    1. Drag and drop files into the Import window, or click inside the dashed box to browse and select your Data Table.
    1. Select your Column Delimiter. The default, and the most commonly used setting, is Comma.
    1. Select Newline as the Row Delimiter, or select the Other radio button and enter a value.
    1. For Data with Delimiter, select MS Excel .csv format.
    2. In the Destination Folder drop-down, select where you would like to store the Data Table.

      The list of folders reflects the available folders in your deployment.

    1. Click Import.

      The Data Table, based on the File Name and the Destination Folder, is displayed in the Folder list. The data table is proceeded by an orange status icon, meaning it has not been deployed.

      Undeployed data table

  1. Deploy the table using one of the following methods:

    • Click Deploy when you have a Data Table open,
    • Right-click on the Data Table name and click Deploy,
    • Select the Data Table and select Deploy Selected from the navigation panel menu drop-down.
If your Table has Natural Keys, you can select rows of data to delete instead of just upsert.

ClosedStop a .CSV Data Table Import Watch Video  Video icon

To stop a .CSV Data Table Import that is currently running, open the Status Log and click on the "Cancel" icon, as shown below.

Cancel a currently running import


ClosedExport .CSV Data Table(s) Watch Video  Video icon

You can make changes to a Data Table and then export the Table, as a .CSV file, to your work station.

  1. ClosedNavigate to the Data Table Administration page .
    1. Click Admin to go to the Admin Home Page.

    2. Click Data Tables in the Developer Tools section.

      The  Data Table Administration page opens.

  2. Select one of the following options:

    ClosedExport a Single Data Table

    ClosedExport Multiple Data Tables

    ClosedExport Filtered Data Table

  3. After exporting a single Data Table, multiple Data Tables, or a filtered Data Table the Export Status dialog indicates the export status.

    • If the export is successful, click on the export link to download the exported file.

      Click on the export link to download the exported file

    • Click on View Status Logs to view export status details.

      Click on View Status Logs to view export status details


ClosedImport and Export of Data Tables with Secure Columns

When Oracle CPQ Data Tables with secure columns are exported to a .CSV file:

  • The Oracle CPQ Data Table column Type is displayed as Secure, as shown below in the Schema Type.

  • The .CSV meta data Type is displayed as String, as shown below in cell B3.
  • The data within secure fields is encrypted, as shown below in cell B6

Encrypted data within secure field

If a data table with a secure column is downloaded using a bulk download, then the same content is uploaded using a bulk upload, values are double encoded, changing their value.

ClosedImport and Export Data Tables with Foreign Key Relationships

When importing or exporting bulk or individual Data Tables with Foreign Keys relationships, the Foreign Key data values are part of the Data Table files. Foreign Key-related schema import and export is not supported. Administrators cannot add or modify Foreign Key relationships via data table import. Therefore, following the import of a new Data Table, Foreign Keys must be manually added. If a Foreign Key relationship error is detected during import or export, an error message displays and the record is not modified.

Due to the inter-dependencies of records in separate Data Tables with Foreign Keys, the sequence of steps is very important when importing Data Tables with Foreign Key relationships. As applicable, perform the import in the following sequence order:

  1. Import files specific to deleting Foreign Key child records with the deletion behavior defined as On Delete No Action. Administrators must identify records that are only referencing parent records which are intended to be deleted during Step 2 below. Failing to do this will prevent the deletion of the referenced parent records during Step 2.
  2. Import files for parent records. We recommend modify actions be grouped and performed first, followed by delete actions. This is important because sets of modify and deletes are processed separately upon import and have different behavior, as follows:
    1. First modify set is processed when field records are processed individually. Therefore failed records do not affect successful update of other records in the set.
    2. Delete set is processed as a whole and any failure results in failure of the whole set of deletes. When deleting records, the On Delete Behavior setting of the Foreign Key schema determines the disposition for deleting or disassociating the child records.
  3. Import files for child records that will be explicitly modified.

ClosedNatural Keys and .CSV Import

For Data Tables with Natural Keys enabled, a column called _update_action is created in imported .CSV Data Tables. This column allows admins to delete Data Table rows.

The Update column is only available on Data Tables enabled with Delta Data Table Uploads (Natural Keys).

Valid values for this column include:

  • Delete: Looks for the Natural Key defined in the row and deletes it.
  • Modify: Upserts data into the Table.

To create the _update_action column in your .CSV file:

  1. Create a .CSV file with your data headings, according to the instructions in the section Prepare a .CSV file for Import.
  2. Import the .CSV file as a Data Table into CPQ.
  3. Apply Natural Keys, according to the instructions above.
  4. Export the .CSV file.
  5. Open the .CSV file.

    By default, there is a new first column, _update_action. The column can be moved.

  6. As desired, change the value in this new column and import the .CSV file into CPQ.

    Depending on the value, the data in Oracle CPQ will be modified or deleted.

  • If you attempt to import duplicate records (where data with the same Natural Keys already exist in the Table) during an XML/CSV import, the duplicate records will be deleted and the new records will replace the pre-existing ones.
  • If your Data Table does not have Natural Keys, the duplicate data is added as a new row.
  • Use the logs to evaluate the success of your import. For more information, see the topic Import Status and Error Logs.

ClosedView Status and Error Logs for Data Tables Watch Video  Video icon

After you have imported or deployed a Data Table, you can check the status and corresponding error logs to ensure that all of your data loaded correctly.

  1. ClosedNavigate to the Data Table Administration page .

    1. Click Admin to go to the Admin Home Page.

    2. Click Data Tables in the Developer Tools section.

      The  Data Table Administration page opens.

  2. Select Status Log from the side navigation panel drop-down menu.

    Select Status Lof from navigation menu drop-down

    The Status Log dialog box appears.

    Status Log dialog box

  3. Check the status of Data Table imports, exports, and deployments.

    The Category column indicates which kind of status is displayed.

  4. If available, click the log link to check the error logs.

    Upload Error Log


Related Topics

Related Topics Link IconSee Also