Apps on Timebox-Filtered Dashboards

Deprecation Warning! The content below is only applicable for use within deprecated 1.x versions of CA Agile Central's App SDK. Use of the components and code on this page is not supported. To develop custom apps within our current environments, please see App SDK 2.0 documentation.

It is possible to get the current dashboard page context from an app running in a custom panel:
    var panelContext = rally.sdk.util.Context.getPanelContext();
    if(panelContext.timeboxFilter && panelContext.timeboxFilter.iteration) {
        //Global iteration filter
        var iteration = panelContext.timeboxFilter.iteration;
        var iterationQuery = panelContext.timeboxFilter.query;
    } else if(panelContext.timeboxFilter && panelContext.timeboxFilter.release) {
        //Global release filter
        var release = panelContext.timeboxFilter.release;
        var releaseQuery = panelContext.timeboxFilter.query;
    } else {
        //No global timebox filter
    }
If your app declares a global function named onDashboardPageTimeboxFilterChanged it will be automatically called when the global timebox filter changes:
    function onDashboardPageTimeboxFilterChanged(args) {
        if (args.iteration) {
            //Global iteration changed
            var iteration = args.iteration;
            var iterationQuery = args.query;
        } else if(args.release) {
            //Global release changed
            var release = args.release;
            var releaseQuery = args.query;  
        }
    }

Feedback

Need more help? The CA Agile Central Community is your one-stop shop for self-service and support. To submit feedback or cases to CA Agile Central Support, find answers, and collaborate with others, please join us in the CA Agile Central Community.