Installation
Dieser Artikel erklärt Dir die Installation des Windows-Dienstes nexcore.CONNECT.
Der Dienst ermöglicht den automatischen Datenaustausch zwischen nexcore und externen Systemen (z. B. AFD) und wird auf einem Windows-Server oder PC ausgeführt.
Vorbereitung
Vor der Installation solltest Du sicherstellen, dass die folgenden Voraussetzungen erfüllt sind:
Windows-Version
Windows Server 2019 oder neuer
Administrationsrechte
Für die Installation und Dienstverwaltung sind Administrationsrechte erforderlich
Netzwerkzugriff
Stabile Verbindung zu https://api.nexcore.app notwendig
Datenverzeichnis
Das externe System (z. B. AFD) muss lokal oder über einen UNC-Pfad erreichbar sein
Installationsdatei
Die aktuelle Installationsdatei (Download)
API-Key
Erstelle einen API-Key in nexcore, der für den Uploader-Dienst verwendet wird (siehe nächste Abschnitt)
API-Key erstellen
nexcore.CONNECT benötigt zur Authentifizierung mit nexcore einen API-Key, diesen kannst Du in den Einstellungen von nexcore unter Developer im Reiter API erstellen:
Mit einem Klick auf den Button "+ API-Key erstellen" öffnet sich ein Dialog in welchem Du einen Kommentar zur späteren Zuordnung der Verwendung des Keys eingeben musst.
Der API-Key wird nur einmal angezeigt! Kopiere und notiere Dir die API Key-ID und den API Key für die weitere Verwendung (beide Elemente werden für die Installation von nexcore.CONNECT oder die Einrichtung einer API-Verbindung benötigt)
Der nun erstellte, individuelle API-Key wird Dir sofort in der API-Key-Liste angezeigt und kann ab sofort verwendet werden.
Installation
Verwendest Du bisher Nexcore.DELIVERY mit dem alten nexcore.CONNECT, deinstalliere den Dienst, bevor Du folgende Version für die Verbindung mit dem neuen nexcore installierst.
Folge dann als AFD-Nutzer bitte der Anleitung zur Verbindung von nexcore mit AFD.
Installationsdatei ausführen
Führe die Datei nexcore-connect-setup.exe als Administrator auf dem PC oder Server aus, auf welchem der Dienst installiert werden soll.
Windows Defender - Ausführung bestätigen
Der Microsoft Defender SmartScreen sollte Dir direkt nach dem Ausführen der Datei anzeigen, dass er die Ausführung verhindert hat.
Damit Du dennoch fortfahren kannst, musst Du zunächst auf "Weitere Informationen" klicken und dann die Ausführung mit "Trotzdem ausführen" bestätigen.
nexcore Connect Konfiguration
Klicke auf "Weiter" bis Du das Fenster der nexcore Connect Konfiguration erreichst.
Dort musst Du nun folgende Informationen auswählen:
Partnersystem: wähle das gewünschte Partnersystem (z. B. AFD)
API Key: füge hier den in der Vorbereitung erstellten API Key ein
API Key ID: füge hier die in der Vorbereitung vergebene API Key ID ein
Verzeichnis Pfad auswählen
Bei der Auswahl der Verzeichnis Pfade wählst Du unter "Dateipfad 1" den "Export Ordner", welchen Du für das externe System festgelegt hast.
"Dateipfad 2" bleibt leer.
Siehe hierzu: Export-Ordner (AFD)
Bei erfolgreicher Installation erscheint der Dienst außerdem im Windows-Task-Manager unter Dienste mit dem Status "Wird ausgeführt".
Verbindung Testen
Nachdem Du – je nach Programm - erfolgreich Export-Dateien generierst und den Uploader-Dienst eingerichtet hast, kannst Du nun überprüfen, ob alles geklappt hat und Deine Daten an nexcore übermittelt werden:
Auftrag erfassen
Starte Dein externes System (z. B. AFD) und erstelle dort einen neuen Auftrag. Beachte dabei die Spezifika des jeweiligen Programms (z. B. AFD: Import von Mietaufträgen mit Transport)
Überprüfe die Übertragung
Öffne in der nexcore Web-App (https://nexcore.app) nun im Bereich Einstellungen die Developer-Seite und wechsle dort auf den Reiter Logs.
Hier erkennst Du nun anhand der Logeinträge, ob Daten von Deinem System über den Uploader-Dienst übertragen wurden:
erfolgreiche Übertragungen erhalten den
Status 200 OKfehlerhafte Übertragungen werden mit dem
Status 400 Bad Requestmarkiert
Zuletzt aktualisiert