Einleitung

Um eine Erweiterung für Dynamics 365 Business Central über Microsoft anbieten zu können, musste das Produkt „Finance“ angepasst werden.
Hierbei mussten unter anderem Änderungen an bestehenden Objekt und Feldnamen durchgeführt werden.

Diese VS Code Erweiterung soll bei dem Upgrade auf die neue Finance Version unterstützen.
Dabei sollte ein Großteil der Objekt- und Feldnamenänderungen automatisch erfolgen.

Manuelle Installation der VS Code Erweiterung

Download: https://nevaris.blob.core.windows.net/finance/v24/Tools/PartnerSupport/finance-partner-support-1.0.4.zip

• Navigieren Sie auf „Erweiterungen“ in der „Activity Bar“.

Open

• Navigieren Sie auf „Ansichten und weitere Aktionen“.

Open

• Führen Sie die Aktion „Aus VSIX installieren“ aus.

• Selektieren Sie die gewünschte „.vsix“ Datei aus.

• Nach der Installation sollten die  VS Code Erweiterung "Finance Partner Support" unter ihren installierten Erweiterungen sehen können.

Vorgehensweise

• Stellen Sie sicher, dass Sie die neue Finance Version haben (24.x) und die jeweiligen „Symbols“ geladen sind. 

• Öffnen Sie Ihr Projekt und warten Sie bis das Projekt vollständig in VS Code geladen wurde (Alle Probleme / Fehler sollten geladen sein).
  Die Erweiterung "Finance Partner Support" operiert auf Basis der von VS Code angezeigten Fehler.
  
  
  

• Rufen Sie die Befehlspalette (strg + shift + p) auf und führen Sie den Befehl „NEVARIS: Apply Finance Affix Rename“ aus.
  
  
  

  
  
  
  

• Es folgt eine Abfrage ob Sie spezielle Fehler wie "AL0118" behandelt wollen. Hierbei handelt es sich in der Regel um Folgefehler.
  Wenn es Ihre erste Ausführung ist, wählen Sie "Nein", um Folgefehler nicht zu behandeln.
  Hierzu ein kurzes logisches Beispiel:
  Obwohl Feldnamen korrekt sind werden Sie als Fehler angezeigt, da die jeweilige Tabelle nicht gefunden werden kann. (Siehe "Beispiel für Folgefehler) 
  Führen Sie diesen Schritt gegebenenfalls (Mit Auswahl "Nein") mehrfach durch, um sicherzustellen, dass Hauptfehler beseitigt wurden sind.
  Achten Sie darauf, dass die Fehlermeldungen in VS Code aktuell sind.
  
  
  

• Um nun die Fehler mit dem Fehlercode "AL0118" zu beseitigen, die keine Folgefehler sind, rufen Sie die Befehlspalette (strg + shift + p) auf und
  führen Sie den Befehl „NEVARIS: Apply Finance Affix Rename“ erneut aus.
  Wählen Sie "Ja" aus bei der Abfrage, ob Sie spezielle Fehler wie "AL0118" behandelt wollen.
  Achten Sie darauf, dass die Fehlermeldungen in VS Code aktuell sind.
  
  
  

• Kontrollieren Sie im Nachgang gegebenenfalls die jeweiligen Änderungen.

Bei diesem Vorgehen werden folgende Kompilierungsfehler beachtet:

1. AL0185 (The referenced application object does not exist.)

2. AL0247 (The target for an extension object is not found.)

3. AL0132 (The referenced element does not contain a definition for the referenced member.)

4. AL0280 (The referenced event is missing.)

5. AL0295 (The referenced field is missing.)

6. AL0118 (The referenced name does not exist in the current context.)
   
   
   

Beispiel für Folgefehler

Situation

Wir haben ein "dataitem", welches sich auf die Tabelle "Personalstamm Baulohn" bezieht.
Unter "RequestFilterFields" und "column" werden unterschiedliche Felder der Tabelle "Personalstamm Baulohn" angesprochen.
Obwohl die Feldnamen korrekt sind, werden diese als Fehler angezeigt.
Die Ursache hierfür ist, dass die Tabelle "Personalstamm Baulohn" nicht gefunden werden kann.
Bei unserer "Korrektur" müssen wir also nur die Tabelle "Personalstamm Baulohn" umbenennen und die Fehler zu den Feldern nicht beachten.

Vorliegende Fehlercodes

Fehlercode für die Tabelle: AL0185

Fehlercode für die Felder: AL0118

Lösung

Es muss also der Fehler "AL0185" beseitigt werden ohne, dass der Fehler "AL0118" berücksichtig wird.
Rufen Sie die Befehlspalette (strg + shift + p) auf und führen Sie den Befehl „NEVARIS: Apply Finance Affix Rename“ aus.
Wählen Sie "Nein" aus bei der Abfrage, ob Sie spezielle Fehler wie "AL0118" behandelt wollen.
Nach der erfolgreich "Korrektur" verschwinden die Folgefehler.

Sonstiges & Tipps

• Um Fehler zu vermeiden, achten Sie darauf, dass sie Folgende AL Extension installiert haben: 
  "AL Language extension for Microsoft Dynamics 365 Business Central" v12.6.936426

• Solange die Verarbeitung läuft, sollten Sie keine Aktivitäten in Vs Code durchführen.
  
  

• Erst wenn die Verarbeitung abgeschlossen ist, sollten Sie wieder in VS Code arbeiten.
  
  

• Schließen Sie den Tab "Loading Screen" / starten Sie VS Code neu nach jeder Ausführung.

• Um Fehler zu vermeiden, stellen Sie sicher, dass Ihr Projekt mit target: "cloud" kompiliert ist.

• "Stagen" Sie Ihre Schritte, um gegebenenfalls Fehlerhafte Schritte wieder rückgängig zu machen.