DataRestorationTool 1.2023.10.25

.NET Framework 4.8 This package targets .NET Framework 4.8. The package is compatible with this framework or higher. 
dotnet add package DataRestorationTool --version 1.2023.10.25
                    


                    

                
NuGet\Install-Package DataRestorationTool -Version 1.2023.10.25
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="DataRestorationTool" Version="1.2023.10.25" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="DataRestorationTool" Version="1.2023.10.25" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="DataRestorationTool" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add DataRestorationTool --version 1.2023.10.25
                    


                    

                
#r "nuget: DataRestorationTool, 1.2023.10.25"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package DataRestorationTool@1.2023.10.25
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=DataRestorationTool&version=1.2023.10.25
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=DataRestorationTool&version=1.2023.10.25
                    


                            Install as a Cake Tool

Data Restoration Tool

The purpose of this tool is to be able to restore deleted Dataverse data. The tool will only list the tables that have auditing enabled and show records that are eligible to be restored.

Prerequisite

To be able to work with this tool, make sure that the table you want to restore records for has auditing enabled! For more information on auditing in Dataverse, visit https://learn.microsoft.com/en-us/power-platform/admin/manage-dataverse-auditing.

How to use the tool

When loading in the tool, make sure you are connected to a Dataverse environment. Once you are connected, the tables that have auditing enabled will be loaded in the "Select Table" dropdown.

Proceed by selecting the desired table and Date Range to load the deleted records from and press the "Load Deleted Records" button. The first grid will be filled with the Audit Items regarding the deleted records. Clicking on the record name (Record column) will display additional information for this record in the right grid. This contains a detailed view on what the data for this specific record looked like.

Select the records you want to restore by checking them in the first column. From the moment you have atleast one record selected you will be able to Restore these records by clicking the "Resotre Selected Data" button.

Note that there are options available under the Advanced Settings.

  • ByPass Custom Plugin Execution - With this option enabled the requests will ignore any custom made plugins allowing for faster insertion of the data and also avoiding any unwanted data modification due to custom plugins (This does not include standard Microsoft plugins!)
  • Bypass Power Automate Flow - With this option enabled the requests will ignore any Power Automate Flow triggers in the background. This refers to Power Automate flows that trigger on record create of the selected table.
  • Reuse deleted GUID - with this option enabled, the requests will use the GUID from the deleted record, making the restoration of any past references possible. This provides more data consistency. Disable this option if you want to iniate a Create request with a new, Dynamics generated GUID.
  • Continue on error - With this option enabled the restoration of multiple records will not stop after an error has occured. Instead it will write the errors to the Log File which can be reviewed later. With the option disabled, once an error has been encoutnered, this error will be reported directly and further records will not be restored.

For more information on these settings please visit: https://learn.microsoft.com/en-us/power-apps/developer/data-platform/bypass-custom-business-logic?tabs=sdk

Product Compatible and additional computed target framework versions.
.NET Framework net48 is compatible.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.2023.10.25 9,908 10/25/2023
1.2023.8.10 1,813 8/10/2023
1.2023.8.4 721 8/2/2023
1.2023.8.3 561 8/1/2023
1.2023.8.2 556 8/1/2023

V1.2023.10.25
- General UI improvements

V1.2023.8.10
- Implemented Advanced Settings Tooltips.
- Implemented Load All Data Button which disregards the selected Date Range.
- Fixed an issue with empty records names which did not allow to view the details of the record.
- Added more feedback to the users when loading in data or restoring data.

V1.2023.8.4
- Added (De)Select All buttons
- Added additional advanced settings
- Implemented better handling of exceptions when restoring data
- Added Settings implementation to save Advanced Configuration