Introduction to Pervasive Data Integrator


Pervasive Data Integrator can be a powerful tool, enabling multiple connections between a wide variety of systems and data points. The Repository Explorer is the starting point for every Data Integrator project.  To get started on your first project, you must understand how to configure your Workspaces and Repositories through Repository Explorer.

What is the Repository Explorer?

The Repository Explorer is the starting point for all Pervasive Data Integrator projects.  From this one application, developers can navigate to projects, open existing Pervasive Data Integrator elements (Maps, Processes, Structured Schemas, etc), or create new instances of those elements.

Who uses the Repository Explorer?

The Repository Explorer is used almost exclusively by developers, but it can also be used by quality assurance resources to access and review code that has already been developed.

How to Configure Repository Explorer?

Opening Repository Explorer

Once installed, Repository Explorer can be accessed like any other program on Windows.

  1. Open the Start menu
  2. Select ‘All Programs’
  3. Select Pervasive folder
  4. Select Data Integrator 9 folder
  5. Select Repository Explorer 9 program

Setting up a Workspace

The Repository Explorer organizes files using two methods.  The first method is via a Workspace.  A Workspace is a collection of one ore many repositories and a single Macrodef.xml file that is specific to the Workspace.  (Note:  For further information on the Macrodef.xml file, check out our two videos on Macro Definition Variables).  At Emprise, our best practice is to create one Workspace for each project.  This allows us to specific a unique Macrodef file for each project.

To create a new Workspace, one just has to follow a few simple steps.

  1. Select File from the menu bar
  2. Select Manage Workspaces…
  3. Click the drop down to the right of Workspaces Root Directory and navigate to the location you would like to save your workspace in.  Hit OK.  The Workspace Root Directory is the location where the Workspace folder will be created.  Inside of this folder a set of mandatory, default files and folders will be created.
    1. Xmldb – This is the folder used for the default repository when creating a new Workspace.
    2. Fileref.xml – A list of file references used by the workspace.
    3. Macrodef.xml – The macrodef file.  For further information see our video.
    4. Repositores.xml – A list of all repositories for the Workspace.  This directory is rarely changed after initial setup.
  4. Select Add
  5. To add an existing workspace, check the box for the proper workspace.
  6. If adding a new Workspace, which will often be the case, click the ‘Create New Workspace” button.  You will be prompted for a name.  Give your workspace a descriptive name and then click “OK” to return to the previous screen.
  7. Click OK
  8. Find the Workspace you just added, click the name to highlight it, then click the Set Current button on the right.  This activates the Workspace, allowing you access to its repositories.

*Note: You can also right click on the white space to the left of the screen that displays your current repository and select the ‘Manage Workspaces’ option from there.  Also, when creating a new Workspace using the “Create New Workspace” option, the Macrodef.xml file from the current Workspace will be copied into the directory of the new Workspace.  This includes the Macro names and values.  This is helpful when standard Macros are used, but is something to pay attention to in regards to directory paths and file names.

Setting up a Repository

Repositories are directory paths pointing to where the Pervasive DI project files will be located.  A Workspace can have any number of Repositories, which are displayed in a tree view on the left side of the Repository Explorer.  Only Pervasive files located in one of the Repositories for the Workspace can be opened and edited from the Repository Explorer.

  1. If you are not currently working in the workspace within which you want to create a repository, navigate to that workspace using File -> Manage Workspaces or right click on the white space on the left that displays the file directory structure and select Manage Workspaces. Then, click the text of the Workspace you would like to use to highlight it before clicking the Set Current button on the right.
  2. Select File form the menu bar
  3. Select Manage Repositories…
  4. Click the Add… button to create a new repository. At this point you can either navigate to the folder you would like to select as the Repository or paste in the file path as copied from Windows Explorer.

Note: You can also right click on the white space to the left of the screen that displays your current repository and select the ‘Manage Repositories’ option from there.

General Notes

  1. Use a standard naming convention for the Workspaces.  This allows for easy identification of what project the Workspace is for.
  2. Use a standard data structure and directory path for the Repository folder.  This prevents issues that may arise when multiple developers work on the same code base.  Pervasive Data Integrator projects use a series of pointers within the files and by standardizing the repository paths you prevent these pointers from being corrupted when moving code between developers.
  3. After creating a new Workspace it is prudent to open the Macrodef.XML file and remove unneeded Macros and change others to match your new project.  Please see our video on the MacroDef for further information.