VersionOne Requestor

Table of Contents

Description

The VersionOne Requestor allows stakeholders across your organization to submit requests to your VersionOne projects. This standalone web application is a simple way for any user to submit a request for a new feature or report a defect without having access to the full VersionOne application or knowledge of your VersionOne project structure.

Provide links to the users you wish to be able to submit requests. Since the project name is specified in the url, you can send different links to different users, depending on which projects they need to submit requests for.

Configure the requestor web application with the url of your VersionOne instance and the username and password of a single VersionOne user account. To submit a request for a particular project, specify the project name as a parameter in the url for the requestor application, e.g.: http://server/requestor/?project=System/Company/Call%20Center

Note that the user account you configure the application to use must have access to the projects you provide links for. If, using the above example, you configure the application with a username and password that only has access to the Company project and below, you would omit the System project from the url: http://server/requestor/?project=Company/Call%20Center

System Requirements

V1: Agile Enterprise 6.4 or above (V1: Agile Team does not have the Request asset)

Integration Server:

Operating System—Windows 2000, 2003
Framework—Microsoft .Net 2.0
Web Server—IIS 5 or IIS 6, with ASP.Net 2.0

Downloads

The latest version of Requestor is available at V1: Integration Dowloads.

Installation

Configuration varies slightly depending on whether you are using VersionOne native authentication or Windows Integrated authentication. Tip: all hosted VersionOne instances use VersionOne native authentication. Local installations can be either.

1. Determine Install Location

The requestor application can be installed on any web server that has internet access to your VersionOne instance. Exact placement should be determined by your internal software management requirements. The integation server must meet the System Requirements stated above.

2. Install

Download the requestor application binary zip using the link above.
Extract the contents to a location on your web server.
Create a virtual directory in IIS that points to the folder you extracted the files to.
Ensure that the virtual directory is using ASP.Net 2.0.
Ensure that the default document is default.aspx.

3. Configure

Open the file Web.config in a text editor, change the configuration parameters listed below, and save your changes.

Table 1. Requestor Configuration Parameters

Parameter	Description
authenticationType	VersionOne security setting. Valid values are "V1" and "WindowsIntegrated".
v1Url	VersionOne installation URL.
username	User that will access VersionOne. If authenticationType is "WindowsIntegrated", you must specify the windows domain account in the form "User@FullyQualifiedDomainName". If you are unsure what the fully qualified domain name is, see the Domain name shown on the 'Computer Name' tab in the My Computer...Properties dialog.
password	Password for the username above.

Optional Configuration

The requestor application UI allows the user to enter 3 fields for each new request – Requested By, Title and Description. Any other fields that you wish to be populated with default values can be configured in Web.config. Add key value pairs to the <appSettings> section for each field you wish to configure, with the key name prefixed with “Request_”. For instance:

<add key="Request_Reference" value="Request Submission Tool"  />

You can view the list of available Request fields using your V1 instance, e.g.: http://server/v1instance/meta.v1/Request?xsl=api.xsl

For fields that are relations to another type, you need to enter the ID associated with the value you want. For example, looking at the meta description, Request.Source is related to StorySource. You need to look up the id attributes on the available story sources using your V1 instance, e.g.: http://server/v1Instance/rest-1.v1/Data/StorySource?sel=Name

Your resulting configuration would then look similar to this:

<add key="Request_Source" value="StorySource:150"  />

4. Test the Application

Access your requestor application through a web browser at the location you set up during installation, specifying the name of a known V1 project as a url paramter, e.g. http://server/requestor/?project=Company/Call%20Center
Enter, at a minimum, Requested By and Title and click OK. You should receive a confirmation message.
Open VersionOne and confirm that the request was entered into your project (go to Planning -> Workitem Planning -> Requests, make sure the correct project is selected in the project tree).