Skip to content

sara-sabr/rp-azuredevops-reports

Repository files navigation

Azure DevOps Extension - Boards - IT Research and Prototyping Reports

Development Production

This Azure Boards extension provides canned reporting capability for an Azure Project.

End User Project Configuration Requirements

Create Required Shared Searches

  1. Create Shared Search Automation\Status Report\Latest Status Report

    • Search Query Search Query Settings for Latest Status Report
    • Click on Column Options and for Columns, choose the following:
      • ID
      • Work Item Type
      • Title
      • State
      • Assigned To
      • Start Date
      • Due Date
      • Finish Date
      • Description
      • Action
      • Risk
      • Priority
      • Parent
      • Area Path
    • Click on Column Options and for Sorting, choose the following:
      • ID
  2. Create Shared Search Automation\Status Report\Impediments

    • Search Query Search Query Settings for Impediments
    • Click on Column Options and for Columns, choose the following:
      • ID
      • Work Item Type
      • Title
      • Assigned To
      • State
      • Parent
    • Click on Column Options and for Sorting, choose the following:
      • ID

Developer Prerequisites

Download and install the following tools

  1. Visual Studio Code
  2. Firefox (because the VS Code Debugger for Chrome extension doesn't support iframes yet)
  3. Node LTS (make sure its Node LTS - tested with Node 16)
  4. The Debugger for Firefox VS Code extension
  5. The tfx-cli npm package
  6. The webpack npm package
  7. The webpack-dev-server npm package

If you would prefer not to install the npm packages globally, you can add them to devDependencies in your package.json file and invoke them with scripts. You can use the package.json in this repo as a template for scripts and to ensure you have the correct versions of packages in your extension.

Instructions

Setup dependencies

npm install

Preparing to publish (Local and PROD)

  1. Follow instructions
    • Acquire a Personal Access Token (PAT)

Developing Locally

Once your ready to test, perform the following:

  1. Publish the package to the marketplace. You will be prompted for your PAT. npm run publish:dev.
  2. Bring up the local environment. npm run start:dev
  3. Open Firefox
  4. Ensure you have installed your extension for your organization.
  5. Browse to the project/organzation.

Publishing Production

  1. Publish the package to the marketplace. You will be prompted for your PAT. npm run publish.

Acknowledgements

This extension is based upon Azure DevOps Extension Hot Reload and Debug and Azure DevOps Web Sample Extension .