> ## Documentation Index
> Fetch the complete documentation index at: https://insightsoftware.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Import or Export Sources

> Describes how to import or export a data source.

You can import or export one or more sources in JSON format, including related connection information. When you import visuals or dashboards, their sources are also imported; this process allows you to import only sources and related connections.

<Note>
  Special characters are not supported for import or export. If the name of a source contains special characters, change that name before continuing.
</Note>

All users can view the **Sources** page.

* To import sources, you must log in as a user who belongs to a group with the **Create New Data Sources** or **Administer Sources** [privilege](/simba-embedded-analytics/docs/self-service-analytics/26.3/administer/users/aaa-ov#group-privilege-reference) as well as the **Manage Connections** privilege.

* To export sources, you must log in as a user who has **read** [permissions](/simba-embedded-analytics/docs/self-service-analytics/26.3/connect-to-data/sources/ds-permissions) for the sources and associated connection or connections.

* If you're importing and exporting a source using the import export API, you can define and use a unique key to identify the source.

  API documentation is provided in your environment at this link: `https://<Self-Service Analytics-URL>/composer/swagger-ui.html`.

<Note>
  In this release, when your admin enables the Enhanced Experience user interface, you will see changes to workflows you may have used in previous releases.
</Note>

### Import

**Import one or more sources**

1. Log in as a user with the **Manage Connections** privilege and the**Create New Data Sources** or **Administer Sources** [privilege](/simba-embedded-analytics/docs/self-service-analytics/26.3/administer/users/aaa-ov#group-privilege-reference). If you are logged in as a tenant admin, verify you're in or switch to the appropriate tenant.

2. Select the **Sources** card on your home page or **Data Sources** from the main menu. The Sources work area opens.

3. Select **Import Source** in the Sources work area. The Import Source dialog opens.

4. Browse to and choose the `json` file for the sources you want to import, then select **Open**.

   The Import Sources dialog populates with information about the objects that make up your sources and the settings you can use to define how your software inserts each object.

   <img src="https://mintcdn.com/insightsoftware/GTXU--ZlYc3DodOR/simba-embedded-analytics/docs/self-service-analytics/26.3/images/datasources/cmp-source-import-24-2.png?fit=max&auto=format&n=GTXU--ZlYc3DodOR&q=85&s=d0e83dfbe1e2039d2d98cf45e34e2716" alt="Use this work are to define what JSON file to import, for which tenants, using what insertion strategies, tags, and access" width="648" height="642" data-path="simba-embedded-analytics/docs/self-service-analytics/26.3/images/datasources/cmp-source-import-24-2.png" />

5. Add and remove tenants by selecting the **Tenants** field. Add or remove them from the list or field.

   <Note>
     Only system admins or members of the Content Distributors group see the Tenants field. If this field is not shown, the content is imported into the tenant you are currently working in.
   </Note>

6. Optionally, enable or disable **Ignore Warnings**.

   When you enable **Ignore Warnings**, a Tags field is added to the Import work area. Add or create tags to apply to objects that do not import cleanly.

   * If errors occur during import, your software adds the tags you select to the affected objects.
   * Use the tags to find objects you need to fix.

   <Note>
     When you enable Ignore Warnings, items that can be imported with warnings are imported and tagged. Use these tags to find and fix the warnings in tagged objects. When disabled, no objects are imported, and errors are returned to aid in troubleshooting.
   </Note>

7. Select an **Insertion Strategy** for each group of objects.

   <Note>
     The groups of objects varies based on what objects are in your JSON file.
   </Note>

   * **Always create objects**: Select to create an object every time, even if an existing object exists with the same name or unique ID. The object is created, appended with a date and time to the name, and assigned a unique ID.
   * **Reuse existing objects**: Select to create an object if no object with the same name exists. If an object with the same name or unique ID exists, the original object is reused.
   * **Update existing objects**: Select to update (overwrite) an existing object with the same name or unique ID. If an object with the same name does not exist, an object is created.

8. Use the default **Matching Strategy** or select the appropriate strategies for your sources in the order you want the strategies to be processed. See [Matching Strategies](#matching-strategies).

9. Enable **Share Default Access With All Users** to immediately give your users access to the items you import.

10. After you have confirmed your choices, select **Import**. The visuals are imported and a success message is returned if objects import successfully or with accepted warnings. Any items imported with warnings have your selected tags applied

<Note>
  If you import an exported source that has an associated translation file, you must re-upload the translation for that source.
</Note>

<h4 id="matching-strategies">
  Matching Strategies
</h4>

When you import objects into Self-Service Analytics, combine these matching strategies with your selected insertion strategies to meet your organization's needs. The strategies are applied in the order you select. When you create new objects, matching strategies are not used.

##### Sources

| Strategy     | Notes                                                          |
| ------------ | -------------------------------------------------------------- |
| By Name      | The default strategy used if no other strategies are selected. |
| By Origin ID |                                                                |

##### Connections

| Strategy                    | Notes                                                                                                                     |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| By Id, Type, and Parameters | A default strategy used if no other strategies are selected. Used with **By Type and Parameters** if it's not deselected. |
| By Type and Parameters      | A default strategy used if no other strategies are selected. Used with **By Id, Type, and Parameters**.                   |
| By Name                     |                                                                                                                           |
| By Name and Type            |                                                                                                                           |
| By Origin ID                |                                                                                                                           |
| By Type and Parameter Keys  |                                                                                                                           |

### Export

**Export one or more sources**

1. Log in a user who has **read** [permissions](/simba-embedded-analytics/docs/self-service-analytics/26.3/connect-to-data/sources/ds-permissions) and the **Manage Connections** privilege for the sources you want to export.
2. Navigate to the Source Library work area.
3. Select to export one or more sources by selecting the checkbox for a source to export. The **Export Selected Items** button becomes active.
4. Select **Export Selected Items**.
5. Your source is prepared in JSON format and downloaded by your browser.

**Export a single source from the library**

1. Log in a user who has **read** [permissions](/simba-embedded-analytics/docs/self-service-analytics/26.3/connect-to-data/sources/ds-permissions) and the **Manage Connections** privilege for the sources you want to export.
2. Navigate to the Source Library work area, locate a data source, then select the more menu icon.
3. A menu opens with the options **Available Visual Types** and **Export Source**. Select **Export Source**.
4. Your source is prepared in JSON format and downloaded by your browser.

**Export a single source**

1. Log in a user who has **read** [permissions](/simba-embedded-analytics/docs/self-service-analytics/26.3/connect-to-data/sources/ds-permissions) and the **Manage Connections** privilege for the sources you want to export.
2. Open the source you want to export. If you edit the data source, you must save your changes to make the **Export Source** icon available.
3. Select **Export Source**.
4. Your source is prepared in JSON format and downloaded by your browser.
