> For the complete documentation index, see [llms.txt](https://docs.sharelogic.com/unifi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sharelogic.com/unifi/4.2/configure/datasets/create-a-new-dataset.md).

# Create a New Dataset

Creating a new **Dataset** for exporting and importing data is a simple 3-step process.

1. Create a new **Dataset**
2. Configure the **Process Message**
3. Configure the **Send Message**
4. Setup an **export schedule**
5. **Build**

{% hint style="info" %}
Datasets require the [**Global Utility**](/unifi/4.2/install/installation/global-utility.md) in order for ServiceNow platform components to be created automatically.
{% endhint %}

## Create a New Dataset

1. Open **Integration Designer** and select or create an **Integration**.
2. From the main integration menu, select **Datasets**.
3. Click **New**.
4. Fill in the required information and choose your configuration.
5. Click **Submit and view**.

Creating a new Dataset will automatically configure several dependencies in your instance. These are:

* A Message called **Process\_\<table>**
* A Message called **Send\_\<table>**
* A **Scheduled Import Set** with the same name as the Dataset
* A **Transform Map**

{% hint style="info" %}
Once the Dataset has been created, data is configured using Messages, Fields and Field Maps.
{% endhint %}

## Configure Process Message

The Process Message handles the data mapping. Use the Fields list to configure which fields are being imported/exported.

1. From the **Dataset** details tab, navigate to the **Process message** and use the clickthrough button to open it.
2. From the Message, open the **Fields** list and add the fields that should be imported/exported. Each field will need to have a Dataset specific Field Map for transforming the data.
3. Ensure at least one field will **Coalesce** so the import can match to existing records.
4. Click **Build Message**.

{% hint style="info" %}
Field Maps designed for an eBonding integration may not work for Datasets. Use the included "Dataset..." Field Maps or create your own using these as an example.
{% endhint %}

## Configure Send Message

The Send Message handles the data to be imported or exported as an attachment.

The Path will need to be configured depending on where the data is being sent. If you are connecting to another ServiceNow instance using a ShareLogic endpoint, you will likely need to configure the Path to use the dataset web service at path "/dataset".

1. From the **Dataset** details tab, navigate to the **Send message** and use the clickthrough button to open it.
2. Open the **Outbound > Settings** page.
3. Configure the **Path** as required, e.g. **"/dataset"**.
4. Click **Save**.

## Setup an Export Schedule

Datasets have the same schedule logic as any other scheduled job and can be configured to export data whenever needed.

1. Open the **Dataset**.
2. Click **Scheduling** to open the scheduling tab.
3. Configure the desired schedule.
4. Click **Save**.

{% hint style="info" %}
Turning off the schedule will prevent data from being automatically exported.
{% endhint %}

## Build

Several important features are built into the integration build process for Datasets. Ensure you build the integration whenever you have finished adding or making major changes to a Dataset.

1. Scheduled Import Sets are created and updated.
2. Transform Maps are created and updated.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sharelogic.com/unifi/4.2/configure/datasets/create-a-new-dataset.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.