# 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. {% hint style="info" %} Diese Anleitung beschreibt ausschließlich die Installation des Dienstes selbst. Informationen zur Einrichtung der Verbindung mit einem konkreten System (z. B. AFD) findest Du in den jeweiligen Integrationsartikeln. {% endhint %} *** ## Vorbereitung Vor der Installation solltest Du sicherstellen, dass die folgenden Voraussetzungen erfüllt sind:
VoraussetzungBeschreibung
Windows-VersionWindows Server 2019 oder neuer
AdministrationsrechteFür die Installation und Dienstverwaltung sind Administrationsrechte erforderlich
NetzwerkzugriffStabile Verbindung zu https://api.nexcore.app notwendig
DatenverzeichnisDas externe System (z. B. AFD) muss lokal oder über einen UNC-Pfad erreichbar sein
InstallationsdateiDie aktuelle Installationsdatei (Download)
API-KeyErstelle 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. {% hint style="danger" %} 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](https://docs.nexcore.de/documentation/integrationen/nexcore.connect/installation) oder die Einrichtung einer API-Verbindung benötigt) {% endhint %} Der nun erstellte, individuelle API-Key wird Dir sofort in der API-Key-Liste angezeigt und kann ab sofort verwendet werden. {% hint style="info" %} Wenn Du mehrere Integrationen nutzt (z. B. ERP-System, BI-Tool, Webservice), empfiehlt es sich, für jede Anwendung einen separaten API-Key mit individuellem Kommentar zu erstellen. So kannst Du die Nutzung besser nachvollziehen. {% endhint %} *** ## Installation {% hint style="warning" %} Verwendest Du bisher Nexcore.DELIVERY mit dem alten nexcore.CONNECT, [deinstalliere](https://docs.nexcore.de/documentation/integrationen/nexcore.connect/loschen) 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](https://docs.nexcore.de/documentation/integrationen/programme/afd/verbindung-einrichten). {% endhint %} {% stepper %} {% step %} ### Installationsdatei ausführen Führe die Datei [nexcore-connect-setup.exe](https://nexcoreconnect.blob.core.windows.net/default/nexcore-connect-setup-2.exe) als Administrator auf dem PC oder Server aus, auf welchem der Dienst installiert werden soll. {% hint style="info" %} In der Regel sollte der Service auf dem selben PC oder Server installiert werden, auf dem auch das externe System (z. B. AFD) lokal installiert ist. {% endhint %} {% endstep %} {% step %} ### 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. {% endstep %} {% step %} ### 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 {% endstep %} {% step %} ### 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)](https://docs.nexcore.de/documentation/programme/afd/verbindung-einrichten#erstelle-einen-export-ordner) {% endstep %} {% step %} ### Abschluss der Installation Bestätige in den folgenden Schritten ohne Anpassungen immer mit "Weiter" bis der Installationsprozess abgeschlossen ist. {% endstep %} {% endstepper %} {% hint style="success" %} Bei erfolgreicher Installation erscheint der Dienst außerdem im Windows-Task-Manager unter Dienste mit dem Status "Wird ausgeführt". {% endhint %} *** ## 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: {% stepper %} {% step %} ### 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](https://docs.nexcore.de/documentation/integrationen/programme/afd/import-von-mietauftragen-mit-transport)) {% endstep %} {% step %} ### Generiere eine Export-Datei Sorge nun dafür, dass eine Export-Datei in unserem Upload-Ordner generiert wird (z. B. AFD: drücke auf den Button **"Auslieferung"**) {% endstep %} {% step %} ### Überprüfe die Übertragung Öffne in der nexcore Web-App ([https://nexcore.app](https://nexcore.app/)) nun im Bereich Einstellungen die Developer-Seite und wechsle dort auf den Reiter [Logs](https://docs.nexcore.de/documentation/einstellungen-and-verwaltung/developer/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 OK` * fehlerhafte Übertragungen werden mit dem `Status 400 Bad Request` markiert {% endstep %} {% endstepper %} {% hint style="info" %} Sollte es nach der Einrichtung zu Problemen mit der Übermittlung kommen, das Du nicht eigenständig durch Berücksichtigung unserer Anleitungen lösen kannst, kontaktiere bitte unseren Support über ein neues Support-Ticket. {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.nexcore.de/documentation/integrationen/nexcore.connect/installation.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.