Entities may be exported from any account either individually or as a deep export of everything required to support the entity (e.g. all item referenced by a menu and all DSDs referenced by all of those items).

The Entity Imports option shows a list of the import files previously uploaded and whether they have been imported into your account. Click on an import, or “Upload Import” to add a new import file.

In this example an fPanels dashboard has been deep exported. It requires the dashboard and a DSD (which are present from a previous version of the export package) and an associated colour gradient (that could not be exported as it was a globally available item). In addition a source is required; these are not exported for security reasons. Finally an fMaps features file is required; these can be exported separately and so is referenced here but not included in the file.

The list to the right is a legend indicating all of the statuses of items required by the import. Some require actions, some may be actioned if required and some are for information. Click on any item in the tags on the left to open the action form.

The Action Required options will differ depending on the item selected. The full set of options is:

• Retain a previously imported item in the same package and version
• New version:
  • Update a previously imported item in the same package but different version (if entity included)
  • Use the existing reference (if only referenced in the export)
• Ignore this item - do not import
• Use the matched item (when an item was found by matching aliases)
• Find an item to use (a search form will be opened for you to locate an existing item of the appropriate type to use as this item)
• Make a new item (use the imported version)
• Replace the current item (with the imported item)

For example, for entities that were not mapped you can ignore it completely, find an existing entity to be used as the one required, or make a new item.

You can save your chosen actions as you work, even returning later to complete the mapping (possibly after adding items such as sources which cannot be imported).

Once you have completed all of the required mappings (all items in all tabs have been changed from red status) click Import to begin the process. Depending on the size of the import file this may take some time.

The import file cannot be re-imported but remains in the list for information. You can delete import files at any time.