# Data Mapping cfxdm - dm:save

**dm:save:** This dm function allows the user to save the retrieved data from an extension's tag as a named dataset for later consumption.

**dm: save** synta&#x78;**:** Below arguments are supported.

* **name** (mandatory):  Name (unique) of the dataset to which data needs to be saved.
* **publish** (optional):  Name of the tag to ingest or publish into cfxDimensions platform. \
  \
  \&#xNAN;*Note: It can be used only with cfxDimensions platform configuration.*

{% hint style="info" %}
This extension tag is typically used along with **dm: recall**&#x20;
{% endhint %}

{% hint style="info" %}
To list the named datasets, use **dm: savedlist**
{% endhint %}

This section explains how users can use a CSV file loaded into a dataset. This saved dataset will be used to explain how the dm: head function can be used to check the head of the stored dataset.

{% hint style="info" %}
Download the [incidents.csv](https://macaw-amer.s3.amazonaws.com/rda/data/incidents.csv) file to the local machine as shown below using a standard web browser. &#x20;
{% endhint %}

### Example 1:

Default dm: save functionality is captured in this example.

Step 1:  Download 'incidents.csv' to the AIOps RDA environment as shown below from the local file system.

![Downloaded file on local filesystem](/files/-MbcPmsKgRqacQ_K6i0b)

Step &#x32;**:** Upload the file 'incidents.csv' to AIOps studio using file-browser (as shown below)

![Screenshot displays how to upload a file into AIOps Studio.](/files/-MbcQiEiFxhuzCwcyT76)

![](/files/-MbcRNIUtmLyJ08hPjZu)

Step &#x33;**:** Add a new empty pipeline with the name "**dm\_save\_example\_1**" as shown below and click the "Save" button (this step will create an empty pipeline and saves it to AIOps studio).

![Empty pipeline ](/files/-Mf4BUweXR8zq3VT6jIm)

Step 4: Add the following pipeline commands into the empty pipeline text field that you have created in above Step 3.

You can copy the below code into your pipeline and execute that in your environment.\
\&#xNAN;*`##### This pipeline loads incidents.csv file into AIOps Studio.`*                          \
*`##### AIOps studio stores the data loaded from incidents.csv file`*\
*`##### into local dataset named 'incident-summary'.`*\
*`##### prints the data that was stored`*\
*`@files:loadfile filename = "incidents.csv"`*\
*`--> @dm:save name = 'incidents-summary'`*\
*`--> *dm:filter *`*&#x20;

Step 5:  Check the data from incidents.csv by executing the pipeline and verifying using inspect data as shown below (screenshot -1 & screenshot-2)

![screenshot -1](/files/-MegL9NYruL-J6k495qk)

![screenshot -2](/files/-MegLgTFQxCVo-IS1Kqz)

Step 5:  Use dm: savedlist to check the logical datasets that were used to store the data using dm: save function as shown in the following screenshot.

You can copy the below code into your pipeline and execute that in your environment to verify that incidents-summary dataset is stored using the pipeline \
\
\&#xNAN;*`##### This pipeline loads incidents.csv file into AIOps Studio.`*                          \
*`##### AIOps studio stores the data loaded from incidents.csv file`*\
*`##### into local dataset named 'incident-summary'.`*\
*`##### prints the data that was stored`*\
*`@files:loadfile filename = "incidents.csv"`*\
*`--> @dm:save name = 'incidents-summary'`*\
\
*`--> @c:new-block`*\
*`--> *dm:savedlist`*<br>

![](/files/-Mf4uX1i7ulO37ATYXTt)

Step &#x36;**:** Click execute button and execute the pipeline. RDA will execute the pipeline without any errors (as shown below)

![](/files/-Mf4v0RByYIfwMj_eP8n)

Step 7: Verify that the incidents-summary dataset is part of the dm:savedlist call as shown in the below screenshot.

!['incident-summary' dataset is part of dm:savedlist  and is as shown above screenshot](/files/-Mf4v_tehqSTl2taanCz)


---

# Agent Instructions: 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:

```
GET https://docs.cloudfabrix.io/rda/rda-userguide/rda-aiops-studio/examples-jupyter/data-mapping-cfxdm-dm-save.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
