Manueller Test Tutorial/en - Versionsgeschichte

Matilk: Weiterleitung zur neuen Seite

2023-08-22T10:48:06Z

Weiterleitung zur neuen Seite

Cg: /* More Examples */

2020-09-20T17:02:54Z

More Examples

← Nächstältere Version		Version vom 20. September 2020, 17:02 Uhr
Zeile 344:		Zeile 344:
	A sample test plan is found in the Manual Test Library itself. It contains multiple manual steps.		A sample test plan is found in the Manual Test Library itself. It contains multiple manual steps.

	Also, find and open "''ManualTestExample.ets''" in the deliver samples folder. This contains a ready to start with example similar to ~~the setup shown~~ above.		Also, find and open "''ManualTestExample.ets''" in the deliver samples folder. This contains a ready to start with example similar to one above.

Cg: /* Weitere Beispiele */

2020-09-20T17:02:37Z

Weitere Beispiele

← Nächstältere Version		Version vom 20. September 2020, 17:02 Uhr
Zeile 340:		Zeile 340:
	Now when running the testplan, a wizard will be automatically opened at the beginning and closed at the end.		Now when running the testplan, a wizard will be automatically opened at the beginning and closed at the end.

	= ~~Weitere~~ ~~Beispiele~~ =		= More Examples =

			A sample test plan is found in the Manual Test Library itself. It contains multiple manual steps.
	In der Manual Test Bibliothek selbst finden Sie einen Beispieltestplan mit mehreren manuellen Schritten.

			Also, find and open "''ManualTestExample.ets''" in the deliver samples folder. This contains a ready to start with example similar to the setup shown above.
	Auch finden Sie in den mitgelieferten Demobeispilene die Testsuite "''ManualTestExample.ets''". Diese enthält ein gebrauchsfertiges Beispiel mit einem Setup ähnlich dieser Beschreibung.

Cg: /* Schritt 6: Erstellen eines Testplans, und automatisches Öffnen und Schließen des Wizards */

2020-09-20T17:00:29Z

Schritt 6: Erstellen eines Testplans, und automatisches Öffnen und Schließen des Wizards

← Nächstältere Version		Version vom 20. September 2020, 17:00 Uhr
Zeile 285:		Zeile 285:
	The wizard stays open and can be closed by hand.		The wizard stays open and can be closed by hand.

			== Step 6: Creation of a Test Plan, Automatic Open/Close of the Wizard ==
	== Schritt 6: Erstellen eines Testplans, und automatisches Öffnen und Schließen des Wizards ==

			Previously, the test case was executed in isolation ("single action test execution"). This is good practice: test your actions in isolation so that you don't have to step through long sequences every time you encounter an error (or wrong texts).
	Bisher wurde der Testfall im Einzeltestmodus innerhalb des Editors gestartet. Dies ist die normale Vorgehensweise: testen Sie Ihre Aktionen immer in kleinen Abschnitten, damit Sie im Fehlerfall nicht jedes mal eine lange Kette von anderen Aktionen durchklicken müssen.

	Anmerkung:		Anmerkung:
			:Only then should you test longer sequences in which multiple cases run one after another. In this simple example, we do not expect any problems; however, if you create eg. a GUI Test, every test case should leave the tested system in a defined state, so that the next text can start with well known initial conditions. Typical errors are left-open dialogs, popups, wrong selections in menus, tabs or selection lists etc.
	:Erst dann sollten Sie Ihre Testpläne, in denen dann mehrerer Testfälle hintereinander ablaufen, in einem Gesamtlauf testen. In unserem Beispiel ist nicht mit Problemen zu rechnen; wenn Sie aber z.B GUI-Tests erstellen, sollte jeder Testfall das System (die Oberfläche) in einem Zustand hinterlassen, in dem der nächste Testfall weiter laufen kann. Typische Fehler in GUI Tests sind z.B. offen gelassene Dialoge oder Popup Fenster, falsche Selektion in Listen etc.

			: Therefore, make sure that such situations are prevented by running individual actions in isolation.
	: Daher versichern Sie sich im Einzeltest, dass solche Situationen nicht entstehen.

	=== ~~Erstellen~~ ~~eines~~ ~~Testplans~~ ===		=== Creating a Test Plan ===

	[[Datei:Manual Test 25.png]]		[[Datei:Manual Test 25.png]]

			Select your new test plan (or create one, if you haven't yet) in the project tree.
	Wählen Sie den neuen Testplan im Projektbaum aus.
			Drag the test case action and drop it into the list of test case items on the right.
	Ziehen Sie dann die Aktion des Testfalls mittels Drag & Drop in die Liste der Testfälle rechts im Testplan Editor.
			As you may have noticed: a test case action can be placed into multiple test plans, and thus be easily reused. Therefore, the position of an action in the tree is not relevant for the test plan; you may place actions wherever and however you want to organize your tree, and group test cases and action independent from where they are used in test plans.
	Wie Sie bemerken, kann ein Testfall in mehreren Testplänen wiederverwendet werden. Daher ist die Position im Projektbaum irrelevant für den Testplan: Sie können den Projektbaum beliebig nach Ihren Vorstellungen organisieren, und ebenso die Listen in den Testplänen unabhängig davon beliebig sortieren.

	[[Datei:Manual Test 26.png]]		[[Datei:Manual Test 26.png]]
Zeile 306:		Zeile 306:
	[[Datei:Manual Test 27.png]]		[[Datei:Manual Test 27.png]]

			If you like, repeat the previous steps to create different test cases - possibly with multiple test steps.
	Wenn Sie möchten, können Sie jetzt obige Schritte mehrfach wiederholen, und mehrere unterschiedliche Testfälle in den Testplan ziehen.

	=== ~~Definieren von~~ Pre- ~~und~~ ~~Postaktionen~~ ===		=== Defining Pre- and Post Actions ===

			Finally, we want to define actions to automatically open the wizard with a well-defined size at the beginning. As a reminder: you don't need this, if you are fine with tis default appearance. However here we want it to come up in a full screen window.
	Jetzt soll noch eine Aktion erstellt werden die als Pre-Aktion vor der Ausführung des Testplans ausgeführt werden soll; in unserem Fall: Start des Wizards mit definierter Grösse. Zur Erinnerung: wenn Ihnen der Wizard in seiner Defaultgrösse passend ist, brauchen sie dies nicht; wir möchten hier aber z.B. eine Fullscreen Darstellung einstellen.

			Also, after the test plan ,the wizard should be automatically closed.
	Nach der Ausführung soll der Wizard in einer Post-Aktion auch wieder automatisch geschlossen werden.

			For a solution, there are 3 ways to go, although we recvommend the last one below:
	Es gibt dafür mehrere mögliche Lösungen, wobei wir die dritte unten empfehlen:
	* (1) Open ~~und~~ Close ~~Aktionen~~ ~~als~~ ~~Testfall~~ in ~~die~~ ~~Liste~~ im ~~Testplan~~		* (1) Open and Close actions as part of the test plan (i.e. first and last actions in the list)
	* (2) Open ~~als~~ Pre-~~Aktion~~; Close ~~als~~ Post-~~Aktion~~ (~~Felder~~ ~~finden~~ ~~Sie~~ ~~unten~~ im ~~Testplan~~ ~~Editor~~)		* (2) Open as Pre-Action; Close as Post-Action (see corresponding fields below the list in the test plan editor)
			* (3) Define wrapper actiones; one to open the wizard, another to close the wizard and define these two as pre- and post actions.
	* (3) Wrapper Aktionen Definieren, eine mit nur der Open-Wizard Aktion, eine nur mit Close-Wizard, und diese als Pre/Post Aktionen definieren.

			(1) is not a good Solution, as it may leave the wizard window open, in case the test plan runs into an error or is aborted. That is not a problem if you sit in front of the screen to close it, but it may be bad if you automize the ist run (eg. via Jenkins) and run it unattended. A wizard Windows may in this case be kept alive on the screen.
	(1) ist schlecht da im Fehlerfall die Abarbeitung des Testplans abgebrochen werden könnte und dann ein Wizardfenster offen bliebe. Das ist kein Problem, wenn Sie vor dem Schirm sitzen und ihn schliessen können; jedoch wird damit eine Vollautomatisierung u.U. Probleme haben, und Fenster auf dem Schirm stehen bleiben.

			(2) is much better: the post action will always be executed (as a cleanup), even if the test plan execution is aborted for whatever reason.
	(2) ist besser, da die Post-Aktion immer ausgeführt wird; auch wenn die Ausführung des Testplans abgebrochen wird.

			(3) is even better as we now a place to place any other cleanup actions in the future (eg. turn off power, remove temporary file, etc). And more can be added later without much maintenance effort.
	(3) ist noch besser, da Sie nun mit der eigen definierten Post-Aktion einen Ort haben, an dem später weitere "Aufräumarbeiten" untergebracht werden können (z.B. temporäre Dateien löschen, Strom ausschalten etc.), und Sie später weniger Wartungsaufwand haben, diese in möglicherweise mehreren Testpläne nachzutragen.

	~~Wir~~ ~~werden~~ ~~also~~ ~~zwei~~ ~~neue~~ ~~Aktionen~~ ~~definieren~~, ~~diese~~ ~~mit~~ "PreAction"~~und~~ "PostAction" ~~benennen~~ ~~und~~ ~~als~~ ~~solche~~ ~~auch~~ im ~~testplan~~ ~~definieren.~~		Therefore, we will define two new actions, which will be called "PreAction" and "PostAction", and define them as such in the ist plan editor:
			Add the "''Manual test Wizard -Start''" action as step to the PreAction (by drag & drop or via "''New Step...''");
		⚫	<br>and also the "''Manual test Wizard -Stop''" action to the PostAction.

			A configuration might look like:
	Fügen Sie zur PreAction die "''Manual test Wizard -Start''" Aktion mittels "''New Step''" oder Drag & Drop hinzu;
⚫	<br>~~und~~ ~~dann~~ ~~platzieren Sie die~~ "''Manual test Wizard -Stop''" ~~Aktion~~ in ~~der~~ PostAction.

	So könnte eine mögliche Konfiguration aussehen:

	[[Datei:Manual Test 28.png]]		[[Datei:Manual Test 28.png]]

			Finally, define those two actions as Pre- and Post actions in the test plan. For that, go to the test plan editor and drag the corresponding action into the fields at the bottom of the editor.
	Zuletzt definieren wir diese Aktionen im Testplan als Pre- und Post Aktionen.
	Öffnen Sie dafür den Testplan Editor, und ziehen die jeweilige Aktion in der Felder unten im Editor.

	[[Datei:Manual Test 29.png]]		[[Datei:Manual Test 29.png]]

			Click "''Accept''" to save this change.
	Drücken Sie "''Übernehmen''" um die Änderungen zu speichern.

			Now when running the testplan, a wizard will be automatically opened at the beginning and closed at the end.
	Führen Sie nun den Testplan aus, wird der Wizard entsprechend der Konfiguration im Startblock geöffnet,
	der Testfall ausgeführt und am Ende die Postaction den Wizard wieder schließen.

	= Weitere Beispiele =		= Weitere Beispiele =

Cg: /* Schritt 5: Testfall einzeln ausführen und Anzeige im Wizard verifizieren */

2020-09-20T16:30:12Z

Schritt 5: Testfall einzeln ausführen und Anzeige im Wizard verifizieren

← Nächstältere Version		Version vom 20. September 2020, 16:30 Uhr
Zeile 271:		Zeile 271:
	Finally, click on "''Accept''" to make your changes permanent in the project tree.		Finally, click on "''Accept''" to make your changes permanent in the project tree.

	== ~~Schritt~~ 5: ~~Testfall~~ ~~einzeln~~ ~~ausführen~~ ~~und~~ ~~Anzeige~~ im Wizard ~~verifizieren~~ ==		== Step 5: Execute the Test Case in Isolation and Verify the Wizard's Presentation ==

			Select the test case in the project tree and navigate to the "''Diagram'"tab.
	Wählen sie den den Testfall im Projektbaum aus und öffnen sie den Tab "''Netzwerk''".

	~~Drücken~~ ~~Sie den~~ "Play"-~~Button~~ in ~~der~~ ~~Toolbar~~ ~~des~~ ~~Netzwerkeditors~~.		Click the "Play"-button in the toolbar of the diagram editor.
			The wizard appears and shows your text:
	Das Wizard-Fenster erscheint geöffnet und der Testschritt wird angezeigt:

	[[Datei: Manual Test 24.png]]		[[Datei: Manual Test 24.png]]

			Expecco will now wait for your input in the wizard. If you click on the green Play-con there, the wizard will advance to the next step and finish after the last test step (in this case, as this is an individual test being executed in isolation, it will finish right after the first step).
	Die Testausführung nun auf Ihre Eingaben im Wizard. Wenn Sie im Wizard das grüne Play-Symbol drücken, schaltet dieser weiter und stoppt nach der Ausführung des letzten Schrittes (in diesem Fall, einem Einzeltest, gleich nach dem Ersten).
	~~Die~~ ~~Testausführung~~ ~~und~~ ~~der~~ ~~Testfall~~ ~~werden als~~ "''Passed''" ~~markiert~~ (~~sofern~~ ~~Sie~~ "~~grün~~" ~~gedrückt haben~~).		The execution will be marked as "''Passed''" (assuming that you clicked on "green").

			The wizard stays open and can be closed by hand.
	Der Wizard bleibt geöffnet und kann nun von Hand geschlossen werden.

	== Schritt 6: Erstellen eines Testplans, und automatisches Öffnen und Schließen des Wizards ==		== Schritt 6: Erstellen eines Testplans, und automatisches Öffnen und Schließen des Wizards ==

Cg: /* Step 4: Define What is to be Shown in the Wizard */

2020-09-20T16:24:34Z

Step 4: Define What is to be Shown in the Wizard

← Nächstältere Version		Version vom 20. September 2020, 16:24 Uhr
Zeile 264:		Zeile 264:
	[[Datei:Manual Test 22.png]]		[[Datei:Manual Test 22.png]]

	Again confirm with "OK".		Again confirm with "OK". The text is now attached to the input pin as so called "''Freeze Value''".

	[[Datei:Manual Test 23.png]]		[[Datei:Manual Test 23.png]]

Cg: /* Schritt 4: Anzeige des Manuellen Wizards im Testschritt definieren */

2020-09-20T16:21:46Z

Schritt 4: Anzeige des Manuellen Wizards im Testschritt definieren

← Nächstältere Version		Version vom 20. September 2020, 16:21 Uhr
Zeile 231:		Zeile 231:
	Sorry, but actions created this way did not automatically get the right tag (in previous expecco versions). Therefore, you may have to navigate to the test step's definition in the tree, got to the documentation tab and add the "TEST-CASE" tag (or better yet, a "MANUAL-TEST-CASE" tag. As usual, click on "Accept" when done.		Sorry, but actions created this way did not automatically get the right tag (in previous expecco versions). Therefore, you may have to navigate to the test step's definition in the tree, got to the documentation tab and add the "TEST-CASE" tag (or better yet, a "MANUAL-TEST-CASE" tag. As usual, click on "Accept" when done.

	== ~~Schritt~~ 4: ~~Anzeige~~ ~~des~~ ~~Manuellen~~ ~~Wizards~~ im ~~Testschritt~~ ~~definieren~~ ==		== Step 4: Define What is to be Shown in the Wizard ==

	Im ~~folgenden~~ ~~werden~~ ~~wir~~ ~~definieren,~~ ~~was~~ im "TS - Open Application" ~~Schritt zu~~ ~~tun~~ ~~ist~~.		We now define what the wizard should show when the "TS - Open Application" Step is executed.

			Up to now, we did not actually define whether this step will be a manual or automated test step. This is done now, by placing an action from the Manual Test Library into our action step.
	Bisher hatten wir noch offen gelassen, ob dies ein manueller oder automatischer Test werden soll.
	Dies wird jetzt definiert, indem wir einen Baustein aus der Manual Test Bibliothek hinein platzieren.

			Notice:
	Anmerkung:
			:in theory, we could have added the manual test step right into the test case. However, this has the disadvantage that this might require more rework if we ever want to change this step to a fully automated one. We would have to change the test case and probably all places were the test step is also used.
	:theoretisch hätte man den nun folgenden Manual Test Step auch gleich in die Testfallaktion platzieren können. Das hat aber den Nachteil, dass wir damit schon im Testfall festgelegt hätten, dass es sich um einen manuellen Test handelt, und wir später, sollten wir diesen Testfall automatisieren, dort ändern müssten.
			:By wrapping the actual wizard action into separate action, enables use to change the inside at any time later, without a need to change all uses of that step. We'll thus get more maintainability and cost reduction in the future.
	:Indem wir die manuelle Aktion in eine separate Testschrittaktion kapseln, können wir dessen Diagram später jederzeit ändern und insbesondere vollautomatisierten, ohne dass wir die Testfälle noch einmal ändern müssen. Wir erhalten dadurch also eine bessere Wartbarkeit, insbes. wenn der Schritt in mehreren Test wiederverwendet wird, werden dann später alle Tests davon profitieren, ohne dass dadurch extra Aufwand ansteht.
			:It is a good practice to place any action which might be changed in the future into a separate compound action / even if it seems strange to have such simple diagrams which only cnsist of a single step.
	:Es ist eine gute Praxis, Aktionen die später möglicherweise geändert werden müssen derart zu Kapseln, auch wenn es merkwürdig scheint, lediglich eine einzelne Aktion in einer zusammengesetzten Aktion zu kapseln.

	~~Wählen~~ ~~Sie~~ ~~nun~~ ~~aus,~~ ~~wie~~ ~~der~~ ~~Baustein~~ ~~seine~~ ~~Testlauf-Information~~ ~~präsentieren~~ ~~und~~ ~~wie~~ ~~Sie~~ ~~diese~~ ~~eingeben~~ ~~wollen~~ (i.e. Text/HTML/Wiki). ~~Dafür~~ ~~selektieren~~ ~~Sie~~ ~~die~~ ~~Testschrittaktion~~ im ~~Projektbaum,~~ ~~wechseln~~ ~~zum~~ ~~Netzwerk/Diagramm Tab~~, ~~und~~ ~~wählen~~ im ~~Popup~~ ~~menu~~ ~~(rechte Maustaste) den Eintrag:~~ "''New Step...''" <br>(~~dismal~~ ~~nicht~~ "New Action", da ~~wir~~ ~~jetzt~~ ~~aus~~ ~~der~~ ~~Liste~~ ~~der~~ ~~verfügbaren~~ ~~Aktionen~~ ~~wählen~~ ~~wollen~~):		Now choose, how the text should be presented to the test and how you want to enter it (i.e. Text/HTML/Wiki). For that, select the test step action in the tree, go to the diagram and choose "''New Step...''" from the popup menu.<br>(this time not "New Action", as we want to select an existing action instead of creating a new one):

	[[Datei:Manual Test 18.png]]		[[Datei:Manual Test 18.png]]

	Im ~~Dialogfenster~~ ~~können~~ ~~Sie~~ ~~einen~~ ~~vorhandenen~~ ~~Baustein~~ ~~auswählen.~~ ~~Falls~~ ~~Ihnen~~ ~~die~~ ~~Liste~~ zu ~~lang~~ ~~ist,~~ ~~können~~ ~~Sie~~ ~~die~~ ~~Suche~~ ~~einschränken;~~ ~~z.B.~~ ~~auf~~ ~~einzelne Bibliotheken~~ (in ~~unserem~~ ~~Fall wäre das die~~ "Manual Test Library") ~~oder~~ ~~den~~ ~~Namen~~ (~~sie~~ ~~können~~ ~~hier~~ ~~z.B.~~ "HTML"~~oder~~ "Wiki" ~~eingeben~~) ~~oder~~ ~~auch~~ ~~Etiketten~~.		Choose the action to be placed into the diagram as step. If the list is too long, filter by listong only individual libraries (in this case: "Manual Test Library") or by name (you might afilter for "HTML" or "Wiki" here) or by tag.

	~~Für~~ ~~unser~~ ~~Beispiel wählen Sie~~ ~~die~~ ~~Aktion~~: "<CODE>Manual Test Template (WikiStyle)</CODE>" (~~die~~ im ~~Screenshot~~ ~~gezeigte~~ ~~Aktion~~ ~~ist~~ ~~veraltet,~~ ~~daher~~ im ~~Screenshot~~ ~~anders~~).		In this example, we choose: "<CODE>Manual Test Template (WikiStyle)</CODE>" (the action shown in the screenshot is somewhat obsolete - therefore different).

	[[Datei:Manual Test 19.png]]		[[Datei:Manual Test 19.png]]

			Confirm with "OK" to add the step to the diagram.
	Mit "OK" wird der Baustein zu Ihrem Testschritt hinzugefügt.

	[[Datei:Manual Test 20.png]]		[[Datei:Manual Test 20.png]]

			Doubleclick on the input pin named "''testStepDescription''" to open an editor for the text. Alternatively, choose "''Freeze as String''" from the pin's context menu to open the text editor.
	Ein Doppelklick auf den Eingangspin "''testStepDescription''" wird einen Editor öffnen.
	Anstatt eines Doppelklicks können Sie auch mit der rechten Maustaste "''Freeze as String''" auswählen um den Editor zu öffnen.

	[[Datei:Manual Test 21.png]]		[[Datei:Manual Test 21.png]]

			Type the text which is to be shown in the wizard eg. according to WikiStyle rules.
	Geben Sie eine Beschriftung z.B. nach den Wiki-Style-Regeln ein, welche im Wizard nachher angezeigt werden soll.

	[[Datei:Manual Test 22.png]]		[[Datei:Manual Test 22.png]]

			Again confirm with "OK".
	Dann drücken Sie bitte "OK". Der eingegebene Text sollte nun als Input für den ManualTestStep verbunden sein.

	[[Datei:Manual Test 23.png]]		[[Datei:Manual Test 23.png]]


			Finally, click on "''Accept''" to make your changes permanent in the project tree.
	Drücken Sie "''Übernehmen''" um die Änderungen zu speichern.

	== Schritt 5: Testfall einzeln ausführen und Anzeige im Wizard verifizieren ==		== Schritt 5: Testfall einzeln ausführen und Anzeige im Wizard verifizieren ==

Cg: /* Schritt 3: Erstellen eines Testschrittes für einen Testfall */

2020-09-20T16:07:58Z

Schritt 3: Erstellen eines Testschrittes für einen Testfall

← Nächstältere Version		Version vom 20. September 2020, 16:07 Uhr
Zeile 200:		Zeile 200:
	Thus, by adding the tag, any action may later be marked as being a test case or test step. You can also use the tree's popup-menu to add this tag to multiple actions at once.		Thus, by adding the tag, any action may later be marked as being a test case or test step. You can also use the tree's popup-menu to add this tag to multiple actions at once.

	== Schritt 3: ~~Erstellen~~ ~~eines~~ ~~Testschrittes~~ ~~für~~ ~~einen~~ ~~Testfall~~ ==		== Schritt 3: Create a Test Step for a Test Case ==

	~~Navigieren~~ ~~Sie~~ ~~zum~~ ~~Netzwerk (~~Diagramm-) ~~Tab~~ ~~der~~ ~~Testfall~~ ~~Aktion~~.		navigate to the Diagramm tab of your test case.
	~~Dieses~~ ~~ist~~ ~~zunächst~~ ~~leer,~~ ~~und~~ ~~muss~~ ~~mit~~ ~~einzelnen~~ ~~Schritten~~ ~~gefüllt~~ ~~werden~~ (im ~~Bild~~ ~~unten~~ ~~leider~~ ~~nicht~~ ~~umbenannt~~ ~~und~~ ~~immer~~ ~~noch~~ "New Action").		Initially, this is empty and has to be filled with individual steps. (sorry, in the picture below this is still named "New Action").

			Teure are various options to add a step:
	Schritte können auf mehrere Arten eingefügt werden:
	* ~~durch~~ ~~Drag~~ & ~~Drop~~ ~~aus~~ ~~dem~~ ~~Projektbaum~~,		* by drag & drop from the project tree,
			* by copy-paste from the project tree or from another diagram
	* durch Copy-Paste aus dem Projektbaum oder einem anderen Netzwerk
	* ~~über~~ ~~eine~~ ~~Suche~~ in ~~bestehenden Aktionen~~ (~~Dialog~~), ~~direkt~~ im ~~Diagram~~ (~~Menu~~: "''New Step...''").		* by searching among existing actions (dialog), directly in the diagram (menu: "''New Step...''").
	* ~~über~~ ~~Anlegen~~ ~~einer~~ ~~neuen~~ ~~Aktionen~~ (~~Dialog~~), ~~direkt~~ im ~~Diagram~~ (~~Menu~~: "''New Action...''").		* by creating a new action (dialog), directly in the diagram (menu: "''New Action...''").

			In the following, new steps are added via the diagram's popup menu (right click). The menu item "New Action" opens a dialog which creates a new action and adds it as step into the diagram:
	Im Folgenden werden die Schritte mit dem Popup-Menü (rechte Maustaste) im Diagrammeditor des Testfalls hinzugefügt. Der Menueintrag "Neue Aktion" öffnet einen Dialog, mit dem einen neue Aktion angelegt und gleich als Testschritt eingefügt wird:

	[[Datei: Manual Test 15.png]]		[[Datei: Manual Test 15.png]]

			This opens a little input dialog.
	Dies öffnet ein kleines Eingabefenster.
			Enter the name of the new test step, honor the rules as above.

			Note:
	Hier geben Sie den Namen des neuen Testschritts ein. Für die Benennung gelten die selben Regeln wie oben.
			If you intent to reuse the test step in multiple test cases later, the name should not contain step-numner or test case number. Use names like "''TS - Open Application''".

			After confirming the dialog with ÖK", a cursor appears to let you specify the position of the new step in the diagram. Place the step and confirm the changes with "Accept" to save the editor's changed diagram in the tree.
	Wichtig:
	Wenn Sie diesen Testschritt später in verschiedenen Testfällen wiederverwenden wollen, sollte der Name nicht die Schrittnummer und die Testfallnummer enthalten. Nehmen Sie in solchen Fällen Namen wie "''TS - Open Application''".

			The project tree now shows the new step below the test case.
	Nach dem Drücken von "OK", erscheint ein Cursor, mit welchem Sie den Baustein an die gewünschte Stelle plazieren können. Drücken Sie danach "Übernehmen", um die Änderung des Editors am der Testfallaktion zu speichern.

	Im Projektbaum erscheint nun auch die neu angelegte Testschrittaktion direkt unter dem Testfall.

	[[Datei:Manual Test 16.png]]		[[Datei:Manual Test 16.png]]
Zeile 230:		Zeile 229:
	[[Datei:Manual Test 17.png]]		[[Datei:Manual Test 17.png]]

			Sorry, but actions created this way did not automatically get the right tag (in previous expecco versions). Therefore, you may have to navigate to the test step's definition in the tree, got to the documentation tab and add the "TEST-CASE" tag (or better yet, a "MANUAL-TEST-CASE" tag. As usual, click on "Accept" when done.
	Leider erhalten derart im Diagrammeditor angelegte Aktionen nicht automatisch das Testschritt-Etikett. Daher navigieren wir kurz zu der "TS - Anwendung öffnen" Aktion (im englischen Screenshot: "TS - Open Application"), wählen den Dokumentationstab, und fügen den Tag "TEST-STEP" zur Tag-Liste hinzu. Bestätigen Sie durch Klick auf "Übernehmen".

	== Schritt 4: Anzeige des Manuellen Wizards im Testschritt definieren ==		== Schritt 4: Anzeige des Manuellen Wizards im Testschritt definieren ==

Cg: /* Schritt 2: Anlegen eines Testfalls */

2020-09-20T15:53:09Z

Schritt 2: Anlegen eines Testfalls

← Nächstältere Version		Version vom 20. September 2020, 15:53 Uhr
Zeile 172:		Zeile 172:
	[[Datei:Manual Test 11.png]]		[[Datei:Manual Test 11.png]]

	== ~~Schritt~~ 2: ~~Anlegen~~ ~~eines~~ ~~Testfalls~~ ==		== Step 2: Create a Test Case ==

			Next we have to create a test case item in the tree. The easiest way is via the toolbar menu, which creates an action with the TEST-CASE tag already attached, and it appears with its own icon in the tree.
	Nun wird ein Testfall angelegt. Der einfachste Weg ist die direkte Verwendung des Toolbar-Menüs, somit wird dem Testfall auch automatisch ein TEST-CASE Etikett angeheftet (sog. ''Tag''), und er erscheint mit seinem eigenen Icon-Symbol im Projektbaum.

			Remark: the TEST-CASE tag is irrelevant, regarding the later execution; it is only a tag to affect its presentation, and makes it easier for you to spot test cases, test steps as oppose to the helper action. Other attributes of the appearance are specific colors or icons; you can define them as to your personal preferences to enhance the "readability" of your suite.
	Anmerkung: in Hinblick auf die spätere Ausführung der Aktion hat das TEST-CASE Etikett keine Auswirkungen; es ist lediglich ein Etikett, welches die Darstellung im Baum beeinflusst, und es Ihnen leichter macht, Testfälle, Testschritte und Hilfsaktionen zu unterscheiden und schneller zu finden.
	Weitere Darstellungsoptionen sind Farbe und spezifische Icons; diese können sie beliebig nach Ihren Wünschen definieren und zur Verbesserung der Übersichtlichkeit nutzen.

	[[Datei:Manual Test 12.png]]		[[Datei:Manual Test 12.png]]

			Note: please always give your test cases (and other items) reasonable and descriptive names. Usually, test cases should include a reference number, which refers to the corresponding items or chapter in your test- or requirements specification. In addition, append a short Description after the number so the humans also see what the individual steps do.
	Wichtig: geben Sie dem Testfall einen sinnvollen Namen. In der Regel beginnt dieser mit einer Nummer, die sich auf die Testspezifikation oder eine Anforderung bezieht. Zusätzlich sollte der Testfall eine Kurzbeschreibung im Namen haben, damit auch Menschen wissen, was die einzelnen Testfälle machen.

	~~Beispiel~~: ~~Zum Beispiel~~ "TC-4711 Login ~~mit~~ ~~gültigen~~ ~~Daten~~".		Example: "TC-4711 Login with valid Name".

			Note: it has turned out to be a best practice to name test cases as "TC_xxx" and test steps which naht be reused in other scenarios as "TS_xxx". Other helper actions should have their function in the name.
	(Anm.: es hat sich als gute Praxis erwiesen, Aktionen welche Testfälle darstellen als "TC_xxx" zu benennen, Testschritte, welche möglicherweise wiederverwendet werden als "TS_xxx" und sonstigen Hilfsaktionen ihre Funktion als Namen zu geben.

			Also please add a short documentation (Documentation-Tab). This helps to find actions and is also useful as these will be shown as tooltip ("fly by help") when you hover the mouse over a tree item or step in a diagram.
	Bitte dokumentieren Sie Ihre Aktionen auch (Registerkarte Dokumentation), das erleichtert eine spätere Suche, da die Dokumentation als Tooltip ("fly by help") angezeigt wird, wenn Sie die Maus über den Projektbaum oder über Schritte bewegen.

	Alternative:<br>~~Eine~~ ~~andere~~ ~~Möglichkeit~~ ~~ist~~ ~~es,~~ ~~eine~~ ~~bestehende~~ ~~Aktion~~ ~~nachträglich als Testfall auszuzeichnen~~, ~~indem~~ ~~ihm~~ ~~das~~ ~~entsprechende~~ ~~Etikett~~ ~~gegeben wird~~. ~~Klicken~~ ~~Sie dafür zuerst auf "Neue zusammengesetzte Aktion"~~ ~~Anlegen~~ ("''New Compound Action''"):		Alternative:<br>You can also mark actions afterwards as test case, by adding the corresponding tag later. Click first on "New Compound Action":

	[[Datei:Manual Test 13.png]]		[[Datei:Manual Test 13.png]]

	~~navigieren~~ ~~dann~~ ~~zum~~ ~~Tab~~ "''~~Dokumentation~~''" ~~der~~ ~~Aktion~~ ~~und~~ ~~fügen~~ ~~den~~ ~~Tag~~ "''TEST-CASE''" an ~~die~~ ~~Tagliste~~ ~~an.~~ ~~Bestätigen~~ ~~sie~~ ~~die~~ ~~Änderung~~ ~~durch~~ ~~Klick~~ ~~auf~~ "~~Übernehmen~~" ~~unten~~ im ~~rechten~~ ~~Editorfenster~~.		then navigate to the "''Documentation''" tab of the action and add the tag "''TEST-CASE''" to the list of tags at the bottom of the editor. Confirm by pressing "Accept" in the editor pane on the right side.

			The icon shown in the project tree changes to "test case".
	Das Symbol der Aktion ändert sich nun im Projektbaum zu Testfall.

	[[Datei:Manual Test 14.png]]		[[Datei:Manual Test 14.png]]

			Thus, by adding the tag, any action may later be marked as being a test case or test step. You can also use the tree's popup-menu to add this tag to multiple actions at once.
	Durch Hinzufügen des Test-Case Etiketts können Sie auch später noch bereits existierende Bausteine als Testfall markieren (und so im Projektbaum darstellen lassen). Mit dem Popup-Menu des Projektbaums ist es auch möglich, mehrere Aktionen gemeinsam als Testfall zu markieren.

	== Schritt 3: Erstellen eines Testschrittes für einen Testfall ==		== Schritt 3: Erstellen eines Testschrittes für einen Testfall ==

Cg: /* Schritt 1: Anlegen einer neuen Testsuite */

2020-09-20T15:39:10Z

Schritt 1: Anlegen einer neuen Testsuite

← Nächstältere Version		Version vom 20. September 2020, 15:39 Uhr
Zeile 166:		Zeile 166:
	= Manual Test Example (Step by Step Tutorial) =		= Manual Test Example (Step by Step Tutorial) =

	== ~~Schritt~~ 1: ~~Anlegen~~ ~~einer~~ ~~neuen~~ ~~Testsuite~~ ==		== Step 1: Create a New Test Suite ==

			Open expecco and create a new test suite. You may of course also add manual test steps to any other suite. Then import the Manual Test Library (which is done automatically, as soon as you create manual test step or test case).
	Öffnen Sie expecco und erstellen Sie eine neue Testsuite (Sie können natürlich auch in jeder anderen Suite manuelle Testschritte einfügen). Dann importieren Sie die ManualTest Bibliothek (dies geschieht auch automatisch, sobald sie einen manuellen Schritt anlegen).

	[[Datei:Manual Test 11.png]]		[[Datei:Manual Test 11.png]]