Tool Extension

TAA Werkzeuge bieten die Möglichkeit, über sogenannte Tool Extensions die Funktionalität der Werkzeuge anzupassen. Dazu muss eine Assembly erstellt werden, die eine Klasse basierend auf TeamWiSE.dacApi.ddbToolExtension enthält. Diese Assembly wird in der TAA-Registry für das jeweilige Werkzeug unterhalb des Schlüssels Extensions eingetragen, z.B. für das Werkzeug PkEdge unterhalb Tools/PkEdge/Extensions.

Hier muss ein Eintrag angelegt werden mit dem Namen der Assembly und der Klasse, in der Form <Assembly>;<Classname>.

Beim Starten des jeweiligen TAA-Werkezugs werden dann die hier eingetragenen Assemblies geladen und eine Instanz der jeweiligen Klassen erzeugt.

Die Klasse ddbToolExtension stellt folgende Eigenschaften und Methoden zu Verfügung:

TeamWiSE.dacApi.ddbTool Tool { get; }

Referenziert das Werkzeug, welches die Extension geladen hat.

string ID { get; }

Name des Eintrags, unter dem die Extension in der Registry eingetragen wurde.

string LoadedFrom { get; }

Inhalt des Eintrages aus der Registry.

string Description { get; set; }

Umschreibung für die Anzeige, ist von der Extension beim Initialisieren zu setzen.

bool Initialize(TeamWiSE.dacApi.ddbTool Tool)

Diese Methode wird einmalig beim Laden der Extension ausgelöst. Der Parameter Tool verweist auf das Werkzeug, welches die Extension lädt. Dieses steht nachher auch als Eigenschaft Tool zu Verfügung. Ein Rückkehrwert false führt dazu, das die Extension nicht weiter berücksichtigt und die Assembly entladen wird.

void Setup()

Wird von TAA-Werkzeug ausgelöst, wenn es bereit ist, Anpassungen an Menus etc. entgegen zu nehmen.

void Cleanup()

Wird beim Beenden des TAA-Werkzeugs ausgelöst. Hiernach wird die Assembly entladen.

void InvokeConsoleCommand(string Cmd)

Wird ausgelöst, wenn dieExtension über ein Batchtool aufgerufen wird.

faq:allg:toolextension · Zuletzt geändert: 22.05.2019 14:21

Copyright © 1992-2024 TeamWiSE Gesellschaft für Softwaretechnik mbH         Adressen |  Kontakt |  AGB |  Datenschutzerklärung |  Impressum