Was ist Aident LocalLink?

Aident LocalLink macht lokale Hardware- und Dateiressourcen (Drucker, Laufwerke, spezielle Peripheriegeräte) innerhalb von Microsoft Dynamics 365 Business Central lokal verfügbar.

Wie funktioniert es?

Teil	Läuft auf	Zweck
Aident LocalLink Agent	Windows-Host neben der NAV/BC Service Tier	Windows-Dienst, der eine REST-Endpunkt-Gruppe pro installiertem Plug-in bereitstellt.
Aident LocalLink Connector (BC App)	Business Central Mandant	AL-Erweiterung, die sich beim Agent authentifiziert und dessen APIs über HTTP/HTTPS aufruft.

Alles bleibt vor Ort: Netzwerkanrufe verlassen niemals Ihr LAN/VPN.

Architektur auf einen Blick

%% Systemarchitektur – Aident LocalLink
graph TD
    %% ====== BC-Ebene ======
    subgraph BC["Business Central (lokales)"]
        BCConnector["Aident LocalLink Connector<br/>(AL-Erweiterung)"]
    end

    %% ====== Debitor-Umgebung ======
    subgraph OnPrem["Debitor lokaler Server / Arbeitsplatz"]
        NavST["BC Service Tier"]
        LocalLink["Aident LocalLink<br/>(Windows-Dienst)"]

        %% Visueller Hinweis, dass LocalLink neben der NST installiert ist
        LocalLink -. nebeneinander .- NavST

        %% ----- Plugin-Zone -----
        subgraph Plugins["Plug-in DLLs (erweiterbar)"]
            FilePlugin["Datei-API-Plug-in<br/>file.dll"]
            PrinterPlugin["Drucker-API-Plug-in<br/>printer.dll"]
            FuturePlugin["Künftige Plug-in(s)<br/>*.dll"]
        end

        %% Endpunkte pro Plug-in freigegeben
        LocalLink -->|REST-Endpunkt&nbsp;/file| FilePlugin
        LocalLink -->|REST-Endpunkt&nbsp;/printer| PrinterPlugin
        LocalLink -->|REST-Endpunkt&nbsp;/&lt;plugin&gt;| FuturePlugin
    end

    %% Cross-Grenze-Aufruf von BC zum lokalen Dienst
    BCConnector -->|HTTPS / JSON| LocalLink 

Schlüsselfunktionen

• Dateispeicheroperationen – Laufwerke/Verzeichnisse/Dateien auflisten, hochladen/herunterladen, kopieren, verschieben, erstellen, löschen.
• Druckeroperationen – Drucker auflisten, Fähigkeiten abrufen, Druckaufträge übermitteln.
• Integritätsprüfung – /api/ping für Überwachungswerkzeuge.
• Plug-in-Lader – zusätzliche *.dll Dateien ablegen, um automatisch brandneue REST-Gruppen freizugeben.
• Keine Cloud-Ausgangsdaten – alle Daten bleiben innerhalb Ihres Netzwerks

Sicherheits- & Bereitstellungshinweise

• Authentifizierung – Basic Auth über TLS; Anmeldeinformationen befinden sich nur im verschlüsselten Speicher von BC und auf dem Agent-Host.
• Netzwerkbereich – Standard-URL https://localhost:5000; eingehende Firewallregeln nach Bedarf einschränken.
• Upgrades – Führen Sie choco upgrade LocalLinkAgent aus; Einstellungen und Protokolle bleiben erhalten.
• Beobachtbarkeit – Strukturierte JSON-Protokolle werden an Windows-Ereignisprotokoll und jeden von Ihnen konfigurierten Syslog/ELK-Ziel gesendet.

Protokolle werden in Ereignisanzeige ➜ Anwendungs- und Dienstprotokolle ➜ LocalLink geschrieben.

API-Katalog (kurze Referenz)

Gruppe	Endpunkt(e)	Zusammenfassung
System	GET /api/ping	Funktionstest
Speicher	listDrives, listDirectories, listFiles, directoryExists, fileExists, getFile, copyFile, moveFile, createDirectory, deleteDirectory, createFile, deleteFile	Lokales Dateisystem
Drucker	GET /api/Printer, GET /api/Printer/{name}, POST /api/Printer/{name}/jobs	Druckerinventar & -jobs
Künftige Plug-ins	/api/{PluginName}/*	Automatisch hinzugefügt, wenn eine neue DLL abgelegt wird

API-Spezifikation

Nächster Schritt

Konfigurieren Sie den LocalLink Agent und verbinden Sie ihn mit Ihrem Business Central.