Parameters Configuration

Parameters Configuration

To assign the settings using the configuration file, just edit the Web.config.

Add this line in the configSections section:

<configSections>
    [...]
    <section name="BugGuardianConfiguration" type="DBTek.BugGuardian.WebForms.Config.BugGuardianConfiguration, DBTek.BugGuardian.WebForms" restartOnExternalChanges="false" requirePermission="false" />
    [...]
</configSections>

Then, add this block anywhere in the config file:

<BugGuardianConfiguration>
    <BugGuardianSettings>
        <add key="Url" value="https://dev.azure.com" />
        <add key="Username" value="USERNAME_OR_PAT" />
        <add key="Password" value="PASSWORD_OR_PAT" />
        <!-- Organization or Team collection name -->
        <add key="CollectionName" value="COLLECTION_OR_ORGANIZATION_NAME" />
        <add key="ProjectName" value="PROJECT_NAME" />
        <!-- Optional -->
        <add key="AvoidMultipleReport" value="true" />
        <add key="AssignToCurrentIteration" value="true" />
    </BugGuardianSettings>
</BugGuardianConfiguration>

Parameters

These are the parameters format and meaning.

Url: url for the Azure DevOps service (https://dev.azure.com) or for your on-premises Azure DevOps Server or Team Foundation Server host (http(s)://yourhostname:port/tfs, default port is 8080)

Username:

• for Azure DevOps, you need to:
  • enable the Alternate Credentials and put here the username, or
  • create a Personal Access token and use its value here
• for Azure DevOps Server and TFS just use a "normal" username.

In both cases, the user must have the permission to create work items on the project you want to interact with

Password:

• the password for the user you want to use, or
• the value of the Personal Access Token

CollectionName:

• for Azure DevOps: the name of the organization (i.e. the XXX part of https://dev.azure.com/XXX)
• for Azure DevOps Server and TFS: the name of the Team Project Collection which contains the Team Project you want to have the bugs created in. Default value is "DefaultCollection"

ProjectName: the name of the Team Project in which you want to create the bugs/tasks

AvoidMultipleReport: optional. When set to true, if the same exception is thrown multiple times it will be reported only once to AzDO/TFS and a counter will be increased (in the Bug title and in its history). When set to false, if the same exception is thrown more than once it will be reported every time as a new bug. Default value is true.

AssignToCurrentIteration: optional. When set to true, the task/bug created will be automatically assigned at the current iteration/sprint.