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.
A dataset can be created only if the user has Create All Datasets
permission.
We can create datasets in the following ways:
+
icon.+
icon+
button in the left side menu and choose Create Dataset
to add a dataset.
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.
A dataset requires a data source, which can be newly created or an existing data source. Please refer to this link for more information.
Read Write Delete
permission for thatSpecific Dataset
will be added for the user who created the dataset.
Click the +
icon in the left side menu, choose Upload Dataset
.
Enter the name and description of the dataset.
Click Browse
and select the .rsd
file to upload.
If the name field is left blank, the system will auto-populate it with the name of the uploaded
.rsd
file.
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.
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.
Read, Write, and Delete
permissions for thatSpecific Dataset
will be granted to the user who created it.
To create a new report using the dataset, click the Actions
button in the dataset grid context menu and select Create Reports
.
To create a new report part using dataset, click the Actions
button in the dataset grid context menu and select Create Report Part
.
Click the Actions
menu button in the dataset grid context menu and select Edit Dataset
to edit a dataset.
This section explains how to change the data source for a created dataset.
Select the Change data source
option from the dataset grid context menu to modify the data source.
Enter the name of the dataset.
Enable the Overwrite option to overwrite the existing dataset.
To change the existing data source, select the new datasource from the dropdown menu, then click the Save
button.
This section explains how to share a dataset with other users on the Report Server.
Click the Actions
menu button in the dataset grid context menu and select the Sharing Permissions
option.
Click the Manage Access
button.
Select the permission access and the users or groups to share the dataset. Once selected, click the Add
button.
Only users who have share permission can share the dataset with other Report Server users.
The user with specific permissions can remove the shared dataset permissions by using the Remove
option in the Access
column.
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.
For each change in the .rsd
file, a new version will be created, allowing all versions to be individually opened.
File logs track each change made to the dataset, including alterations in the event, user, and date.
Click the Actions menu button in the Dataset grid context menu and select Info
.
The Dataset info action provides information about the Dataset Id, Created by, Created on, Last modified by, Last modified on, and Linked Reports.
Click Show
to view the linked reports.
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.
Click the context menu icon in the dataset grid and select Edit As XML
to edit a dataset.
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.
Click the Actions
menu button in the dataset grid context menu and select Update Dataset
to update the Dataset.
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.
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.
A dataset cannot be deleted if it is currently being used by any report.
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. |