Post-installation jobs are process-oriented logicnets that the system runs after you install a published package. Such jobs can include performing actions like creating user groups, adding data to database tables, or performing a data migration task, for example.
When you install a package using the Package Installer the system searches for any post-installation jobs contained in the package and runs them accordingly. When you upgrade a package installation the system searches for all post-installation jobs in all installed packages and runs them in the order in which the packages were installed.
Identifying Post Installation Jobs
You must house post-installation jobs within a direct subfolder of the logicnets folder in the application. This folder is called postinstalljobs, and the system does not create this folder automatically. You must add it using the New Folder tool in the Project Explorer toolbar.
Creating Post-Installation Jobs
A post-installation job is a logicnet containing only processing and pathway nodes. It should not contain form or form-part nodes, because post-installation jobs run without any user interaction.
- Open the project in which you want to create your post-installation job.
- Navigate to the logicnets folder in the tree view and create a subfolder called postinstalljobs.
- In the this folder, create a logicnet for each job. Note: You can add multiple post-installation job logicnets to this folder, but each logicnet should be a separate, invokable job. The logicnet can reach out to logicnets outside of the postinstall subfolder, but the invoked logicnets themselves must be in the postinstalljobs subfolder.
- Model the postinstalljob logicnet to perform the processing you want it to do. Remember to use only process nodes and system-facing node types.
- When you have finished creating your logicnet publish the project -- only published projects can be installed and trigger post-installation jobs.