This page contains:
This guide describes the Methodologies features that are available in Dradis v2.6.0 or later. If you need to upgrade, please follow the instructions on the Upgrade Dradis Pro page of the Deployment guide.
Methodologies are lists of tasks you want to perform for a given project type.
Using methodologies serves a double purpose:
Methodology templates are simple XML-based documents, with different
<?xml version="1.0"?> <board version="2"> <name>New Methodology</name> <list> <name>List 1</name> <card> <name>Task #1.1</name> <description> <![CDATA[ #[Details]# #[Results]# ]]> </description> </card> <card> <name>Task #1.2</name> <description> <![CDATA[ #[Details]# #[Results]# ]]> </description> </card> </list> <list> <name>List 2</name> <card> <name>Task #2.1</name> <description> <![CDATA[ #[Details]# #[Results]# ]]> </description> </card> </list> </board>
The methodology editor has a built-in preview feature that lets you see how the final tasks and sections will look as you tweak the XML on the left-hand side:
If you want to avoid dealing with the XML directly, you can build your Methodology templates within Dradis with a little help from Project Templates
Open your project and navigate to Methodologies in the sidebar. Then, create a new Methodology.
Customize it! Add lists, tasks, and descriptions until the Methodology is exactly what you want to use as a template.
Navigate to Export results in the project header.
In the Save and restore project information tab, select Template as your export option, then click Export.
Open the exported Project Template file (
dradis-template.xml) in your favorite text editor. Then, select and copy the portion at the end of the file from
Back in Dradis, navigate to Templates > Methodologies in the header and click + New Methodology template.
Replace the entire contents of the Methodology editor by pasting in the board data that you copied in Step #6.
Click Create methodology to save your new Methodology template.
Troubleshooting: If you see the following error message, you likely are trying to create a new Methodology template that contains more than one board (
Error while saving template:
* Extra content at the end of the document
To resolve this, only include on board in your Methodology template. You can only save Methodology templates one at a time, but you can always add more than one board to your projects.
If you have downloaded one of the methodologies available in the Extras section of the Users Portal, just follow the steps outlined in the previous section and replace the contents of the methodology editor with the contents of the XML file you downloaded. Some of the methodologies you can download and use:
The new style of Methodologies has boards, lists, and tasks. We also support the old XML format that looks like:
<?xml version="1.0"?> <methodology> <name>New checklist</name> <sections> <section> <name>Section #1</name> <tasks> <task>Task #1.1</task> </tasks> </section> </sections> </methodology>
If you add a section/task-style methodology template to a project or open up an existing project that contains a section/task-style XML-based methodology, it will be automatically converted for you into the new board, list, and task style.
A Pending list and a Done list will be automatically created for you.
The Section Name (e.g. "Section #1") from the XML will be prepended to the Name of each Task using the following format: [Section Name] Task Name.
The example XML-based Methodology shown above is converted into the following Task and Lists:
Each task will contain the following fields, populated with the data from the original V1 methodology:
If you want to delete an existing methodology template:
In the interest of keeping information organized, I'm going to have to ask you to open the Using methodologies page of the Working with projects manual that explains how to include (and customize) any of the available methodology templates in your projects.
We want to ensure that the latest and most up-to-date information about each topic is in a single page.
Next help article: System settings →