Importing Configurations into a Workspace
This feature allows you to import Integration Manager configurations and the associated configuration macros, packages (djars) into your active DataConnect workspace. Once imported, you can edit the configuration details, add and delete the files or configuration macros, and edit the DataConnect artifacts referenced inside the package (djar). Once you have updated the configuration and package, the entire configuration can be repackaged and redeployed to Integration Manager.
When you import a configuration into your current workspace the .jobconfig and all related files (djar, macros and other artifacts) are copied and displayed in the Project Explorer. You have the option of creating a new macroset, containing the configuration macros, within your active macro definition file (the macroset will have the same name as the configuration). This feature makes it easy to manage and separate the macros needed to run your artifacts locally vs running from Integration Manager. During the redeploy process, you will be provided with an option to merge any new macros you may have added to the macroset into the configuration macros.
You can choose to import using an existing Integration Manager connection that was added using the Setting Integration Manager Preferences dialog, or define a new connection information from the Import Wizard.
To import a Configuration into your workspace:
1. In Integration Manager Explorer, select the desired connection.
All available job configurations are listed in the Integration Manager Explorer.
2. From the Job Configurations list, double-click the configuration that you want to import.
3. Click 
from the Job Configuration Details pane.
from the Job Configuration Details pane. The first page of the Package Import Wizard is displayed and lists the connection information.
4. Specify the connection information and click Next.
The second page of the Wizard is displayed and lists the configuration and package that will be imported.
5. Review the configuration and package (djar) information and click Next.
6. (Optional) Select Add Configuration macros to current workspace macrodef (recommended).
The final page of the Wizard provides an option to import the configuration macros into your active macro definition file. If selected, the new macro set will have the same name as the imported configuration. These macros can be edited locally (from the Macro Manager) to resolve within your desktop environment. This approach is advantageous as it allows for a copy of the configuration macros to be used while editing, or extending, your artifacts. When you’re ready to repackage and redeploy, you’ll have the option of merging the macros from the macro set back into the configuration macros. This is optional but useful if you’ve expanded or altered your map or process after importing it.
7. Click Finish.
A dialog will appear with a message stating the import is complete. You can view the import log file by clicking View Log. The log file will contain a detailed summary of each file that was imported.
Note: If the job configuration already exists in your workspace then a dialog appears asking, if you want to overwrite the existing project or create a new one with a different name.
8. Click Close.
A new project is created in your current workspace. This project will have the same name as your imported configuration. By default, the .jobconfig file will open in an editor.
The following is a sample image of an imported configuration folder structure:
Within this new project you will find:
• A folder titled Files, which contains the djars referenced inside your configuration.
• A folder named after the configuration. This folder contains:
– The DataConnect artifacts found inside the djar
– The configuration macros
– The .jobconfig file
• In the root of the parent folder, you’ll find the macro definition file that was added when the djar was originally created.
Note:
- All the files that were imported can now be opened and edited. The configuration details, files and configuration macros can be edited through the .jobconfig file (see Editing Configurations).
- After editing the configuration and artifacts, you can repackage and redeploy the configuration to Integration Manager (see Redeploying to Integration Manager).
- All the files that were imported can now be opened and edited. The configuration details, files and configuration macros can be edited through the .jobconfig file (see Editing Configurations).
- After editing the configuration and artifacts, you can repackage and redeploy the configuration to Integration Manager (see Redeploying to Integration Manager).
Last modified date: 07/26/2024