Import and Export Apps
NIM Apps · Administration
Import an App from a JSON file or export an existing App to reuse its configuration in another NIM environment.
App import and export let you reuse Apps from the Tools4ever NIM GitHub organization or transfer Apps you have created or modified. Imports use an App .json file and include a review of related resources, such as systems, tables, filters, and audit queries.
Import an AppDirect link to Import an App
Have the App's .json file ready before starting. To follow the example shown below, use the AD User Correlation App.
Open App importDirect link to Open App import
- In NIM Studio, go to Configuration → Apps.
- Select Import in the upper-right corner.
- Select Upload, then choose the App's
.jsonfile.
Review the App's dependenciesDirect link to Review the App's dependencies
After uploading the file, review the related resources shown for the App. The resource list depends on the App's design.
- OK indicates that the required resource is available.
- Action required identifies a resource that is missing or not configured.
- Use the available action to create a related resource, such as Add filter or Create query. Resolve any remaining dependencies in the destination environment.
Verify the imported configurationDirect link to Verify the imported configuration
Open the imported App in the Designer. Check that its related resources match the destination environment, then test the forms and actions in Run mode with safe data.
Review App access before making it available to users. Importing the configuration does not replace testing the App's behavior and permissions in its new environment.
Export an AppDirect link to Export an App
Selecting Exportable prompts you to delete the App's reconfiguration information, such as permission assignments. Preserve any settings you need before confirming. For a configuration backup before this change, use NIM repositories.
Mark the App as exportableDirect link to Mark the App as exportable
- Go to Configuration → Apps and find the App.
- Select its Exportable checkbox.
- Review the confirmation that this will delete App reconfiguration information. Select Yes to continue, or No to cancel.
Export the App fileDirect link to Export the App file
Once the App is marked exportable, select its Export button in the Actions column on the right side of the App list.
NIM exports the App as a .json file. Save it for reuse or import it into the destination NIM environment using the import steps above.
For ongoing changes to an App's name, settings, and design, see Manage Apps.