Mantis – Useful Resources ”; Previous Next The following resources contain additional information on Mantis. Please use them to get more in-depth knowledge on this. Useful Links on Mantis Mantis − Mantis Official Website. Mantis Wiki − Wikipedia Reference for Mantis. To enlist your site on this page, please drop an email to [email protected] Print Page Previous Next Advertisements ”;
Mantis – Roadmap ”; Previous Next The Roadmap page has the information about the upcoming versions and the issues that are targeted to be fixed in these versions. This is very useful information to be provided to the team, the users, and other stakeholders. It also helps prioritize an issue assignment. It keeps track of the progress of issues such as how many issues are resolved/closed, how many issues still need to be addressed, etc. The Roadmap page gets automatically populated, once the issues are assigned into a “Target Version”. The following screenshot shows where the target version field is present in the Issue Details page. Once a Target Version is added into Issue, it appears in the Roadmap page. Roadmap information displays up-to-date progress of all issues. Users can see the number of issues to be addressed, how many have been resolved/closed as well as the percentage in progress. The following screenshot shows the Roadmap page with the percentage in progress and the list of issues. If the issues are not assigned to a target version, it will not appear in the Roadmap. Resolved issues appear with a strikethrough. If the “Fixed in Version” field is set, it will appear in the Change Log page as well. Print Page Previous Next Advertisements ”;
Mantis – Add Custom Fields ”; Previous Next The process of adding custom fields include first defining the custom field and then linking it to appropriate projects. Step 1 − Go to Manage → Manage Custom Field section. Step 2 − Enter the field name in the textbox. Step 3 − Click the New Custom Field button as shown in the following screenshot. Step 4 − After clicking the New Custom Field, the Edit Custom field page opens where the user has to define the custom field specification. Step 5 − Select a ‘Type’ for the field from the dropdown list (date, string, list, etc.). For custom field types, you can write Possible Values. Use the ‘|’ character to separate the different values. Custom field types that expect such lists include: enumeration, checkbox, list, multi-selection list, and radio buttons. The ”Default Value” definition allows the custom field to have a default value based on the field type. In most cases, it is a simple value such as a string, a number, or a value from the list of possible values. However, for the Date type, the possible values can include values such as: {today}, {tomorrow}, {+3 days}, {-7 days}, {next week}, {15 December 2013}, etc. Step 6 − Check the checkboxes specifying the pages on which the custom field should appear and is required. After defining the custom field, it should be linked to the appropriate projects. Step 7 − Scroll to the bottom of the ”Edit Custom Field” page to the ”Link custom field to projects” section. Select the projects from the displayed list and click ”Link Custom Field’ as shown in the following screenshot. The sequence number is used to determine the relative order of custom fields to each other. Smaller sequence numbers are shown first. Print Page Previous Next Advertisements ”;
Discuss Mantis ”; Previous Next Mantis is a Bug Reporting tool, widely used as an issue tracking tool for all types of testing. This is a brief tutorial that introduces the readers to the basic features and usage of Mantis. The various chapters of this tutorial will guide the readers on how to utilize the tool in reporting and maintain an issue. Print Page Previous Next Advertisements ”;
Mantis – Issues Relationships ”; Previous Next This feature is very useful when two issues have some type of dependency on each other, such as they are duplicates or are related to each other, upstream downstream dependency as parent/child issue. Create a Link to Another Issue Issues can be linked together at any point of time, while reporting an issue using the View Issue or Edit Issue page. Step 1 − Click the view issue page. Step 2 − Navigate to Relationships section. Step 3 − Choose the relation of the issue with the linking issue. For example: the opened issue is parent/duplicate of another issue. Step 4 − Now, type the issue id and click the Add button as shown in the following screenshot. After addition, you can see the linked issues in the Relationships section. It is hyperlinked hence, it is also possible to navigate to the linked issue. You can add a relationship for multiple issues at once using the ”|” character in between issue IDs. The following screenshot displays the linked issue. Delete a Link Step 1 − Go to View Issue Details page that contains the link to the issue. Step 2 − Scroll down and go to the Relationships section. Step 3 − Click the Delete icon as shown in the following screenshot. Step 4 − A confirmation pop-up will be displayed as shown in the following screenshot. Click the Delete button. Print Page Previous Next Advertisements ”;
Mantis – Advanced Features ”; Previous Next While reporting an issue, along with some general information, there are advanced features supported by Mantis to make it more informational and useful. In this chapter, we will discuss about those advanced features. @Mention – Notification Mantis supports @mentions to gather user attentions and send notifications about an issue or note, even if they are not on the notified list. It is a simple way to draw someone”s attention. Simply reference a college in an issue note or description, and the note details with a link to the issue details will be emailed. To mention a user in Description/Note section, first write @ and along with it write the name of user as shown in the following screenshot. @mentions is hyperlinked to the user page and highlighted when notes/issues are formatted. In this case, users receive both regular email notification as well as @mention notification. However, @mention notifications have a simplified format as well as a different subject. The following screenshot displays the received email for @mention. Send Reminder Send Reminder is the alternate functionality of @mention. This feature is used to call the attention of a particular user. For example, the Product Owner sends a reminder to the team to update comments. Mantis generally recommends to use @mention. However, it is an optional feature. Go to the View Issue and click the Issue ID to open the View page. At the top of the issue, the “Send a Reminder” button is displayed as shown in the following screenshot. After clicking the Send a reminder button, a message box appears. On the left side, there is a list of users and on the right side messages can be typed. After selecting the user and writing the message, click the Send button at the bottom of the page. The following screenshot shows how to send a reminder. In the View Issue → Activities section, the Reminder information can be seen as shown in the following screenshot. Text Formatting As of now, Mantis supports the following HTML tags that can be used to format the tag in the description and notes field − p, li, ul, ol, br, pre, I, b, u, em, strong. However, Mantis doesn’t encourage formatting the text. The text emails will have raw tags rather than formatted text. Mantis has a plan to move towards Markdown for formatting, which will deprecate HTML tags. In addition to Markdown support, Mantis is planning to support html emails. These features together will address the limitations of the existing solution. However, as of now, there is no specific timeline for Markdown or for HTML emails support. Attach Files Mantis supports attaching multiple files to an issue. A user can attach the file while reporting the issue by clicking the Choose File button. The file can also be attached from the View Issue by clicking the Upload File button. Alternative method, is to attach the file in Edit Issue mode. The following screenshot displays how to attach a file in the View Issue module. Click the above marked button and browse the file to upload. Files will be displayed below the button on successful upload. Then, click Add Notes. The file will be get added in the Activities section as shown in the following screenshot. Print Page Previous Next Advertisements ”;
Mantis – Summary ”; Previous Next The Summary page is the heart of Mantis. It displays the tabular records of issues. Mantis supports the Summary page as a reporting document in a tabular form. Summary page displays table records based on the following fields − By Status By Severity By Category Time Stats for Resolved Issues (days) Developer Status Reporter by Resolution Developer by Resolution By Date Most Active Longest Open By Resolution By Priority Reporter Status Reporter Effectiveness In each section, it displays how many issues are in Open, Resolved, and Closed status. It also displays how many total issues are reported on a particular category. The following screenshot displays the Summary page and its different categories. Print Page Previous Next Advertisements ”;
Mantis – Miscellaneous Functionalities ”; Previous Next There are other useful functionalities in the View Issue Page such as Monitor, Delete, Close or Stick an issue, which we will discuss in this chapter. Monitor Mantis has a feature called Monitor to receive notifications and observe the progress of an issue. A user who has marked the issue as Monitor will be notified whenever any changes are made on the issue by any other users. Following are the steps to monitor an issue − Step 1 − Go to View Issue → View Issue Details (by clicking any issue ID) Page to see the details. Step 2 − Click the Monitor button present at the bottom of the screen as shown in the following screenshot. Once the user starts to monitor, the button changes to End Monitoring. The same can be confirmed from Issue History as well. Step 3 − After a certain time period, when the monitoring is complete, click the End Monitoring button as shown in the above screenshot. The button will again change to Monitor. Stick Mantis supports Stick functionality, i.e. an issue can be displayed as the first entry in the View Issue page → Viewing Issue section. Step 1 − Go to View Issue → Viewing Issues section and choose any Issue that you want to display as the first entry in this table. Here, we choose Issue ID 02 as shown in the following screenshot. Step 2 − Click the Stick button at the bottom of the View Issue Details page. The button name changes to Unstick. Step 3 − Go back to View Issue → Viewing Issues section and observe the location of Issue ID in the table. It will be displayed as the first entry as shown in the following screenshot. Step 4 − To unstick it, go to View Issue Details page and click the Unstick button as shown in the following screenshot. If more than one issues are marked as Stick, it follows LIFO (Last In First Out) concept. The latest one that was marked as Stick will be displayed as the first entry and will be followed by the second latest, and so on. Close an Issue Mantis supports the functionality to close an issue from any current status of the issue. Following are the steps to close an issue. Step 1 − Go to View Issue → Viewing Issues section and choose any issue that is to be closed. Here, we choose Issue ID 02 as shown in the following screenshot. Step 2 − Click the Close button on the View Issue Details page as shown in the following screenshot. Step 3 − Select Resolution from the dropdown and Add Notes. Click the Close Issue button. The status of issue changes to Reopen button instead of Close for this issue as seen in the following screenshot. By clicking the Reopen button, you can open the issue any time again. Delete an Issue Mantis supports deletion functionality in case the user wants to delete any of the issues. The reason might be duplication, wrong entry, or no more useful. Following are the steps to delete an issue. Step 1 − Go to View Issue → Viewing Issue section and choose any issue that is to be deleted. Step 2 − Click the Delete button on the View Issue Details page as shown in the following screenshot. Step 3 − A confirmation page is displayed asking to perform the delete action on the selected issue. Click the Delete Issue button if sure as shown in the following screenshot. Print Page Previous Next Advertisements ”;
Mantis – Import Issues ”; Previous Next The user can create multiple issues at a time using CSV files. CSV files are comma separated file. Rules for CSV File While creating a CSV file, following points must be considered − CSV file should be separate for each project. CSV file should be saved as CSV (Comma Delimited). The user should switch to the project before starting the CSV import steps. All entries should be made in a Notebook application. Each entry should be separated by a comma “,”. Files should be saved as filename.csv and the file type as All files. Don’t map ID field with any field in CSV. The system will automatically generate an Issue ID. For multiple lines “n” can be used. For timestamp fields such as issue submission and last update timestamps, it is recommended using ISO 8601. However, PHP accepts any method strtotime (). If an integer is provided as the value, then it will be treated as the number of seconds, since Unix Epoch (January 1 1970 00:00:00 GMT). Sample file will look like the following − login wires General login functionality should be available Assigned to administrator 1.0 error wires General error message on wrong credential new 1.0 on successful wires General welcome page on successful login Assigned to administrator 1.0 Import CSV To import a CSV file, the user should perform the following steps − Step 1 − Go to Manage → Manage Plug-in. Step 2 − Check whether the CSV Importer plug-in is installed or not. Step 3 − If it is not installed, click Install as shown in the following screenshot. Step 4 − Since CSV Importer is not present in the Installed Plugins, go to Available Plugins section and find CSV Importer. Click Install as shown in the following screenshot. Step 5 − After installation, the user can see CSV Importer in the Installed Plug-in section. The Import CSV File section is also present. Click Import CSV File as shown in the following screenshot. Step 6 − After clicking Import CSV file, import issues from the CSV file opens. Select various options based on the file and requirements as shown in the following screenshot. Later, click Choose File to browse the file and then click Upload file. Step 7 − After successful upload, the user can see the data column wise. Below that, the user needs to map those columns with different fields of Issue form as shown in the following screenshot. Step 8 − After mapping, click the Import File button. After completion of import, the user can see counts of successful and unsuccessful entries. Automatically, the user navigates to View Issues tab at Viewing Issues section as shown in the following screenshot. Print Page Previous Next Advertisements ”;
Mantis – Move an Issue ”; Previous Next Mantis has a feature to move an issue from one project to another project. One Issue At a Time Step 1 − Go to the View Issue Details page that needs to move to another project. Step 2 − Click Move as shown in the following screenshot. Step 3 − In the Move Issue page, select the new project where the issue will move and click the Move Issues button as shown in the following screenshot. Multiple Issues at a Time Step 1 − Go to the View Issue page. Step 2 − Set the filter and navigate to the Viewing Issues section where you will find a list of issues. Step 3 − Check the checkboxes for all issues that are required to be moved. Step 4 − Select the Move option from the dropdown present at the bottom of the screen and then click OK. The following screenshots display how to move multiple issues at a time. Step 5 − In the Move Issues to page, select the new project, where the issue will move and click the Move Issue button as shown in the following screenshot. Print Page Previous Next Advertisements ”;