Samstag, 9. September 2023

Better Access Charts: Eigene Erweiterungen einfügen

Mit Better Access Charts steht eine Lösung zur Verfügung, die noch längst nicht alle Möglichkeiten bietet, die chart.js zur Verfügung stellt. Wie man am besten vorgeht, wenn man den VBA-Code um ein selbst gewähltes Feature erweitern möchte, erläutert dieser Beitrag.

Es gibt grundsätzlich zwei Gründe, warum man auf die Idee kommt, Better Access Charts zu erweitern:

Da ist zum ersten die Tatsache, dass Better Access Charts seit der Version 3.00.09 nur noch mit dem neuen Edge Browser Steuerelement funktioniert. Nicht jeder Benutzer hat in seinem Umfeld Zugriff auf Office 365 und damit auf das neue Edge Browser Steuerelement. Damit kommt man nicht in den Genuss von Erweiterungen, die nach dieser Version in Better Access Charts vorgenommen wurden und muss selber Hand anlegen.

Zum zweiten ist da die Tatsache, dass chart.js eine riesige Zahl von möglichen Paramentern bietet, um die zu erstellenden Charts zu erzeugen. Es liegt auf der Hand, dass in Better Access Charts nicht alle mögliche Parameter umgesetzt werden können. Dies ist ein weiterer Grund warum ein Feature, dass chart.js bereitstellt, in Better Access Charts eingebaut werden soll.

Im Wiki auf GitHub habe ich eine Schritt-für-Schritt Anleitung zu diesem Thema veröffentlicht:
https://github.com/team-moeller/better-access-charts/wiki/add-a-feature
Im Folgenden gehe ich auf die dort genannten Schritte näher ein.

1. HTML-Datei speichern

Erstellen Sie ein Diagramm mit allen gewünschten Parametern. Wählen Sie abschließend auf der Registerkarte „Diagramm“ die Option „HTML-Datei zum Debuggen speichern“ und erstellen Sie das Diagramm erneut.

2. HTML-Datei öffnen

Die HTML-Datei wird in dem Ordner gespeichert, in dem die Better Access Charts-Datenbank gespeichert ist. Die Datei heißt „BetterAccessChart_XXXXXXXXX.html“. (X ist jeweils eine Ziffer)
Öffnen Sie diese Datei in einem Texteditor wie Notepad++.

3. HTML-Datei anpassen

Durchsuchen Sie die Dokumentation zu chart.js nach dem Parameter, den Sie anpassen möchten. Achten Sie dabei unbedingt darauf, die richtige Version der Dokumentation zu verwenden. Insbesondere zwischen der Version 2.9.4 und den nachfolgenden Versionen gibt es große Änderungen.
Fügen Sie der HTML-Datei die erforderlichen Informationen hinzu und speichern Sie das Ergebnis.

4. Öffnen Sie die HTML-Datei im Browser

Öffnen Sie die von Ihnen angepasste HTML-Datei im Browser. Ihre Anpassung sollte nun wie gewünscht hier sichtbar sein. Wenn nicht, gehen Sie zurück zu Schritt 3.
Dieser Schritt hilft dabei festzustellen, wo ein eventuelles Problem liegt. Wenn bereits an dieser Stelle der Chart nicht oder nicht wie gewünscht erzeugt wird ist klar, dass der Fehler in der HTML-Datei liegt. Eine Fehlersuche im VBA-Code kann somit unterbleiben.

5. Passen Sie den VBA-Code an

Passen Sie den VBA-Code an der entsprechenden Stelle an. Geben Sie dort die notwendigen Informationen ein, damit am Ende die von Ihnen angepasste HTML-Datei generiert wird.
Wenn an dieser Stelle der Chart nicht wie gewünscht erzeugt wird ist klar, dass der Fehler in der Umsetzung im VBA-Code liegt.

Zum Abschluss noch eine letzte Anmerkung:
Wenn Sie der Meinung sind, dass Ihre Anpassung für andere Benutzer nützlich ist, öffnen Sie bitte ein Issue in GitHub. Beschreiben Sie dort ihre Anpassung und hängen Sie eine angepasste Datenbank an. Ich bin immer an neuen Ideen interessiert. 😎

Keine Kommentare: