targetprocess/mashupslibrary

Mashups you can use with Targetprocess

TargetProcess Mashups Library

Mashups are supported from TargetProcess v.2.22 or higher.

Mashups allow you to quickly extend TargetProcess UI with almost any functionality you want. There are several places on each page where you can add some new UI, or you can modify the existing UI.

This repository contains some example Mashups both for immediate use and as starting points for developing your own Mashups.

Current Mashups

UserStory Templates

Provides a means to pre-populate the description field when adding new UserStories with template data.

Numeric Rank Display

Replaces the progress-bar style display of Ranks with a numeric text representation of a User Story/Bug/Feature's rank.

Kanban Board Impending Doom

Colors cards on the Kanban board according to the value of a Date pulled from a Custom Field. To use, add a Custom Field called 'Due Date' of type 'Date' to your Process. The Mashup colors cards Green, Yellow, and Red depending on the amount of time remaining for the card.

Classes of Service

Clors cards on the Kanban board according to tags. For example, stories or bugs tagged urgent can be colored red and all stories and bugs tagged sup are colored yellow. Colors and tags are customizable in the .js file.

[Board Class Of Services](https://github.com/TargetProcess/MashupsLibrary/tree/master/Board Class Of Services)

The same as Class Of Services but for TP3 board.

Highlighter

Mashup that highlights chunks of text in the page according to the search input.

TopMenu

A simple Mashup that shows how to add tabs to the end of your navigation bar linking to custom URLs. Fully customizable via the .cfg file.

NumberOfAssignments

The Kanban Board Number of Assignments mashup add list of users in a project along with numbers of bugs and user stories assigned to the user.

Entity Templates

An expanded version of the UserStory Templates mashup, this mashup pulls the contents of a template file and gives that as a starting point for the description of the following entities in TargetProcess:

• User Stories
• Bugs
• Features
• Tasks
• Requests
• Test Cases

OnDemand Entity Templates

The OnDemand Entity Templates Mashup is an adaptation of the Entity Templates Mashup (above) designed for the OnDemand version of TargetProcess.

DoneEntitiesByMonthReport

The Done Entities By Month Report mashup adds a report to TargetProcess that provides a visual way to see how many stories, bugs, issues, and features were completed or closed over the past year grouped by months.

DetailsHider

The Details Hider Mashup is a very, very, very simple that removes the system messages at the bottom of each page (such as page generation time, the Whats New link, and the free version notification).

Kanban Board Column Grouper

The Kanban Board column grouper Mashup allows you to group together swimlanes on your Kanban board and have grouped WIP limits for your swimlanes in aggregate.

Kanban Board Tag and Custom Field Card Colorer

The Kanban Board Tag and Custom Field Card Colorer mashup colors the cards on your Kanban Board according to both tags and custom fields. This mashup will determine a base color for your cards based on the first match of either tags and custom fields that it finds. The cards are ultimately colored a particular shade of this base color, depending on the entity's business value or priority. There are also some fail-safe mechanisms that will ensure that you are never given black text over a dark-colored card.

Kanban Board Comment Counts

The Kanban Board comment count Mashup adds an icon with the current comment count to each of your cards in similar fashion as to the task and bug count icons.

Extra Time Sheet Info

The Extra Time Sheet Info Mashup is a simple Mashup for TargetProcess that adds more information to the listings in your time sheet. Currently, the Mashup only adds the entity ID to the row, but can be easily expanded to display more information, such as custom fields.

Kanban Custom Priority Colorer

The Kanban Board Custom Priority Colorer mashup is a simple Mashup for TargetProcess that allows you to customize the priority colors of cards.

Tag Linker

The Tag Linker Mashup allows you to link to other entities in TargetProcess through the use of tags. Simply put #(entity ID) as a tag name (for example: requires#208) and clicking on the tag will take you to that entity.

Auto Reply Customer Requests

The Auto Reply Customer Requests mashup is a simple mashup that automatically checks the "Requesters" checkbox for the notification settings on requests.

Kanban Card Rotter

The Kanban Card Rotter mashup is an advanced mashup that "rots" cards on your Kanban board according to how long they have been in progress.
The more a card has exceeded your threshold, the more brown the cards will look. If they have fully exceeded a maximum threshold, the mashup will have them pulsate red. The mashup allows you to visualize which cards have been in progress for long periods of time.

Kanban Board Auto Assignment

The Kanban Board Auto Assignment mashup is a simple mashup that will automatically assign entities on the Kanban board as their states are changed. The cards will be automatically assigned to the currently logged in user if there is no assignment for the upcoming state.

Assigned Effort Report

The Assigned Effort Report is a simple report that shows the total amount of open effort assigned to users across all projects and all roles. You can then expand each user to see a list of the assignments and their associated effort values and roles.

Easy Tag Search

The Easy Tag Search Mashup is a super simple mashup that allows you to quickly search for entities with a particular tag by clicking on the tag.

Task Board Card Colorer

The Task Board Card Colorer mashup is a simple mashup for your task board that colors task cards based on either tags or values of your custom fields. It is the Task Board equivalent of the KanbanTagCustomFieldColorer mashup

Assign People Point/Hour Availability

The Assign People Point Availability mashup is an advanced Mashup that adds hourly availability information to your assign people screen if you're using points. This information is otherwise unavailable if you're estimating stories in points.

mashupslibrary's Issues

Include screenshots / use cases for all Mashups

I'm trying to evaluate the mashups but don't understand what some of them are for. A screenshot would really help - please consider adding screenshots for all mashups. For example the Extra Time Sheet Info says that I can add more information to my time sheet - but doesn't show me what that means, so I would like to see a screenshot showing what is added. Whether that's before and after screenshots or a single image with the change highlighted...

OnDemand Entity Templates template overwrites contents in old edit view

Taken from HD request #47323

The Good:
· Everything works fine when I edit the User story Template in the “New Look”
· When I got to “Actions => Old Edit”, I’m actually able to Edit the User story in the Old Look and the Template STILL contains all the Template information I’ve added and other details, conversations, cards, confirmations added over time…

The Bad:
· If someone Switches to “The Old Look”, then goes to Edit the User Story, the Auto-Template generator automatically overwrites ALL CONTENT in the User story, which would make me lose all the Data added over time….

Availability Mashup ignores sprint length

The mashup currently doesn't take into account sprint length. Availability is based on weekly hours and it only counts one week. Sprint lengths should be taken into account.

I was just playing with the "Roles and Availability" section of the 
Team Settings and the "Assign People" page that uses the mashup. 
It seems, that the availability that I see there is the availability per 
week. However, as the sprint length is 2 weeks, I think that the 
number should be doubled.

User Story Merge Mashup Documentation

It would be nice if more info was provided on how to merge stories J

https://github.com/TargetProcess/MashupsLibrary/tree/master/User%20Story%20Merge

Number of assignments isn't showing

I have downloaded the zip and added the contents to JavaScript/Mashups/NumberOfAssignments but when I visit the Kanban page I do not see the list of users and bugs / user stories as per the screenshot.
Firefox and Chrome do not have any JavaScript bugs...
How do I enable this mashup?

"Easy Tag Search" mashup does not work in build 2.23.13

tried in several systems/browsers.
The tag is not clickable.
Also, reported by customer in request 56296

"Auto Reply Customer Requests" mashup does not work with TP 3.2.0.6131

I downloaded the zip archive, which contains a js different from the one shown in the installer page, but it does not work at all.

Regards

Descriptions / .mkds missing

There is no information to allow me to understand what the following mashups do:
TopMenu, Website, WorkflowEditor

Rewrite DOMSubtreeModified hacks

When new looks have proper events to bind to, rewrite all the $('#main').bind('DOMSubtreeModified', something); hacks accordingly.

Assigned Effort Report mashup is not working for 2.23.11

Looks like Assigned Effort Report mashup is not working for 2.23.11
This was reported by On-Demand customer ( request 54108) and it did not seem to work for me

Kanban Column Hider header matching

The matching in the Kanban Column Hider Mashup does not function when two columns contain the text in the statesToHide variable. This matching uses span:contains, so given this scenario:

Bugs:
Open -> In Progress -> Testing -> Done
Stories:
Open -> In Progress -> In Testing -> Done

A statesToHide = ["Testing"] will match both the Testing and In Testing states. The mashup will remove both headers, but the logic does not exist to remove both of the matching columns. As a result, the first column matched is removed, but subsequent columns will stay regardless of their headers no longer being shown.

Possible solutions are either changing the span:contains to something more exclusive, or changing the hide logic to loop through each header returned.

Entity Templates and Quick-Add

From a request:

TP Support friends –

Would it be possible to make our UserStoryTemplate MAshup apply to new User Stories created via the Quick-Add Capability below???

If so – is there a specific HANDLE in the Java Script that we need to incorporate into our Mashup? We will likely do the update to the Mashup ourselves, but if you have any pointers, that would be valuable.

Numeric Rank Display lacks On-Demand instructions

KanbanBoard Impending Doom does not work with auto refresh

I have installed the KanbanBoardImpendingDoom mashup for the Kanban Board, but when it is auto refreshing, the script isn't executed again. Is it possible to trigger it after the refresh has been finished?

Kanban Board Impending Doom Error: date.match(/((\d+)-/) is null

This follows on from a previous issue(#9) but remains unresolved.
Not all my tasks, User Stories or bugs have a Date Due assigned, but I have added a custom field to all these entities as per the instructions. I updated the version of the mashup to the latest but still when I go to the Kanban Board I get the following errors in my console and the mashup does not work.

Timestamp: 30/03/2012 14:08:33
Error: date.match(/((\d+)-/) is null
Source File: http://myserver/TargetProcess2/JavaScript/Mashups/Kanban%20Board%20Impending%20Doom/KanbanBoardImpendingDoom.js
Line: 59

which Firefox points to
date = new Date(Number(date.match(/((\d+)-/)[1]));

and in Chrome I get:
Uncaught TypeError: Cannot read property '1' of null
$.ajax.successKanbanBoardImpendingDoom.js:59
jQuery.Callbacks.mjQuery.js:48
jQuery.Callbacks.n.fireWithjQuery.js:48
vjQuery.js:48
jQuery.support.ajax.jQuery.ajaxTransport.send.djQuery.js:48
FBL.ns.handleStateChangefirebug-lite.js:18917

System Settings > Processes > All Practices > Custom Fields:
Label: "Due Date"
Entity Type: Feature
[User Story], [Task], [Bug]
Field Type: Date
Show in lists/Enabled for filter [Checked]

Server locale is UK (en-gb)

UserStory Merge Mashup bug: Cancel button does not work

Hi Jonathan,

Below's a bug report from our customer:
Kevin MacHarg
[email protected]

If you click on Merge for selected items, then click Cancel, it still pops up the Hardcore Merging loading screen thing.

I select 3 Users stories and then clicked Merge. This brings up the "Ready to merge. Which story should be the main/master story?" window. Clicking Cancel here brought up the Working screen, even though I don't think it was doing anything, and it never seemed to finish (I had to reload the page).

Is this a known issue?

Kanban Board Tag and Custom Field Card Colorer

When I just copy the code from github and fill in the custom fields I want to use, my cards on the kanban board go completely black.

To test I changed the following in the function "ColorTheCard". Like this it works partially (but it is not as nice as the intended functionality so I would like to get the original code to work on my machine).

I don't know javascript so this was already pretty though to figure out. Any idea what is wrong with the original piece of code (do I need to install stuff like a certain version of JQuery, ..?)

  /*COMMENTED OUT SINCE THIS DOES NOT WORK ON MY MACHINE*/
  /* and some pretty animations */
    /*i.animate({'background-color':newColor},1000);
    i.find('div.name:first').animate({'color':safeColor(newColor)},1000);
    i.find('a.kanban-item-id:first').animate({'color':safeColor(newColor,60,['#94a1c5','#28428B'])},1000);*/

  /*ADDED THIS SIMPLIFIED VERSION INSTEAD*/
    /*background*/
    i.css('background-color', c);
    /*us name*/
    i.find('div.name:first').css('color', 'white');
    /*link*/
    i.find('a.kanban-item-id:first').css('color', 'white');

Assigned Effort Report and inactive users

The assigned effort report lists inactive users - it shouldn't.

It also lists First Name, Last Name - should list Last Name, First Name

NumberOfAssignments does not appear to work with Target Process 2.23

I have tried installed it via the Mashups Manager, and by directly copying the files into the JavaScript/Mashups folder. There are no errors in the log.

Sprint Finishing Reminder mashup fails on clicking 'Finish' link

Sprint Finishing Reminder mashup fails on clicking 'Finish' link:

System.NullReferenceException: Object reference not set to an instance of an object.
at Project_Planning_Iteration_Finish.OnInit(EventArgs e) in c:.jenkins\workspace\BuildPackage\Code\Main\Tp.Web\Project\Planning\Iteration\Finish.aspx.cs:line 23
at System.Web.UI.Control.InitRecursive(Control namingContainer)
at System.Web.UI.Page.ProcessRequestMain(Boolean includeStagesBeforeAsyncPoint, Boolean includeStagesAfterAsyncPoint)

Tag Linker not working

Downloaded the Tag Linker.js from
https://github.com/TargetProcess/MashupsLibrary/tree/master/Tag%20Linker

Tried at the latest TPv2.23.13 and also on TPv2.23.6 - the mashup does not work.
Please, fix

Card Rotter broken with Kanban Board's Auto-Refresh

Reported from customer:

If we leave the kanban board to refresh using your own refresh feature, the mashup fails to load. If we manually press F5, teh mashup works again on all projects.

Tag colorer doesn't work unless tag is first tag

The mashup should not rely on the div.tags but should instead pull from the REST API and check all available tags.

Kanban Board Impending Doom JavaScript errors

I am trying to get the Impending Doom mashup to work. I downloaded the latest version and extracted it to my Mashups folder but it throws errors which are below. I have quite a few other mashups installed all from the MashupsLibrary and most of them are working fine (the exception is the NumberOfAssignments - for which I have another issue open).

I added a custom field "Due Date" and set it as per the instructions, then set a due date for 2 entities: 1 User Story and 1 Task, but not all stories and tasks... would every entity now require the field to be populated?

For reference I am on: Build 2.23.1.21592 / 05-Mar-2012

Uncaught TypeError: Cannot call method 'match' of null KanbanBoardImpendingDoom.js:64
Uncaught TypeError: Cannot read property '1' of null KanbanBoardImpendingDoom.js:64