Integration mit C#
Allgemeine Informationen
Die folgende Integration findet per Visual Studio statt.
Sie brauchen zwei "NuGet" Pakete um Data Quality Express unter C# benutzen zu können.
In zwei Schritten gelangen Sie zu einer erfolgreichen Verbindung mit dem Data Quality Express unter C#.
Schritt 1: NuGet - Pakete installieren
Sie benötigen die "NuGet" Pakete → "Newtonsoft.Json" und "RestSharp".
Öffnen Sie Visual Studio und starten Sie ein Projekt.
Im folgenden Popup-Fenster wählen Sie die Option "NuGet-Pakete für ProjektMappe verwalten".
Es erscheint nun das Dialog "NuGet - Projektmappe".
Sie sehen eine Suchleiste, dort schreiben Sie "Newtonsoft" hinein.
Nachdem Sie das "NuGet" Paket "Newtonsoft.Json" ausgewählt haben, sehen Sie rechts folgendes Fenster
Wählen Sie Ihren Projekt aus und drücken Sie danach auf "Installieren".
Damit haben Sie das erste Paket installiert, dass Sie benötigen um die Empfangenen Daten verarbeiten zu können.
Das gleiche machen Sie nun mit dem NuGet-Paket "RestSharp".
Schritt 2: Verbindung zum DQ Express
Sie haben nun die zwei "NuGet" Pakete Ihrem Projekt als Verweis hinzugefügt.
Damit Sie diese Pakete in Ihrem Programmcode verwenden können, müssen Sie folgenden Schritte ausführen.
Öffnen Sie die Klasse, in der Sie Data Quality Express ansprechen möchten.
Jetzt fügen Sie ganz oben bei den "using"s folgendes ein.
using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using RestSharp;
Um später die Module benutzen zu können, werden Sie sich authentifizieren müssen. (Welche Module gibt es?)
Implementieren Sie den folgenden Programmcode, damit Sie einen RestRequest an den Data Quality Express senden können.
RestClient client = new RestClient("https://api.data-quality-express.de/connect/token");
RestRequest request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/x-www-form-urlencoded");
request.AddParameter("undefined", "grant_type=password" +
"&scope=offline_access Omikron.DataQuality.Express.CustomerService.Api" +
"&client_id=Omikron.DataQuality.Express.CustomerService.Client" +
"&client_secret=bcb796d2-4dc7-4aac-97d1-4f186764ef0e" +
"&username=<Benutzername>" +
"&password=<Passwort>"
, ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
object JsonResult = JsonConvert.DeserializeObject(response.Content);
Vergessen Sie nicht, dass Sie bei <Benutzername> und <Passwort> die Daten angeben müssen, die Sie von uns erhalten haben.
Sie haben erfolgreich eine Verbindung zum Data Quality Express hergestellt.
Wie Sie die einzelnen Module ansprechen, finden Sie unter: Codebeispiele
Was die einzelnen Module bewirken, finden Sie unter: Module