Das 'ACMP Custom Fields Tool'
Custom Fields, die benutzerdefinierten Felder, sind sind eines der Alleinstellungsmerkmale von Aagon ACMP.
Die Datentypen und die Benennung können frei gewählt werden. Aber, dass sie vollständig in alle Abfragen, Skripte, Formulare integriert sind und sich quasi nicht von systemeigenen Feldern unterscheiden, macht ihren Einsatz so vielseitig und einfach
Besonders leistungsfähig sind die sogenannten 1:n Felder. Diese eigenen sich besonders zur Entwicklung von mächtigen Client Commands - den ACMP eigenen Skrpten - aber auch zur Anbindung an andere Tabellen und Datenbanken.
ACMP ist mit der MSSQL Datenbank von Haus offen für individuelle Erweiterungen und den Datenaustausch mit anderen Systemen. Um hier die Arbeit zu erleichtern, habe ich das 'ACMP Custom Fields Tool entwickelt, dass hier als Freeware zum Download angeboten wird.
Das Tool mit den nötigen DLLs ist in einem Zip gepackt. Es benötigt keine Installation.
Bitte setzen Sie sich mit mir in Verbindung, Sie erhalten einen Download Link.
Übersicht
Anmeldung an der ACMP SQL Datenbank
Das Custom Fields Tool benötigt einen Zugriff auf die ACMP Datenbank.
Ein lesender Zugriff reicht aus, um die Metainformationen der Tabellen abzurufen und Queries zu erstellen und auszuführen.
Sollen Daten in den Tabellen geändert werden oder Datensätze gelöscht werden, benötigt man einen schreibenden Zugriff.
Die Anmeldung ist über die Windows Authentifizierung ebenso möglich, wie über die SQL Authentifizierung.
Aus Gründen der Einfachheit, aber insbesondere der Datensicherheit, wird die Windows-Authentifizierung empfohlen.
Wird das ACMP Custom Fields Tool auf dem ACMP Server selbst aufgerufen, dann kann der Servername automatisch ermittelt werden. Den Datenbanknamen findet man ggf. über das Management Studio heraus.
Die Übersicht | Alles Wichtige auf einen Blick
In der Grundansicht sieht man alle benutzerdefinierten Tabellen, sowohl mit dem Klartextnamen, wie auch dem iternen Tabellennamen.
Zu der jeweils gewählten Tabelle werden die Felder angezeigt, ebenfalls mit der englischen und deutschen Benennung, sowie den Datenformaten der zugrundeliegenden SQL Tabelle.
Auch die Inhalte der Tabellen selbst werden dargestellt. Dabei werden die Daten in einem lesbaren Format ausgegeben, was besonders bei Datumsfeldern vieles erleichtert.
Bereits hier ist ein gezieltes Löschen möglich. Das ist bei der Entwicklung von Client Commands sehr hilfreich.
Zur jeweils gewählten Tabelle besteht die Möglichkeit, den Query Creator zu starten.
Die Grundansicht, sowohl mit den Klartext Namen, wie auch den technischen Bezeichnungen innerhalb der SQL Tabelle und sonstigen wichtigen Infos für den Entwickler.
Der Query-Creator
Der Query Creator bietet vielfältige Möglichkeiten, um aus der zugrundeliegenden Tabelle automatisiert Queries zu erzeugen.
Diese können auch sofort ausgeführt werden. Dabei wurde die Handhabung an das Management Studio angelehnt.
Da die Tabellen der Customfields immer an einen Client gebunden sind, kann diese Tabelle auf Wunsch auch über einen Join verbunden und die wichtigsten Daten des Clients angezeigt werden.
Das gilt selbstverständlich auch für eine mögliche Verknüpfung zur Mandanten Tabelle um zu ermitteln, welchem Mandanten ein ACMP Objekt zugeordnet ist.
Bei den Benennungen der Felder kann zwischen den Klartextnamen und den Namen innerhalb der SQL Tabelle gewählt werden. Auch eine optionale Umwandlung von Feldtypen, wie dem Datum, vom technischen in ein lesbares Format sind möglich.
Der Query Creator innerhalb des ACMP Custom Fields Tools ist in der Lage, auch komplexe Queries automatisiert zu erstllen und auszuführen.
Formatierung von Daten
In einer Tabelle liegen manche Daten in keinem einfach lesbaren Format vor.
Das gilt für IPv4 Adressen, aber insbesondere für Datums- und Zeitfelder. Bei letzteren ist es durchaus üblich, diese im sogenannten 'Float' Format abzulegen.
Da ACMP zu jedem Feld eigene Metadaten liefert, können diese abgefragt werden. Damit ist eine automatische Umwandlung in ein lesbares Format möglich. Diese Umwandlung erfolgt auf der Ebene der SQL Query. Auf Wunsch kann das Datenfeld zusätzlich im Original, dem 'Raw' Format mit ausgegeben werden.
Alle, die bereits im Management Studio mit Datumsfeldern von ACMP zu tun hatten haben festgestellt, dass ACMP einen weniger verbreiteten Grundwert für die Datumsberechnung hat. Das fällt nicht auf, wenn man ausschließlich in der ACMP Umgebung entwickelt. Beim direkten Zugriff auf die Datenbank, muss das jedoch berücksichtigt werden. Daher erfolgt auch im ACMP Custom Fields Tool diese Anpassung durchängig.
Ein Datumsfeld kann im lesbaren ANSI Format, aber auch im Original, dem Raw Format ausgegeben werden. Die Anpassung an den von ACMP verwendeten Grundwert erfolgt dabei automatisch.
SQL Queries innerhalb von ACMP Client Commands
ACMP Client Commands sind Skripte in der ACMP eigenen interaktiven Skriptsprache. Einer der vielen Befehle dieser Sprache, ist auch eine SQL Query.
Dabei kümmert sich das Client Command selbständig um eine korrekte Verbindung zur ACMP Datenbank.
Die Query selbst muss jedoch manuell erstellt werden.
Auch hier hilft das ACMP Custom Fields Tool erheblich. Viele der Queries die nötig sind, können in diesem Werkzeug ebenfalls interaktiv definiert werden. Die meisten sind dann ohne, oder nur mit kleinen Anpassungen, im Client Command einsetzbar.
Eine mit dem ACMP Custom Fields Tool erstellt Query, die alle Einträge in einer benutzerdefinierten Tabelle löscht, die zu dem betreffenden Client gehören.
Übergang zum SQL Management Studio
Einfache Aufgaben können mit dem ACMP Custom Fields Tool vollständig erledigt werden.
Für komplexere Abfragen oder weitere Datenanbinungen, ist das Management Studio unumgänglich.
Doch gerade für solche Tätigkeiten übernimmt das Tool einen Großteil der Vorarbeit. Es kennt alle internen Namen und Klartextnamen der benötigten Tabellen und Felder, sowie auch die ACMP eigenen 'Field Types', die Typen innerhalb des Client Management Systems.
Entweder man lässt sich die Typumwandlung abnehmen, oder arbeitet mit den Raw Typen. Hier kann man das ACMP Custom Fields Tool damit beauftragen, die entsprechenden Metadaten in die Kommentare zu den jeweiligen Felder zu schreiben. Das erleichtert die Handhabung im Management Studio erheblich.
Eine mit dem ACMP Custom Fields Tool erstellt Query wird im Management Studio ausgeführt.