Exercise 8: Re-Open your Story

Overview

Prerequisites

• Access to a VersionOne 7.0 instance or newer. We are using https://www16.v1host.com/api-examples from our previous exercises.

• We assume that you understand all material found in the following previous exercises:

  • VersionOne REST API Tutorial 

  •  Exercise 1: Basic Use of the API Console

  • Exercise 2: Find a Scope (Project)  OID Token in the U

  • Exercise 3: Query a Scope (Project) for Specific Attribute

  • Exercise 4: Create your own Story (Backlog Item) within a Scope

  • Exercise 5: Query your Story 

  • Exercise 6: Update your Story 

  • Exercise 7: Close your Story 

• Knowledge of the VersionOne API Console

• Basic Knowledge of XML

What you'll learn

This exercise walks you through the process of closing of a Story using the Rest API.

Step 1: Recall the OID of the newly created story.

Recall the saved OID Story:1045 returned in the response from the output in Exercise 4: Create your own Story (Backlog Item) within a Scope and Exercise 5: Query your Story.

Step 2: Change URL and execute POST.

1. Change your url to this: rest-1.v1/Data/Story/1045?op=Reactivate.

2. Click Send.

Step 3: Examine response. 

Here are some points of evidence indicating the reactivation of the story.

• Response Body
  This XML below is returned after a successful closure. It returns the Story with a brand new Moment appended marking its change of state.

• Query for the Story
  Run this query rest-1.v1/Data/Story/1045?sel=AssetState. The output indicates that the AssetState attribute of this Story is equal to 64, which means that it is open. If it were equal to 128, that would mean that the Story is closed.
   
• Check in the VersionOne Backlog
  Go to your backlog, and you will see My New Story (Story:1045) in the backlog. 

Review

• Re-opened a Story using an OID.