User Guide : Packaging and Deploying Integration Artifacts : Creating a Package (.djar File) When Compatibility Mode is Disabled
Share this page             
Creating a Package (.djar File) When Compatibility Mode is Disabled
To create a package when Compatibility Mode is disabled
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 Options window is displayed.
4. Specify the following:
Choose Runtime Configuration - Click Browse and specify the required runtime configuration file (.process.rtc or .map.rtc).
Expand macros in references when building package (recommended) - Select this option to expand macros while packaging. Macros in referenced artifact paths are 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.
Include Global Macros: If you select the Include only Configuration Macros option, it enables selection of the Include Global Macros option. This option allows you to include the global macros from the workspace macro definition file.
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 .process.rtc file and another local macro with the same name but with a different value in .map.rtc file and this map is used within the .process.rtc (in a transformation step). When creating the inventory, if you select .process.rtc as entry-point, then the userName from .process.rtc is included in the configurationMacros.json file and not the macro from .map.rtc 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.
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.
Package Inventory Changes Pop-up Message
The Package Inventory Changes warning message is displayed or not displayed based on the following conditions:
If package has extra files and there are other changes, the warning message is displayed and the version number for the artifacts is incremented.
If there are additional files in package and no other changes have occurred, the warning message is not displayed and the version number for artifacts is not incremented.