Troubleshooting – Skyline DataMiner SDK

Below you can find troubleshooting procedures for some common issues encountered with the Skyline DataMiner SDK.

If you have followed the procedures below, but the issue you have encountered persists, please contact tech support.

Missing DataMiner project templates

If the DataMiner project templates are missing in Visual Studio:

Ensure you are using Visual Studio 2022 or higher.
Check if the templates are installed by running the following command in the command line:
```
dotnet new uninstall
```
You should see Skyline.DataMiner.VisualStudioTemplates version 2.0.3 or higher listed.
If this is not listed, install the templates using one of the following methods:
- Install via CLI:
```
dotnet new install skyline.dataminer.visualstudiotemplates
```
- Install or update DataMiner Integration Studio (DIS) via the Visual Studio Marketplace and restart Visual Studio.

.NET SDK not found error

The DataMiner SDK depends on the .NET SDK.

If you encounter an error stating that no .NET SDKs were found, install the required SDK as follows:

winget install Microsoft.DotNet.SDK.8

Unable to find Skyline.DataMiner.Sdk in Visual Studio

Visual Studio has to retrieve the SDK from nuget.org, so verify if this is configured as a NuGet source by running the following command:
```
dotnet nuget list source
```
The following source should be listed:
```
nuget.org [Enabled]
```

If it is missing, add it as follows:

dotnet nuget add source https://api.nuget.org/v3/index.json -n "nuget.org"

Alternatively, if it is not missing, make sure your NuGet configuration is not blocking access because of package source mapping:
1. Open Visual Studio 2022.
2. Navigate to Options > NuGet Package Manager > Package Source Mapping.
3. Ensure that Skyline.DataMiner.Sdk is not blocked from accessing nuget.org.

If the issue still persists, manually download the SDK using the following command:

dotnet tool install --global Skyline.DataMiner.Sdk.Download
dataminer-sdk-download

The Manage User Secrets option is part of the ASP.NET and web development workflow. You can enable it as follows:

Open the Visual Studio Installer.
Select Modify for Visual Studio 2022 or higher.
Enable the ASP.NET and web development workload.

DotNet publish succeeds but item is not visible in the Catalog

Check whether you are viewing the correct organization in the Catalog, as items are by default published as private.
Check whether your .csproj file contains the following property:
```
<GenerateDataMinerPackage>True</GenerateDataMinerPackage>
```
If this property is missing or set to false, publishing will "succeed" without actually uploading a DataMiner package to the Catalog.

DotNet publish succeeds but the new version is not visible

Ensure the version number is updated before publishing:

Check the Visual Studio Project (.csproj file).
If you are using custom CI/CD, update the version via CLI arguments.

Note

If an existing version is uploaded, only the metadata and README are updated. The previously released version itself cannot be overwritten.

DIS publish or other features are not working with new projects

This issue is often caused by an outdated or misaligned DIS or SDK version. To resolve this, check the DIS and SDK version alignment:

Check Visual Studio Notifications for a new DIS version and update if available.
Verify the installed SDK version:
1. Locate global.json in your solution directory.
2. Compare the version with the latest stable release on NuGet.
  
  Example global.json file:
```
{
   "msbuild-sdks": {
      "Skyline.DataMiner.Sdk": "1.1.0"
   }
}
```
  The version must be the latest stable release (i.e. without "*-abc" suffix).

Table of Contents