Versions Compared

Old Version 5

changes.mady.by.user Former user

Saved on

compared with

New Version 6

changes.mady.by.user Kevin Pham

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Template Overview

Templates enables you to capture issues even faster during testing, by automatically populating fields in issues with your predefined values. Templates are remembered stored on your JIRA server, so your the saved templates remain the same regardless of which browser you are testing in. Templates are also shared, so you can create one template that your whole team can use.

Creating and

...

Using Templates

To create a new template, go to the "View all Templates and Variables" tab window in the Capture for JIRA browser extension by clicking the following button, then click "Add Template" under the "Mine" section.

  • Here, you can pre-fill an issue creation form with any information you would like. (e.g. a particular project, version, or component you are working).
  • Selecting the option "Attach Screenshot by Default" will include a screenshot attachment automatically when you are applying a template.
  • You can have as many templates as you like, so you can have very specific templates for issues that you may wish to raise during testing.

...

Image Added

Image Added

Note

For IE users, the user interface for viewing and editing templates may vary from other browsers. The 2 images below for viewing and editing templates are displayed for the IE browser extension.

Image Added Image Added

Templates are used when creating an issue. To do this, simply choose one from the "Use Field Template" menu on the Create Issue tab in the Capture for JIRA browser extension. The "Use Field Template" menu will only show templates that you have marked as "Favorite" with a star ((star)). By default, all templates you create are marked favorite for you.

Using a template will keep it selected until you choose otherwise – even across multiple uses of the browser extension.

Image RemovedImage Added

A template can also be assigned as the default template for a shared test session, allowing all participants of the test session to create consistent issues. For more information on creating test sessions, please read Working with Sessions.


Using

...

Variables in

...

Templates

Variables allow templates to contain dynamic information, and are only evaluated into actual values when the template is used during issue creation. Variables previously creating a new issue in the extension. Previously, variables only worked when used in a template, but as of JIRA Capture 2.2 ( now Capture for JIRA), they can be used at any time during the issue creation process.

To use a variable, enter the variable name surrounded by braces ("{" and "}") into a text field on the template or issue creation forms.

By default, Capture for JIRA ships with four variables:

  • {cookies} - Are cookies turned on? Value is either true or false.
  • {useragent} - Browser information
  • {title} - Current page title
  • {url} - Current page URL

Creating

...

Variables for Templates

The default variables shipped with Capture for JIRA are only a start – you can also create your own variables to do different things. To create another variable, simply click the "Add Variable" tab in the Templates tab of the browser extensionwindow. For each variable, you need to provide 2 pieces of information:

  • the name Name - this This is the variable name. You use the variable in templates by enclosing the variable name in '{' and '}'
  • the javascript selector - this Selector (Javascript Selector) - This is the javascript that will evaluate when you run the variable. This happens when you select a template to use in the create issue tab.

Image Added

Some other examples:

Name

Javascript Selector

Explanation


Code Block
jiraVersion



Code Block
document.getElementById('footer-build-information').innerHTML


This is one specific to JIRA itself. In our JIRA footer, we always include the JIRA version and build numbers. This javascript selector will get this information for us


Code Block
date



Code Block
new Date().toDateString()


Today's date.


Code Block
selectedText


Chrome & Safari

Code Block
window.getSelection().toString();

Firefox

Code Block
document.getSelection().toString();

IE

Code Block
document.selection.createRange().text;


Will insert any text that's already selected.

Note that the javascript for this differs across browsers, so you will need to create separate variables for each browser you wish to use this in.

Sharing

...

and

...

Favoriting Templates

Once you have templates working the way you want, you can also opt to share it with your team by marking the "Share this template" checkbox.

Image Removed

Your teammates 'Share' checkbox and adding the template to favorites allows you to use the template as it appears in the "Use Field Template" menu.

Image Added

Your team members will now be able to see this template in their list of available templates to use and can use .Image Removedthe template however they see fit.

If they " favorite " the template, it will be made available for use in their issue creation when creating a new issue under the "Use Field Template" menu. Note - using

Note

Using a shared template will also include any variables which are included in the template.

Control

...

Field Visibility with Templates

The checkboxes on the template form control the visibility of the field when the template is used. This means that you can choose to view only the fields that matter to you when using the template. These hidden fields will also apply for anyone using your shared template. Mandatory fields that are required for issue creation will always be visible, to minimize the chance of issue creation errors.

Image RemovedImage Removed

...

  • View the example below. Note how we unchecked the 'Priority' field and now the priority field is not visible when using the Template.

Image AddedImage Added