Logico AL Toolbox

Eine umfassende VS Code Extension für die Entwicklung mit Microsoft Dynamics 365 Business Central (AL). Diese Toolbox bietet eine Vielzahl von Tools zur effizienten Verwaltung von AL-Objekten, Integration mit Entwicklungsplattformen und Unterstützung für lokale sowie Remote-Entwicklungsumgebungen.

Übersicht

Die Logico AL Toolbox ist speziell für AL-Entwickler entwickelt worden, die mit Business Central arbeiten. Sie integriert sich nahtlos in VS Code und bietet Funktionen für:

• Automatische Verwaltung von Objekt- und Feld-IDs
• Lokale Sandbox-Umgebungen
• Remote-Entwicklungsumgebungen
• Integration mit Azure DevOps und GitHub Enterprise
• Debugging-Tools
• PowerShell-Modul-Verwaltung
• Und vieles mehr

Features

1. Object/Field ID Management

Verwalten Sie automatisch Objekt- und Feld-IDs in Ihrem Business Central-System.

• Nächste ID abrufen: Ermittelt die nächste verfügbare Objekt-/Feld-ID.
• ID rückgängig machen: Widerruft die letzte ID-Zuweisung.
• Objekte/Felder löschen: Entfernt Objekte oder Felder aus dem System.
• Neu nummerieren: Nummeriert einzelne Dateien oder alle Objekte neu.
• Synchronisation: Synchronisiert alle Objekte automatisch.
• Tree View: Zeigt Team-Objekt-/Feld-IDs in einem Explorer-Bereich an.

2. Lokale Sandbox-Verwaltung

Erstellen und verwalten Sie lokale Business Central Sandbox-Umgebungen.

• Neue lokale Sandbox erstellen
• Service Tier neu starten
• Event-Logs abrufen
• Projekt wiederherstellen
• Lokalen Build ausführen
• Lokale Tests ausführen
• Übersetzungen aktualisieren
• Lizenz importieren

3. Remote-Entwicklungsumgebungen

Arbeiten Sie mit Remote-Entwicklungsumgebungen über das Logico DevOps Portal.

• Neue Remote-Umgebung erstellen
• Mit Remote-Umgebung verbinden/trennen
• Umgebung auswählen
• Daten in Umgebung kopieren
• Quellordner synchronisieren (mit RoboCopy oder Symlink)
• Automatische Wiederverbindung
• Status-Anzeige in der Statusleiste

4. Azure DevOps Integration

Erweitert die native VS Code Git-Integration um Azure DevOps Unterstützung.

• Repository-Liste: Zeigt Repositories von Azure DevOps Cloud an.
• Repository clonen: Wählen Sie ein Repository aus der Liste zum Klonen aus.
• Repository öffnen: Lokale Repositories werden automatisch in konfigurierten Ordnern erkannt (z. B. git.defaultCloneDirectory, ~/source/repos, ~/repos, ~/Projects, ~/git).
• Authentifizierung: Verwendet VS Code's Microsoft Authentication API.

5. GitHub Enterprise Integration

Erweitert die native VS Code Git-Integration um GitHub Enterprise Unterstützung.

• Repository-Liste: Zeigt Repositories von GitHub Enterprise Servern an.
• Repository clonen: Wählen Sie ein Repository aus der Liste zum Klonen aus.
• Repository öffnen: Lokale Repositories werden automatisch in konfigurierten Ordnern erkannt (z. B. git.defaultCloneDirectory, ~/source/repos, ~/repos, ~/Projects, ~/git).
• Authentifizierung: Verwendet VS Code's GitHub Authentication API.

6. Debugging-Tools

Erstellen und verwalten Sie Debug-Projekte für AL-Code.

• Debug-Projekt erstellen
• Debug-Projekt aktualisieren
• Integration mit AL Object Designer

7. PowerShell-Modul-Verwaltung

Verwalten Sie das Logico-AL PowerShell-Modul.

• Modul aktualisieren/installieren
• Repository-Konfiguration

8. Benutzerverwaltung

• Benutzer anmelden/abmelden
• Login-Status prüfen

Installation

1. Öffnen Sie VS Code.
2. Gehen Sie zu den Extensions (Strg+Umschalt+X).
3. Suchen Sie nach "Logico DEV Toolbox".
4. Klicken Sie auf "Installieren".

Alternativ können Sie die Extension über die VS Code Marketplace-Seite installieren oder aus dem Quellcode kompilieren:

npm install
npm run compile

Konfiguration

Nach der Installation müssen Sie die Extension konfigurieren. Öffnen Sie die VS Code-Einstellungen (Strg+,) und suchen Sie nach "Logico Dev Toolbox".

API-Einstellungen (Object ID Management)

• API Base Url (logico-dev-toolbox.apiBaseUrl): Basis-URL des ODATA-Webservices.
  • Beispiel: http://server:port/Instanz/OData/
• API Base Company (logico-dev-toolbox.apiBaseCompany): Mandant, in dem die Daten gespeichert sind.
  • Beispiel: Mandant%20für%20Leerzeichen (URL-kodiert)
• Auto Sync to NAV (logico-dev-toolbox.AutoSyncToNAV): Automatische Synchronisation beim Speichern von AL-Dateien.
  • Standard: true

Azure OAuth (für Cloud-Integrationen)

• Client ID (logico-dev-toolbox.ClientID): Azure OAuth Client ID.
• Tenant ID (logico-dev-toolbox.TenantID): Azure Entra Tenant ID.
• Environment (logico-dev-toolbox.Enviroment): Azure-Umgebung.

Azure DevOps

• URL (logico-dev-toolbox.AzureDevOps.Url): Basis-URL zum Azure DevOps/TFS-Server.
  • Beispiel: https://server:port/
• Project Collection (logico-dev-toolbox.AzureDevOps.ProjectCollection): Name der Projektkollektion.
• Team Project (logico-dev-toolbox.AzureDevOps.TeamProject): Name des Teamprojekts.

Logico DevOps Portal

• API Url (logico-dev-toolbox.LogicoDevOpsPortal.ApiUrl): API-URL des Logico DevOps Portals.
  • Beispiel: http://server/api

Remote Development

• Auto Reconnect (logico-dev-toolbox.DevEnvironment.AutoReconnect): Automatische Wiederverbindung zur letzten Umgebung.
• RoboCopy Enabled (logico-dev-toolbox.RemoteDevelopment.RoboCopyEnabled): Verwendet RoboCopy anstatt Symlinks für Quellordner-Synchronisation.
• Auto Sync on Save (logico-dev-toolbox.RemoteDevelopment.AutoSyncOnSave): Automatische Synchronisation bei Dateiänderungen.

PowerShell-Modul

• PS Repository Name (logico-dev-toolbox.PSRepositoryName): Name des PS-Repositorys für das Logico-AL Modul.
• PS Update Date (logico-dev-toolbox.PSUpdateDate): Datum der letzten Modul-Aktualisierung (schreibgeschützt).

Verwendung

Befehlspalette (Strg+Umschalt+P)

Suchen Sie nach "LOGI:" um alle verfügbaren Befehle zu sehen.

Tastenkürzel

• Strg+F8: Nächste ID abrufen
• Strg+Umschalt+F8: Objekt löschen
• Strg+F9: Feld hinzufügen (nächste ID)
• Strg+Umschalt+F9: Feld löschen

Tree View

Im Explorer-Bereich finden Sie "Team Object/Field Ids" für die Verwaltung von IDs.

Statusleiste

Zeigt den Status der Remote-Entwicklungsumgebung an.

Erweiterte Funktionen

GitHub Enterprise Integration

Konfigurieren Sie VS Code für GitHub Enterprise:

1. Einstellungen öffnen
2. Nach "GitHub Enterprise" suchen
3. Server-URL und Authentifizierung konfigurieren

Remote Development Requirements

• Quellcode muss für die Gruppe g_devops freigegeben sein
• Bei VPN-Verbindungen Netzwerk-Shares verwenden

Debugging

1. Debug-Projekt erstellen
2. AL Object Designer installieren (empfohlen)
3. Extension veröffentlichen und debuggen

Dokumentation

Ausführliche Dokumentation finden Sie im docs/-Ordner:

• GitHub Enterprise Integration
• Quick Debug Guide
• Remote Container Development
• Testing Guide

Changelog

Siehe CHANGELOG.md für alle Änderungen.

Lizenz

Diese Extension ist unter der MIT-Lizenz lizenziert.

Entwickelt von Logico für die Optimierung der eigenen Microsoft Dynamics 365 Business Central Entwicklungen.