User Guide > Packaging and Deploying Integration Artifacts > Creating a Package (.djar File) When Compatibility Mode is Enabled
Was this helpful?
Creating a Package (.djar File) When Compatibility Mode is Enabled
To create a package when Compatibility Mode is enabled:
1. Select the project for which you want to create a package and do any of the following:
Go to File > New > Package.
Click the arrow in /download/attachments/24977198/ProjectExplorer_New_Icon.png?version=1&modificationDate=1489232659673&api=v2 and then click Package.
Right-click within Project Explorer and then click New > Package.
The New Package (Inventory File) window is displayed.
2. Select the parent folder where you want save the package inventory file.
3. In the Enter Package Name field, type a name for the package file and click Next.
The Select Entry Point and Security Options window is displayed.
4. Specify the following:
Choose Entry Point - Click Browse and specify the required process or map file. Initially, the selected process or map and any artifacts referenced by the entry point are added to the package.
v9 Compatible maps cannot be an entry point.
Expand macros in references when building package (recommended) - This option is always enabled for packaging in Compatibility Mode. Macros in referenced artifact paths are always expanded, ensuring a self-contained package for distribution and execution.
Include Macro Definition File - Select this option to include the macro definition file in the package and then select one of the following:
Include entire Workspace Macros - Includes the entire macro definition file associated with the workspace. This is selected by default.
Include only Configuration Macros - Includes the local macros and all the macros from the Configuration tab > Macros section for all the processes and referenced maps.
Note:  In case of duplicate macros, only the local macros configured in the process that is selected as an entry-point is added. For example, consider that there is a local macro named userName in .ip.xml file and another local macro with the same name but with a different value in .tf.xml file and this map is used within the .ip.xml (in a transformation step). When creating the inventory, if you select .ip.xml as entry-point, then the userName from .ip.xml is included in the configurationMacros.json file and not the macro from .tf.xml file.
5. Click Finish.
The package inventory file is created (with extension as .inv.xml) and it opens in the Package Manager Editor tab. It displays all the artifacts that are included in the package.
If you have selected the Include entire Workspace Macro option, then the MacroDefinition.json file is included in the package.
If you have selected the Include only Configuration Macro option, then a new {nameOfPackageEntryPoint)_macros.json file is created in the same location as the workspace macro definition file. This macro definition file includes only the configuration macros used by the entry point map or process. When it is packaged in the djar, this file name is changed to configurationMacros.json, which is required by Integration Manager.
The following information is displayed for the artifacts that are included in the package:
Main: The main artifact is selected by default. Select the required check box to specify another artifact as the main.
Type: Indicates the type of artifact (map, process, macro, map configuration, and so on.)
File: Displays the file name of the artifact that is included in the package.
Location: Displays the location of the artifact. If the artifact is located outside the workspace or if it contains a macro, then it displays the full path. If the artifact is in the same workspace, then it displays the path relative to the workspace.
Version: Displays the version number of the artifact.
Also, the .inv.xml file is available within the project folder.
Note:  The package inventory file is created relative to where the project is located.
6. To create a package, do the following:
Open the package inventory file (if it is closed).
Select the check box for the process artifact that you want to designate as the main process for the package.
Note:  By default, the main process for the package is already selected when creating the package inventory file.
Package Name displays the package name. It defaults to the name of the inventory file. You can change this name if required.
Package Version displays the version number of the package file. The default is 1.0. You can change this version number.
Click /download/attachments/24977198/Map_Mapping_AddField_Icon.png?version=1&modificationDate=1488156316129&api=v2 if you want to add files to the package. To remove a file, select the required file and click /download/attachments/24977198/Map_Mapping_DeleteField_Icon.png?version=1&modificationDate=1488156316176&api=v2.
7. Click Create Package.
The Package Creation Success dialog box displays a confirmation message and the folder where the .djar file is stored. The default location for the package is C:\Users\<<username>>\Actian\DataConnect\Packages. You can change this location in Options > Preferences > DataConnect > Package and Deploy.
When you run a .djar that contains a macro definition file, djengine does not automatically use this file. You must specify a macro file that is outside the .djar to use a macro definition file when you run a package.
Last modified date: 08/10/2022