blob: db77f04c2b083bd89125c55000d17fbda3e6cb3f [file] [log] [blame]
<!DOCTYPE html>
<head>
<title>RCPTT Documentation Center</title>
<meta charset="UTF-8">
<link rel="stylesheet" href="https://www.eclipse.org/rcptt/shared/css/bootstrap.min.css">
<link rel="stylesheet" href="https://www.eclipse.org/rcptt/shared/css/main.css">
<link rel="stylesheet" href="https://www.eclipse.org/rcptt/shared/css/prism.css">
<link rel="icon" href="https://www.eclipse.org/rcptt/shared/img/favicon.ico">
<script src="https://www.eclipse.org/rcptt/shared/js/jquery.min.js"></script>
<script src="https://www.eclipse.org/rcptt/shared/js/bootstrap.min.js"></script>
<script src="https://www.eclipse.org/rcptt/shared/js/prism.js"></script>
<script src="https://www.eclipse.org/rcptt/shared/js/ecl.js"></script>
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-39589807-5', 'eclipse.org');
ga('send', 'pageview');
</script>
</head>
<body>
<div id="before-footer">
<header>
<nav class="navbar navbar-default navbar-static-top" role="navigation">
<div class="container">
<div class="navbar-header">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<span class="navbar-brand">RCPTT Documentation Center</span>
</div>
<div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
<ul class="nav navbar-nav">
<li class="active" >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/getstarted">User Guide</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/faq/">FAQ</a>
</li>
<li>
<a href="http://eclipse.org/rcptt">Back to RCPTT Main Site</a>
</li>
<li>
<a href="http://eclipse.org">Eclipse.org</a>
</li>
</ul>
</div>
</nav>
</header>
<section class="content">
<div class="container">
<div class="row">
<div class="col-sm-3">
<div class="rcptt-sidebar">
<ul class="nav">
<li ><a href="https://www.eclipse.org/rcptt/documentation/userguide/getstarted/">Get Started</a>
</li>
<li ><a href="https://www.eclipse.org/rcptt/documentation/userguide/testeditor/">Test Case Editor</a>
</li>
<li ><a href="https://www.eclipse.org/rcptt/documentation/userguide/controlpanel">Control Panel</a>
</li>
<li ><a href="https://www.eclipse.org/rcptt/documentation/userguide/assertions/">Assertions</a>
</li>
<li ><a href="https://www.eclipse.org/rcptt/documentation/userguide/ecl/">Eclipse Command Language</a>
<ul class="nav">
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/ecl/new-command-guide/">New ECL Command Guide</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/ecl/excel-import-export/">ECL commands for Excel import and export</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/ecl/xml-import-export/">ECL commands for XML import and export</a>
</li>
</ul>
</li>
<li ><a href="https://www.eclipse.org/rcptt/documentation/userguide/contexts/">Contexts</a>
<ul class="nav">
<li class="active" >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/contexts/workspace/">Workspace</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/contexts/workbench/">Workbench</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/contexts/launch/">Launch</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/contexts/preferences/">Preferences</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/contexts/parameters/">Parameters</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/contexts/group/">Group</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/contexts/folder/">Folder</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/contexts/default/">Default</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/contexts/super/">Super</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/contexts/ecl/">ECL Script</a>
</li>
</ul>
</li>
<li ><a href="https://www.eclipse.org/rcptt/documentation/userguide/verifications/">Verifications</a>
<ul class="nav">
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/verifications/text/">Text</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/verifications/treetable/">Table/Tree</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/verifications/errorlog/">Error Log</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/verifications/time/">Time</a>
</li>
</ul>
</li>
<li ><a href="https://www.eclipse.org/rcptt/documentation/userguide/procedures/">Procedures and Variables</a>
</li>
<li ><a href="https://www.eclipse.org/rcptt/documentation/userguide/runner/">Test Runner</a>
<ul class="nav">
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/runner/arguments/">Arguments</a>
</li>
</ul>
</li>
<li ><a href="https://www.eclipse.org/rcptt/documentation/userguide/maven/">Maven plugin</a>
</li>
<li ><a href="https://www.eclipse.org/rcptt/documentation/userguide/rap/">RAP</a>
<ul class="nav">
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/rap/install/">Install instructions</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/rap/recordReplay/">Record and Replay</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/rap/capability/">Capability Contexts</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/rap/rap-commands/">ECL commands</a>
</li>
<li >
<a href="https://www.eclipse.org/rcptt/documentation/userguide/rap/rap-maven/">Maven plugin</a>
</li>
</ul>
</li>
<li ><a href="https://www.eclipse.org/rcptt/documentation/userguide/integration/test-rail-integration/">Integration with TestRail</a>
</li>
</ul>
</div>
</div>
<div class="col-sm-9">
<h1>Workspace Contexts</h1>
<p></p>
<p>Workspace contexts are used to control the state of an application workspace.</p>
<p><p>Move a mouse over highlighted areas on a screenshot below to get a documentation regarding UI elements</p>
</p>
<div class="screenshot">
<img src="https://www.eclipse.org/rcptt/shared/img/screenshot-workspace-context-editor.png"></img>
<div class="ann" style="top:93px;left:118px;">
<div class="ann-border" style="width:100px;height:19px;"></div>
<div class="ann-overlay" style="left:0px;;">
Context name. This name is automatically synced with file system name. Symbols in name which are not allowed in file names are replaced with underscore character.
</div>
</div>
<div class="ann" style="top:119px;left:118px;">
<div class="ann-border" style="width:100px;height:19px;"></div>
<div class="ann-overlay" style="left:0px;;">
Comma-separated list of arbitrary hierarchical tags, i.e. <code>resourcePerspective, jira/PC-1352, windows-only</code>
</div>
</div>
<div class="ann" style="top:118px;left:584px;">
<div class="ann-border" style="width:22px;height:22px;"></div>
<div class="ann-overlay" style="left:0px;;">
Use this button to open tag selection dialog with list of tags from another test resources.
</div>
</div>
<div class="ann" style="top:92px;left:616px;">
<div class="ann-border" style="width:75px;height:22px;"></div>
<div class="ann-overlay" style="left:0px;;">
Make a snapshot of all projects inside AUT workspace and copy them into this context. Previous contents of this workspace context is overridden with new projects.
</div>
</div>
<div class="ann" style="top:118px;left:616px;">
<div class="ann-border" style="width:75px;height:22px;"></div>
<div class="ann-overlay" style="left:0px;;">
Copies given projects into AUT workspace. If <span class="uiElement">Clear workspace</span>
option is on, removes existing projects from AUT at first.
</div>
</div>
<div class="ann" style="top:152px;left:69px;">
<div class="ann-border" style="width:95px;height:20px;"></div>
<div class="ann-overlay" style="left:0px;;">
Arbitrary plain text associated with a context.
</div>
</div>
<div class="ann" style="top:154px;left:665px;">
<div class="ann-border" style="width:19px;height:19px;"></div>
<div class="ann-overlay" style="left:0px;;">
Click this button to erase current description contents
</div>
</div>
<div class="ann" style="top:200px;left:75px;">
<div class="ann-border" style="width:110px;height:21px;"></div>
<div class="ann-overlay" style="left:0px;;">
Turned on by default. Whether existing projects should be removed before applying new ones.
</div>
</div>
<div class="ann" style="top:248px;left:75px;">
<div class="ann-border" style="width:610px;height:19px;"></div>
<div class="ann-overlay" style="left:0px;;">
When <span class="uiElement">Clear workspace</span>
is on, this option allows to specify a list of projects, which should be kept intact in AUT workspace.
</div>
</div>
<div class="ann" style="top:295px;left:75px;">
<div class="ann-border" style="width:112px;height:36px;"></div>
<div class="ann-overlay" style="left:0px;;">
Projects in current context
</div>
</div>
<div class="ann" style="top:295px;left:519px;">
<div class="ann-border" style="width:166px;height:22px;"></div>
<div class="ann-overlay" style="left:0px;;">
Create new general project without any nature
</div>
</div>
<div class="ann" style="top:320px;left:519px;">
<div class="ann-border" style="width:166px;height:22px;"></div>
<div class="ann-overlay" style="left:0px;;">
Create new empty folder in currently selected project/folder
</div>
</div>
<div class="ann" style="top:345px;left:519px;">
<div class="ann-border" style="width:166px;height:47px;"></div>
<div class="ann-overlay" style="left:0px;;">
Pretty much the same as Eclipse's standard Project/Filesystem import wizards, but imported resources go directly inside Workspace context, not inside RCPTT workspace.
</div>
</div>
<div class="ann" style="top:395px;left:519px;">
<div class="ann-border" style="width:166px;height:72px;"></div>
<div class="ann-overlay" style="left:0px;;">
Instead of embedding contents inside workspace context, put links on resources from RCPTT workspace. This is particularly useful when resources for AUT need to be modified often, or used somewhere else.
</div>
</div>
<div class="ann" style="top:470px;left:519px;">
<div class="ann-border" style="width:166px;height:22px;"></div>
<div class="ann-overlay" style="left:0px;;">
Removes selected resource(s) from workspace context
</div>
</div>
<div class="ann" style="top:495px;left:519px;">
<div class="ann-border" style="width:166px;height:22px;"></div>
<div class="ann-overlay" style="left:0px;;">
Opens a file in a text editor. This may be useful for examining file contents, but at the moment file cannot be modified and saved
</div>
</div>
</div>
<h3>Introduction</h3>
<p>Workspace Contexts are responsible for preparing the initial workspace content for your test case.
The Workspace Context contains projects and files you need to place on your workspace before running your test. It also has an option to clear the workspace before applying your Context. That is, if the Clear workspace option is turned on, the Workspace context just replaces the entire workspace contents.
Otherwise it verifies that all of its items are present in the workspace and have the same properties. If not, it creates missing items or replaces modified items correspondingly.</p>
<p>The Workspace Context editor allows either to manually construct/modify the content of your Context or capture the workspace state from the AUT.</p>
<p>With the <span class="uiElement"><img src="https://www.eclipse.org/rcptt/shared/img/ui-capture.gif"></img> Capture</span> button in the upper-right corner above the Context name field you can capture the current state of the AUT workspace. With a single click all the project with all their files and subfolders will be added to your Context.</p>
<p>Otherwise, you can manually add/import Projects and Files using the corresponding buttons.</p>
</div>
</div>
</div>
</section>
<script src="https://www.eclipse.org/rcptt/shared/js/main.js"></script>
</body>