AccUnit - Benutzerbeiträge [de]

Installation

Sten Schmidt — Wed, 23 May 2012 18:10:29 GMT

Sten Schmidt:

__NOTOC__ [[en:Installation]]
===Vorbereitung===

Vor der Installation von AccUnit sollten Sie überprüfen, ob in Ihren Access- bzw. Excel-Einstellungen bei den ''Einstellungen für Makros'' die Option ''[[Zugriff auf das VBA-Projektobjektmodell vertrauen]]'' aktiviert ist (siehe auch [http://bug.access-codelib.net/view.php?id=78 Bug #78]).

===Installation===

Für die Verwendung von AccUnit muss [[SimplyVBUnit|SimplyVBUnit 3.0]] installiert sein.
SimplyVBUnit ist ein in Visual Basic 6 geschriebenes Testframework.
Weitere Informationen zu VBUnit finden Sie auf
der [http://sourceforge.net/projects/simplyvbunit/ Projektseite von SimplyVBUnit auf sourceforge].

Laden Sie die [http://sourceforge.net/projects/simplyvbunit/files/latest/download Setup-Datei] von sourceforge herunter.
Danach können Sie [http://accunit.access-codelib.net/download/AccUnitSetup.zip AccUnitSetup.zip]
herunterladen und die Installation mit ''Setup.exe'' starten.

=== AccUnit als VBE-Add-In verwenden ===
AccUnit installiert sich als VBE AddIn im Visual Basic Editor.
Sie finden AccUnit einmal als Menüpunkt unter Extras->AccUnit
und zweitens als zusätzlich Symbolleiste mit drei Symbolen.

[[Bild:AccUnit-Menue.jpg]]

[[Datei:AccUnit_AddIn_Commandbar_Beschreibung.png]]

Tipps und Tricks

Sten Schmidt — Wed, 23 May 2012 18:10:10 GMT

Sten Schmidt:

== Bekannte Probleme ==

* AccUnit verursacht (derzeit noch) Probleme bei der Verwendung unter Access 2000.

Installation

Sten Schmidt — Tue, 22 May 2012 21:30:05 GMT

Sten Schmidt:

__NOTOC__ [[en:Installation]]
===Vorbereitung===

Vor der Installation von AccUnit sollten Sie überprüfen, ob in Ihren Access- bzw. Excel-Einstellungen bei den ''Einstellungen für Makros'' die Option ''[[Zugriff auf das VBA-Projektobjektmodell vertrauen]]'' aktiviert ist (siehe auch [http://bug.access-codelib.net/view.php?id=78 Bug #78]).

===Installation===

Für die Verwendung von AccUnit muss [[SimplyVBUnit|SimplyVBUnit 3.0]] installiert sein.
SimplyVBUnit ist ein in Visual Basic 6 geschriebenes Testframework.
Weitere Informationen zu VBUnit finden Sie auf
der [http://sourceforge.net/projects/simplyvbunit/ Projektseite von SimplyVBUnit auf sourceforge].

Laden Sie die [http://sourceforge.net/projects/simplyvbunit/files/latest/download Setup-Datei] von sourceforge herunter.
Danach können Sie [http://accunit.access-codelib.net/download/AccUnitSetup.zip AccUnitSetup.zip]
herunterladen und die Installation mit ''Setup.exe'' starten.

Hinweis:

AccUnit verursacht (derzeit noch) Probleme bei der Verwendung unter Access 2000.

=== AccUnit als VBE-Add-In verwenden ===
AccUnit installiert sich als VBE AddIn im Visual Basic Editor.
Sie finden AccUnit einmal als Menüpunkt unter Extras->AccUnit
und zweitens als zusätzlich Symbolleiste mit drei Symbolen.

[[Bild:AccUnit-Menue.jpg]]

[[Datei:AccUnit_AddIn_Commandbar_Beschreibung.png]]

Installation

Sten Schmidt — Tue, 22 May 2012 21:29:11 GMT

Sten Schmidt: /* Vorbereitung */

__NOTOC__ [[en:Installation]]

===Vorbereitung===

Vor der Installation von AccUnit sollten Sie überprüfen, ob in Ihren Access- bzw. Excel-Einstellungen bei den ''Einstellungen für Makros'' die Option ''[[Zugriff auf das VBA-Projektobjektmodell vertrauen]]'' aktiviert ist (siehe auch [http://bug.access-codelib.net/view.php?id=78 Bug #78]).

===Installation===

Für die Verwendung von AccUnit muss [[SimplyVBUnit|SimplyVBUnit 3.0]] installiert sein.
SimplyVBUnit ist ein in Visual Basic 6 geschriebenes Testframework.
Weitere Informationen zu VBUnit finden Sie auf
der [http://sourceforge.net/projects/simplyvbunit/ Projektseite von SimplyVBUnit auf sourceforge].

Laden Sie die [http://sourceforge.net/projects/simplyvbunit/files/latest/download Setup-Datei] von sourceforge herunter.
Danach können Sie [http://accunit.access-codelib.net/download/AccUnitSetup.zip AccUnitSetup.zip]
herunterladen und die Installation mit ''Setup.exe'' starten.

Hinweis:

AccUnit verursacht (derzeit noch) Probleme bei der Verwendung unter Access 2000.

=== AccUnit als VBE-Add-In verwenden ===
AccUnit installiert sich als VBE AddIn im Visual Basic Editor.
Sie finden AccUnit einmal als Menüpunkt unter Extras->AccUnit
und zweitens als zusätzlich Symbolleiste mit drei Symbolen.

[[Bild:AccUnit-Menue.jpg]]

[[Datei:AccUnit_AddIn_Commandbar_Beschreibung.png]]

Installation

Sten Schmidt — Tue, 22 May 2012 15:36:11 GMT

Sten Schmidt: Bug #78

__NOTOC__ [[en:Installation]]

===Vorbereitung===

Vor der Installation von AccUnit sollten Sie überprüfen, ob in Ihren Access- bzw. Excel-Einstellungen bei ''Vertrauensstellungscenter >> Einstellungen für Makros'' die Option ''Zugriff auf das VBA-Projektobjektmodell vertrauen'' aktiviert ist (siehe [http://bug.access-codelib.net/view.php?id=78 Bug #78]).

===Installation===

Für die Verwendung von AccUnit muss [[SimplyVBUnit|SimplyVBUnit 3.0]] installiert sein.
SimplyVBUnit ist ein in Visual Basic 6 geschriebenes Testframework.
Weitere Informationen zu VBUnit finden Sie auf
der [http://sourceforge.net/projects/simplyvbunit/ Projektseite von SimplyVBUnit auf sourceforge].

Laden Sie die [http://sourceforge.net/projects/simplyvbunit/files/latest/download Setup-Datei] von sourceforge herunter.
Danach können Sie [http://accunit.access-codelib.net/download/AccUnitSetup.zip AccUnitSetup.zip]
herunterladen und die Installation mit ''Setup.exe'' starten.

Hinweis:

AccUnit verursacht (derzeit noch) Probleme bei der Verwendung unter Access 2000.

=== AccUnit als VBE-Add-In verwenden ===
AccUnit installiert sich als VBE AddIn im Visual Basic Editor.
Sie finden AccUnit einmal als Menüpunkt unter Extras->AccUnit
und zweitens als zusätzlich Symbolleiste mit drei Symbolen.

[[Bild:AccUnit-Menue.jpg]]

[[Datei:AccUnit_AddIn_Commandbar_Beschreibung.png]]

Der erste Test

Sten Schmidt — Mon, 21 May 2012 19:56:25 GMT

Sten Schmidt: /* Typo fixed */

[[en: The first Test]]
== Der erste Test ==

Den ersten Test wollen wir natürlich nicht mit einem komplexen sondern mit einem ganz simplen Beispiel beginnen:
Es soll eine Funktion erstellt werden, die zu einem Dezimal Wert die binäre Darstellung liefert.

Ein entsprechende VBA Funktion könnte also so aussehen:
<source>Public Function Dez2Bin(ByVal TheValue As Long) As String</source>

Wie könnte also der erste Test lauten ?
- Die Funktion Dez2Bin
- liefert bei einer Eingabe des Dezimalwerts 0
- einen String mit der Ziffer "0"

Erstellen Sie also ein neues Modul mit dem oben genannten Funktionsrumpf. Klicken Sie innerhalb dieser Funktion die rechte Maustaste und wählen Sie "Neue Testmethode einfügen", es öffnet sich der Dialog zum Einfügen einer neue Testmethode:

[[Bild: AccUnit-Test1.jpg]]
[[Bild: AccUnit-DialogEinfuegen.jpg]]

AccUnit wird zu unserem Modul mit den zu testenden Funktionen eine neue Testklasse erstellen, in denen dann die Testmethoden untergebracht sind. Das Modul mit der Funktion Dez2Bin habe ich "Umrechungen" genannt. AccUnit schlägt als Name für die Testklasse "UmrechnungeTest" vor, den Sie so übernehmen sollten. Bei den zu testenden Methode ist schon unsere Funktion Dez2Bin ausgewählt, so daß wir nur noch den zu testenden Zustand und das erwartete Verhalten eintragen müssen.
Als zu testender Zustand tragen wir ein: "mitEingabe0"
und als erwartetes Verhalten: "liefertdenString0"
AccUnit erzeugt aus diesen beiden Angaben den Namen der Testmethode. Achten Sie also darauf, daß Sie keine Leerzeichen, Anführungszeichen oder andere Sonderzeichen verwenden, die in Methodennamen nicht erlaubt sind.

AccUnit erzeugt die die Testklasse:
<source>
Option Compare Text
Option Explicit
'AccUnit:TestClass
'--------------------------------------------------------------------
' AccUnit Infrastructure
'--------------------------------------------------------------------
Implements SimplyVBUnit.ITestFixture
Implements AccUnit_Integration.ITestManagerBridge
Private TestManager As AccUnit_Integration.TestManager
Private Sub ITestManagerBridge_InitTestManager(ByVal NewTestManager As AccUnit_Integration.ITestManagerComInterface): Set TestManager = NewTestManager: End Sub
Private Function ITestManagerBridge_GetTestManager() As AccUnit_Integration.ITestManagerComInterface: Set ITestManagerBridge_GetTestManager = TestManager: End Function
Private Sub ITestFixture_AddTestCases(ByVal Tests As SimplyVBUnit.TestCaseCollector): TestManager.AddTestCases Tests: End Sub
'--------------------------------------------------------------------
' Tests
'--------------------------------------------------------------------
'
Public Sub Dez2Bin_mitEingabe0_liefertdenString0()
' Arrange
Err.Raise vbObjectError, "Dez2Bin_mitEingabe0_liefertdenString0", "Not implemented"
' Act
' Assert
Assert.That 1, Iz.EqualTo(1)
End Sub
</source>

In dem Bereich 'AccUnit Infrastructure' werden ein paar Funktionen definiert die von der Testumgebung benötigt werden.
Bitte nehmen Sie in diesem Bereich KEINE Änderungen vor.

In unserer Testprozedur Dez2Bin_mitEingabe0_liefertdenString0 sehen Sie schon durch die Kommentare angedeutet, aus welchen Schritten ein Test bestehen sollte:

- Arrange : Vorbereitungen zum Test - Variablen definieren - Vorgabewerte festlegen
- Act: Die zu testende Funktion mit den Vorgabewerten aufrufen und das Ergebniss erhalten
- Assert: Das erhaltene Ergebniss mit dem erwarteten Ergebniss vergleichen

Ändern Sie also die Testprozedur ab:
<source>
Public Sub Dez2Bin_mitEingabe0_liefertdenString0()
' Arrange
Dim Eingabe As Long
Dim Ergebniss As String
Dim Erwartet As String

Eingabe = 0
Erwartet = "0"

' Act
Ergebniss = Dez2Bin(Eingabe)

' Assert
Assert.That Ergebniss, Iz.EqualTo(Erwartet)
End Sub
</source>

Den Test können Sie jetzt mit dem Kontextmenü der rechten Maustaste starten: "Aktiven Test ausführen".
Es öffnet sich ein zusätzliches Fenster in denen Ihnen TestUnit das Ergebnis des Tests anzeigt:

[[Bild: AccUnit-TestErgebnis1.jpg]]

Mit einem Rechtsklick auf die Testbeschreibung können Sie das Detailfenster mit der ausführlichen Fehlerbeschreibung aufrufen. Der erste Fehler ist recht schnell zu erkennen: Wir liefern noch überhaupt kein Ergebnis zurück! Ändern wir als unsere Dez2Bin Funktion ab, damit ein korrektes Ergebnis geliefert wird:

<source>

Public Function Dez2Bin(ByVal TheValue As Long) As String
Dez2Bin = "0"
End Function

</source>

Einmal den Test wieder starten ( Entweder über das Kontextmenü oder über die Symbolleiste ) und voilá : alle Tests wurden erfolgreich durchgeführt, wir sind im Status "GRÜN"

[[Bild: AccUnit-TestErgebnis2.jpg]]

Verweise

Sten Schmidt — Mon, 21 May 2012 19:49:21 GMT

Sten Schmidt: +Verweise

=Verweise=

AccUnit benötigt die folgenden zwei Verweise:

* AccUnit Access/VBA TestSuite
* Simple VBUnit Framework v3.0

Diese werden durch AccUnit automatisch hinzugefügt bzw. [[Testumgebung_entfernen|entfernt]].

Testumgebung entfernen

Sten Schmidt — Mon, 21 May 2012 19:21:21 GMT

Sten Schmidt: /* Die Testumgebung vollständig entfernen */

== Entfernen der Testumgebung ==

=== Die Testumgebung vollständig entfernen ===

Über das [[Benutzeroberfläche#Menüeinträge|Menü]] ''Extras >> AccUnit-de >> Testumgebung entfernen'' werden alle Testklassen sowie die durch AccUnit hinzugefügten [[Verweise]] automatisch entfernt. In diesem Fall wird im aktuellen Arbeitsverzeichnis ein Ordner "[[Einstellungen|Tests]]" erzeugt, welcher ein Backup alle Ihrer Testklassen enthält.

Sofern Sie den Ordner "Tests" nicht löschen, können Sie die Testumgebung wiederherstellen, indem Sie im [[Benutzeroberfläche#Menüeinträge|Menü]] ''Extras >> AccUnit-de >> Tests importieren'' wählen.

=== Entfernen einzelner Testklassen ===

Wenn Sie einzelne Testklassen komplett entfernen (Löschen), erhalten Sie beim nächsten Kompilieren eine Fehlermeldung. Sie müssen in diesem Fall im Modul ''AccessUnit_TestClassFactory'' die zugehörige Funktion entfernen, welche die Instanz der gelöschte Testklasse erzeugt hat.

Alternativ können Sie auch das komplette Modul ''AccessUnit_TestClassFactory'' entfernen. Es wird automatisch beim nächsten Lauf von AccUnit wiederhergestellt.

=== Entfernen einzelner Tests ===

Einzelne Tests können in der jeweiligen Testklasse einfach gelöscht werden. Enthält eine Ihrer Testklassen keine Testmethode mehr, so wird diese im Fenster ''AccUnit Test-Liste'' mit einem Fragezeichen-Symbol dargestellt.

Testumgebung entfernen

Sten Schmidt — Mon, 21 May 2012 19:20:31 GMT

Sten Schmidt: /* QV Menü */

== Entfernen der Testumgebung ==

=== Die Testumgebung vollständig entfernen ===

Über das [[Benutzeroberfläche#Menüeinträge|Menü]] ''Extras >> AccUnit-de >> Testumgebung entfernen'' werden alle Testklassen sowie die durch AccUnit hinzugefügten [[Verweise]] automatisch entfernt. In diesem Fall wird im aktuellen Arbeitsverzeichnis ein Ordner "[[Einstellungen|Tests]]" erzeugt, welcher ein Backup alle Ihrer Testklassen enthält.

Sofern Sie den Ordner "Tests" nicht löschen, können Sie die Testumgebung wiederherstellen, indem Sie im Menü ''Extras >> AccUnit-de >> Tests importieren'' wählen.

=== Entfernen einzelner Testklassen ===

Wenn Sie einzelne Testklassen komplett entfernen (Löschen), erhalten Sie beim nächsten Kompilieren eine Fehlermeldung. Sie müssen in diesem Fall im Modul ''AccessUnit_TestClassFactory'' die zugehörige Funktion entfernen, welche die Instanz der gelöschte Testklasse erzeugt hat.

Alternativ können Sie auch das komplette Modul ''AccessUnit_TestClassFactory'' entfernen. Es wird automatisch beim nächsten Lauf von AccUnit wiederhergestellt.

=== Entfernen einzelner Tests ===

Einzelne Tests können in der jeweiligen Testklasse einfach gelöscht werden. Enthält eine Ihrer Testklassen keine Testmethode mehr, so wird diese im Fenster ''AccUnit Test-Liste'' mit einem Fragezeichen-Symbol dargestellt.

Einstellungen

Sten Schmidt — Mon, 21 May 2012 12:42:07 GMT

Sten Schmidt: /* Interner Link */

==Einstellungen==

=== Der Einstellungsdialog ===

Den Einstellungsdialog erreichen Sie über das Menü ''Extras >> AccUnit-de >> Einstellungen...''

[[Datei:AccUnit_AddIn_UserSettings.png]]

=== Verfügbare Einstellungsparameter ===

==== Add-in ====

===== RestoreVbeWindowsStateOnLoad =====

Legt fest, ob der Status des Treeview-Fensters beim Schließen gespeichert und beim Laden wiederhergestellt werden soll.

===== TestClassNameFormat =====

Parameter: ''%ModuleUnderTest%''

Legt die Namenskonvention für die Testklasse fest. Als Parameter wird der Name der zu testenden Klasse bzw. des Moduls eingesetzt.

==== Features ====

===== IsAccSpecEnabled =====

===== VbaProgrammingToolsEnabled =====

==== Import/Export ====

===== ImportExportFolder =====

Parameter: ''%APPFOLDER%'' - aktuelles Arbeitsverzeichnis <br />
Parameter: ''%APPNAME%'' - Name der aktuellen Datei (Access-Datenbank / Excel-File)

Legt den Pfad für den Im- und Export-Ordner für Testklassen fest. Beim [[Testumgebung entfernen|Entfernen der Testumgebung]] werden im hier definierten Pfad alle Testklassen gesichert.

==== Templates ====

===== TemplateFolder =====

===== TestMethodTemplate =====

===== UserDefinedTemplates =====

Installation

Sten Schmidt — Sun, 20 May 2012 22:24:19 GMT

Sten Schmidt: Satzbau

__NOTOC__ [[en:Installation]]

Für die Verwendung von AccUnit muss [[SimplyVBUnit|SimplyVBUnit 3.0]] installiert sein.
SimplyVBUnit ist ein in Visual Basic 6 geschriebenes Testframework.
Weitere Informationen zu VBUnit finden Sie auf
der [http://sourceforge.net/projects/simplyvbunit/ Projektseite von SimplyVBUnit auf sourceforge].

Laden Sie die [http://sourceforge.net/projects/simplyvbunit/files/latest/download Setup-Datei] von sourceforge herunter.
Danach können Sie [http://accunit.access-codelib.net/download/AccUnitSetup.zip AccUnitSetup.zip]
herunterladen und die Installation mit ''Setup.exe'' starten.

Hinweis:

AccUnit verursacht (derzeit noch) Probleme bei der Verwendung unter Access 2000.

=== AccUnit als VBE-Add-In verwenden ===
AccUnit installiert sich als VBE AddIn im Visual Basic Editor.
Sie finden AccUnit einmal als Menüpunkt unter Extras->AccUnit
und zweitens als zusätzlich Symbolleiste mit drei Symbolen.

[[Bild:AccUnit-Menue.jpg]]

[[Datei:AccUnit_AddIn_Commandbar_Beschreibung.png]]

Testumgebung entfernen

Sten Schmidt — Sun, 20 May 2012 22:19:25 GMT

Sten Schmidt: /* Die Testumgebung vollständig entfernen */

== Entfernen der Testumgebung ==

=== Die Testumgebung vollständig entfernen ===

Über das Menü ''Extras >> AccUnit-de >> Testumgebung entfernen'' werden alle Testklassen sowie die durch AccUnit hinzugefügten [[Verweise]] automatisch entfernt. In diesem Fall wird im aktuellen Arbeitsverzeichnis ein Ordner "[[Einstellungen|Tests]]" erzeugt, welcher ein Backup alle Ihrer Testklassen enthält.

Sofern Sie den Ordner "Tests" nicht löschen, können Sie die Testumgebung wiederherstellen, indem Sie im Menü ''Extras >> AccUnit-de >> Tests importieren'' wählen.

=== Entfernen einzelner Testklassen ===

Wenn Sie einzelne Testklassen komplett entfernen (Löschen), erhalten Sie beim nächsten Kompilieren eine Fehlermeldung. Sie müssen in diesem Fall im Modul ''AccessUnit_TestClassFactory'' die zugehörige Funktion entfernen, welche die Instanz der gelöschte Testklasse erzeugt hat.

Alternativ können Sie auch das komplette Modul ''AccessUnit_TestClassFactory'' entfernen. Es wird automatisch beim nächsten Lauf von AccUnit wiederhergestellt.

=== Entfernen einzelner Tests ===

Einzelne Tests können in der jeweiligen Testklasse einfach gelöscht werden. Enthält eine Ihrer Testklassen keine Testmethode mehr, so wird diese im Fenster ''AccUnit Test-Liste'' mit einem Fragezeichen-Symbol dargestellt.

AccUnit-Attribute

Sten Schmidt — Fri, 11 May 2012 10:12:58 GMT

Sten Schmidt: /* Beispiel */ source lang="vb"

__NOTOC__
== AccUnit:TestClass ==
Markiert eine Klasse als Testklasse.

==== Syntax ====
<source>' AccUnit:TestClass</source>

==== Verwendbar in ====
* Deklarationsbereich einer Klasse

== AccUnit:TestRelated ==
Markiert eine Klasse, Standardmodul bzw. Formulare/Berichte als Hilfsmodule für Tests. Diese Codemodule bzw. Formulare/Berichte können wie Testklassen importiert bzw. exportiert werden.

==== Syntax ====
<source>' AccUnit:TestRelated </source>

==== Verwendbar in ====
* Deklarationsbereich einer Klasse
* Deklarationsbereich eines Standardmoduls
* Deklarationsbereich eines Formular- oder Bericht-Moduls

== AccUnit:Row ==
Übergabe der Row-Test-Parameter

==== Syntax ====
<source>' AccUnit:Row(Param1, Param2)</source>

==== Verwendbar in ====
* Deklarationsbereich einer Testmethode

==== Beispiel ====

===== Methode/Funktion =====

<source lang="vb">
Public Function GetFoo(ByVal JaNein As String) As Boolean
GetFoo = False
If JaNein = "Ja" Then GetFoo = True
End Function
</source>

===== Test Methode =====

<source lang="vb">
'AccUnit:Row("Ja", True)
'AccUnit:Row("Nein", False)
Public Sub GetFoo_ValueTest(ByVal value As String, ByVal Expected As Boolean)
Assert.That GetFoo(value), Iz.EqualTo(Expected)
End Sub
</source>

== AccUnit:Tags ==
Markiert Testklassen bzw. Testmethoden. Kann zum Filtern der Tests verwendet werden.

==== Syntax ====
<source>' AccUnit:Tags(Tag1, Tag2, Tag3)</source>

==== Verwendbar in ====
* Deklarationsbereich einer Testklasse
* Deklarationsbereich einer Testmethode

== AccUnit:Ignore ==
Testklasse oder Methode nicht ausführen.

==== Syntax ====
<source>' AccUnit:Ignore
' AccUnit:Ignore(Comment)
' AccUnit:Row(Param1, Param2).Ignore(Comment)</source>

==== Verwendbar in ====
* Deklarationsbereich einer Klasse
* Deklarationsbereich einer Testmethode
* Erweiterung des Row-Attributs

== AccUnit:ClickingMsgBox ==

Mausklicks für Msgbox-Ersatzfunktion

==== Syntax ====
<source>' AccUnit:ClickingMsgBox(vbYes, vbOk, vbNo)
' AccUnit:Row(Param1, Param2).ClickingMsgBox(vbYes, vbOk, vbNo))</source>

==== Verwendbar in ====
* Deklarationsbereich einer Testmethode
* Erweiterung des Row-Attributs

== AccUnit:Rollback ==

Erzeugt vor jedem Lauf der Testmethode eine Transaktion auf den Standard Jet-Workspace (DAO) und rollt diese Transaktion nach dem Lauf der Testmethode wieder zurück.

==== Syntax ====
<source>' AccUnit:Rollback</source>

==== Verwendbar in ====
* Deklarationsbereich einer Testmethode

==== ''Nicht'' verwendbar bei ====
* Eingebauten Domänenaggregatfunktionen (DLookup, DCount, etc.) - hier Ersatzfunktionen verwenden
* Produktionscode der selbst Transaktionen verwendet.
* Per OleDb eingebundene SQL-Server Backends

==== Vorsicht ====
Der Rollback setzt den Zähler für AutoWert-Spalten nicht zurück. Nach einem zurückgerollten Insert ist der dabei vergebene AutoWert nicht mehr verfügbar.

Grundlagen

Sten Schmidt — Fri, 11 May 2012 10:11:25 GMT

Sten Schmidt:

[[en:Basics]]
Eine Software zu testen bedeutet, festzustellen, ob die Software an sie gestellte Anforderungen auch erfüllt.

Anforderungen in Umgangssprache sind jedoch nicht geeignet als Grundlage eines Tests.
( "Naja, das Ding soll halt nicht abstürzen" oder "Wenn ich da vorne 100 eingebe, dann soll da hinten irgendwas rauskommen.. " )

Zudem ist es nicht möglich komplexe Applikationen präzise zu beschreiben.

Zum Testen von Software ist es also wichtig, die große Komplexität einer Applikation in kleine testbare Programmfragmente ( = Funktionen / Prozeduren) aufzuteilen.
Diese Programmfragmente sollten dann EINE Aufgabe erledigen, so daß man dieses Programmfragment testet in dem man beschreibt:

- welches Programmfragment ( Modul, Klasse, Funktion, Sub ) teste ich
- welche Eingabewerte ( Vorbedingungen ) definiere ich
- welche Ausgabewerte ( Nachbedingungen ) erwarte ich

Unter Umständen wird es also nötig sein den bestehenden Programmcode zu überarbeiten und in kleine testbare Einheiten zu zerlegen.

[[Der erste Test]]

[[Tests erstellen]]

[[Testumgebung entfernen]]

[[Einstellungen]]

[[AccUnit-Attribute]]

AccUnit-Attribute

Sten Schmidt — Fri, 11 May 2012 08:45:15 GMT

Sten Schmidt: /* AccUnit:Row */ +Beispiel

__NOTOC__
== AccUnit:TestClass ==
Markiert eine Klasse als Testklasse.

==== Syntax ====
<source>' AccUnit:TestClass</source>

==== Verwendbar in ====
* Deklarationsbereich einer Klasse

== AccUnit:TestRelated ==
Markiert eine Klasse, Standardmodul bzw. Formulare/Berichte als Hilfsmodule für Tests. Diese Codemodule bzw. Formulare/Berichte können wie Testklassen importiert bzw. exportiert werden.

==== Syntax ====
<source>' AccUnit:TestRelated </source>

==== Verwendbar in ====
* Deklarationsbereich einer Klasse
* Deklarationsbereich eines Standardmoduls
* Deklarationsbereich eines Formular- oder Bericht-Moduls

== AccUnit:Row ==
Übergabe der Row-Test-Parameter

==== Syntax ====
<source>' AccUnit:Row(Param1, Param2)</source>

==== Verwendbar in ====
* Deklarationsbereich einer Testmethode

==== Beispiel ====

===== Methode/Funktion =====

<pre>
Public Function GetFoo(ByVal JaNein As String) As Boolean
GetFoo = False
If JaNein = "Ja" Then GetFoo = True
End Function
</pre>

===== Test Methode =====

<pre>
'AccUnit:Row("Ja", True)
'AccUnit:Row("Nein", False)
Public Sub GetFoo_ValueTest(ByVal value As String, ByVal Expected As Boolean)
Assert.That GetFoo(value), Iz.EqualTo(Expected)
End Sub
</pre>

== AccUnit:Tags ==
Markiert Testklassen bzw. Testmethoden. Kann zum Filtern der Tests verwendet werden.

==== Syntax ====
<source>' AccUnit:Tags(Tag1, Tag2, Tag3)</source>

==== Verwendbar in ====
* Deklarationsbereich einer Testklasse
* Deklarationsbereich einer Testmethode

== AccUnit:Ignore ==
Testklasse oder Methode nicht ausführen.

==== Syntax ====
<source>' AccUnit:Ignore
' AccUnit:Ignore(Comment)
' AccUnit:Row(Param1, Param2).Ignore(Comment)</source>

==== Verwendbar in ====
* Deklarationsbereich einer Klasse
* Deklarationsbereich einer Testmethode
* Erweiterung des Row-Attributs

== AccUnit:ClickingMsgBox ==

Mausklicks für Msgbox-Ersatzfunktion

==== Syntax ====
<source>' AccUnit:ClickingMsgBox(vbYes, vbOk, vbNo)
' AccUnit:Row(Param1, Param2).ClickingMsgBox(vbYes, vbOk, vbNo))</source>

==== Verwendbar in ====
* Deklarationsbereich einer Testmethode
* Erweiterung des Row-Attributs

== AccUnit:Rollback ==

Erzeugt vor jedem Lauf der Testmethode eine Transaktion auf den Standard Jet-Workspace (DAO) und rollt diese Transaktion nach dem Lauf der Testmethode wieder zurück.

==== Syntax ====
<source>' AccUnit:Rollback</source>

==== Verwendbar in ====
* Deklarationsbereich einer Testmethode

==== ''Nicht'' verwendbar bei ====
* Eingebauten Domänenaggregatfunktionen (DLookup, DCount, etc.) - hier Ersatzfunktionen verwenden
* Produktionscode der selbst Transaktionen verwendet.
* Per OleDb eingebundene SQL-Server Backends

==== Vorsicht ====
Der Rollback setzt den Zähler für AutoWert-Spalten nicht zurück. Nach einem zurückgerollten Insert ist der dabei vergebene AutoWert nicht mehr verfügbar.

Einstellungen

Sten Schmidt — Fri, 11 May 2012 08:32:46 GMT

Sten Schmidt:

==Einstellungen==

=== Der Einstellungsdialog ===

Den Einstellungsdialog erreichen Sie über das Menü ''Extras >> AccUnit-de >> Einstellungen...''

[[Datei:AccUnit_AddIn_UserSettings.png]]

=== Verfügbare Einstellungsparameter ===

==== Add-in ====

===== RestoreVbeWindowsStateOnLoad =====

Legt fest, ob der Status des Treeview-Fensters beim Schließen gespeichert und beim Laden wiederhergestellt werden soll.

===== TestClassNameFormat =====

Parameter: ''%ModuleUnderTest%''

Legt die Namenskonvention für die Testklasse fest. Als Parameter wird der Name der zu testenden Klasse bzw. des Moduls eingesetzt.

==== Features ====

===== IsAccSpecEnabled =====

===== VbaProgrammingToolsEnabled =====

==== Import/Export ====

===== ImportExportFolder =====

Parameter: ''%APPFOLDER%'' - aktuelles Arbeitsverzeichnis <br />
Parameter: ''%APPNAME%'' - Name der aktuellen Datei (Access-Datenbank / Excel-File)

Legt den Pfad für den Im- und Export-Ordner für Testklassen fest. Beim Entfernen der Testumgebung (siehe auch: [[Testumgebung entfernen]]) werden im hier definierten Pfad alle Testklassen gesichert.

==== Templates ====

===== TemplateFolder =====

===== TestMethodTemplate =====

===== UserDefinedTemplates =====

Einstellungen

Sten Schmidt — Fri, 11 May 2012 08:22:33 GMT

Sten Schmidt: /* ImportExportFolder */

==Einstellungen==

=== Der Einstellungsdialog ===

Den Einstellungsdialog erreichen Sie über das Menü ''Extras >> AccUnit-de >> Einstellungen...''

[[Datei:AccUnit_AddIn_UserSettings.png]]

=== Verfügbare Einstellungsparameter ===

==== RestoreVbeWindowsStateOnLoad ====

Legt fest, ob der Status des Treeview-Fensters beim Schließen gespeichert und beim Laden wiederhergestellt werden soll.

==== TestClassNameFormat ====

Parameter: ''%ModuleUnderTest%''

Legt die Namenskonvention für die Testklasse fest. Als Parameter wird der Name der zu testenden Klasse bzw. des Moduls eingesetzt.

==== IsAccSpecEnabled ====

==== VbaProgrammingToolsEnabled ====

==== ImportExportFolder ====

Parameter: ''%APPFOLDER%'' - aktuelles Arbeitsverzeichnis <br />
Parameter: ''%APPNAME%'' - Name der aktuellen Datei (Access-Datenbank / Excel-File)

Legt den Pfad für den Im- und Export-Ordner für Testklassen fest. Beim Entfernen der Testumgebung (siehe auch: [[Testumgebung entfernen]]) werden im hier definierten Pfad alle Testklassen gesichert.

==== TemplateFolder ====

==== TestMethodTemplate ====

==== UserDefinedTemplates ====

Einstellungen

Sten Schmidt — Fri, 11 May 2012 08:22:11 GMT

Sten Schmidt: /* ImportExportFolder */

==Einstellungen==

=== Der Einstellungsdialog ===

Den Einstellungsdialog erreichen Sie über das Menü ''Extras >> AccUnit-de >> Einstellungen...''

[[Datei:AccUnit_AddIn_UserSettings.png]]

=== Verfügbare Einstellungsparameter ===

==== RestoreVbeWindowsStateOnLoad ====

Legt fest, ob der Status des Treeview-Fensters beim Schließen gespeichert und beim Laden wiederhergestellt werden soll.

==== TestClassNameFormat ====

Parameter: ''%ModuleUnderTest%''

Legt die Namenskonvention für die Testklasse fest. Als Parameter wird der Name der zu testenden Klasse bzw. des Moduls eingesetzt.

==== IsAccSpecEnabled ====

==== VbaProgrammingToolsEnabled ====

==== ImportExportFolder ====

Parameter: ''%APPFOLDER%'' - aktuelles Arbeitsverzeichnis
Parameter: ''%APPNAME%'' - Name der aktuellen Datei (Access-Datenbank / Excel-File)

Legt den Pfad für den Im- und Export-Ordner für Testklassen fest. Beim Entfernen der Testumgebung (siehe auch: [[Testumgebung entfernen]]) werden im hier definierten Pfad alle Testklassen gesichert.

==== TemplateFolder ====

==== TestMethodTemplate ====

==== UserDefinedTemplates ====

Einstellungen

Sten Schmidt — Fri, 11 May 2012 08:16:20 GMT

Sten Schmidt: /* TestClassNameFormat */

Einstellungen

Sten Schmidt — Fri, 11 May 2012 08:12:48 GMT

Sten Schmidt: /* Verfügbare Einstellungsparameter */

Einstellungen

Sten Schmidt — Tue, 08 May 2012 10:32:43 GMT

Sten Schmidt: Die Seite wurde neu angelegt: „==Einstellungen== === Der Einstellungsdialog === Den Einstellungsdialog erreichen Sie über das Menü ''Extras >> AccUnit-de >> Einstellungen...'' [[Datei:AccU…“

Testumgebung entfernen

Sten Schmidt — Tue, 08 May 2012 10:27:28 GMT

Sten Schmidt: /* Die Testumgebung vollständig entfernen */

== Entfernen der Testumgebung ==

=== Die Testumgebung vollständig entfernen ===

Über das Menü ''Extras >> AccUnit-de >> Testumgebung entfernen'' werden alle Testklassen sowie die durch AccUnit hinzugefügten [[Verweise]] automatisch entfernt. In diesem Fall wird im aktuellen Arbeitsverzeichnis ein Ordner "Tests" erzeugt (siehe auch [[Einstellungen]]), welcher ein Backup alle Ihrer Testklassen enthält.

Sofern Sie den Ordner "Tests" nicht löschen, können Sie die Testumgebung wiederherstellen, indem Sie im Menü ''Extras >> AccUnit-de >> Tests importieren'' wählen.

=== Entfernen einzelner Testklassen ===

Wenn Sie einzelne Testklassen komplett entfernen (Löschen), erhalten Sie beim nächsten Kompilieren eine Fehlermeldung. Sie müssen in diesem Fall im Modul ''AccessUnit_TestClassFactory'' die zugehörige Funktion entfernen, welche die Instanz der gelöschte Testklasse erzeugt hat.

Alternativ können Sie auch das komplette Modul ''AccessUnit_TestClassFactory'' entfernen. Es wird automatisch beim nächsten Lauf von AccUnit wiederhergestellt.

=== Entfernen einzelner Tests ===

Einzelne Tests können in der jeweiligen Testklasse einfach gelöscht werden. Enthält eine Ihrer Testklassen keine Testmethode mehr, so wird diese im Fenster ''AccUnit Test-Liste'' mit einem Fragezeichen-Symbol dargestellt.

Testumgebung entfernen

Sten Schmidt — Tue, 08 May 2012 10:24:11 GMT

Sten Schmidt: /* Vollständig */

== Entfernen der Testumgebung ==

=== Die Testumgebung vollständig entfernen ===

Über das Menü ''Extras >> AccUnit-de >> Testumgebung entfernen'' werden alle Testklassen sowie die durch AccUnit hinzugefügten Verweise automatisch entfernt. In diesem Fall wird im aktuellen Arbeitsverzeichnis ein Ordner "Tests" erzeugt, welcher ein Backup alle Ihrer Testklassen enthält.

Sofern Sie den Ordner "Tests" nicht löschen, können Sie die Testumgebung wiederherstellen, indem Sie im Menü ''Extras >> AccUnit-de >> Tests importieren'' wählen.

=== Entfernen einzelner Testklassen ===

Wenn Sie einzelne Testklassen komplett entfernen (Löschen), erhalten Sie beim nächsten Kompilieren eine Fehlermeldung. Sie müssen in diesem Fall im Modul ''AccessUnit_TestClassFactory'' die zugehörige Funktion entfernen, welche die Instanz der gelöschte Testklasse erzeugt hat.

Alternativ können Sie auch das komplette Modul ''AccessUnit_TestClassFactory'' entfernen. Es wird automatisch beim nächsten Lauf von AccUnit wiederhergestellt.

=== Entfernen einzelner Tests ===

Einzelne Tests können in der jeweiligen Testklasse einfach gelöscht werden. Enthält eine Ihrer Testklassen keine Testmethode mehr, so wird diese im Fenster ''AccUnit Test-Liste'' mit einem Fragezeichen-Symbol dargestellt.

Grundlagen

Sten Schmidt — Tue, 08 May 2012 10:22:24 GMT

Sten Schmidt:

[[en:Basics]]
Eine Software zu testen bedeutet, festzustellen, ob die Software an sie gestellte Anforderungen auch erfüllt.

Anforderungen in Umgangssprache sind jedoch nicht geeignet als Grundlage eines Tests.
( "Naja, das Ding soll halt nicht abstürzen" oder "Wenn ich da vorne 100 eingebe, dann soll da hinten irgendwas rauskommen.. " )

Zudem ist es nicht möglich komplexe Applikationen präzise zu beschreiben.

Zum Testen von Software ist es also wichtig, die große Komplexität einer Applikation in kleine testbare Programmfragmente ( = Funktionen / Prozeduren) aufzuteilen.
Diese Programmfragmente sollten dann EINE Aufgabe erledigen, so daß man dieses Programmfragment testet in dem man beschreibt:

- welches Programmfragment ( Modul, Klasse, Funktion, Sub ) teste ich
- welche Eingabewerte ( Vorbedingungen ) definiere ich
- welche Ausgabewerte ( Nachbedingungen ) erwarte ich

Unter Umständen wird es also nötig sein den bestehenden Programmcode zu überarbeiten und in kleine testbare Einheiten zu zerlegen.

[[Der erste Test]]

[[Der zweite und der dritte Test]]

[[Testumgebung entfernen]]

[[Einstellungen]]

[[AccUnit-Attribute]]

Tipps und Tricks

Sten Schmidt — Tue, 08 May 2012 10:17:56 GMT

Sten Schmidt: Inhalt auf eigene Seite ausgelagert (-> Testumgebung entfernen)

Testumgebung entfernen

Sten Schmidt — Tue, 08 May 2012 10:17:08 GMT

Sten Schmidt: Eingene Seite für Testumgebung entfernen

== Entfernen der Testumgebung ==

=== Vollständig ===

Über das Menü ''Extras >> AccUnit-de >> Testumgebung entfernen'' werden alle Testklassen sowie die durch AccUnit hinzugefügten Verweise automatisch entfernt. In diesem Fall wird im aktuellen Arbeitsverzeichnis ein Ordner "Tests" erzeugt, welcher ein Backup alle Ihrer Testklassen enthält.

Sofern Sie den Ordner "Tests" nicht löschen, können Sie die Testumgebung wiederherstellen, indem Sie im Menü ''Extras >> AccUnit-de >> Tests importieren'' wählen.

=== Entfernen einzelner Testklassen ===

Wenn Sie einzelne Testklassen komplett entfernen (Löschen), erhalten Sie beim nächsten Kompilieren eine Fehlermeldung. Sie müssen in diesem Fall im Modul ''AccessUnit_TestClassFactory'' die zugehörige Funktion entfernen, welche die Instanz der gelöschte Testklasse erzeugt hat.

Alternativ können Sie auch das komplette Modul ''AccessUnit_TestClassFactory'' entfernen. Es wird automatisch beim nächsten Lauf von AccUnit wiederhergestellt.

=== Entfernen einzelner Tests ===

Einzelne Tests können in der jeweiligen Testklasse einfach gelöscht werden. Enthält eine Ihrer Testklassen keine Testmethode mehr, so wird diese im Fenster ''AccUnit Test-Liste'' mit einem Fragezeichen-Symbol dargestellt.

Grundlagen

Sten Schmidt — Tue, 08 May 2012 10:16:31 GMT

Sten Schmidt:

[[en:Basics]]
Eine Software zu testen bedeutet, festzustellen, ob die Software an sie gestellte Anforderungen auch erfüllt.

Anforderungen in Umgangssprache sind jedoch nicht geeignet als Grundlage eines Tests.
( "Naja, das Ding soll halt nicht abstürzen" oder "Wenn ich da vorne 100 eingebe, dann soll da hinten irgendwas rauskommen.. " )

Zudem ist es nicht möglich komplexe Applikationen präzise zu beschreiben.

Zum Testen von Software ist es also wichtig, die große Komplexität einer Applikation in kleine testbare Programmfragmente ( = Funktionen / Prozeduren) aufzuteilen.
Diese Programmfragmente sollten dann EINE Aufgabe erledigen, so daß man dieses Programmfragment testet in dem man beschreibt:

- welches Programmfragment ( Modul, Klasse, Funktion, Sub ) teste ich
- welche Eingabewerte ( Vorbedingungen ) definiere ich
- welche Ausgabewerte ( Nachbedingungen ) erwarte ich

Unter Umständen wird es also nötig sein den bestehenden Programmcode zu überarbeiten und in kleine testbare Einheiten zu zerlegen.

[[Der erste Test]]

[[Der zweite und der dritte Test]]

[[Testumgebung entfernen]]

[[AccUnit-Attribute]]

Tipps und Tricks

Sten Schmidt — Mon, 07 May 2012 17:04:18 GMT

Sten Schmidt: Die Seite wurde neu angelegt: „== Entfernen der Testumgebung == === Vollständig === Über das Menü ''Extras >> AccUnit-de >> Testumgebung entfernen'' werden alle Testklassen sowie die durch…“

Installation

Sten Schmidt — Mon, 07 May 2012 09:41:19 GMT

Sten Schmidt: Direktlink zu SimplyVBUnit

__NOTOC__ [[en:Installation]]

Für die Verwendung von AccUnit muss [[SimplyVBUnit|SimplyVBUnit 3.0]] installiert sein.
SimplyVBUnit ist ein in Visual Basic 6 geschriebenes Testframework.
Weitere Informationen zu VBUnit finden Sie auf
der [http://sourceforge.net/projects/simplyvbunit/ Projektseite von SimplyVBUnit auf sourceforge].

Laden Sie die [http://sourceforge.net/projects/simplyvbunit/files/latest/download Setup-Datei] von sourceforge herunter.

AccUnit verursacht (derzeit noch) Probleme bei der Verwendung unter Access 2000.

Danach können Sie von dieser Webseite das AccUnit Programm [http://accunit.access-codelib.net/download/AccUnitSetup.zip AccUnitSetup.zip]
laden und die Installation mit ''Setup.exe'' starten.

=== AccUnit als VBE-Add-In verwenden ===
AccUnit installiert sich als VBE AddIn im Visual Basic Editor.
Sie finden AccUnit einmal als Menüpunkt unter Extras->AccUnit
und zweitens als zusätzlich Symbolleiste mit drei Symbolen.

[[Bild:AccUnit-Menue.jpg]]

[[Datei:AccUnit_AddIn_Commandbar_Beschreibung.png]]