Import assays into PLA 3.0

Import the extracted assays from the synchronization folder into your PLA 3.0 target database.

Document type required for this task: PLA 2.x Database synchronization document.

Important: If your synchronization folder contains projects with a large number of assays, you have to increase the Java heap size of your PLA 3.0 installation: In the PLA 3.0.vmoptions file of your PLA 3.0 installation, replace -Xmx512m with -Xmx1024m. The default installation path of this file is: C:\Program Files (x86)\Stegmann Systems\PLA 3.0\bin.

Before you begin

Complete the steps described in the Extract assays from PLA 2.x topic.

Procedure

To import assays into PLA 3.0:
  1. Log in to PLA 3.0 with your PLA administrator account.
  2. In the Navigator, create a root folder for your archive.
  3. Create the PLA 2.x Database synchronization document that is required to control the import process:
    1. Right-click the archive root folder, and select New.
    2. In the Create a new document dialog, navigate to PLA 2.x Archive package > PLA 2.x Database synchronization document, and select 'New PLA 2.x Database synchronization document.'
    3. Select Create.
  4. Set up the document in the Content editor:
    Figure 1. Setup of a PLA 2.x Database synchronization document
    1. Enter a name for the document.
      If you import data from several databases, we recommended you use the source database as the name.
    2. As the Source directory, enter the path and name of your synchronization folder, and the subfolder that identifies the database: Open the corresponding folder in your Windows Explorer, copy the full path, and paste it in the Value column.
      Tip: The subfolder is created automatically. You can identify it by the 37-digit UUID, for example: C:\TransferFolder\f51a019d-20a8-4921-abf1-75e0d272d645.
    3. Leave the Migration target folder empty. The import process automatically saves the imported assays in subfolders parallel to the Database synchronization document.
  5. Save the document.
  6. To start the import process, on the action bar, select Synchronize.
    Note: If the Synchronize button is not available, make sure the PLA 2.x Archive Import Module add-on is activated in the PLA 3.0 database.

Result

For each project you imported from the PLA 2.x source database, a project subfolder is created in the archive root folder. In each project subfolder, the following document types are created:

PLA 2.x Assay archive

For each PLA 2.x assay in the imported project, a PLA 2.x Assay archive document is created in the project subfolder.

PLA 2.x Project synchronization

A PLA 2.x Project synchronization document is created that stores information about all the assays in the project folder.

Tip: Use the Dashboard of this document to view a list of the first 100 assays you imported, or start a bulk migration. If you imported more than 100 assays, you have to open the report to view the complete list.

Example

In the following example, the 'Migration and Archiving Toolkit' folder holds the data created by the Toolkit. After importing the '10 Examples Parallel-Line Assays' project, the 'PLA 2.x Archive' archive root folder contains the corresponding project subfolder, which in turn holds nine PLA 2.x Assay archive documents as well as the PLA 2.x Project synchronization document.

Figure 2. Result of an assay import