Export
On this page you will learn how to perform the Export operation, the first step of Import / Export: select Repository Model items or Roles in a source instance and send them to a file or to an External Instance.
Important
The Import / Export feature is disabled in Nodinite 7.0 and may return in a future version. This page describes it as it worked in earlier versions; use the Web API to move data between instances for now.
Step 1: Start Export operation
In earlier versions, you started the Export operation from the Import / Export item in the Tools menu or on the Tools card of the Administration overview. In Nodinite 7.x the feature is disabled, and neither link is shown.
Click the Export tab and then click on the type of item that you would like to export. In this guide we will select an Integration since this is the top level object in the Repository Model and all related child objects will also be included in the export by default.
Pick the item type to start from; Integrations bring their related child items along.
A Nodinite administrator can also initiate the Export from the Actions button where applicable:
Starting the export from an Integration preselects it in the tree.
Step 2: Select item(s) to export
In the tree, select the items to be exported. Whenever you check a leaf in the tree, Nodinite will check any dependencies and add related items as necessary
Select items for export
When you check a leaf, all dependencies are checked and added to the list by the system. A modal is presented while this operation is in progress. Depending on what level in the tree you checked, this operation may take anywhere between a few seconds and more. You should not export the whole Repository Model in one single operation. The Import / Export feature was built to manage a few (<100) at a time.
Checking a high level in the tree can take a while, because every dependency is resolved.
Once you are happy with the selected items to export, click on the Next button to proceed to the next step.
Next moves on to the export method.
Step 3: Export method
The output from the Export operation can be sent either:
Once you are happy with the choice of Export method, click on the Next button to proceed to the next step.
Next moves on to the confirmation step.
File
For environments where direct communication is not allowed or available. This option is usually selected for customers with Nodinite in different WLAN (zones) or where production and test environments have different Active Directory associations.
If you select to perform a file based Export, an Export file in JSON format is downloaded with your browser. Copy/Move this file to the target environment and proceed with the Upload operation in order to be able to Import the export data.
The file route works between environments that can't reach each other.
Note
The file option, opens a pop-up window for the file being created, that operation might be blocked depending on the browser settings. allow browser pop-ups
If you do not like the default file name (export_{CustomerName}_{EnvironmentName}_{Timestamp}.json), then you can provide your own name. Check the Use custom filename checkbox and enter a (valid) file name:
Override the default export file name when you keep several exports side by side.
External Instance
If you export directly to another Nodinite instance, then you will not need to Upload the file (the other previous export option method).
This option uses the Nodinite Web API and requires that External Instances have been pre-configured.
From the list of External Instances, select target Nodinite instance for the export operation.
Only instances registered under Settings › External Instances appear here.
The target instance must be online and accessible
The current Windows user in the Web Client must be a Nodinite administrator on both Nodinite instances
Step 4: Confirm Export
The final step before performing the actual export, you are given an option to describe the export (ultimately an Import module). This information may be helpful when you later eventually manage the list of Import modules, review the Import user guide for additional information.
The description follows the export and appears in the Import Module list on the target.
Click the Start Export button to proceed, or click the No button to exit the confirm export modal.
No closes the dialog without exporting.
Step 5: Finish
If the Export succeeds, you are presented with the following alert.
After a file export, continue with Upload on the target instance.
Errors are presented in the browser. The most common problems are related to direct transfers between Nodinite instances, either due to network or access related problems.