---
title: "Import and Export"
slug: "v4importandexport"
updated: 2024-08-20T05:01:07Z
published: 2024-08-20T05:01:07Z
excludeFromSearch: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.12dsynergy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Import and Export

Import and Export is a useful tool to export data from a 12d Synergy Instance to be imported again at a later date or location.

This is most typically used if you need to export data or configuration from one instance and merge it into another.

This is different to a migration - a migration is often used when an entire server needs to be moved.

Import and Export can be used to merge data, as a one-off operation.

## **What is included?**

The import and export tool includes, by default, the following

1. Job structure
2. Relevant job and folder rules, meta data and configuration
  1. Teams
  2. Attributes
  3. Naming Rules
  4. Folder Layouts
  5. Dashboard configuration
  6. Issue Types
  7. Associations
  8. Notes
  9. Permissions
3. Tasks
4. Relevant file information including
  1. Content (and all versions if required)
  2. Attributes
  3. Change records (who changed it, and when)
  4. Permissions
5. 12d Model projects and relevant meta data including
  1. Attributes
  2. Default rules

The package tool will automatically collect groups, contacts and attributes used to add them to the target system as required.

## What can be configured?

Most options can be turned on or off, if you don't want to include particular pieces of data.

For example, you may not want to include permissions, or teams.

You may also want to export system level rules that aren't collected as part of a job, such as Permission Sets, or Categories.

You can also preview and choose which data to import from a particular package.

This will be discussed in details below.

## Exporting Data

An export package is created via the 12d Synergy Administrator. You currently need a license for this process - should you wish a license, please contact your Account Manager.

To create an export package,

1. Open the 12d Synergy Administrator and Connect
2. Go to the Import/Export node on the tree
3. Select the Export tab

You now need to decide what to export - are you exporting jobs, or system level configuration, or both?

### Adding Jobs to Export

You can add one or more jobs to export, or pick All Jobs, using the Jobs tab. If you are picking individual jobs, you can exclude any relevant sub jobs or folders you don't want to include.

You don't need to pick any contacts or attributes to include from your global configuration - if they are used by any of the jobs selected above, they will automatically be added.

![](https://cdn.document360.io/36833d89-59e3-46a5-b491-e9aa1b524a85/Images/Documentation/image-1695217387249.png)

### **Defining Configuration and Rules**

You may wish to export configuration additional to your jobs, or you may only wish to export configuration, such as Job Templates.

This can be achieved via the Config and Rules tab.

![](https://cdn.document360.io/36833d89-59e3-46a5-b491-e9aa1b524a85/Images/Documentation/image-1695217664213.png)

### Export Parameters

Export Parameters allow you to determine additional rules around what to include.

For example, you may not wish to package permissions, if the people involved in operations will not be Users in the target system, or the groups are not relevant.

You can also choose to not include all versions of every file, if that is not required.

![](https://cdn.document360.io/36833d89-59e3-46a5-b491-e9aa1b524a85/Images/Documentation/image-1695217697837.png)

#### Job Parameters

| **Name** | **Description** |
| --- | --- |
| Package permissions | Whether or not to include job level permissions for users, groups and teams in the package |
| Package file change attribute settings | Whether or not to include job level file change attribute rules in the package |
| Package file attribute settings | Whether or not to include job level file attribute rules in the package |
| Package forums | Whether or not to include job forums and content in the package |
| Package file naming settings | Whether or not to include job level file naming rules in the package |
| Package notification settings | Whether or not to include job level notification subscriptions in the package |
| Package tasks | Whether or not to include tasks in the package |
| Package notes | Whether or not to include job level notes in the package |
| Package issues | Whether or not to include issues and issue set types in the package |
| Package team | Whether or not to include the job team and role assignments in the package |
| Package associations | Whether or not to include job level associations in the package |

#### Folder Parameters

| **Name** | **Description** |
| --- | --- |
| Package permissions | Whether or not to include folder level permissions for users, groups and teams in the package |
| Package file change settings | Whether or not to include folder level file change rules in the package |
| Package file settings | Whether or not to include folder level file rules in the package |
| Package file naming settings | Whether or not to include folder level file naming rules in the package |
| Package notification settings | Whether or not to include folder level notification subscriptions in the package |
| Package notes | Whether or not to include folder notes in the package |
| Package folder layouts | Whether or not to include folder layouts in the package |
| Package files | Whether or not to include files in the package |
| Package folder associations | Whether or not to include folder associations in the package |
| Package last version only | Whether or not to only package the last file version - false by default |

#### 12d Model Parameters

| **Name** | **Description** |
| --- | --- |
| Package permissions | Whether or not to include 12d Model level permissions for users, groups and teams in the package |
| Package notes | Whether or not to include 12d Model notes in the package |
| Package notifications | Whether or not to include 12d Model notification subscriptions in the package |
| Package associations | Whether or not to include 12d model associations in the package |

### Important Notes

#### Linked Files

In order to package linked files, the source of the link must be included in the package.

If it is not, the file will be packaged as its own file and not a link.

### Missing Files

In some cases, virus scanners have been known to remove previous versions due to false positives.

If this has happened, and all file versions are required, the packaging process will stop.

To prevent this from happening, it is advisable to turn on a custom setting that allows it to be less rigid and skip missing versions.

To turn this on, follow these steps:

1. Go to System Settings in the 12d Synergy Administrator
2. Go to Custom Settings
3. Add a new setting named: **SkipMissingFilesInPackage** and set its value to 1

### Packaging Time

Packaging can take some time, depending on the amount of data. You should expect at least several hours.

It is advisable to do a test run before any export to understand how long this process will take.

## Importing Data

Importing data requires a package previously exported from the Export tool above.

### Adding a Package to be Imported

Before you can import a package, you must add it to the system so it can be properly referenced and validated.

To add a package,

1. Open the 12d Synergy Administrator
2. Go to the Import/Export node
3. Select the Import Tab
4. Click +
5. Enter an appropriate name for your package
6. You must then choose where your package lives
  1. Is it on your local hard drive only
  2. Is it accessible by the server, such as a network drive

Uploading a large package can take time - if it is already accessible by the server, use Server accessible location - but make sure to use a valid network path.

Be aware that whichever option you pick, it will still be copied into the servers General Store.

It can be deleted once the import is completed.

![](https://cdn.document360.io/36833d89-59e3-46a5-b491-e9aa1b524a85/Images/Documentation/image-1695228265551.png)

When you are ready, click Import.

You can choose to import jobs at the top level, or below another job.

### Import Time

It is important to note that importing can take a very long time. This is also an onerous process that may consume server resources - where possible, this should be run out of hours to avoid contention.