Search results
Suggest a FeaturePDF

Dataset management in Report Server

You can create and store datasets on a Report Server that can be used by multiple reports. When you create or upload a dataset to the Report Server, it is considered a shared dataset and is always placed on the Dataset page. A shared dataset must be based on a shared data source. Datasets are accessible to users, depending on their permissions. This section explains dataset management in the Report Server. It allows you to create, edit, update, share permissions, and delete datasets in Bold Reports On-Premise. The following image shows the list of options available to manage a dataset.

Options available to manage data sets

Create dataset

A dataset can be created only if the user has Create All Datasets permission.

Steps to create a dataset

We can create datasets in the following ways:

  1. Add a dataset from the + icon.
  2. Add a dataset from the dataset listing page.

Add dataset from + icon

  • Click on the + button in the left side menu and choose Create Dataset to add a dataset. Create a dataset menu option

Add dataset from Dataset listing page

  • Click Dataset in the left side panel of the Report Server. If there are no datasets listed, click the Create my first Dataset button. Otherwise, click the Create Dataset button. Create a dataset menu option listing

  • A dataset requires a data source, which can be newly created or an existing data source. Please refer to this link for more information.

    Data source listing

    Read Write Delete permission for that Specific Dataset will be added for the user who created the dataset.

Add or upload dataset

  1. Click the + icon in the left side menu, choose Upload Dataset. Upload DataSet

  2. Enter the name and description of the dataset.

  3. Click Browse and select the .rsd file to upload. Auto-Filled Dataset Name

    If the name field is left blank, the system will auto-populate it with the name of the uploaded .rsd file.

  4. Select the Data Source. In the select data source dialog, you can either choose an data source from the Report Server or create a new data source. Select a data source for the uploaded dataset

  5. Click on the Save option, and the dataset will be uploaded to the Bold Reports On-Premise and displayed in the list as shown below. Added datasets list view

    Read, Write, and Delete permissions for that Specific Dataset will be granted to the user who created it.

Create report with dataset

To create a new report using the dataset, click the Actions button in the dataset grid context menu and select Create Reports. Create new report with dataset

Edit dataset

Click the Actions menu button in the dataset grid context menu and select Edit Dataset to edit a dataset. Edit dataset properties

Change data source

This section explains how to change the data source for a created dataset.

Steps to change data source

  1. Select the Change data source option from the dataset grid context menu to modify the data source. Click Change Datasource

  2. Enter the name of the dataset.

  3. Enable the Overwrite option to overwrite the existing dataset. Overwrite Dataset

  4. To change the existing data source, select the new datasource from the dropdown menu, then click the Save button. Click Save

Share dataset

This section explains how to share a dataset with other users on the Report Server.

Steps to share a dataset

  1. Click the Actions menu button in the dataset grid context menu and select the Sharing Permissions option. Manage dataset permission option

  2. Click the Manage Access button. Set permissions to share a dataset

  3. Select the permission access and the users or groups to share the dataset. Once selected, click the Add button. Add permission to dataset Add button

    Only users who have share permission can share the dataset with other Report Server users.

Remove dataset permission

The user with specific permissions can remove the shared dataset permissions by using the Remove option in the Access column. Remove Permission

Version history

Versions and file logs for each dataset are maintained in the Report Server, capturing every single change made to the dataset. To access this information, first click on the grid context menu. Then from the options that appear, select the Version History option. Version History Option

Versions

For each change in the .rsd file, a new version will be created, allowing all versions to be individually opened. Versions

File logs

File logs track each change made to the dataset, including alterations in the event, user, and date. File logs

Edit dataset as XML

This XML editor provides a user-friendly interface for you to make necessary modifications to the dataset in the Report Server. This means you can make necessary changes to the dataset without downloading it and using a separate text editor.

  1. Click the context menu icon in the dataset grid and select Edit As XML to edit a dataset. Edit dataset in XML

  2. The respective dataset will be opened in a new tab as XML, allowing you to make modifications, and you can save the edited dataset by publishing it from the XML editor. Edit dataset XML View

Update dataset

  1. Click the Actions menu button in the dataset grid context menu and select Update Dataset to update the Dataset. Update DataSet

  2. You can change the name, description and other required details of the dataset. After making these changes, click Update option in the update dataset dialog box.

    Select a data source for the uploaded dataset

Delete dataset

When datasets are no longer needed, they can be conveniently deleted from the Report Server.

To delete a Dataset, click the Actions menu button in the dataset grid context menu and then select the Delete option.

Delete Dataset

A dataset cannot be deleted if it is currently being used by any report.

REST API Reference

The following table illustrates the list of available APIs related to datasets in Bold Reports On-Premise.

Action HTTP Method Endpoint Description
AddDataset POST /api/site/{tenant-name}/v1.0/reports/datasets Adds a new dataset to the server. Dataset details must be passed as input.
UpdateDataset PUT /api/site/{tenant-name}/v1.0/reports/datasets Updates the dataset on the server. Updated dataset details must be passed as input.
GetDataSets GET /api/site/{tenant-name}/v1.0/items Returns the list of datasets for the current user. ItemType should be dataset.
GetDataSetLocation GET /api/site/{tenant-name}/v1.0/items/{itemId}/location Returns the item location of the specified dataset. A specific DataSet ID should be passed as a path parameter.
IsDataSetNameExists POST /api/site/{tenant-name}/v1.0/items/is-name-exists Returns an item's existence, whether the given dataset name already exists or not on the server. Dataset name and ItemType as DataSet should be passed in the request body.
GetDataSetDetail GET /api/site/{tenant-name}/v1.0/items/{id} Returns the specified dataset details from the server. The dataset item ID should be passed as a path parameter.
DeleteDataSet DELETE /api/site/{tenant-name}/v1.0/items/{id} Deletes the specified dataset from the server. DataSet item ID should be passed as a path parameter.