Attachment 130734 Details for Bug 257266 – Patch.

Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

[patch] Patch.

Defect_257266_patch.txt (text/plain), 212.33 KB, created by Paul Slauenwhite

on 2009-04-02 13:29:49 EDT

(hide)

Description:

Filename:

MIME Type:

Creator: Paul Slauenwhite

Created: 2009-04-02 13:29:49 EDT

Size: 212.33 KB

patch

obsolete

>### Eclipse Workspace Patch 1.0
>#P org.eclipse.hyades.ui
>Index: src/org/eclipse/hyades/ui/internal/wizard/AttributeWizardPage.java
>===================================================================
>RCS file: /cvsroot/tptp/platform/org.eclipse.hyades.ui/src/org/eclipse/hyades/ui/internal/wizard/AttributeWizardPage.java,v
>retrieving revision 1.9
>diff -u -r1.9 AttributeWizardPage.java
>--- src/org/eclipse/hyades/ui/internal/wizard/AttributeWizardPage.java	1 Apr 2009 13:36:40 -0000	1.9
>+++ src/org/eclipse/hyades/ui/internal/wizard/AttributeWizardPage.java	2 Apr 2009 17:28:52 -0000
>@@ -24,21 +24,20 @@
> import org.eclipse.ui.PlatformUI;
> 
> /**
>- * Wizard page that allows the user to define the description of the object 
>- * to be created.
>- * 
>+ * Wizard page that allows the user to define the description of the object 
>+ * to be created.
> * 
> * 
> * @author Patrick Nedelec
> * @author Marcelo Paternostro
> * @author 	 Paul E. Slauenwhite
>- * @version April 1, 2009
>+ * @version April 2, 2009
> * @since January 26, 2005
> */
> public class AttributeWizardPage extends WizardPage {
> 
>-	private Text itemDescriptionText;
>- private String itemDescription;
>+	protected Text itemDescriptionText;
>+	protected String itemDescription;
> 
> private boolean firstActivation = true;
> 
>#P org.eclipse.tptp.test.report.birt.doc.user
>Index: tasks/treporttest.xhtml
>===================================================================
>RCS file: /cvsroot/tptp/test/org.eclipse.tptp.test.report.birt.doc.user/tasks/treporttest.xhtml,v
>retrieving revision 1.16
>diff -u -r1.16 treporttest.xhtml
>--- tasks/treporttest.xhtml	31 Mar 2009 13:33:27 -0000	1.16
>+++ tasks/treporttest.xhtml	2 Apr 2009 17:28:53 -0000
>@@ -62,10 +62,10 @@
> 
> Generate a BIRT test report:
> <ol>
>- <li>Right-click on a test suite in the Test Navigator and select Report... .</li>
>+ <li>Open the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a>, right-click on a test suite in the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a>, and select Report... .</li>
> <li>Select one of the BIRT test report types and click Next .</li>
> <li>Select the parent folder and define the name of the BIRT test report and click Next.</li>
>- <li>Optionally, provide the report window (start and end data and time) for the BIRT test report.</li>
>+ <li>Provide the report window (start and end data and time) for the BIRT test report.</li>
> <li>Click Finish to generate the BIRT test report.</li>
> <li>The Confirm Open Editor dialog may appear (see the Window &gt; Preferences... &gt; Test &gt; Open Editor preference), confirming if the new BIRT test report is to be opened in the internal Web Browser or text editor.</li>	
> </ol>
>#P org.eclipse.tptp.test.recorders.url.doc.user
>Index: tasks/tcreatetestfromurlrecording.htm
>===================================================================
>RCS file: /cvsroot/tptp/test/org.eclipse.tptp.test.recorders.url.doc.user/tasks/tcreatetestfromurlrecording.htm,v
>retrieving revision 1.1
>diff -u -r1.1 tcreatetestfromurlrecording.htm
>--- tasks/tcreatetestfromurlrecording.htm	31 Mar 2009 13:33:24 -0000	1.1
>+++ tasks/tcreatetestfromurlrecording.htm	2 Apr 2009 17:28:54 -0000
>@@ -54,7 +54,7 @@
> Performance tests are created from new URL recordings with the <a href="../../org.eclipse.hyades.test.doc.user/tasks/tcreatetestfromrecording.htm">New Test From Recording</a> wizard:
> 
> <ol>
>-	<li>Right-click in the Test Navigator, select New &gt; Test Element... &gt; Test From Recording, and click Next. Alternatively, click the New Test From Recording button in the toolbar of the <a href="../../org.eclipse.hyades.test.doc.user/concepts/crecordercontrolview.htm">Recorder Control View</a>.</li>
>+	<li>Open the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a>, right-click in the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a>, select New &gt; Test Element... &gt; Test From Recording, and click Next. Alternatively, click the New Test From Recording button in the toolbar of the <a href="../../org.eclipse.hyades.test.doc.user/concepts/crecordercontrolview.htm">Recorder Control View</a>.</li>
> <li>Select Create the test from a new recording.</li>
> <li>Select the URL Recorder to record the new URL recording.</li>
> <li>Optionally, click Advanced &gt;&gt; and confirm the TPTP URL Test Generator is selected to create the new performance test from the new URL recording.</li> 
>@@ -97,7 +97,7 @@
> In addition, performance tests can be created from existing URL recordings with the New Test From Recording wizard:
> 
> <ol>
>-	<li>Right-click in the Test Navigator, select New &gt; Test Element... &gt; Test From Recording, and click Next. Alternatively, click the New Test From Recording button in the toolbar of the <a href="../../org.eclipse.hyades.test.doc.user/concepts/crecordercontrolview.htm">Recorder Control View</a>.</li>
>+	<li>Open the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a>, right-click in the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a>, select New &gt; Test Element... &gt; Test From Recording, and click Next. Alternatively, click the New Test From Recording button in the toolbar of the <a href="../../org.eclipse.hyades.test.doc.user/concepts/crecordercontrolview.htm">Recorder Control View</a>.</li>
> <li>Select Test From Recording and click Next.</li>
> <li>Select Create the test from an existing URL recording.</li>
> <li>Select the URL Recorder to record the new URL recording.</li>
>#P org.eclipse.tptp.test.tools.junit.plugin.doc.user
>Index: concepts/cworkbenchLocationEditor.htm
>===================================================================
>RCS file: /cvsroot/tptp/test/org.eclipse.tptp.test.tools.junit.plugin.doc.user/concepts/cworkbenchLocationEditor.htm,v
>retrieving revision 1.6
>diff -u -r1.6 cworkbenchLocationEditor.htm
>--- concepts/cworkbenchLocationEditor.htm	17 Jul 2008 19:07:15 -0000	1.6
>+++ concepts/cworkbenchLocationEditor.htm	2 Apr 2009 17:28:55 -0000
>@@ -2,7 +2,7 @@
> <html lang="en-us" xml:lang="en-us">
> 
>+
> <context id="recw0001">
> <description>Create a new test from a new or existing recording of user interactions with an application.</description>
> <topic href="../org.eclipse.hyades.test.doc.user/tasks/tcreatetestfromrecording.htm" label="Creating a test from a recording"/>
>@@ -19,7 +19,7 @@
> 
> 
> <context id="recv0001">
>-<description>View to control and monitor recorders.</description>
>+<description>Control and monitor recorders.</description>
> <topic href="../org.eclipse.hyades.test.doc.user/concepts/crecordercontrolview.htm" label="Recorder Control View"/>
> </context>
> 
>Index: infopop/testDatapool.xml
>===================================================================
>RCS file: /cvsroot/tptp/test/org.eclipse.hyades.test.ui/infopop/testDatapool.xml,v
>retrieving revision 1.4
>diff -u -r1.4 testDatapool.xml
>--- infopop/testDatapool.xml	21 Nov 2008 18:44:36 -0000	1.4
>+++ infopop/testDatapool.xml	2 Apr 2009 17:28:56 -0000
>@@ -1,6 +1,6 @@
> <?xml version="1.0" encoding="UTF-8"?>
> 
>-<description>An overview of the datapool.</description>
>-<topic href="../org.eclipse.hyades.test.doc.user/tasks/teditdp.htm" label="Editing a datapool"/>
>-<topic href="../org.eclipse.hyades.test.doc.user/tasks/taccessdp.htm" label="Accessing a datapool from a Hyades Test"/>
>+
>+<context id="dpld0001">
>+<description>Edit the structure of datapools.</description>
>+<topic href="../org.eclipse.hyades.test.doc.user/concepts/cdatapooleditor.htm" label="Datapool Editor"/>
> </context>
> 
>-<context id="dplt0001">
>-
>-<description>Datapools contain data that tests can use when they run. You can add Variables (columns), Records (rows) and Equivalence Classes (groups of related Records), and can then populate the table with data which wil be used by your Hyades test.</description>
>-<topic href="../org.eclipse.hyades.test.doc.user/tasks/teditdp.htm" label="Editing a datapool"/>
>-<topic href="../org.eclipse.hyades.test.doc.user/tasks/taccessdp.htm" label="Accessing a datapool from a Hyades Test"/>
>+
>+<context id="dplw0001">
>+<description>Create a new datapool.</description>
>+<topic href="../org.eclipse.hyades.test.doc.user/tasks/tcreatedatapool.htm" label="Creating a datapool"/>
> </context>
> 
>-<context id="dpld0001">
>-
>-<description>Edit the structure of the datapool.</description>
>-<topic href="../org.eclipse.hyades.test.doc.user/concepts/cdatapools.htm" label="Datapool structure"/>
>-<topic href="../org.eclipse.hyades.test.doc.user/tasks/teditdp.htm" label="Editing a datapool"/>
>+
>+<context id="dplw0002">
>+<description>Import a Comma-Separated Value (CSV) file into a new or existing new datapool.</description>
>+<topic href="../org.eclipse.hyades.test.doc.user/tasks/cdatapoolimport.htm" label="Importing a Comma-Separated Value (CSV) file as a datapool"/>
>+</context>
>+
>+
>+<context id="dplw0003">
>+<description>Export a datapool to a Comma-Separated Value (CSV) file.</description>
>+<topic href="../org.eclipse.hyades.test.doc.user/tasks/cdatapoolexport.htm" label="Exporting a datapool as a Comma-Separated Value (CSV) file"/>
> </context>
> 
> </contexts>
>Index: src/org/eclipse/hyades/test/ui/datapool/internal/dialog/DatapoolBaseDialog.java
>===================================================================
>RCS file: /cvsroot/tptp/test/org.eclipse.hyades.test.ui/src/org/eclipse/hyades/test/ui/datapool/internal/dialog/DatapoolBaseDialog.java,v
>retrieving revision 1.3
>diff -u -r1.3 DatapoolBaseDialog.java
>--- src/org/eclipse/hyades/test/ui/datapool/internal/dialog/DatapoolBaseDialog.java	21 Nov 2008 18:44:38 -0000	1.3
>+++ src/org/eclipse/hyades/test/ui/datapool/internal/dialog/DatapoolBaseDialog.java	2 Apr 2009 17:28:56 -0000
>@@ -1,5 +1,5 @@
> /*******************************************************************************
>- * Copyright (c) 2005, 2008 IBM Corporation and others.
>+ * Copyright (c) 2005, 2009 IBM Corporation and others.
> * All rights reserved. This program and the accompanying materials 
> * are made available under the terms of the Eclipse Public License v1.0
> * which accompanies this distribution, and is available at
>@@ -12,7 +12,7 @@
> package org.eclipse.hyades.test.ui.datapool.internal.dialog;
> 
> import org.eclipse.hyades.test.ui.UiPlugin;
>-import org.eclipse.hyades.test.ui.datapool.internal.util.ContextIds;
>+import org.eclipse.hyades.test.ui.internal.util.ContextIds;
> import org.eclipse.jface.dialogs.IDialogConstants;
> import org.eclipse.jface.dialogs.TrayDialog;
> import org.eclipse.swt.widgets.Button;
>@@ -22,13 +22,13 @@
> import org.eclipse.ui.PlatformUI;
> 
> /**
>- * A base dialog for all other datapool dialogs with OK (default)
>- * and Cancel buttons.
>+ * A base dialog for all other datapool dialogs with OK (default)
>+ * and Cancel buttons.
> * 
> * 
> * @author Bianca Xue Jiang
> * @author Paul Slauenwhite
>- * @version November 21, 2008
>+ * @version April 2, 2009
> * @since January 27, 2005
> */
> public class DatapoolBaseDialog extends TrayDialog {
>@@ -52,7 +52,7 @@
> 	 */
> 	protected Control createDialogArea(Composite parent){
> 		
>-		//Set the context sensitive help for the dialog:
>+		//Set the context sensitive help:
> 		PlatformUI.getWorkbench().getHelpSystem().setHelp(parent, UiPlugin.getID() + ContextIds.DATA_BASE_DIALOG);
> 		
> 		return (super.createDialogArea(parent));
>Index: src/org/eclipse/hyades/test/ui/internal/component/ProxyNodeSelectionViewer.java
>===================================================================
>RCS file: /cvsroot/tptp/test/org.eclipse.hyades.test.ui/src/org/eclipse/hyades/test/ui/internal/component/ProxyNodeSelectionViewer.java,v
>retrieving revision 1.2
>diff -u -r1.2 ProxyNodeSelectionViewer.java
>--- src/org/eclipse/hyades/test/ui/internal/component/ProxyNodeSelectionViewer.java	1 Apr 2009 13:36:48 -0000	1.2
>+++ src/org/eclipse/hyades/test/ui/internal/component/ProxyNodeSelectionViewer.java	2 Apr 2009 17:28:56 -0000
>@@ -40,12 +40,13 @@
> * 
> * 
> * @author Paul E. Slauenwhite
>- * @version April 1, 2009
>+ * @version April 2, 2009
> * @since October 31, 2008
> */
> public class ProxyNodeSelectionViewer {
> 	
> 	private TreeViewer assetViewer = null;
>+	private Button filterButton = null;
> 	private ProxyNodeContentProvider contentProvider = null;
> 	private List selectedProxyNodes = null;
> 	
>@@ -74,6 +75,10 @@
> 		}
> 	}
> 
>+	public Button getFilterButton() {
>+		return filterButton;
>+	}
>+
> 	public TreeViewer getViewer(){
> 		return assetViewer;
> 	}
>@@ -136,7 +141,7 @@
> 			}
> 		});
> 		
>-		final Button filterButton = new Button(composite, SWT.CHECK);
>+		filterButton = new Button(composite, SWT.CHECK);
> 		filterButton.setText(UiPluginResourceBundle.SHOW_FOLDERS); 
> 		filterButton.addSelectionListener(new SelectionAdapter(){
> 			
>Index: src/org/eclipse/hyades/test/ui/datapool/internal/util/ContextIds.java
>===================================================================
>RCS file: src/org/eclipse/hyades/test/ui/datapool/internal/util/ContextIds.java
>diff -N src/org/eclipse/hyades/test/ui/datapool/internal/util/ContextIds.java
>--- src/org/eclipse/hyades/test/ui/datapool/internal/util/ContextIds.java	21 Nov 2008 18:44:37 -0000	1.3
>+++ /dev/null	1 Jan 1970 00:00:00 -0000
>@@ -1,59 +0,0 @@
>-/**********************************************************************
>- * Copyright (c) 2005, 2008 IBM Corporation and others.
>- * All rights reserved. This program and the accompanying materials
>- * are made available under the terms of the Eclipse Public License v1.0
>- * which accompanies this distribution, and is available at
>- * http://www.eclipse.org/legal/epl-v10.html
>- * $Id: ContextIds.java,v 1.3 2008/11/21 18:44:37 paules Exp $
>- * 
>- * Contributors: 
>- * IBM - Initial API and implementation
>- **********************************************************************/
>-package org.eclipse.hyades.test.ui.datapool.internal.util;
>-
>-/**
>- * Context IDs
>- * 
>- * 
>- * @author Paul Slauenwhite
>- * @version November 21, 2008
>- * @since January 1, 2005
>- */
>-public class ContextIds {
>-	
>-	// Added to support datapool editing (PBS 12/06/03)
>-	// datapool editor
>-	public static final String DATA_FORM = ".datf0001";	//$NON-NLS-1$
>-	public static final String DATA_TEXT_FORM = ".datf0002"; //$NON-NLS-1$		
>-	public static final String DATA_NAME_FORM = ".datf0003"; //$NON-NLS-1$
>-	
>-	public static final String DATA_TABLE_FORM = ".datbf0001"; //$NON-NLS-1$	
>-
>-	//Datapool base dialog ID:
>-	public static final String DATA_BASE_DIALOG = ".dpld0001"; //$NON-NLS-1$	
>-
>-	// insert column action
>-	public static final String INS_COL_ACT = ".ica0001"; //$NON-NLS-1$	
>-	// delete column action
>-	public static final String DEL_COL_ACT = ".dca0001"; //$NON-NLS-1$
>-	// edit column action
>-	public static final String EDIT_COL_ACT = ".eca0001"; //$NON-NLS-1$
>-	// insert row action
>-	public static final String INS_ROW_ACT = ".ira0001"; //$NON-NLS-1$
>-	// delete row action
>-	public static final String DEL_ROW_ACT = ".dra0001"; //$NON-NLS-1$
>-	// edit row action
>-	public static final String EDIT_ROW_ACT = ".era0001"; //$NON-NLS-1$
>-	// insert row group action
>-	public static final String INS_ROW_GRP_ACT = ".irga0001"; //$NON-NLS-1$
>-	// delete row group action
>-	public static final String DEL_ROW_GRP_ACT = ".drga0001"; //$NON-NLS-1$
>-	// edit row group action
>-	public static final String EDIT_ROW_GRP_ACT = ".erga0001"; //$NON-NLS-1$
>-	// cut group action
>-	public static final String CUT_ACT = ".cuta0001"; //$NON-NLS-1$
>-	// copy action
>-	public static final String COPY_ACT = ".cpya0001"; //$NON-NLS-1$
>-	// paste action
>-	public static final String PASTE_ACT = ".psta0001"; //$NON-NLS-1$
>-}
>Index: plugin.properties
>===================================================================
>RCS file: /cvsroot/tptp/test/org.eclipse.hyades.test.ui/plugin.properties,v
>retrieving revision 1.94
>diff -u -r1.94 plugin.properties
>--- plugin.properties	1 Apr 2009 13:36:47 -0000	1.94
>+++ plugin.properties	2 Apr 2009 17:28:56 -0000
>@@ -118,10 +118,10 @@
> Shortcut.RunMenu=Test
> 
> # Datapool and CSV import and export:
>-WIZARD_IMPORT_DATAPOOL_NAME = CSV File as Datapool.
>+WIZARD_IMPORT_DATAPOOL_NAME = CSV File as Datapool
> WIZARD_IMPORT_DATAPOOL_DESCRIPTION = Import a CSV file as a datapool.
> 
>-WIZARD_EXPORT_DATAPOOL_NAME = Datapool as CSV File.
>+WIZARD_EXPORT_DATAPOOL_NAME = Datapool as CSV File
> WIZARD_EXPORT_DATAPOOL_DESCRIPTION = Export a datapool as a CSV file.
> 
> GENERATE_TEST_TOOLTIP = Generate Test
>#P org.eclipse.hyades.test.doc.user
>Index: tasks/tcreatetestdeployment.htm
>===================================================================
>RCS file: /cvsroot/tptp/test/org.eclipse.hyades.test.doc.user/tasks/tcreatetestdeployment.htm,v
>retrieving revision 1.7
>diff -u -r1.7 tcreatetestdeployment.htm
>--- tasks/tcreatetestdeployment.htm	31 Mar 2009 13:33:17 -0000	1.7
>+++ tasks/tcreatetestdeployment.htm	2 Apr 2009 17:28:59 -0000
>@@ -30,10 +30,9 @@
> Test deployments are created with the New Deployment wizard:
> 
> <ol>
>-	<li>Right-click in the Test Navigator and select New &gt; Test Element....</li>
>-	<li>Select Test Assets &gt; Deployment and click Next.</li>
>+	<li>Open the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a>, right-click in the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a>, and select New &gt; Test Element... &gt; Test Assets &gt; Deployment, and click Next.</li>
> <li>Select the parent folder and define the name of the test deployment and click Next.</li>
>- <li>Optionally, provide a description for the test deployment and click Next.</li>
>+ <li>Provide a description for the test deployment and click Next.</li>
> <li>Select or create the associated test artifacts by clicking the New... button and 
> selecting the test artifacts or creating a <a href="tcreateartifact.htm">new test artifact</a>.
> Selected test artifacts can be removed (Remove), moved up (Up), or moved down (Down).</li>
>Index: tasks/trun.htm
>===================================================================
>RCS file: /cvsroot/tptp/test/org.eclipse.hyades.test.doc.user/tasks/trun.htm,v
>retrieving revision 1.14
>diff -u -r1.14 trun.htm
>--- tasks/trun.htm	31 Mar 2009 13:33:17 -0000	1.14
>+++ tasks/trun.htm	2 Apr 2009 17:28:59 -0000
>@@ -26,7 +26,7 @@
> 
> There are a number of options available to run a test.
> 
>-You can right-click on it in the Test Navigator and select Run As &gt; Run or
>+You can right-click on it in the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a> of the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a> and select Run As &gt; Run or
> Run As &gt; Test. If the latter option is chosen, TPTP will automatically run the selected test without invoking the launch configuration dialog.&nbsp;
> 
> If the former option is selected, the launch configuration dialog will be opened and the 
>Index: tasks/tcreatingaperformancetest.htm
>===================================================================
>RCS file: /cvsroot/tptp/test/org.eclipse.hyades.test.doc.user/tasks/tcreatingaperformancetest.htm,v
>retrieving revision 1.3
>diff -u -r1.3 tcreatingaperformancetest.htm
>--- tasks/tcreatingaperformancetest.htm	30 May 2008 18:24:26 -0000	1.3
>+++ tasks/tcreatingaperformancetest.htm	2 Apr 2009 17:28:59 -0000
>@@ -3,7 +3,7 @@
> 
> 
>-<head>
>-<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>-<meta name="security" content="public" />
>-<meta name="Robots" content="index,follow" />
>-<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
>-<meta name="DC.Type" content="task" />
>-<meta name="DC.Title" content="Creating a datapool" />
>-<meta name="abstract" content="Datapools contain data that tests can use when they run." />
>-<meta name="description" content="Datapools contain data that tests can use when they run." />
>-<meta name="DC.Relation" scheme="URI" content="../tasks/tdatapool.dita" />
>-<meta name="DC.Format" content="XHTML" />
>-<meta name="DC.Identifier" content="tcreatedp" />
>-<meta name="DC.Language" content="en-us" />
>-<link rel="stylesheet" type="text/css" href="../css/ibmdita.css" />
>-<link rel="stylesheet" type="text/css" href="../css/swg_info_common.css" />
>-<title>Creating a datapool</title>
>-</head>
>-<body><a name="tcreatedp"></a>
>-
>-<h1 class="topictitle1">Creating a datapool</h1>
>-<div>Datapools contain data that tests can use when they run.
>-<div class="skipspace">To create a datapool, do the following.</div>
>-<ol><li class="skipspace">Open the Test perspective.
>-	<ul>
>-		<li>From the File menu, choose Window &gt; Open Perspective &gt;
>-		Other.</li>
>-		<li>Select Test and click OK. The Test Navigator
>-		appears.</li>
>-		</ul>
>-	</li>
>-<li class="skipspace">In the Test Navigator, right-click a project
>-	and select New &gt; Test Element.... The -		class="uicontrol">New Test Element dialog appears.</li>
>-	<li class="skipspace">In the Wizards list box, expand the Test Assets folder and
>-select Datapool.</li>
>-<li class="skipspace">Click Next. The New Datapool dialog
>-appears.</li>
>-<li class="skipspace">Choose the datapool project folder and datapool name. In the list of existing projects, select the project to store the datapool. You can store datapools
>-in any kind of project (Java, Simple, etc.). You do not have to store datapools with the
>-	tests that use them. In the Name
>-	field, enter the name of the new datapool. Click Finish to create an empty datapool with default settings or click Next to continue.</li>
>-	<li class="skipspace">Optionally, enter a description and initial dimensions for the datapool. Click Next to continue.</li>
>-	<li class="skipspace">Optionally, import data contained in an existing CSV file (comma-separated value text file).
>-	<ul>
>-		<li>In the CSV File field, type
>-		the name of a CSV file or click Browse
>-		to navigate to the file.</li>
>-		<li>If the data in the CSV file is encoded differently from what
>-		the local computer expects, select the encoding from the -			class="uicontrol">Import Encoding drop down menu.</li>
>-		<li>The first row of the CSV file may contain column names. If
>-		it does, check the box beside First row
>-		contains variable names and suggested types. If this box is not checked, default
>-variable names and types such as Variable1::String are used. You can easily change the names using the datapool editor.</li>
>-		<li>If the first column of your CSV file contains equivalence class names, check -			class="uicontrol">First column contains equivalence class names. Equivalence classes group related data. The following example shows a CSV file with two equivalence
>-		classes, flowers and vegetables.<pre>,ModelNumber::String,Description::String,Price::Double
>-flowers,F0001,Orchid,5.99 flowers,F0002,Tulip,1.99 flowers,F0003,Yellow Carnation,6.99 flowers,F0004,White Rose,9.99 flowers,F0005,Geraniums,4.99 vegetables,F0006,Cabbage,0.99 vegetables,F0007,Lettuce,0.99 vegetables,F0008,Tomatoes,0.25 vegetables,F0009,Celery,0.35 vegetables,F0010,Cucumbers,0.4</pre>Note: if your CSV file does not include equivalence class names, all imported rows are grouped under a single equivalence class.</li>
>-	</ul>
>-	</li><li class="skipspace">Click Finish. If you specified initial datapool dimensions, which may conflict with the CSV file dimensions, a dialog appears. Click Yes to use the dimensions of the CSV file. Click No to use the specified initial dimensions (and possibly truncate the CSV file data). The Datapool editor appears, showing the
>-	datapool's first equivalence class. 
>-	</li>
>-	<li class="skipspace">The Confirm Open Editor dialog may appear (see the Window &gt; Preferences... &gt; Test &gt; Open Editor preference), confirming if the new datapool is to be opened in the Datapool editor. 
>-	</li>
>-	
>-</ol>
>-<div class="skipspace"> For instructions
>-on how to add data to or edit the new datapool, go to <a
>-	href="./teditdp.htm">Editing a datapool</a>.
>-</div>
>-</div>
>-
>-<div>
>-
>-Related concepts 
>-	<a href="../samples/saccessdp.htm">Tutorial: Creating a datapool driven JUnit test application</a> 
>- 
>-Related tasks 
>-	<a href="../tasks/teditdp.htm">Editing a datapool</a> 
>-
>-</div>
>-</body>
>-</html>
>Index: tasks/tptpJUnitTest_creatingManually.htm
>===================================================================
>RCS file: /cvsroot/tptp/test/org.eclipse.hyades.test.doc.user/tasks/tptpJUnitTest_creatingManually.htm,v
>retrieving revision 1.11
>diff -u -r1.11 tptpJUnitTest_creatingManually.htm
>--- tasks/tptpJUnitTest_creatingManually.htm	30 May 2008 18:24:25 -0000	1.11
>+++ tasks/tptpJUnitTest_creatingManually.htm	2 Apr 2009 17:28:59 -0000
>@@ -3,7 +3,7 @@
> 
> </a>
> <h1 class="topictitle1">Opening a test log</h1>
> <div>To open a test log file, use the Open File window, or double-click
>-in the Test Navigator the file with the extension, .execution.
>+in the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a> of the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a> the file with the extension, .execution.
> <ol><li>From the File menu, click Open
> File.</li>
> <li>Browse to and select the test log file to open. (Test log files
> use the extension, .execution.)</li>
> <li>Click OK.</li>
> </ol>
>-<div class="section">Alternatively, locate in the Test Navigator the test log file and
>+<div class="section">Alternatively, locate in the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a> of the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a> the test log file and
> then double-click it.</div>
> </div>
> </body>
>Index: tasks/topendp.htm
>===================================================================
>RCS file: tasks/topendp.htm
>diff -N tasks/topendp.htm
>--- tasks/topendp.htm	30 May 2008 18:24:24 -0000	1.11
>+++ /dev/null	1 Jan 1970 00:00:00 -0000
>@@ -1,50 +0,0 @@
>-<!DOCTYPE html
>- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
>-<html lang="en-us" xml:lang="en-us">
>-
>-<head>
>-<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>-<meta name="security" content="public" />
>-<meta name="Robots" content="index,follow" />
>-<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
>-<meta name="DC.Type" content="task" />
>-<meta name="DC.Title" content="Opening a datapool" />
>-<meta name="abstract" content="Inspect or modify the contents of a datapool." />
>-<meta name="description" content="Inspect or modify the contents of a datapool." />
>-<meta name="DC.Relation" scheme="URI" content="../tasks/tdatapool.dita" />
>-<meta name="DC.Format" content="XHTML" />
>-<meta name="DC.Identifier" content="topendp" />
>-<meta name="DC.Language" content="en-us" />
>-<link rel="stylesheet" type="text/css" href="../css/ibmdita.css" />
>-<link rel="stylesheet" type="text/css" href="../css/swg_info_common.css" />
>-<title>Opening a datapool</title>
>-</head>
>-<body><a name="topendp"></a>
>-
>-<h1 class="topictitle1">Opening a datapool</h1>
>-<div>Inspect or modify the contents of a datapool.
>-<div class="skipspace">To open a datapool for editing:
>-</div>
>-<ol><li>Open the Test perspective.</li>
>-<li>In the Test Navigator, expand the Java project containing the datapool
>-to be edited.</li>
>-<li>From the list of test assets in the Test Navigator, double-click
>-the datapool: the datapool opens in the Equivalence Class tab.</li>
>-<li>Along the bottom of the edit pane, click the Data Table tab.</li>
>-</ol>
>-</div>
>-
>-</body>
>-</html>
>Index: tasks/teditdp.htm
>===================================================================
>RCS file: tasks/teditdp.htm
>diff -N tasks/teditdp.htm
>--- tasks/teditdp.htm	30 May 2008 18:24:24 -0000	1.16
>+++ /dev/null	1 Jan 1970 00:00:00 -0000
>@@ -1,60 +0,0 @@
>-<!DOCTYPE html
>- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
>-<html lang="en-us" xml:lang="en-us">
>-
>-<head>
>-<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>-<meta name="security" content="public" />
>-<meta name="Robots" content="index,follow" />
>-<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
>-<meta name="DC.Type" content="task" />
>-<meta name="DC.Title" content="Editing a datapool" />
>-<meta name="abstract" content="In a manner similar to editing a spreadsheet, you can add, modify or remove data from a datapool." />
>-<meta name="description" content="In a manner similar to editing a spreadsheet, you can add, modify or remove data from a datapool." />
>-<meta name="DC.Relation" scheme="URI" content="../tasks/tdatapool.dita" />
>-<meta name="DC.Format" content="XHTML" />
>-<meta name="DC.Identifier" content="teditdp" />
>-<meta name="DC.Language" content="en-us" />
>-<link rel="stylesheet" type="text/css" href="../css/ibmdita.css" />
>-<link rel="stylesheet" type="text/css" href="../css/swg_info_common.css" />
>-<title>Editing a datapool</title>
>-</head>
>-<body>
>-<div>
>-<h1 class="topictitle1">Editing a datapool</h1>
>-
>-The datapool editor is a grid similar to a spreadsheet.
>-
>-In a manner similar to editing a spreadsheet, you can add, modify or remove data from a datapool.
>-
>-When you right-click on the datapool editing grid, a context menu appears to add, edit, and remove a 
>-record or variable, and cut, copy, and paste the selected cell.
>-
>-If you insert a variable, the name, type, and relative position of the new variable is required. 
>-In addition, you may encrypt the new variable, which requires a password.
>-
>-The Datapool editor's overview tab allows you to edit variables and equivalence classes. 
>-
>-
>-Related concepts 
>-	<a href="../samples/saccessdp.htm">Tutorial: Creating a datapool driven JUnit test application</a> 
>- 
>-Related tasks 
>-	<a href="../tasks/tcreatedp.htm">Creating a datapool</a> 
>-
>-
>-</div>
>-</body>
>-</html>
>Index: tasks/tdatapool.htm
>===================================================================
>RCS file: tasks/tdatapool.htm
>diff -N tasks/tdatapool.htm
>--- tasks/tdatapool.htm	30 May 2008 18:24:25 -0000	1.14
>+++ /dev/null	1 Jan 1970 00:00:00 -0000
>@@ -1,62 +0,0 @@
>-<!DOCTYPE html
>- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
>-<html lang="en-us" xml:lang="en-us">
>-
>-<head>
>-<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>-<meta name="security" content="public" />
>-<meta name="Robots" content="index,follow" />
>-<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
>-<meta name="DC.Type" content="task" />
>-<meta name="DC.Title" content="Providing tests with variable data" />
>-<meta name="abstract" content="If you associate a value in a test with a datapool column, the test substitutes column data for that value when it runs." />
>-<meta name="description" content="If you associate a value in a test with a datapool column, the test substitutes column data for that value when it runs." />
>-<meta name="DC.Relation" scheme="URI" content="../concepts/ccommontestingtasksandconcepts.dita" />
>-<meta name="DC.Relation" scheme="URI" content="../concepts/cdatapools.dita" />
>-<meta name="DC.Relation" scheme="URI" content="../tasks/tcreatedp.dita" />
>-<meta name="DC.Relation" scheme="URI" content="../tasks/topendp.dita" />
>-<meta name="DC.Relation" scheme="URI" content="../tasks/teditdp.dita" />
>-<meta name="DC.Relation" scheme="URI" content="../tasks/taccessdp.dita" />
>-<meta name="DC.Format" content="XHTML" />
>-<meta name="DC.Identifier" content="tdatapool" />
>-<meta name="DC.Language" content="en-us" />
>-<link rel="stylesheet" type="text/css" href="../css/ibmdita.css" />
>-<link rel="stylesheet" type="text/css" href="../css/swg_info_common.css" />
>-<title>Providing tests with variable data</title>
>-</head>
>-<body><a name="tdatapool"></a>
>-
>-<h1 class="topictitle1">Providing tests with variable data</h1>
>-<div>If you associate a value in a test with a datapool column, the
>-test substitutes column data for that value when it runs.
>-</div>
>-
>-<div>
>-<blockquote>
>-<div class="ulchildlink"><a href="../concepts/cdatapools.htm">Datapool structure</a> 
>-Datapools provide variable data to your tests during execution.</div>
>-<div class="ulchildlink"><a href="../tasks/tcreatedp.htm">Creating a datapool</a> 
>-Datapools contain data that tests can use when they run.</div>
>-<div class="ulchildlink"><a href="../tasks/topendp.htm">Opening a datapool</a> 
>-Inspect or modify the contents of a datapool.</div>
>-<div class="ulchildlink"><a href="../tasks/teditdp.htm">Editing a datapool</a> 
>-In a manner similar to editing a spreadsheet, you can add, modify or remove data from a datapool.</div>
>-<div class="ulchildlink"><a href="../samples/saccessdp.htm">Tutorial: Accessing a datapool from a JUnit test</a> 
>-Create and access a datapool from an example test application.</div>
>-</blockquote>
>-
>-</div>
>-</body>
>-</html>
>Index: concepts/ccommontestingtasksandconcepts.htm
>===================================================================
>RCS file: /cvsroot/tptp/test/org.eclipse.hyades.test.doc.user/concepts/ccommontestingtasksandconcepts.htm,v
>retrieving revision 1.22
>diff -u -r1.22 ccommontestingtasksandconcepts.htm
>--- concepts/ccommontestingtasksandconcepts.htm	29 Feb 2008 04:21:42 -0000	1.22
>+++ concepts/ccommontestingtasksandconcepts.htm	2 Apr 2009 17:28:58 -0000
>@@ -3,7 +3,7 @@
> <html lang="en-us" xml:lang="en-us">
> 
>-<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>-<meta name="security" content="public" />
>-<meta name="Robots" content="index,follow" />
>-<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
>-<meta name="DC.Type" content="concept" />
>-<meta name="DC.Title" content="Datapool structure" />
>-<meta name="abstract" content="Datapools provide variable data to your tests during execution." />
>-<meta name="description" content="Datapools provide variable data to your tests during execution." />
>-<meta name="DC.Relation" scheme="URI" content="../tasks/tdatapool.dita" />
>-<meta name="DC.Format" content="XHTML" />
>-<meta name="DC.Identifier" content="cdatapools" />
>-<meta name="DC.Language" content="en-us" />
>-<link rel="stylesheet" type="text/css" href="../css/ibmdita.css" />
>-<link rel="stylesheet" type="text/css" href="../css/swg_info_common.css" />
>-<title>Datapool structure</title>
>-</head>
>-<body><a name="cdatapools"></a>
>-
>-<h1 class="topictitle1">Datapool structure</h1>
>-<div>Datapools provide variable data to your tests during execution. You can add Variables (columns), Records (rows) and
>-Equivalence Classes (groups of related Records), to define a datapool's structure. This section describes these structural elements. For information about populating a datapool and using the datapool API, see Tutorial: Creating a datapool driven
>-JUnit test application.
>-<h3>Performance testing example</h3>Performance tests are based on user emulation. During a session with the
>-application-under-test, the tester uses a feature that real customers
>-will use, and from the recorded session a test is generated containing the
>-exact data that the tester entered. For example, to create a performance test
>-for a dialog in a web-based shopping application that prompts a shopper for
>-an account number, the tester engages the dialog by selecting an
>-item that is offered for sale, clicking a "pay now" button, and entering an
>-account number. During playback of the test, in which the tester might request
>-that hundreds of instances of the transaction be run simultaneously, it is
>-desirable that different account numbers (perhaps a combination of valid and
>-invalid numbers) are used for each of the instances. To supply variable data
>-for tests to use during playback, the tester creates datapools.
>-<h3>Structural elements.</h3>
>-Datapools contain three structural elements
>-<ul><li>Equivalence class. A datapool subset containing a range of data that,
>-when submitted to a test, produces the equivalent pass/fail result. Equivalence classes group related data. A datapool
>-must contain one equivalence class. 
>-	Note: you should use only one equivalence class for performance
>-	testing. A performance test can open a datapool in one of 3 modes,
>-	which determines how virtual users access the datapool: private, shared
>-	per machine, or segmented per machine. In the private and shared
>-	modes, equivalence classes are ignored but the segmented access mode
>-	requires that the datapool contain only 1 equivalence class. For this
>-	reason, we recommend that you add only a single equivalence class to
>-	datapools that you plan to use for performance testing.
>-	</li>
>-<li>Record. A row of data. Rows are indexed by an equivalence class starting
>-with 0.
>-</li>
>-<li>Variable. A named data column. Data resides in column cells and is
>-typically typed based on what is expected by the application-under-test.
>-</li>
>-</ul>
>-
>-When you create a datapool, you have the option of initializing the new
>-datapool with data contained in an existing comma-separated value text file (CSV)
>-that you created with a spreadsheet editor or with some external or custom
>-tool. For datapools containing large amounts of data, this approach is recommended.
>-The datapool editor is suitable for entering small amounts of data and modifying
>-individual records but provides no means of generating large amounts of typed
>-data.
>-
>-
>-</div>
>-
>-<div>
>-
>-Related concepts 
>-	<a href="../samples/saccessdp.htm">Tutorial: Creating a datapool driven JUnit test application</a>
>-</div>
>-</body>
>-</html>
>Index: concepts/cEditingJUnitTests.htm
>===================================================================
>RCS file: /cvsroot/tptp/test/org.eclipse.hyades.test.doc.user/concepts/cEditingJUnitTests.htm,v
>retrieving revision 1.1
>diff -u -r1.1 cEditingJUnitTests.htm
>--- concepts/cEditingJUnitTests.htm	16 Apr 2008 19:32:47 -0000	1.1
>+++ concepts/cEditingJUnitTests.htm	2 Apr 2009 17:28:58 -0000
>@@ -2,7 +2,7 @@
> <html lang="en-us" xml:lang="en-us">
> 
> <?NLS TYPE="org.eclipse.help.toc"?>
> <toc label="Providing tests with variable data">
>-	
>-	<topic label="Providing tests with variable data" href="tasks/tdatapool.htm">
>- 	 
>- 	 <topic label="Datapool structure" href="concepts/cdatapools.htm"/>
>- 	<topic label="Creating a datapool" href="tasks/tcreatedp.htm"/>
>- 	<topic label="Opening a datapool" href="tasks/topendp.htm"/>
>- <topic label="Editing a datapool" href="tasks/teditdp.htm"/>
>-	 <topic label="Tutorial: Accessing a datapool from a JUnit test" href="samples/saccessdp.htm"/>
>+	 	 
>+	<topic label="Providing tests with variable data" href="tasks/tdatapoolsintro.htm">
>+	 	 
>+ 	<topic label="Creating a datapool" href="tasks/tcreatedatapool.htm">
>+ 		<topic label="Datapool Editor" href="concepts/cdatapooleditor.htm"/>
>+ 		<topic label="Importing a Comma-Separated Value (CSV) file as a datapool" href="tasks/cdatapoolimport.htm"/>
>+ 		<topic label="Exporting a datapool as a Comma-Separated Value (CSV) file" href="tasks/cdatapoolexport.htm"/>
>+ 	</topic>
>+ 	
>+	 <topic label="Tutorial: Accessing a datapool from a TPTP JUnit test" href="samples/saccessdatapool.htm"/>
> 	</topic>
> </toc>
>\ No newline at end of file
>Index: samples/saccessdp.htm
>===================================================================
>RCS file: samples/saccessdp.htm
>diff -N samples/saccessdp.htm
>--- samples/saccessdp.htm	23 Dec 2008 20:27:08 -0000	1.17
>+++ /dev/null	1 Jan 1970 00:00:00 -0000
>@@ -1,425 +0,0 @@
>-<!DOCTYPE html
>- PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
>-<html lang="en-us" xml:lang="en-us">
>-
>-
>-<head>
>-<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>-<meta name="security" content="public" />
>-<meta name="Robots" content="index,follow" />
>-<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
>-<meta name="DC.Type" content="task" />
>-<meta name="DC.Title" content="Accessing a datapool from a Hyades test" />
>-<meta name="abstract" content="You can use a datapool from a Hyades test by making calls to the datapool API from a test's generated Java code." />
>-<meta name="description" content="You can use a datapool from a Hyades test by making calls to the datapool API from a test's generated Java code." />
>-<meta name="DC.Relation" scheme="URI" content="../tasks/tdatapool.dita" />
>-<meta name="DC.Format" content="XHTML" />
>-<meta name="DC.Identifier" content="taccessdp" />
>-<meta name="DC.Language" content="en-us" />
>-<link rel="stylesheet" type="text/css" href="../css/ibmdita.css" />
>-<link rel="stylesheet" type="text/css" href="../css/swg_info_common.css" />
>-<title>Tutorial: Accessing a datapool from a JUnit test</title>
>-</head>
>-<body>
>-
>-<h1 class="topictitle1">Tutorial: Accessing a datapool from a JUnit test</h1>
>-<div>
>-<h2> 
>-Objectives:</h2>
>-To create and access a datapool from an example test application using the Eclipse Test and
>-Performance Tools Platform (TPTP). <h2>
>-Time required</h2>
>-1 hour
>-<h2><a name="BeforeYouBegin">Before you begin</a></h2>
>-Before you start this tutorial,
>-you need to 
>-<ol>
>-	<li>
>-	Install Eclipse and the Eclipse Test and Performance Tools
>-	Platform (TPTP).</li>
>-	<li>Have a basic understanding of JUnit testing. For more information about JUnit testing, see <a
>-		href="http://www.junit.org">www.junit.org</a>.</li>
>-	<li>Configure and run the Agent Controller which corresponds to your TPTP version. For more information, see <a
>-		href="http://www.eclipse.org/tptp/home/downloads/installguide/HyadesDataCollection.html">
>-	Getting started with the Agent Controller</a>. 
>-	</li></ol>
>-<h2> 
>-Description</h2>
>-In this tutorial,
>-you create and test an application called MyShoppingCart. Using the Eclipse Test and Performance Tools Platform (TPTP), you develop JUnit tests and create a datapool to provide data to the test environment. 
>-This tutorial guides you through the following procedures:
>-<ol>
>-	<li><a href="#CreateUserApp">Creating a sample user application</a></li>
>-	<li><a href="#SetupTestApp" target="_self">Setting up a TPTP test
>-	suite</a></li>
>-	<li><a href="#CreateDatapool">Creating a datapool and initializing test
>-	data</a></li>
>-	<li><a href="#ModifyTestCasesDP">Modifying test cases to reference a
>-	datapool</a> 
>-	</li>
>-</ol>
>-
>-
>-<h2><a name="CreateUserApp">Creating a sample user application</a></h2> 
>-In this procedure, you develop the MyShoppingCart class. In subsequent procedures, you will use the Eclipse Test and Performance Tools Platform to develop a corresponding test environment. <ol>
>-	<li>Create a new Eclipse Java Project. <ul>
>-		<li>From the File menu choose File &gt; New &gt; Project... The
>-		New Project dialog appears.</li>
>-		<li>In the Wizards list, select Java Project and click Next.
>-		The Create a Java project page appears.</li>
>-		<li>Type <tt>datapoolExample</tt> for the Project name and click Finish.
>-		The datapoolExample project appears in the Navigator view. 
>-		</li>
>-	</ul>
>-	</li>
>-	<li>Create the MyShoppingCart class.<ul>
>-		<li>In the Navigator view, right-click the datapoolExample
>-		project and choose New &gt; Class. The New Java Class dialog
>-		appears.</li>
>-		<li>Type <tt>MyShoppingCart</tt> in the Name field.</li>
>-		<li>Clear the option to create the main method public static void
>-		main(String[] args).</li>
>-		<li>Click Finish. The MyShoppingCart.java file appears in the Java
>-		editor.</li>
>-		<li>Type the following for the MyShoppingCart source:<pre>
>-import java.util.Hashtable;
>-
>-public class MyShoppingCart {
>-
>-	public Hashtable myFlowers;
>-	
>-	public MyShoppingCart() {
>-	 
>-		myFlowers = new Hashtable();
>-		myFlowers.put("Orchid", new Double(5.99));
>-		myFlowers.put("Tulip", new Double(1.99));
>-		myFlowers.put("Yellow Carnation", new Double(6.99));
>-		myFlowers.put("White Rose", new Double(9.99));
>-		myFlowers.put("Geraniums", new Double(4.99));		
>-	}
>-	
>-	public double itemCost(String itemName, int itemQuantity)
>-	{
>-	 Double price = (Double)myFlowers.get(itemName);
>-		
>-	 if (price != null) {
>-	 	 return price.doubleValue()*itemQuantity;
>-	 }
>-	 
>-	 return -1;	 	 	 	 	 		
>-	}
>-}</pre></li>
>-		<li>Save MyShoppingCart.java. From the File menu choose File &gt;
>-		Save.</li>
>-	</ul>
>-	</li>
>-</ol>
>-<h2><a name="SetupTestApp">Setting up a TPTP test suite</a></h2>
>- In this procedure, you develop a test suite for the the MyShoppingCart class. Using the Eclipse Test and Performance Tools Platform, you develop a JUnit
>-	test for the itemCost method. <ol>
>-	<li>Open the Test Perspective.
>-	<ul>
>-		<li>From the File menu, choose Window &gt; Open Perspective &gt;
>-		Other.</li>
>-		<li>Select Test and click OK. The Test Navigator appears.</li>
>-	</ul>
>-	</li>
>-	<li>Create a new TPTP JUnit Test.<ul>
>-		<li>In the Test Navigator, right-click the datapoolExample project and choose New
>-		&gt; Test Element...</li>
>-		<li>In the Test Element dialog, select TPTP JUnit test and click Next. The New Test Case dialog appears, prompting you to add JUnit libraries. Click Yes to add JUnit libraries.</li>
>-		<li> In the New JUnit Test Source Code page, type MyShoppingCartTest in the Name field. In the Select how the test behavior is edited section, choose the edit In
>-		the test editor option (the default).</li>
>-		<li>Click Finish. The TPTP JUnit Test editor appears, showing the
>-		MyShoppingCartTest test suite. The Overview tab includes a test description, Source Information, and a Test Methods listing. Currently, no test methods are defined. For this tutorial, the TPTP JUnit Test editor generates method stubs so the Implement
>-		Test Behavior as code option in the Source Information section should be cleared. For more information, see 
>-		<a href="../concepts/cJUnitTestEditor.htm">JUnit Test Suite Editor</a>.</li>
>-	</ul>
>-
>-		</li>
>-	<li>Add the testItemCost and testMyShoppingCartConstructor methods.
>-	<ul>
>-		<li>In the Test Methods tab, click Add. A default name appears for your test.</li>
>-		<li>Add the testItemCost method. In the Name field, type testItemCost for the new test name. In the Description field, type Test
>-		for the MyShoppingCart.itemCost(String, int) method.</li>
>-		<li>Add the testMyShoppingCartConstructor method. In the Test Methods tab, click Add. In the Name field, type testMyShoppingCartConstructor for the new test name. In the Description field, type Test
>-		for the MyShoppingCart constructor.</li>
>-	</ul>
>-	</li>
>-	<li>Configure the test execution behavior.
>-	<ul>
>-		<li>Add a test execution loop. In the Behavior tab, click Add..
>-		&gt; Loop. In the Name field, type Loop_MyShoppingCart. In
>-		the Number of Iterations field, type 1 (the default value).</li>
>-		<li>Add a testMyShoppingCartConstructor invocation. Select
>-		Loop_MyShoppingCart and click Add... &gt; invocation. The Test Invocation
>-		dialog appears. Select Select testMyShoppingCartConstructor and
>-		click OK.</li>
>-		<li>Add a testItemCost invocation. Select
>-		Loop_MyShoppingCart and click Add... &gt; invocation. The Test
>-		Invocation dialog appears. Select testItemCost and click OK.</li>
>-		<li>Save the test suite. From the File menu, choose File &gt; Save.
>-		 
>-		<img border="0" src="../images/testTutorial_Behavior.gif" width="534"
>-			height="407" alt=""/> 
>-		Note: the Save command causes the TPTP JUnit Test editor to create
>-		test method stubs in MyShoppingCartTest.java. 
>-		</li>
>-	</ul>
>-	</li>
>-	<li>
>-	Enter code for the generated JUnit test methods testMyShoppingCartConstructor and testItemCost.<ul>
>-		<li>Open the Java Perspective. From the file menu choose Window
>-		&gt; Open Perspective &gt; Other... &gt; Java.</li>
>-		<li>Open MyShoppingCartTest.java. In the Navigator, open the datapoolExample project folder and double-click MyShoppingCartTest.java. The MyShoppingCartTest.java contents appear in the Java editor, including code to setup and execute the test suite, and stub methods for testMyShoppingCartConstructor and testItemCost.</li>
>-		<li>Type the following code for the testMyShoppingCartConstructor method.<pre>public void testMyShoppingCartConstructor()
>-throws Exception
>-{
>-	MyShoppingCart cart = new MyShoppingCart();
>-	Double priceOrchid = (Double)cart.myFlowers.get("Orchid");
>-	Double priceTulip = (Double)cart.myFlowers.get("Tulip");
>-	
>-	assertTrue(priceOrchid.doubleValue() == 5.99);
>-	assertTrue(priceTulip.doubleValue() == 1.99);
>-}</pre></li>
>-	<li>Type the following code for the testItemCost method.
>-<pre>public void testItemCost()
>-throws Exception
>-{
>-	MyShoppingCart cart = new MyShoppingCart();
>-	double priceForTwo = cart.itemCost("Orchid", 2);
>-	
>-	assertTrue(priceForTwo == 11.98);
>-}</pre>
>-</li><li>Save MyShoppingCartTest.java. From the file menu, choose File
>-		&gt; Save.</li></ul></li><li>Open the Test Perspective and create a test deployment. For an example, see <a href="../tasks/tdeploymentintro.htm">Creating a
>-	Test Deployment</a>. </li>
>-	<li>
>-	Run the test using your custom deployment.<ul>
>-		<li>In the Test Navigator, right-click the MyShoppingCartTest test suite and choose Run
>-		As &gt; Run.... The Run configuration dialog appears.</li>
>-		<li>In the Configurations pane, select Test and then click New.</li>
>-		<li>In the left pane of the Run configuration (Select test to run), expand datapoolExample and choose the MyShoppingCartTest test suite.</li>
>-		<li>In the right pane of the Run configuration, select the deployment you created section. </li>
>-		<li>In the Test Logs tab, clear the Use defaults option and
>-		select the datapoolExample project folder for the location.</li>
>-		<li>Click Run to launch the test.</li>
>-	</ul></li>
>-		<li>Double-click the MyShoppingCartTest test log, which appears in the Test Navigator. The MyShoppingCartTest test log appears. Select the Events tab to view the test details. You should see the following events: start of test suite, start of Loop_MyShoppingCart, test start, test verdict, test stop, second test start, second test verdict, second test stop, loop stop, test suite verdict, and test suite stop. 
>-		<img border="0" src="../images/testTutorial_JUnitSuccess.gif"
>-			width="666" height="420" alt=""/></li></ol> 
>-<h2><a name="CreateDatapool">Creating a datapool and initializing test
>-data</a></h2>
>- In this procedure, you create a simple datapool to store test data. Using the datapool editor, you define a datapool's structural
>-	elements, including variables (columns), records (rows), and
>-	equivalence classes (groups of related records). <ol>
>-	<li>Create a CSV (comma delimited) file including your test data. Typically, you can export data in a spreadsheet application or database to CSV format. In this tutorial, however, you type the data in a text editor.
>-	<ul>
>-		<li>Type the following in a text editor. <pre>
>-,ModelNumber::String,Description::String,Price::Double
>-flowers,F0001,Orchid,5.99
>-flowers,F0002,Tulip,1.99
>-flowers,F0003,Yellow Carnation,6.99
>-flowers,F0004,White Rose,9.99
>-flowers,F0005,Geraniums,4.99</pre>
>-</li><li>Save the file as flowerData.csv in a temporary external location.</li>
>-	</ul>
>-	</li>
>-
>-	<li class="skipspace">In Eclipse, open the Test perspective.
>-	<ul>
>-		<li>From the File menu, choose Window &gt; Open Perspective &gt;
>-		Other.</li>
>-		<li>Select Test and click OK. The Test Navigator
>-		appears.</li>
>-	</ul>
>-	</li>
>-	<li class="skipspace">In the Test Navigator, right-click a
>-	project and select New &gt; Test Element...
>-	The New Test Element dialog appears.</li>
>-	<li class="skipspace">In the Wizards list box, expand the -		class="uicontrol">Test Assets folder and select -		class="uicontrol">Datapool.</li>
>-	<li class="skipspace">Click Next. The -		class="uicontrol">New Datapool dialog appears.</li>
>-	<li class="skipspace">Choose the datapool project folder and
>-	datapool name. In the list of existing projects, select the
>-	datapoolExample project. In the Name
>-	field, type shoppingCartDatapool. Click Next to
>-	continue and then Next again to open the CSV (comma delimited) file import page.</li>
>-	<li class="skipspace">Import the
>-	CSV file flowerData.csv.<ul>
>-		<li>In the CSV File field, click Browse
>-		and navigate to flowerData.csv.</li>
>-		<li>Check the First row
>-		contains variable names and suggested types option. The first row of flowerData.csv contains column headings and types.</li>
>-		<li>Check the First column contains
>-		equivalence class names option. Equivalence classes group related data. The first column of flowerData.csv specifies a single equivalence class called flowers.</li></ul>
>-	</li>
>-	<li class="skipspace">Click Finish. If you specified initial datapool dimensions, which may conflict with the CSV file dimensions, a dialog appears. Click Yes to use the dimensions of the CSV file. Click No to use the specified initial dimensions (and possibly truncate the CSV file data).
>-	The Datapool editor appears, showing the data contained in the flowers equivalence class. 
>-	<img
>-		border="0" src="../images/testTutorial_datapoolAppears.gif"
>-		width="354" height="416" alt=""/> 
>-		 For detailed information about creating a datapool, see <a
>-		href="../tasks/tcreatedp.htm">Creating a datapool</a>.</li>
>-</ol>
>-<h2><a name="ModifyTestCasesDP"> 
>-Modifying test cases to reference a
>-datapool</a></h2>
>- In this procedure, you use the datapool API to replace hard-coded test values with
>-	references to datapool columns.
>-
>-<h3>Adding libraries required by the datapool API</h3>The datapool API requires various TPTP and Eclipse Modeling Framework (EMF) libraries. In this procedure, you add the libraries to your Java build path. 
>-<ol>
>-	<li>Open the Java Perspective. From the file menu choose Window &gt;
>-	Open Perspective &gt; Java.</li>
>-	<li>Open the datapoolExample project properties. In the Navigator or Package Explorer window, right-click the datapoolExample project folder and choose Properties. The Properties for datapoolExample dialog appears.</li>
>-	<li>Add the following library JARs to the Java build path of the datapoolExample project:
>-
>-	
>-	<ul>
>-		<li>org.eclipse.tptp.platform.models_&lt;version&gt;/tptp-models.jar</li>
>-		<li>org.eclipse.tptp.platform.models.hierarchy_&lt;version&gt;/tptp-models-hierarchy.jar</li>
>-		<li>org.eclipse.emf.common_&lt;version&gt;.jar</li>
>-		<li>org.eclipse.emf.ecore_&lt;version&gt;.jar</li>
>-		<li>org.eclipse.emf.ecore.xmi_&lt;version&gt;.jar</li>
>-		<li>org.eclipse.equinox.common_&lt;version&gt;.jar</li>
>-	</ul>
>- 	
>- 	
>-	where &lt;version&gt; is the current version of the library JAR.
>-
>-	Steps:
>-	
>-	<ul>
>-		<li>In the left pane, select Java Build Path. </li>
>-		<li>In the right pane, select the Libraries tab. </li>
>-		<li>For each of the library JARs, complete the following steps:
>-	
>-		<ul>
>-			<li>If the library JAR is on the Java build path of the datapoolExample project, continue to the next library JAR. Otherwise, continue to the next step.</li>
>-			<li>Click Add External JARs....</li>
>-			<li>Navigate to the directory containing the library JAR and select the JAR file. The library JAR is contained in the same directory as the dependencies under the TPTP Libraries or JUnit 3 classpath container for the datapoolExample project. </li>
>-			<li>Click Open.</li>
>-		</ul>
>-		</li>
>-	</ul>
>-	</li>
>-	<li>Click OK to close the Properties dialog.</li>
>-</ol><h3> 
>-Using the datapool API</h3>In this procedure, you modify the MyShoppingCartTest class and testMyShoppingCartConstructor method to utilize the 
>-shoppingCartDatapool.
>- 
>-<ol>
>-	<li>If required, open the Java Perspective. From the file menu choose Window &gt;
>-	Open Perspective &gt; Java.</li>
>-	<li>Open MyShoppingCartTest.java. In the Navigator, open the
>-	datapoolExample project folder and double-click
>-	MyShoppingCartTest.java. The MyShoppingCartTest.java contents
>-	appear in the Java editor.</li>
>-	<li>Add the following import statements to the MyShoppingCartTest class.<pre>import org.eclipse.hyades.execution.runtime.datapool.IDatapool;
>-import org.eclipse.hyades.execution.runtime.datapool.IDatapoolFactory;
>-import org.eclipse.hyades.execution.runtime.datapool.IDatapoolIterator;
>-import org.eclipse.hyades.models.common.datapool.impl.Common_DatapoolFactoryImpl;</pre></li>
>-	<li>Declare an IDatapoolIterator class instance. This class instance will be initialized in your set up code and used in test methods.<pre>public class MyShoppingCartTest extends HyadesTestCase {
>-	
>-	IDatapoolIterator dpIterator;
>-	
>-	//...</pre></li>
>-	<li>Modify the setUp method to initialize your datapool. In a TPTP JUnit test environment, the setUp method provides a common fixture. You can use setUp to initialize common test variables. Note: specify your fully qualified workspace path in place of &lt;workspace&gt; in the java.io.File constructor.<pre>protected void setUp() throws Exception {
>-	// Initialize the datapool factory
>-	IDatapoolFactory dpFactory = new Common_DatapoolFactoryImpl();
>-		
>-	// Load the shoppingCartDatapool datapool 
>-	IDatapool datapool = dpFactory.load(
>-			new java.io.File(&quot;&lt;workspace&gt;\\datapoolExample\\shoppingCartDatapool.datapool&quot;),
>-			false);
>-		 
>-	// Create an iterator to traverse the datapool
>-	dpIterator = dpFactory.open(datapool,&quot;org.eclipse.hyades.datapool.iterator.DatapoolIteratorSequentialPrivate&quot;);
>-	
>-	// Initialize the datapool to traverse the first equivalence class.
>-	dpIterator.dpInitialize(datapool,0);
>-}</pre>Notes: 
>-	<ul>
>-		<li>The second parameter in the IDatapoolFactory load method indicates if the datapool instance is shared. If true the datapool cache is checked for an existing copy of the datapool. If false, the datapool is a private instance. Modifying a shared datapool instance may affect other users, and is only recommended for confined environments.</li>
>-		<li>If you want to programmatically edit a datapool import org.eclipse.hyades.edit.datapool.</li>
>-		<li>The second parameter in the IDatapoolFactory open method represents the type of iterator. For shared datapools use DatapoolIteratorSequentialPrivate.</li>
>-	</ul>
>-	</li><li>Modify the testMyShoppingCartConstructor method to utilize the 
>-	shoppingCartDatapool.
>-<pre>public void testMyShoppingCartConstructor()
>-throws Exception
>-{
>-	MyShoppingCart cart = new MyShoppingCart();
>-		
>-	// Traverse through datapool...
>-	// Test if constructor initializes each flower record appropriately
>-	while(!dpIterator.dpDone())
>-	{
>-		String Description = dpIterator.dpCurrent().getCell(&quot;Description&quot;).getStringValue();
>-		double datapoolPrice = dpIterator.dpCurrent().getCell(&quot;Price&quot;).getDoubleValue();
>-		
>-		// Test if the flower is accounted for in the application
>-		Double applicationPrice;
>-		assertNotNull(applicationPrice = (Double)cart.myFlowers.get(Description));
>-		
>-		// Test that the application price equals the price in the datapool 
>-		assertTrue(applicationPrice.doubleValue() == datapoolPrice);
>-		
>-		dpIterator.dpNext();
>-	}
>-}</pre></li><li>Save MyShoppingCartTest.java. From the file menu, choose File
>-	&gt; Save.</li>
>-	<li>Add the datapool to your testArtifact.
>-		<ul>
>-			<li>Open the Test Perspective. In the Test Navigator, double-click testDeployment to open it in the editor.</li>
>-			<li>In the Pairs tab, select testAsset and click Open...</li>
>-		<li>In the Test Assets tab, click Add.... Select the datapool and click OK. Save the asset.</li>
>-	</ul>
>-	</li>
>-	<li>Run the test using your custom deployment.<ul>
>-		<li>Open the Test Perspective. In the Test Navigator, right-click the MyShoppingCartTest test suite and choose Run
>-		As &gt; Run.... The Run configuration dialog appears.</li>
>-		<li>In the left pane of the Run configuration, choose the MyShoppingCartTest test suite.</li>
>-		<li>In the right pane of the Run configuration, select the deployment you created in the <a
>-			href="#BeforeYouBegin">Before You Begin</a> section. </li>
>-		<li>In the Test Logs tab, clear the Use defaults option and
>-		select the datapoolExample project folder for the location.</li>
>-		<li>Click Run to launch the test.</li>
>-	</ul></li>
>-	Notes: 
>-	<ul>		
>-		<li>If the deployment you select contains any encrypted datapools, a dialog will be shown after you have launched the test to require the password for each encrypted datapool that contained in the deployment.</li>		
>-	</ul>
>-		<li>Double-click the new MyShoppingCartTest test log, which appears in the Test Navigator. The MyShoppingCartTest test log appears. Select the Events tab to view the test result details.</li></ol>
>-</div><div>
>- 
>-Related concepts
>- 
>-<a href="../concepts/ccommontestingtasksandconcepts.htm">Common testing
>-tasks and concepts</a> 
>- 
>-Related tasks 
>-<a href="../tasks/tdeploymentintro.htm">Creating a Test Deployment</a> 
>-<a href="../tasks/tdatapool.htm">Providing tests with variable data</a>
>- 
>-<a href="../tasks/tptpJUnitTest_creatingManually.htm">Creating a JUnit
>-test manually</a> 
>- 
>-</div>
>-</body>
>-</html>
>Index: samples/saccessdatapool.htm
>===================================================================
>RCS file: samples/saccessdatapool.htm
>diff -N samples/saccessdatapool.htm
>--- /dev/null	1 Jan 1970 00:00:00 -0000
>+++ samples/saccessdatapool.htm	1 Jan 1970 00:00:00 -0000
>@@ -0,0 +1,419 @@
>+<!DOCTYPE html
>+ PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
>+<html lang="en-us" xml:lang="en-us">
>+
>+
>+<head>
>+<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
>+<meta name="security" content="public" />
>+<meta name="Robots" content="index,follow" />
>+<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
>+<meta name="DC.Type" content="task" />
>+<meta name="DC.Title" content="Accessing a datapool from a Hyades test" />
>+<meta name="abstract" content="You can use a datapool from a Hyades test by making calls to the datapool API from a test's generated Java code." />
>+<meta name="description" content="You can use a datapool from a Hyades test by making calls to the datapool API from a test's generated Java code." />
>+<meta name="DC.Relation" scheme="URI" content="../tasks/tdatapool.dita" />
>+<meta name="DC.Format" content="XHTML" />
>+<meta name="DC.Identifier" content="taccessdp" />
>+<meta name="DC.Language" content="en-us" />
>+<link rel="stylesheet" type="text/css" href="../css/ibmdita.css" />
>+<link rel="stylesheet" type="text/css" href="../css/swg_info_common.css" />
>+<title>Tutorial: Accessing a datapool from a TPTP JUnit test</title>
>+</head>
>+<body>
>+
>+<h1 class="topictitle1">Tutorial: Accessing a datapool from a TPTP JUnit test</h1>
>+<div>
>+<h2> 
>+Objectives:</h2>
>+To create and access a datapool from an example test application using the Eclipse Test and
>+Performance Tools Platform (TPTP). <h2>
>+Time required</h2>
>+1 hour
>+<h2><a name="BeforeYouBegin">Before you begin</a></h2>
>+Before you start this tutorial,
>+you need to 
>+<ol>
>+	<li>
>+	Install Eclipse and the Eclipse Test and Performance Tools
>+	Platform (TPTP).</li>
>+	<li>Have a basic understanding of JUnit testing. For more information about JUnit testing, see <a
>+		href="http://www.junit.org">www.junit.org</a>.</li>
>+	<li>Configure and run the Agent Controller which corresponds to your TPTP version. For more information, see <a
>+		href="http://www.eclipse.org/tptp/home/downloads/installguide/HyadesDataCollection.html">
>+	Getting started with the Agent Controller</a>. 
>+	</li></ol>
>+<h2> 
>+Description</h2>
>+In this tutorial,
>+you create and test an application called MyShoppingCart. Using the Eclipse Test and Performance Tools Platform (TPTP), you develop JUnit tests and create a datapool to provide data to the test environment. 
>+This tutorial guides you through the following procedures:
>+<ol>
>+	<li><a href="#CreateUserApp">Creating a sample user application</a></li>
>+	<li><a href="#SetupTestApp" target="_self">Setting up a TPTP test
>+	suite</a></li>
>+	<li><a href="#CreateDatapool">Creating a datapool and initializing test
>+	data</a></li>
>+	<li><a href="#ModifyTestCasesDP">Modifying test cases to reference a
>+	datapool</a> 
>+	</li>
>+</ol>
>+
>+
>+<h2><a name="CreateUserApp">Creating a sample user application</a></h2> 
>+In this procedure, you develop the MyShoppingCart class. In subsequent procedures, you will use the Eclipse Test and Performance Tools Platform to develop a corresponding test environment. <ol>
>+	<li>Create a new Eclipse Java Project. <ul>
>+		<li>From the File menu choose File &gt; New &gt; Project... The
>+		New Project dialog appears.</li>
>+		<li>In the Wizards list, select Java Project and click Next.
>+		The Create a Java project page appears.</li>
>+		<li>Type <tt>datapoolExample</tt> for the Project name and click Finish.
>+		The datapoolExample project appears in the Navigator view. 
>+		</li>
>+	</ul>
>+	</li>
>+	<li>Create the MyShoppingCart class.<ul>
>+		<li>In the Navigator view, right-click the datapoolExample
>+		project and choose New &gt; Class. The New Java Class dialog
>+		appears.</li>
>+		<li>Type <tt>MyShoppingCart</tt> in the Name field.</li>
>+		<li>Clear the option to create the main method public static void
>+		main(String[] args).</li>
>+		<li>Click Finish. The MyShoppingCart.java file appears in the Java
>+		editor.</li>
>+		<li>Type the following for the MyShoppingCart source:<pre>
>+import java.util.Hashtable;
>+
>+public class MyShoppingCart {
>+
>+	public Hashtable myFlowers;
>+	
>+	public MyShoppingCart() {
>+	 
>+		myFlowers = new Hashtable();
>+		myFlowers.put("Orchid", new Double(5.99));
>+		myFlowers.put("Tulip", new Double(1.99));
>+		myFlowers.put("Yellow Carnation", new Double(6.99));
>+		myFlowers.put("White Rose", new Double(9.99));
>+		myFlowers.put("Geraniums", new Double(4.99));		
>+	}
>+	
>+	public double itemCost(String itemName, int itemQuantity)
>+	{
>+	 Double price = (Double)myFlowers.get(itemName);
>+		
>+	 if (price != null) {
>+	 	 return price.doubleValue()*itemQuantity;
>+	 }
>+	 
>+	 return -1;	 	 	 	 	 		
>+	}
>+}</pre></li>
>+		<li>Save MyShoppingCart.java. From the File menu choose File &gt;
>+		Save.</li>
>+	</ul>
>+	</li>
>+</ol>
>+<h2><a name="SetupTestApp">Setting up a TPTP test suite</a></h2>
>+ In this procedure, you develop a test suite for the the MyShoppingCart class. Using the Eclipse Test and Performance Tools Platform, you develop a JUnit
>+	test for the itemCost method. <ol>
>+	<li>Open the Test Perspective.
>+	<ul>
>+		<li>From the File menu, choose Window &gt; Open Perspective &gt;
>+		Other.</li>
>+		<li>Select Test and click OK. The <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a> of the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a> appears.</li>
>+	</ul>
>+	</li>
>+	<li>Create a new TPTP JUnit Test.<ul>
>+		<li>In the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a> of the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a>, right-click the datapoolExample project and choose New
>+		&gt; Test Element...</li>
>+		<li>In the Test Element dialog, select TPTP JUnit test and click Next. The New Test Case dialog appears, prompting you to add JUnit libraries. Click Yes to add JUnit libraries.</li>
>+		<li> In the New JUnit Test Source Code page, type MyShoppingCartTest in the Name field. In the Select how the test behavior is edited section, choose the edit In
>+		the test editor option (the default).</li>
>+		<li>Click Finish. The TPTP JUnit Test editor appears, showing the
>+		MyShoppingCartTest test suite. The Overview tab includes a test description, Source Information, and a Test Methods listing. Currently, no test methods are defined. For this tutorial, the TPTP JUnit Test editor generates method stubs so the Implement
>+		Test Behavior as code option in the Source Information section should be cleared. For more information, see 
>+		<a href="../concepts/cJUnitTestEditor.htm">JUnit Test Suite Editor</a>.</li>
>+	</ul>
>+
>+		</li>
>+	<li>Add the testItemCost and testMyShoppingCartConstructor methods.
>+	<ul>
>+		<li>In the Test Methods tab, click Add. A default name appears for your test.</li>
>+		<li>Add the testItemCost method. In the Name field, type testItemCost for the new test name. In the Description field, type Test
>+		for the MyShoppingCart.itemCost(String, int) method.</li>
>+		<li>Add the testMyShoppingCartConstructor method. In the Test Methods tab, click Add. In the Name field, type testMyShoppingCartConstructor for the new test name. In the Description field, type Test
>+		for the MyShoppingCart constructor.</li>
>+	</ul>
>+	</li>
>+	<li>Configure the test execution behavior.
>+	<ul>
>+		<li>Add a test execution loop. In the Behavior tab, click Add..
>+		&gt; Loop. In the Name field, type Loop_MyShoppingCart. In
>+		the Number of Iterations field, type 1 (the default value).</li>
>+		<li>Add a testMyShoppingCartConstructor invocation. Select
>+		Loop_MyShoppingCart and click Add... &gt; invocation. The Test Invocation
>+		dialog appears. Select Select testMyShoppingCartConstructor and
>+		click OK.</li>
>+		<li>Add a testItemCost invocation. Select
>+		Loop_MyShoppingCart and click Add... &gt; invocation. The Test
>+		Invocation dialog appears. Select testItemCost and click OK.</li>
>+		<li>Save the test suite. From the File menu, choose File &gt; Save.
>+		 
>+		<img border="0" src="../images/testTutorial_Behavior.gif" width="534"
>+			height="407" alt=""/> 
>+		Note: the Save command causes the TPTP JUnit Test editor to create
>+		test method stubs in MyShoppingCartTest.java. 
>+		</li>
>+	</ul>
>+	</li>
>+	<li>
>+	Enter code for the generated JUnit test methods testMyShoppingCartConstructor and testItemCost.<ul>
>+		<li>Open the Java Perspective. From the file menu choose Window
>+		&gt; Open Perspective &gt; Other... &gt; Java.</li>
>+		<li>Open MyShoppingCartTest.java. In the Navigator, open the datapoolExample project folder and double-click MyShoppingCartTest.java. The MyShoppingCartTest.java contents appear in the Java editor, including code to setup and execute the test suite, and stub methods for testMyShoppingCartConstructor and testItemCost.</li>
>+		<li>Type the following code for the testMyShoppingCartConstructor method.<pre>public void testMyShoppingCartConstructor()
>+throws Exception
>+{
>+	MyShoppingCart cart = new MyShoppingCart();
>+	Double priceOrchid = (Double)cart.myFlowers.get("Orchid");
>+	Double priceTulip = (Double)cart.myFlowers.get("Tulip");
>+	
>+	assertTrue(priceOrchid.doubleValue() == 5.99);
>+	assertTrue(priceTulip.doubleValue() == 1.99);
>+}</pre></li>
>+	<li>Type the following code for the testItemCost method.
>+<pre>public void testItemCost()
>+throws Exception
>+{
>+	MyShoppingCart cart = new MyShoppingCart();
>+	double priceForTwo = cart.itemCost("Orchid", 2);
>+	
>+	assertTrue(priceForTwo == 11.98);
>+}</pre>
>+</li><li>Save MyShoppingCartTest.java. From the file menu, choose File
>+		&gt; Save.</li></ul></li><li>Open the Test Perspective and create a test deployment. For an example, see <a href="../tasks/tdeploymentintro.htm">Creating a
>+	Test Deployment</a>. </li>
>+	<li>
>+	Run the test using your custom deployment.<ul>
>+		<li>In the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a> of the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a>, right-click the MyShoppingCartTest test suite and choose Run
>+		As &gt; Run.... The Run configuration dialog appears.</li>
>+		<li>In the Configurations pane, select Test and then click New.</li>
>+		<li>In the left pane of the Run configuration (Select test to run), expand datapoolExample and choose the MyShoppingCartTest test suite.</li>
>+		<li>In the right pane of the Run configuration, select the deployment you created section. </li>
>+		<li>In the Test Logs tab, clear the Use defaults option and
>+		select the datapoolExample project folder for the location.</li>
>+		<li>Click Run to launch the test.</li>
>+	</ul></li>
>+		<li>Double-click the MyShoppingCartTest test log, which appears in the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a> of the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a>. The MyShoppingCartTest test log appears. Select the Events tab to view the test details. You should see the following events: start of test suite, start of Loop_MyShoppingCart, test start, test verdict, test stop, second test start, second test verdict, second test stop, loop stop, test suite verdict, and test suite stop. 
>+		<img border="0" src="../images/testTutorial_JUnitSuccess.gif"
>+			width="666" height="420" alt=""/></li></ol> 
>+<h2><a name="CreateDatapool">Creating a datapool and initializing test
>+data</a></h2>
>+ In this procedure, you create a simple datapool to store test data. Using the datapool editor, you define a datapool's structural
>+	elements, including variables (columns), records (rows), and
>+	equivalence classes (groups of related records). <ol>
>+	<li>Create a CSV (comma delimited) file including your test data. Typically, you can export data in a spreadsheet application or database to CSV format. In this tutorial, however, you type the data in a text editor.
>+	<ul>
>+		<li>Type the following in a text editor. <pre>
>+,ModelNumber::String,Description::String,Price::Double
>+flowers,F0001,Orchid,5.99
>+flowers,F0002,Tulip,1.99
>+flowers,F0003,Yellow Carnation,6.99
>+flowers,F0004,White Rose,9.99
>+flowers,F0005,Geraniums,4.99</pre>
>+</li><li>Save the file as flowerData.csv in a temporary external location.</li>
>+	</ul>
>+	</li>
>+
>+	<li class="skipspace">In Eclipse, open the Test perspective.
>+	<ul>
>+		<li>From the File menu, choose Window &gt; Open Perspective &gt;
>+		Other.</li>
>+		<li>Select Test and click OK. The <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a> of the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a>
>+		appears.</li>
>+	</ul>
>+	</li>
>+	<li class="skipspace">In the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a> of the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a>, right-click a
>+	project and select New &gt; Test Element...
>+	The New Test Element dialog appears.</li>
>+	<li class="skipspace">In the Wizards list box, expand the +		class="uicontrol">Test Assets folder and select +		class="uicontrol">Datapool.</li>
>+	<li class="skipspace">Click Next. The +		class="uicontrol">New Datapool dialog appears.</li>
>+	<li class="skipspace">Choose the datapool project folder and
>+	datapool name. In the list of existing projects, select the
>+	datapoolExample project. In the Name
>+	field, type shoppingCartDatapool. Click Next to
>+	continue and then Next again to open the CSV (comma delimited) file import page.</li>
>+	<li class="skipspace">Import the
>+	CSV file flowerData.csv.<ul>
>+		<li>In the CSV File field, click Browse
>+		and navigate to flowerData.csv.</li>
>+		<li>Check the First row
>+		contains variable names and suggested types option. The first row of flowerData.csv contains column headings and types.</li>
>+		<li>Check the First column contains
>+		equivalence class names option. Equivalence classes group related data. The first column of flowerData.csv specifies a single equivalence class called flowers.</li></ul>
>+	</li>
>+	<li class="skipspace">Click Finish. If you specified initial datapool dimensions, which may conflict with the CSV file dimensions, a dialog appears. Click Yes to use the dimensions of the CSV file. Click No to use the specified initial dimensions (and possibly truncate the CSV file data).
>+	The Datapool editor appears, showing the data contained in the flowers equivalence class. 
>+	<img
>+		border="0" src="../images/testTutorial_datapoolAppears.gif"
>+		width="354" height="416" alt=""/> 
>+		 For detailed information about creating a datapool, see <a
>+		href="../tasks/tcreatedatapool.htm">Creating a datapool</a>.</li>
>+</ol>
>+<h2><a name="ModifyTestCasesDP"> 
>+Modifying test cases to reference a
>+datapool</a></h2>
>+ In this procedure, you use the datapool API to replace hard-coded test values with
>+	references to datapool columns.
>+
>+<h3>Adding libraries required by the datapool API</h3>The datapool API requires various TPTP and Eclipse Modeling Framework (EMF) libraries. In this procedure, you add the libraries to your Java build path. 
>+<ol>
>+	<li>Open the Java Perspective. From the file menu choose Window &gt;
>+	Open Perspective &gt; Java.</li>
>+	<li>Open the datapoolExample project properties. In the Navigator or Package Explorer window, right-click the datapoolExample project folder and choose Properties. The Properties for datapoolExample dialog appears.</li>
>+	<li>Add the following library JARs to the Java build path of the datapoolExample project:
>+
>+	
>+	<ul>
>+		<li>org.eclipse.tptp.platform.models_&lt;version&gt;/tptp-models.jar</li>
>+		<li>org.eclipse.tptp.platform.models.hierarchy_&lt;version&gt;/tptp-models-hierarchy.jar</li>
>+		<li>org.eclipse.emf.common_&lt;version&gt;.jar</li>
>+		<li>org.eclipse.emf.ecore_&lt;version&gt;.jar</li>
>+		<li>org.eclipse.emf.ecore.xmi_&lt;version&gt;.jar</li>
>+		<li>org.eclipse.equinox.common_&lt;version&gt;.jar</li>
>+	</ul>
>+ 	
>+ 	
>+	where &lt;version&gt; is the current version of the library JAR.
>+
>+	Steps:
>+	
>+	<ul>
>+		<li>In the left pane, select Java Build Path. </li>
>+		<li>In the right pane, select the Libraries tab. </li>
>+		<li>For each of the library JARs, complete the following steps:
>+	
>+		<ul>
>+			<li>If the library JAR is on the Java build path of the datapoolExample project, continue to the next library JAR. Otherwise, continue to the next step.</li>
>+			<li>Click Add External JARs....</li>
>+			<li>Navigate to the directory containing the library JAR and select the JAR file. The library JAR is contained in the same directory as the dependencies under the TPTP Libraries or JUnit 3 classpath container for the datapoolExample project. </li>
>+			<li>Click Open.</li>
>+		</ul>
>+		</li>
>+	</ul>
>+	</li>
>+	<li>Click OK to close the Properties dialog.</li>
>+</ol><h3> 
>+Using the datapool API</h3>In this procedure, you modify the MyShoppingCartTest class and testMyShoppingCartConstructor method to utilize the 
>+shoppingCartDatapool.
>+ 
>+<ol>
>+	<li>If required, open the Java Perspective. From the file menu choose Window &gt;
>+	Open Perspective &gt; Java.</li>
>+	<li>Open MyShoppingCartTest.java. In the Navigator, open the
>+	datapoolExample project folder and double-click
>+	MyShoppingCartTest.java. The MyShoppingCartTest.java contents
>+	appear in the Java editor.</li>
>+	<li>Add the following import statements to the MyShoppingCartTest class.<pre>import org.eclipse.hyades.execution.runtime.datapool.IDatapool;
>+import org.eclipse.hyades.execution.runtime.datapool.IDatapoolFactory;
>+import org.eclipse.hyades.execution.runtime.datapool.IDatapoolIterator;
>+import org.eclipse.hyades.models.common.datapool.impl.Common_DatapoolFactoryImpl;</pre></li>
>+	<li>Declare an IDatapoolIterator class instance. This class instance will be initialized in your set up code and used in test methods.<pre>public class MyShoppingCartTest extends HyadesTestCase {
>+	
>+	IDatapoolIterator dpIterator;
>+	
>+	//...</pre></li>
>+	<li>Modify the setUp method to initialize your datapool. In a TPTP JUnit test environment, the setUp method provides a common fixture. You can use setUp to initialize common test variables. Note: specify your fully qualified workspace path in place of &lt;workspace&gt; in the java.io.File constructor.<pre>protected void setUp() throws Exception {
>+	// Initialize the datapool factory
>+	IDatapoolFactory dpFactory = new Common_DatapoolFactoryImpl();
>+		
>+	// Load the shoppingCartDatapool datapool 
>+	IDatapool datapool = dpFactory.load(
>+			new java.io.File(&quot;&lt;workspace&gt;\\datapoolExample\\shoppingCartDatapool.datapool&quot;),
>+			false);
>+		 
>+	// Create an iterator to traverse the datapool
>+	dpIterator = dpFactory.open(datapool,&quot;org.eclipse.hyades.datapool.iterator.DatapoolIteratorSequentialPrivate&quot;);
>+	
>+	// Initialize the datapool to traverse the first equivalence class.
>+	dpIterator.dpInitialize(datapool,0);
>+}</pre>Notes: 
>+	<ul>
>+		<li>The second parameter in the IDatapoolFactory load method indicates if the datapool instance is shared. If true the datapool cache is checked for an existing copy of the datapool. If false, the datapool is a private instance. Modifying a shared datapool instance may affect other users, and is only recommended for confined environments.</li>
>+		<li>If you want to programmatically edit a datapool import org.eclipse.hyades.edit.datapool.</li>
>+		<li>The second parameter in the IDatapoolFactory open method represents the type of iterator. For shared datapools use DatapoolIteratorSequentialPrivate.</li>
>+	</ul>
>+	</li><li>Modify the testMyShoppingCartConstructor method to utilize the 
>+	shoppingCartDatapool.
>+<pre>public void testMyShoppingCartConstructor()
>+throws Exception
>+{
>+	MyShoppingCart cart = new MyShoppingCart();
>+		
>+	// Traverse through datapool...
>+	// Test if constructor initializes each flower record appropriately
>+	while(!dpIterator.dpDone())
>+	{
>+		String Description = dpIterator.dpCurrent().getCell(&quot;Description&quot;).getStringValue();
>+		double datapoolPrice = dpIterator.dpCurrent().getCell(&quot;Price&quot;).getDoubleValue();
>+		
>+		// Test if the flower is accounted for in the application
>+		Double applicationPrice;
>+		assertNotNull(applicationPrice = (Double)cart.myFlowers.get(Description));
>+		
>+		// Test that the application price equals the price in the datapool 
>+		assertTrue(applicationPrice.doubleValue() == datapoolPrice);
>+		
>+		dpIterator.dpNext();
>+	}
>+}</pre></li><li>Save MyShoppingCartTest.java. From the file menu, choose File
>+	&gt; Save.</li>
>+	<li>Add the datapool to your testArtifact.
>+		<ul>
>+			<li>Open the Test Perspective. In the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a> of the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a>, double-click testDeployment to open it in the editor.</li>
>+			<li>In the Pairs tab, select testAsset and click Open...</li>
>+		<li>In the Test Assets tab, click Add.... Select the datapool and click OK. Save the asset.</li>
>+	</ul>
>+	</li>
>+	<li>Run the test using your custom deployment.<ul>
>+		<li>Open the Test Perspective. In the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a> of the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a>, right-click the MyShoppingCartTest test suite and choose Run
>+		As &gt; Run.... The Run configuration dialog appears.</li>
>+		<li>In the left pane of the Run configuration, choose the MyShoppingCartTest test suite.</li>
>+		<li>In the right pane of the Run configuration, select the deployment you created in the <a
>+			href="#BeforeYouBegin">Before You Begin</a> section. </li>
>+		<li>In the Test Logs tab, clear the Use defaults option and
>+		select the datapoolExample project folder for the location.</li>
>+		<li>Click Run to launch the test.</li>
>+	</ul></li>
>+	Notes: 
>+	<ul>		
>+		<li>If the deployment you select contains any encrypted datapools, a dialog will be shown after you have launched the test to require the password for each encrypted datapool that contained in the deployment.</li>		
>+	</ul>
>+		<li>Double-click the new MyShoppingCartTest test log, which appears in the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a> of the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a>. The MyShoppingCartTest test log appears. Select the Events tab to view the test result details.</li></ol>
>+</div>
>+
>+
>+Related tasks 
>+<a href="../concepts/cjunitintro.htm">Testing with JUnit</a> 
>+<a href="../tasks/tdatapoolsintro.htm">Providing tests with variable data</a> 
>+<a href="../tasks/tdeploymentintro.htm">Creating a test deployment</a> 
>+
>+
>+</body>
>+</html>
>Index: tasks/tcreatedatapool.htm
>===================================================================
>RCS file: tasks/tcreatedatapool.htm
>diff -N tasks/tcreatedatapool.htm
>--- /dev/null	1 Jan 1970 00:00:00 -0000
>+++ tasks/tcreatedatapool.htm	1 Jan 1970 00:00:00 -0000
>@@ -0,0 +1,94 @@
>+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN">
>+<html lang="en-us" xml:lang="en-us">
>+
>+<head>
>+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
>+<link rel="StyleSheet" href="../css/book.css" type="text/css" />
>+
>+<title>Creating a datapool</title>
>+</head>
>+
>+<body>
>+
>+<h1>Creating a datapool</h1>
>+
>+Datapools provide variable test data to tests during execution. Test data (for example, input and output data) is stored in a 
>+datapool and substituted in the test during execution. Test data can be added, modified, 
>+and deleted from the datapool and substituted in the test during execution without any 
>+modifications to the test.
>+
>+Datapools contain three structural elements:
>+
>+<ul>
>+	<li>Equivalence class: A subset of related test data in the datapool with an associated name that produces the equivalent pass/fail result for a test. A datapool contains at least one equivalence class.</li>
>+	 
>+	 
>+	<li>Variable: A column of test data within each equivalence class with an associated name and type.</li>
>+	 
>+	 
>+	<li>Record: A slice or row of test data within an equivalence class with one or more variables.</li>
>+</ul>
>+
>+Datapools are created with the New Datapool wizard:
>+
>+<ol>
>+	<li>Open the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a>, right-click in the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a>, select New &gt; Test Element... &gt; Test Assets &gt; Datapool, and click Next.</li>
>+ <li>Select the parent folder and define the name of the datapool and click Next.</li>
>+ <li>Provide a description for the datapool.</li>
>+ <li>Provide the dimensions for the datapool. The dimensions represent the number of variables (or columns) and records (or rows) in each equivalence class of the datapool.</li>
>+ <li>Test data can be created and edited in a 
>+Comma-Separated Value (CSV) file editor (for example, Microsoft® Excel®) and imported into a new or existing datapool. When working with large 
>+quantities of data, this approach is recommended. To import test data from a Comma-Separated Value (CSV) file into the datapool, select Import CSV file into the new datapool:
>+ 	<ul>
>+ 		<li>Provide or select (click Browse...) the path to the Comma-Separated Value (CSV) file.</li>
>+ 		<li>Select the encoding of the Comma-Separated Value (CSV) file. This encoding is used to read the Comma-Separated Value (CSV) file.</li>
>+ 		<li>Select First row of the CSV file contains the variable names and optional suggested types if the first row of the Comma-Separated Value (CSV) file contains the variable names and optional suggested types. That is, the first row of the Comma-Separated Value (CSV) file contains: 
>+ 			 
>+ 			&lt;variable 1 name&gt;[::&lt;variable 1 type&gt;],&lt;variable 2 name&gt;[::&lt;variable 2 type&gt;]...&lt;variable n name&gt;[::&lt;variable n type&gt;]
>+ 			 
>+ 		</li>
>+ 		<li>Select First column of the CSV file contains the equivalence class names and optional row numbers if the first column of the CSV file contains the equivalence class names and optional row numbers. That is, the first column of the Comma-Separated Value (CSV) file contains:
>+		 	 
>+		 	&lt;equivalence class 1 name&gt;[::0]
>+				&lt;equivalence class 2 name&gt;[::1]
>+				...
>+				&lt;equivalence class n name&gt;[::&lt;n&gt;]
>+				 
>+ 		</li>
>+ 	</ul>
>+ </li>
>+ <li>Click Finish to create the datapool.</li>
>+ <li>The Confirm Open Editor dialog may appear (see the Window &gt; Preferences... &gt; Test &gt; Open Editor preference), confirming if the new datapool is to be opened in the Datapool editor.</li>
>+</ol>
>+
>+
>+Related concepts 
>+<a href="../concepts/cdatapooleditor.htm">Datapool Editor</a> 
>+
>+
>+
>+Related tasks 
>+<a href="cdatapoolimport.htm">Importing a Comma-Separated Value (CSV) file as a Datapool</a> 
>+<a href="cdatapoolexport.htm">Exporting a Datapool as a Comma-Separated Value (CSV) file</a> 
>+
>+
>+
>+Related samples 
>+<a href="../samples/saccessdatapool.htm">Tutorial: Accessing a datapool from a TPTP JUnit test</a> 
>+
>+
>+</body>
>+
>+</html>
>Index: tasks/tdatapoolsintro.htm
>===================================================================
>RCS file: tasks/tdatapoolsintro.htm
>diff -N tasks/tdatapoolsintro.htm
>--- /dev/null	1 Jan 1970 00:00:00 -0000
>+++ tasks/tdatapoolsintro.htm	1 Jan 1970 00:00:00 -0000
>@@ -0,0 +1,56 @@
>+<!DOCTYPE html
>+ PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
>+<html lang="en-us" xml:lang="en-us">
>+
>+<head>
>+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
>+<link rel="StyleSheet" href="../css/book.css" type="text/css" />
>+
>+<title>Providing tests with variable data</title>
>+</head>
>+
>+<body>
>+
>+<h1>Providing tests with variable data</h1>
>+
>+This section describes providing tests with variable test data from a datapool.
>+
>+<ul>
>+	<li>
>+		<a href="tcreatedatapool.htm">Creating a datapool</a>
>+		Datapools provide variable test data to tests during execution.
>+		 
>+	</li>
>+	<li>
>+		<a href="../samples/saccessdatapool.htm">Tutorial: Accessing a datapool from a TPTP JUnit test</a>
>+		Tutorial to demonstrate using datapools with <a href="../concepts/cjunitintro.htm">TPTP JUnit tests</a>.
>+		 
>+	</li>
>+</ul>
>+
>+
>+Related concepts 
>+<a href="../concepts/cdatapooleditor.htm">Datapool Editor</a> 
>+
>+
>+
>+Related tasks 
>+<a href="cdatapoolimport.htm">Importing a Comma-Separated Value (CSV) file as a Datapool</a> 
>+<a href="cdatapoolexport.htm">Exporting a Datapool as a Comma-Separated Value (CSV) file</a> 
>+
>+
>+</body>
>+
>+</html>
>Index: concepts/cdatapooleditor.htm
>===================================================================
>RCS file: concepts/cdatapooleditor.htm
>diff -N concepts/cdatapooleditor.htm
>--- /dev/null	1 Jan 1970 00:00:00 -0000
>+++ concepts/cdatapooleditor.htm	1 Jan 1970 00:00:00 -0000
>@@ -0,0 +1,131 @@
>+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN">
>+<html lang="en-us" xml:lang="en-us">
>+
>+
>+<head>
>+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
>+<link rel="StyleSheet" href="../css/book.css" type="text/css" />
>+
>+<title>Datapool Editor</title>
>+</head>
>+
>+<body>
>+
>+<h1>Datapool Editor</h1>
>+
>+Datapools are edited using the Datapool Editor. The editor contains the following tabs: 
>+
>+<h2>Overview</h2>
>+
>+This tab provides an overview of the datapool, including its general information, variables, and equivalence classes.
>+
>+This tab contains the following sections:
>+
>+<ul>
>+	<li>
>+		General Information
>+		Contains the datapool's name, description, and file path within the workspace. The datapool's name1 and description are editable.
>+		 
>+	</li>
>+	<li>
>+		Variables
>+		Contains the variables associated with the datapool.
>+		 
>+		Variables can be added to the list by clicking the Add button.
>+		 
>+		Selected variables can be removed (Remove), moved up (Up), or moved down (Down).
>+		 
>+		Variable names can be edited by double-clicking the variable or selecting the variable and pressing F2.
>+		 
>+	</li>
>+	<li>
>+		Equivalence Classes
>+		Contains the equivalence classes associated with the datapool.
>+		 
>+		Equivalence classes can be added to the list by clicking the Add button.
>+		 
>+		Selected equivalence classes can be removed (Remove), moved up (Up), moved down (Down), or opened in the associated tab (Open...).
>+		 
>+		Equivalence class names can be edited by double-clicking the equivalence class or selecting the equivalence class and pressing F2.
>+		 
>+	</li>
>+</ul>
>+
>+[1] Datapools have a file name and logical name. The logical name is used in the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a> of the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a>, dialogs, editors, and wizards to represent the datapool.
>+The file name represents the datapool file (*.datapool) within the workspace. When the datapool is created, the logical name defaults to the file name 
>+(excluding the .artifact file extension) and may be modified without modifying the file name. The logical name allows customization of the datapool name 
>+without affecting the file name within the workspace.
>+
>+<h2>Equivalence Classes2</h2>
>+
>+This tab contains the datapool table with the variables (or columns) for the datapool, records (or rows) for the equivalence class, and cells for the records:
>+
>+<ul>
>+	<li>
>+		Variables
>+
>+		Each variable has an associated name and type (for example, String, Number, Boolean, Enumeration, and Complex) that are used in the variable column name (for example, 
>+		&lt;variable name&gt;::&lt;variable type&gt;) in the datapool table. Each variable is positioned in the datapool table relative to the other variables 
>+		in the datapool. Variables may be encrypted for sensitive data, such as user identifiers. Variables are encrypted with a password for the datapool.
>+		 
>+		Variables can be inserted (right-click on the datapool table and select Insert Variable...), removed (right-click a variable column in the datapool table and 
>+		select Remove Variable), and edited (right-click a variable column in the datapool table and select Edit Variable... or select the variable column name 
>+		in the datapool table).
>+		 
>+	</li>
>+	<li>
>+		Records
>+
>+		Each record has an associated number that is used in the first column in the datapool table. Each record is positioned in the datapool table relative to the other records in the equivalence class.
>+		 
>+		Records can be inserted (right-click on the datapool table and select Insert Record), removed (right-click the record number in the first column in the datapool table and 
>+		select Remove Record), and edited (right-click the record number in the first column in the datapool table and select Edit Record...).
>+		 
>+		Individual selected records (click the record number in the first column in the datapool table) or multiple selected records (hold Ctrl and click the record numbers in the first 
>+		column in the datapool table) can be cut (right-click and select Cut, Ctrl+X, or select Edit &gt; Cut from the file menu),
>+		copied (right-click and select Copy, Ctrl+C, or select Edit &gt; Copy from the file menu), and deleted (press Delete). Copied records can be pasted
>+		(right-click the record number in the first column in the datapool table and select Paste, Ctrl+V, or select Edit &gt; Paste from the file menu).
>+		 
>+	</li>
>+	<li>
>+		Cells
>+
>+		Cells can be edited by double-clicking the cell in the datapool table.
>+		 
>+		Individual selected cells can be cut (right-click and select Cut, Ctrl+X, or select Edit &gt; Cut from the file menu),
>+		copied (right-click and select Copy, Ctrl+C, or select Edit &gt; Copy from the file menu), and deleted (press Delete). Copied cells or the system clipboard can be pasted
>+		(right-click the cell and select Paste, Ctrl+V, or select Edit &gt; Paste from the file menu). Finally, cells can be searched and replaced (Ctrl+F or select Edit 
>+		&gt; Find/Replace from the file menu).
>+		 
>+	</li>
>+</ul>
>+
>+[2] Each equivalence class has an associated tab named &lt;Equivalence Class Name&gt;.
>+
>+
>+Related tasks 
>+<a href="../tasks/tcreatedatapool.htm">Creating a datapool</a> 
>+<a href="../tasks/cdatapoolimport.htm">Importing a Comma-Separated Value (CSV) file as a Datapool</a> 
>+<a href="../tasks/cdatapoolexport.htm">Exporting a Datapool as a Comma-Separated Value (CSV) file</a> 
>+
>+
>+
>+Related samples 
>+<a href="../samples/saccessdatapool.htm">Tutorial: Accessing a datapool from a TPTP JUnit test</a> 
>+
>+
>+</body>
>+
>+</html>
>Index: tasks/cdatapoolimport.htm
>===================================================================
>RCS file: tasks/cdatapoolimport.htm
>diff -N tasks/cdatapoolimport.htm
>--- /dev/null	1 Jan 1970 00:00:00 -0000
>+++ tasks/cdatapoolimport.htm	1 Jan 1970 00:00:00 -0000
>@@ -0,0 +1,102 @@
>+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN">
>+<html lang="en-us" xml:lang="en-us">
>+
>+<head>
>+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
>+<link rel="StyleSheet" href="../css/book.css" type="text/css" />
>+
>+<title>Importing a Comma-Separated Value (CSV) file as a datapool</title>
>+</head>
>+
>+<body>
>+
>+<h1>Importing a Comma-Separated Value (CSV) file as a datapool</h1>
>+
>+Test data in a Comma-Separated Value (CSV) file can be imported into a new or existing datapool. Test data can be created and edited in a 
>+Comma-Separated Value (CSV) file editor (for example, Microsoft® Excel®) and imported into a new or existing datapool. This is the recommended
>+approach when working with large quantities of data.
>+
>+Import test data from a Comma-Separated Value (CSV) file into a new datapool with the Import CSV File as Datapool wizard:
>+
>+<ol>
>+	<li>Open the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a>, right-click in the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a>, and select Import....</li>
>+	<li>Select Test &gt; CSV File as Datapool, and click Next.</li>
>+ <li>Provide or select (click Browse...) the path to the Comma-Separated Value (CSV) file.</li>
>+ <li>Select the encoding of the Comma-Separated Value (CSV) file. This encoding is used to read the Comma-Separated Value (CSV) file.</li>
>+ <li>Select First row of the CSV file contains the variable names and optional suggested types if the first row of the Comma-Separated Value (CSV) file contains the variable names and optional suggested types. That is, the first row of the Comma-Separated Value (CSV) file contains: 
>+ 	 
>+ 	&lt;variable 1 name&gt;[::&lt;variable 1 type&gt;],&lt;variable 2 name&gt;[::&lt;variable 2 type&gt;]...&lt;variable n name&gt;[::&lt;variable n type&gt;]
>+ 	 
>+ </li>
>+ <li>Select First column of the CSV file contains the equivalence class names and optional record numbers if the first column of the Comma-Separated Value (CSV) file contains the equivalence class names and optional record numbers. That is, the first column of the Comma-Separated Value (CSV) file contains:
>+ 	 
>+ 	&lt;equivalence class 1 name&gt;[::0]
>+		&lt;equivalence class 2 name&gt;[::1]
>+		...
>+		&lt;equivalence class n name&gt;[::&lt;n&gt;]
>+		 
>+ </li>
>+	<li>Click Next and click Next.</li>
>+ <li>Select the parent folder and define the name of the new datapool.</li>
>+ <li>Click Finish to import test data from the Comma-Separated Value (CSV) file into the new datapool.</li>
>+ <li>The Confirm Open Editor dialog may appear (see the Window &gt; Preferences... &gt; Test &gt; Open Editor preference), confirming if the new datapool is to be opened in the Datapool editor.</li>
>+</ol>
>+
>+Import test data from a Comma-Separated Value (CSV) file into an existing datapool with the Import CSV File as Datapool wizard:
>+
>+<ol>
>+	<li>Open the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a>, right-click in the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a>, select Import.</li>
>+	<li>Select Test &gt; CSV File as Datapool, and click Next.</li>
>+ <li>Provide or select (click Browse...) the path to the Comma-Separated Value (CSV) file.</li>
>+ <li>Select the encoding of the Comma-Separated Value (CSV) file. This encoding is used to read the Comma-Separated Value (CSV) file.</li>
>+ <li>Select First row of the CSV file contains the variable names and optional suggested types if the first row of the Comma-Separated Value (CSV) file contains the variable names and optional suggested types. That is, the first row of the Comma-Separated Value (CSV) file contains: 
>+ 	 
>+ 	&lt;variable 1 name&gt;[::&lt;variable 1 type&gt;],&lt;variable 2 name&gt;[::&lt;variable 2 type&gt;]...&lt;variable n name&gt;[::&lt;variable n type&gt;]
>+ 	 
>+ </li>
>+ <li>Select First column of the CSV file contains the equivalence class names and optional record numbers if the first column of the Comma-Separated Value (CSV) file contains the equivalence class names and optional record numbers. That is, the first column of the Comma-Separated Value (CSV) file contains:
>+ 	 
>+ 	&lt;equivalence class 1 name&gt;[::0]
>+		&lt;equivalence class 2 name&gt;[::1]
>+		...
>+		&lt;equivalence class n name&gt;[::&lt;n&gt;]
>+		 
>+ </li>
>+	<li>Click Next.</li>
>+ <li>Select Append to an existing datapool to append the test data imported from a Comma-Separated Value (CSV) to an existing datapool.</li>
>+ <li>Select an existing datapool from the list of datapool. Select Show folders to show the list of datapools in the workspace project structure. If the selected datapool contains an encrypted variable, provide the password for the selected datapool.</li>
>+ <li>Click Finish to import test data from the Comma-Separated Value (CSV) file into the existing datapool.</li>
>+ <li>The Confirm Open Editor dialog may appear (see the Window &gt; Preferences... &gt; Test &gt; Open Editor preference), confirming if the existing datapool is to be opened in the Datapool editor.</li>
>+</ol>
>+
>+
>+Related concepts 
>+<a href="../concepts/cdatapooleditor.htm">Datapool Editor</a> 
>+
>+
>+
>+Related tasks 
>+<a href="../tasks/tcreatedatapool.htm">Creating a datapool</a> 
>+<a href="cdatapoolexport.htm">Exporting a Datapool as a Comma-Separated Value (CSV) file</a> 
>+
>+
>+
>+Related samples 
>+<a href="../samples/saccessdatapool.htm">Tutorial: Accessing a datapool from a TPTP JUnit test</a> 
>+
>+
>+</body>
>+
>+</html>
>Index: tasks/cdatapoolexport.htm
>===================================================================
>RCS file: tasks/cdatapoolexport.htm
>diff -N tasks/cdatapoolexport.htm
>--- /dev/null	1 Jan 1970 00:00:00 -0000
>+++ tasks/cdatapoolexport.htm	1 Jan 1970 00:00:00 -0000
>@@ -0,0 +1,79 @@
>+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN">
>+<html lang="en-us" xml:lang="en-us">
>+
>+<head>
>+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
>+<link rel="StyleSheet" href="../css/book.css" type="text/css" />
>+
>+<title>Exporting a datapool as a Comma-Separated Value (CSV) file</title>
>+</head>
>+
>+<body>
>+
>+<h1>Exporting a datapool as a Comma-Separated Value (CSV) file</h1>
>+
>+Test data in a datapool can be exported to a Comma-Separated Value (CSV) file. Test data can exported from a datapool, edited in a 
>+Comma-Separated Value (CSV) file editor (for example, Microsoft® Excel®), and re-imported into a new or existing datapool. This is the recommended
>+approach when working with large quantities of data.
>+
>+Export test data from a datapool to a Comma-Separated Value (CSV) file with the Export Datapool as CSV File wizard:
>+
>+<ol>
>+	<li>Open the <a href='javascript:executeCommand("org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.hyades.ui.perspective.TestPerspective)")'>Test Perspective</a>, right-click in the <a href='javascript:executeCommand("org.eclipse.ui.views.showView(org.eclipse.ui.views.showView.viewId=org.eclipse.hyades.test.ui.TestNavigator)")'>Test Navigator</a>, and select Export....</li>
>+	<li>Select Test &gt; Datapool as CSV File, and click Next.</li>
>+ <li>Select an existing datapool from the list of datapool. Select Show folders to show the list of datapools in the workspace project structure. If the selected datapool contains an encrypted variable, provide the password for the selected datapool.</li>
>+	<li>Click Next.</li>
>+ <li>Provide or select (click Browse...) the path to the new Comma-Separated Value (CSV) file.</li>
>+ <li>Select the encoding of the Comma-Separated Value (CSV) file. This encoding is used to write the Comma-Separated Value (CSV) file.</li>
>+ <li>Select Export the variable names and suggested types to the first row of the CSV file if the first row of the Comma-Separated Value (CSV) file will contain the variable names and suggested types. That is, the first row of the Comma-Separated Value (CSV) file will contain: 
>+ 	 
>+ 	&lt;variable 1 name&gt;[::&lt;variable 1 type&gt;],&lt;variable 2 name&gt;[::&lt;variable 2 type&gt;]...&lt;variable n name&gt;[::&lt;variable n type&gt;]
>+ 	 
>+ </li>
>+ <li>Select Export the equivalence class names and record numbers to the first column of the CSV file if the first column of the Comma-Separated Value (CSV) file will contain the equivalence class names and record numbers. That is, the first column of the Comma-Separated Value (CSV) will contain:
>+ 	 
>+ 	&lt;equivalence class 1 name&gt;[::0]
>+		&lt;equivalence class 2 name&gt;[::1]
>+		...
>+		&lt;equivalence class n name&gt;[::&lt;n&gt;]
>+		 
>+ </li>
>+ <li>Select Enclose cell values in XML tags if the cell values of the Comma-Separated Value (CSV) file will be enclosed in XML tags. That is, the cell values of the Comma-Separated Value (CSV) will contain:
>+ 	 
>+ 	&lt;Literal&gt;&lt;cell value&gt;&lt;/Literal&gt;
>+		 
>+ </li>
>+ <li>Click Finish to export test data from the datapool to the new Comma-Separated Value (CSV) file .</li>
>+</ol>
>+
>+
>+Related concepts 
>+<a href="../concepts/cdatapooleditor.htm">Datapool Editor</a> 
>+
>+
>+
>+Related tasks 
>+<a href="../tasks/tcreatedatapool.htm">Creating a datapool</a> 
>+<a href="cdatapoolimport.htm">Importing a Comma-Separated Value (CSV) file as a datapool</a> 
>+
>+
>+
>+Related samples 
>+<a href="../samples/saccessdatapool.htm">Tutorial: Accessing a datapool from a TPTP JUnit test</a> 
>+
>+
>+</body>
>+
>+</html>

Actions: View | Diff

Attachments on bug 257266: 130734