VersionOne Collector

Retrieves VersionOne feature content data from the source system APIs and places it in a MongoDB for later retrieval and use by the DevOps Dashboard. This project uses Spring Boot to package the collector as an executable JAR with dependencies.

Execute the following command to package the collector into an executable JAR file.

    mvn install

Copy this file to your server and launch it using:

  java -JAR versionone-feature-collector.jar

You will need to provide an application.properties file that contains information about how to connect to the Dashboard MongoDB database instance, as well as properties the Hudson collector requires. See the Spring Boot [documentation](http://docs.spring.io/spring-boot/docs/current-SNAPSHOT/reference/htmlsingle/#boot-features-external-config-application-property-files) for information about sourcing this properties file.

Sample application.properties file

  #Database Name
  spring.data.mongodb.database=dashboard

  #Database HostName - default is localhost
  spring.data.mongodb.host=10.0.1.1

  #Database Port - default is 27017
  spring.data.mongodb.port=9999

  #Database Username - default is blank
  spring.data.mongodb.username=db

  #Database Password - default is blank
  spring.data.mongodb.password=dbpass

  #Collector schedule (required)
  feature.cron=0 * * * * *

  #Page size for data calls (VersionOne recommended 2000)
  feature.pageSize=2000

  #In-built folder housing prepared REST queries (required)
  feature.queryFolder=v1api-queries

  #Jira API Query file names (String template requires the files to have .st extension) (required)
  feature.storyQuery=story
  feature.epicQuery=epicinfo
  feature.projectQuery=projectinfo
  feature.memberQuery=memberinfo
  feature.sprintQuery=sprintinfo
  feature.teamQuery=teaminfo
  feature.trendingQuery=trendinginfo

  # Trending Query:  Number of days in a sprint (not-required)
  feature.sprintDays=60
  # Trending Query:  Length of sprint week (not-required)
  feature.sprintEndPrior=7

  #Scheduled Job prior minutes to recover data created during execution time (usually, 2 minutes is enough)
  feature.scheduledPriorMin=2

  #Delta change date that modulates the collector item task - should be about as far back as possible, in ISO format (required)
  feature.deltaCollectorItemStartDate=2008-01-01T00:00:00.000000

  #VersionOne Connection Details
  #Proxy assumes a host:port syntax
  feature.versionOneProxyUrl=http://proxy.com:9999
  feature.versionOneBaseUri=https://www.versionone.com/our-company-instance/
  #Access token provided by VersionOne
  feature.versionOneAccessToken=YWxsIHlvdXIgYmFzZSBhcmUgYmVsb25nIHRvIHVzOiB5b3UgYXJlIG9uIHRoZSB3YXkgdG8gZGVzdHJ1Y3Rpb246IG1ha2UgeW91ciB0aW1l

  #Start dates from which to begin collector data, if no other data is present - usually, a month back is appropriate (required)
  feature.deltaStartDate=2015-03-01T00:00:00.000000
  feature.masterStartDate=2008-01-01T00:00:00.000000

VersionOne Collector

Building and Deploying