VS Code Extension

Diese Seite beschreibt die Möglichkeiten der Customizing-Entwicklung mit der VS Code Extension codeblock (business express).

Systems Explorer - Konfiguration der be-Systeme

In VS Code können für die Codeblock-Extension verschiedene Systeme konfiguriert werden:

• Verwalten → Einstellungen → Erweiterungen → codeblock (business express) → In “settings.json” bearbeiten

• Manage → Settings → Extensions → codeblock (business express) → Edit in settings.json

Für die settings.json ist ein Schema hinterlegt. Damit kann die Datei mit Hilfe von Autovervollständigung bearbeitet werden und die einzelnen Elemente sind darin dokumentiert. Beispielhafte Konfiguration:

"codeblock.beSystems": [
        {
            "matchcode": "TENANT1",
            "beInstances": [
                {
                    "instanceType": "development",
                    "description": "Testsystem",
                    "developmentServices": {
                        "url": "https://<tenant>.businessexpress.cloud",
                        "beas": {
                            "url": "http://<ip-adresse>:<port>",
                            "username": "<username>",
                            "password": "<password>"
                        }
                    },
                    "matchcode": "TEST"
                }
            ]
        },
        {
            "matchcode": "TENANT2",
            "beInstances": [
                {
                    "instanceType": "training",
                    "description": "LocalHost",
                    "developmentServices": {
                        "url": "http://localhost:8080",
                        "beasUrl": "http://<ip-adresse>:<port>"
                    },
                    "matchcode": "LOCAL"
                },
                {
                    "instanceType": "production",
                    "description": "Production System - LIVE!",                    
                    "developmentServices": {
                        "url": "https://<tenant>.businessexpress.cloud",
                        "beasUrl": "http://<ip-adresse>:<port>"
                    },
                    "matchcode": "PROD"
                }
            ]
        }
    ]

Arbeiten mit VS Code

Verbindung und Standard Funktionen

1. In der VS Code Extension kann über das Connect-Icon und Eingabe von Benutzername und Passwort eine Verbindung zu einem der konfigurierten Systeme hergestellt werden.

2. Das virtuelle Dateisystem aus der DabPRG (Programmierung) wird nach der Verbindungsherstellung geladen. Dies ermöglicht es Datensätze in der DabPRG wie lokale Dateien im VS Code Explorer zu benutzen. Ist die Verbindung zusätzlich mit basic-auth beim nginx abgesichert, können in den Settings neben der URL für den beas auch Benutzername und Passwort dafür hinterlegt werden.

"beas": {
    "url": "http://<ip-adresse>:<port>",
    "username": "<username>",
    "password": "<password>"
}

3. Über die be-Volltextsuche kann eine Volltextsuche über alle Programme verwendet werden. Hier wird immer die letzte Version eines Programmes durchsucht.

4. Über diese Anzeige ist erkennbar, ob und mit welchen System Sie gerade verbunden sind.

Folgende zwei Punkte entsprechen den jeweiligen Aktionen im Administration Widget des be-portals.

5. Caches zurücksetzen/neu aufbauen. Dies baut alle relevanten Caches in der be-api neu auf (Objekte, Berechtigungen, Personal-Hierarchie-Bäume etc.).

6. Packages neu laden. Diese Aktion ist zwingend notwendig wenn ein Package in der DabPRG angepasst wurde und diese Änderungen im be-portal ankommen sollen.

Bearbeitung von Programm und anderen Ressourcen

1. Über das Ausrufezeichen ! erkennt man, dass diesem Programm ein Event zugewiesen ist.

2. Freigegebene Programme sind mit einem Häkchen markiert.

3. Über diesen Button kann das Programm freigegeben werden. Befindet sich die Datei in einem Package mit einer be_package.install.yaml-Datei und besteht eine Verbindung zum be-Portal, dann wird das zugehörige Package automatisch neu geladen.

Datei-Suche

Über Strg + P wird eine Datei-Suche geöffnet, in die der Suchtext eingegeben wird. Alle Dateien die den Text im Namen oder im Pfad enthalten werden aufgelistet.

Codeblock-Programm ausführen

Codeblock-Programm können über den Button (1) gestartet werden. Nach der Ausführung werden die Ausgaben und das Ergebnis bzw. die Fehlermeldung im automatisch geöffneten OutputChannel dargestellt.

Mit den Menüpunkten (2) und (3) kann der Modus der Ausführung konfiguriert werden.