In dieser Kurzanleitung wird erklärt, wie Sie 365 business Proxy Application in Ihrer Microsoft Dynamics 365 Business Central Umgebung installieren und einrichten.
Voraussetzungen
- Microsoft Dynamics 365 Business Central 2021 release wave 1 (18.0) oder neuer.
- Ein Microsoft Windows-Clientgerät zur Ausführung von 365 business Proxy Application Client.
- Eine Internetverbindung.
Für weitere Informationen zur Einrichtung weiterer Plugins besuchen Sie bitte die Dokumentation.
Schritt 1: Installation von 365 business Proxy Application
Öffnen Sie den Marketplace für Erweiterungen in Microsoft Dynamics 365 Business Central und suchen Sie nach 365 business Proxy Application. Installieren Sie die App von Microsoft AppSource und warten Sie, bis die Installation abgeschlossen ist.
Schritt 1.1: Proxy Application Einrichtung
Um den 365 business Proxy Application einzurichten, öffnen Sie die Seite Proxy Application Einrichtung in Microsoft Dynamics 365 Business Central.
- Wählen Sie Authentifizieren um Ihre Microsoft Dynamics 365 Business Central Umgebung mit 365 business Proxy Application Service zu verbinden.
- Kopieren Sie den Wert Tenant ID indem Sie auf den Feldwert klicken.
Hinweis: Gibt die Tenant-ID an, die zur Sicherung der Kommunikation zwischen dem Proxy Application Dienst und Microsoft Dynamics 365 Business Central verwendet wird.
- Wählen Sie Client herunterladen… um 365 business Proxy Application Client herunterzuladen.
Schritt 1.2: Installieren von 365 business Proxy Application Client
- Speichern Sie die heruntergeladene ZIP-Datei auf dem Server oder Computer, den Sie mit 365 business Proxy Application verwenden möchten.
- Entpacken Sie die ZIP-Datei (z.B.
C:\install
) - Starten Sie die Setup Datei und folgen Sie den Anweisungen.
- Geben Sie die Tenant ID aus dem vorherigen Schritt und einen Namen für den Client ein, der Ihnen dabei hilft den Client in Microsoft Dynamics 365 Business Central zu identifizieren.
- (Optional) Geben Sie einen Domänenbenutzer und das Kennwort ein, mit dem 365 business Proxy Application Client betrieben werden soll.
Hinweis: Wenn Sie keinen Benutzer angeben, wird 365 business Proxy Application Client im Kontext Lokales System ausgeführt.
Schritt 2: Proxy Application Client einrichten
Um auf die Proxy Application Clients direkt in Microsoft Dynamics 365 Business Central zugreifen zu können, müssen die Clients aktiviert werden.
- Öffnen Sie die Proxy Application Einrichtung in Microsoft Dynamics 365 Business Central.
- Beim Öffnen der Seite werden automatisch alle verfügbaren 365 business Proxy Application Clients abgerufen und werden in der Einrichtung angezeigt:
- Wählen Sie Aktiviert um einen Proxy Application Client für die Verwendung zu aktivieren.
- Klicken Sie auf den Namen des Proxy Application Client um die Karte zu öffnen.
- In der Proxy Application Client Karte finden Sie das Feld Client ID.
Hinweis: Die Client ID wird verwendet, um den Proxy Application Dienst zu adressieren. 365 business Proxy Application stellt zusätzlich Funktionen zur Verfügung um die Clients, die ein spezifisches Plugin unterstützen, zurückgibt. In dieser Kurzanleitung wird allerdings davon ausgegangen, dass die spezifische Client ID verwendet wird.
Schritt 2.1: Proxy Application Client Plugins installieren
- Microsoft Dynamics 365 Business Central öffnen.
- Proxy Application Clients Seite öffnen.
- Wählen Sie Aktualisieren um die verfügbaren 365 business Proxy Application Clients zu laden.
- Wählen Sie den gewünschten Proxy Application Client, an Hand des Namens den Sie im vorherigen Schritt vergeben haben.
- Wählen Sie Plugins installieren.
- Klicken Sie Weiter.
- Wählen Sie die Plugins (z.B. File Plugin), die Sie installieren möchten.
- Klicken Sie Weiter.
- Nach der erfolgten Plugin Installation klicken Sie Schließen.
Schritt 2.2: Standard Clients für Plugin (Optional)
Um die Ansteuerung von Clients zu vereinfachen gibt es die Möglichkeit einen Standard Client für Plugins zu definieren. Hierdurch ermöglichen Sie 365 business Proxy Application automatisch den Client für das aktuelle Plugin auszuwählen.
- Microsoft Dynamics 365 Business Central öffnen.
- Proxy Application Einrichtung Seite öffnen.
- Wählen Sie Zugehörig.
- Wählen Sie Standard Clients.
- Wählen Sie das Plugin aus, für das Sie einen Standard Client festlegen möchten (z.B. File Plugin).
- Wählen Sie den Namen des Clients aus.
Schritt 3: Implementierung File Plugin
In dieser Kurzanleitung wird erklärt, wie Sie mit Hilfe von 365 business Proxy Application eine Datei in Ihrem lokalen Dateisystem schreiben. Im folgenden wird eine AL-Erweiterung für Microsoft Dynamics 365 Business Central vorgenommen. Diese Kurzanleitung geht dabei davon aus, dass das AL-Projekt bereits existiert und nur um die Integration mit 365 business Proxy Application erweitert werden muss.
Schritt 3.1: Abhängigkeit zu 365 business Proxy Application
Um auf die Funktionen in 365 business Proxy Application zugreifen zu können, muss Ihre AL-Erweiterung eine Abhängigkeit zu 365 business Proxy Application festlegen.
- Öffnen Sie das Application Manifest (
app.json
) in Visual Studio Code. - Ergänzen Sie folgenden Eintrag im JSON-Token
dependencies
:[..], "dependencies": [ { "id": "ae907ccb-e4a3-4594-9955-bd931031af8f", "name": "365 business Proxy Application", "publisher": "365 business development", "version": "18.0.0.0" } ], [..]
- Führen Sie den Befehl AL: Download symbols aus.
Schritt 3.2: AL Implementierung
Im folgenden wird beispielhaft eine Datei geschrieben und anschließend wieder gelesen. In dieser Kurzanleitung wird angenommen, dass eine Datei mit dem Inhalt “Hello, World!” als test.txt
im Pfad C:\temp
geschrieben werden soll.
Eine detaillierte Dokumenation finden Sie in der Plugin Dokumenation.
- Öffnen Sie eine bestehende Codeunit oder erstellen Sie eine neuen AL-Datei, in der der AL-Code entwickelt werden kann.
- Fügen Sie folgenden AL-Code ein:
procedure WriteAndReadHelloWorldFile() var proxyApp: Codeunit "bdev.PRX Proxy Application"; file: Codeunit "Temp Blob"; filePath: Text; sampleText: Label 'Hello, World!', Locked = true; begin // write "Hello World" into the text file CreateFileInTempBlob(file, sampleText); // set file path filePath := 'c:\temp\test.txt'; // write file to filesystem if (not proxyApp.PostFile( filePath, file )) then Error('Failed to write file!\Error: %1', GetLastErrorText()); Clear(file); // reset temp blob // read file from filesystem file := proxyApp.GetFile( filePath ); // compare content with expected content if (ReadContentFromTempBlob(file) <> sampleText)then Error('The file content does not matcht.') else Message('The file has been written.'); end; local procedure CreateFileInTempBlob(var file: Codeunit "Temp Blob", fileContent: Text) var stream: OutStream; begin file.CreateOutStream(stream, TextEncoding::UTF8); stream.WriteText(fileContent); end; local procedure ReadFile(filePath: Text): Text var proxyApp: Codeunit "bdev.PRX Proxy Application"; file: Codeunit "Temp Blob"; begin // invoke Proxy Application plugin file := proxyApp.GetFile( filePath ); exit(ReadContentFromTempBlob(file)); end;
- Führen Sie die Funktion
WriteAndReadHelloWorldFile()
aus.