vcoworkflows 0.1.1

data/lib/vcoworkflows/workflowpresentation.rb

@@ -0,0 +1,59 @@
+require_relative 'constants'
+require_relative 'workflowservice'
+require_relative 'workflow'
+require_relative 'workflowtoken'
+require_relative 'workflowparameter'
+require 'json'
+
+# VcoWorkflows
+module VcoWorkflows
+  # rubocop:disable ClassLength
+
+  # WorkflowPresentation is a helper class for Workflow and is primarily used
+  # internally to apply additional constraints to WorkflowParameters. Currently
+  # WorkflowPresentation examines the presentation JSON from vCO to determine
+  # whether input parameters for the workflow are required or not.
+  class WorkflowPresentation
+    attr_reader :presentation_data
+    attr_reader :required
+
+    # rubocop:disable LineLength, MethodLength
+
+    # Create a new WorkflowPresentation
+    # @param [VcoWorkflows::WorkflowService] workflow_service workflow service to use
+    # @param [String] workflow_id workflow GUID
+    # @return [VcoWorkflows::WorkflowPresentation]
+    def initialize(workflow_service, workflow_id)
+      @required = []
+      @presentation_data = JSON.parse(workflow_service.get_presentation(workflow_id))
+
+      # Determine if there are any required input parameters
+      # We're parsing this because we specifically want to know if any of
+      # the input parameters are marked as required. This is very specifically
+      # in the array of hashes in:
+      # presentation_data[:steps][0][:step][:elements][0][:fields]
+      fields = @presentation_data['steps'][0]['step']['elements'][0]['fields']
+      fields.each do |attribute|
+        next unless attribute.key?('constraints')
+        attribute['constraints'].each do |const|
+          if const.key?('@type') && const['@type'].eql?('mandatory')
+            @required << attribute['id']
+          end
+        end
+      end
+    end
+
+    # String representation of the presentation
+    # @return [String]
+    def to_s
+      @presentation_data.to_s
+    end
+
+    # JSON document
+    # @return [String] JSON Document
+    def to_json
+      JSON.pretty_generate(@presentation_data)
+    end
+  end
+  # rubocop:enable ClassLength
+end

data/lib/vcoworkflows/workflowservice.rb

@@ -0,0 +1,110 @@
+require_relative 'constants'
+require_relative 'vcosession'
+require_relative 'workflow'
+require_relative 'workflowexecutionlog'
+require 'json'
+require 'erb'
+
+include ERB::Util
+
+module VcoWorkflows
+  # WorkflowService is the object which acts as the interface to the vCO
+  # API, and is loosely modeled from the vCO API documentation.
+  class WorkflowService
+    # Return the VcoSession
+    attr_reader :session
+
+    # rubocop:disable LineLength
+
+    # Create a new WorkflowService
+    # @param [VcoWorkflows::VcoSession] session Session object for the API endpoint
+    # @return [VcoWorkflows::WorkflowService]
+    def initialize(session)
+      @session = session
+    end
+    # rubocop:enable LineLength
+
+    # Get a workflow by GUID
+    # @param [String] id Workflow GUID
+    # @return [VcoWorkflows::Workflow] the requested workflow
+    def get_workflow_for_id(id)
+      @session.get("/workflows/#{id}").body
+    end
+
+    # Get the presentation for the given workflow GUID
+    # @param [String] workflow_id workflow GUID
+    # @return [String] JSON document representation of Workflow Presentation
+    def get_presentation(workflow_id)
+      @session.get("/workflows/#{workflow_id}/presentation/").body
+    end
+
+    # Get one workflow with a specified name.
+    # @param [String] name Name of the workflow
+    # @return [VcoWorkflows::Workflow] the requested workflow
+    def get_workflow_for_name(name)
+      path = "/workflows?conditions=name=#{url_encode(name)}"
+      response = JSON.parse(@session.get(path).body)
+
+      # barf if we got anything other than a single workflow
+      fail(IOError, ERR[:too_many_workflows]) if response['total'] > 1
+      fail(IOError, ERR[:no_workflow_found]) if response['total'] == 0
+
+      # yank out the workflow id and name from the result attributes
+      workflow_id = nil
+      response['link'][0]['attributes'].each do |a|
+        workflow_id = a['value'] if a['name'].eql?('id')
+      end
+
+      # Get the workflow by GUID
+      get_workflow_for_id(workflow_id)
+    end
+
+    # Get a WorkflowToken for the requested workflow_id and execution_id
+    # @param [String] workflow_id Workflow GUID
+    # @param [String] execution_id Execution GUID
+    # @return [String] JSON document for workflow token
+    def get_execution(workflow_id, execution_id)
+      path = "/workflows/#{workflow_id}/executions/#{execution_id}"
+      @session.get(path).body
+    end
+
+    # Get a list of executions for the given workflow GUID
+    # @param [String] workflow_id Workflow GUID
+    # @return [Hash]
+    def get_execution_list(workflow_id)
+      path = "/workflows/#{workflow_id}/executions/"
+      relations = JSON.parse(@session.get(path).body)['relations']
+      # The first two elements of the relations['link'] array are URLS,
+      # so scrap them. Everything else is an execution.
+      executions = {}
+      relations['link'].each do |link|
+        next unless link.key?('attributes')
+        attributes = {}
+        link['attributes'].each { |a| attributes[a['name']] = a['value'] }
+        executions[attributes['id']] = attributes
+      end
+      executions
+    end
+
+    # Get the log for a specific execution
+    # @param [String] workflow_id
+    # @param [String] execution_id
+    # @return [String] JSON log document
+    def get_log(workflow_id, execution_id)
+      path = "/workflows/#{workflow_id}/executions/#{execution_id}/logs/"
+      @session.get(path).body
+    end
+
+    # Submit the given workflow for execution
+    # @param [String] id Workflow GUID for the workflow we want to execute
+    # @param [String] parameter_json JSON document of input parameters
+    # @return [String] Execution ID
+    def execute_workflow(id, parameter_json)
+      path = "/workflows/#{id}/executions/"
+      response = @session.post(path, parameter_json)
+      # Execution ID is the final component in the Location header URL, so
+      # chop off the front, then pull off any trailing /
+      response.headers[:location].gsub(%r{^.*/executions/}, '').gsub(/\/$/, '')
+    end
+  end
+end

data/lib/vcoworkflows/workflowtoken.rb

@@ -0,0 +1,111 @@
+require_relative 'constants'
+require_relative 'workflow'
+require_relative 'workflowservice'
+require 'json'
+
+module VcoWorkflows
+  # WorkflowToken is used for workflow execution results, and contains as much
+  # data on the given workflow execution instance as vCO can provide.
+  class WorkflowToken
+    attr_reader :id
+    attr_reader :workflow_id
+    attr_reader :name
+    attr_reader :state
+    attr_reader :href
+    attr_reader :start_date
+    attr_reader :end_date
+    attr_reader :started_by
+    attr_reader :current_item_name
+    attr_reader :current_item_state
+    attr_reader :content_exception
+    attr_reader :global_state
+    attr_reader :input_parameters
+    attr_reader :output_parameters
+    attr_reader :json_content
+
+    # rubocop:disable CyclomaticComplexity, PerceivedComplexity, MethodLength, LineLength
+
+    # Create a new workflow token
+    # @param [VcoWorkflows::WorkflowService] workflow_service Workflow service to use
+    # @param [String] workflow_id GUID of the workflow
+    # @param [String] execution_id GUID of execution
+    # @return [VcoWorkflows::WorkflowToken]
+    def initialize(workflow_service, workflow_id, execution_id)
+      @service = workflow_service
+      @workflow_id = workflow_id
+      @json_content = @service.get_execution(workflow_id, execution_id)
+
+      token = JSON.parse(@json_content)
+
+      @id                 = token.key?('id')                        ? token['id']                        : nil
+      @name               = token.key?('name')                      ? token['name']                      : nil
+      @state              = token.key?('state')                     ? token['state']                     : nil
+      @href               = token.key?('href')                      ? token['href']                      : nil
+      @start_date         = token.key?('start-date')                ? token['start-date']                : nil
+      @end_date           = token.key?('end-date')                  ? token['end-date']                  : nil
+      @started_by         = token.key?('started-by')                ? token['started-by']                : nil
+      @current_item_name  = token.key?('current-item-display-name') ? token['current-item-display-name'] : nil
+      @current_item_state = token.key?('current-item-state')        ? token['current-item-state']        : nil
+      @global_state       = token.key?('global-state')              ? token['global-state']              : nil
+      @content_exception  = token.key?('content-exeption')          ? token['content-exception']         : nil
+
+      if token.key?('input-parameters')
+        @input_parameters = VcoWorkflows::Workflow.parse_parameters(token['input-parameters'])
+      else
+        @input_parameters = {}
+      end
+
+      if token.key?('output-parameters')
+        @output_parameters = VcoWorkflows::Workflow.parse_parameters(token['output-parameters'])
+      else
+        @output_parameters = {}
+      end
+    end
+    # rubocop:enable CyclomaticComplexity, PerceivedComplexity, MethodLength, LineLength
+
+    # Is the workflow execution still alive?
+    # @return [Boolean]
+    def alive?
+      running? || waiting?
+    end
+
+    # Is the workflow actively running?
+    # @return [Boolean]
+    def running?
+      state.eql?('running')
+    end
+
+    # Is the workflow in a waiting state?
+    # @return [Boolean]
+    def waiting?
+      state.match(/waiting/).nil? ? false : true
+    end
+
+    # rubocop:disable MethodLength, LineLength
+
+    # Convert this object to a string representation
+    # @return [String]
+    def to_s
+      string =  "Execution ID:      #{@id}\n"
+      string << "Name:              #{@name}\n"
+      string << "Workflow ID:       #{@workflow_id}\n"
+      string << "State:             #{@state}\n"
+      string << "Start Date:        #{Time.at(@start_date / 1000)}\n"
+      string << "End Date:          #{end_date.nil? ? '' : Time.at(@end_date / 1000)}\n"
+      string << "Started By:        #{@started_by}\n"
+      string << "Content Exception: #{@content_exception}\n" unless @content_exception.nil?
+      string << "\nInput Parameters:\n"
+      @input_parameters.each_value { |wf_param| string << " #{wf_param}" if wf_param.set? } if @input_parameters.size > 0
+      string << "\nOutput Parameters:" << "\n"
+      @output_parameters.each_value { |wf_param| string << " #{wf_param}" } if @output_parameters.size > 0
+      string
+    end
+    # rubocop:enable MethodLength, LineLength
+
+    # Convert this object to a JSON document (string)
+    # @return [String] JSON representation of the workflow token
+    def to_json
+      JSON.pretty_generate(JSON.parse(@json_content))
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+$LOAD_PATH << '../../lib'
+
+# require 'coveralls'
+# Coveralls.wear!

data/spec/vcoworkflows/vcosession_spec.rb

@@ -0,0 +1,33 @@
+require_relative '../spec_helper.rb'
+require 'vcoworkflows'
+
+# rubocop:disable LineLength
+
+describe VcoWorkflows::VcoSession, 'VcoSession' do
+  before(:each) do
+    @uri = 'https://vcoserver.example.com:8281'
+    @username = 'johndoe'
+    @password = 's3cr3t'
+  end
+
+  it 'should set the URL' do
+    vs = VcoWorkflows::VcoSession.new(@uri, user: @username, password: @password)
+    api_url = '/vco/api'
+
+    expect(vs.rest_resource.url).to eql(@uri << api_url)
+  end
+
+  it 'should set the username' do
+    vs = VcoWorkflows::VcoSession.new(@uri, user: @username, password: @password)
+
+    expect(vs.rest_resource.user).to eql(@username)
+  end
+
+  it 'should set the password' do
+    vs = VcoWorkflows::VcoSession.new(@uri, user: @username, password: @password)
+
+    expect(vs.rest_resource.password).to eql(@password)
+  end
+end
+
+# rubocop:enable LineLength

data/spec/vcoworkflows/workflow_spec.rb

@@ -0,0 +1,144 @@
+require_relative '../spec_helper.rb'
+require 'vcoworkflows'
+
+# rubocop:disable LineLength
+
+describe VcoWorkflows::Workflow, 'Workflow' do
+  before(:each) do
+    # Set up some basic starting data
+    @workflow_name = 'Request Component'
+    @workflow_id = '6e04a460-4a45-4e16-9603-db2922c24462'
+    @execution_id = 'ff8080814a1cb55c014a6481a9927a78'
+    @workflow_json = '''{"output-parameters":[{"name":"result","type":"string","description":"Catalog item request state"},{"name":"requestNumber","type":"number"},{"name":"requestCompletionDetails","type":"string"}],"relations":{"link":[{"rel":"up","href":"https://vco.example.com:8281/vco/api/inventory/System/Workflows/dlinsley%2540vmware.com/vCAC/"},{"rel":"executions","href":"https://vco.example.com:8281/vco/api/workflows/6e04a460-4a45-4e16-9603-db2922c24462/executions/"},{"rel":"presentation","href":"https://vco.example.com:8281/vco/api/workflows/6e04a460-4a45-4e16-9603-db2922c24462/presentation/"},{"rel":"tasks","href":"https://vco.example.com:8281/vco/api/workflows/6e04a460-4a45-4e16-9603-db2922c24462/tasks/"},{"rel":"icon","href":"https://vco.example.com:8281/vco/api/workflows/6e04a460-4a45-4e16-9603-db2922c24462/icon/"},{"rel":"schema","href":"https://vco.example.com:8281/vco/api/workflows/6e04a460-4a45-4e16-9603-db2922c24462/schema/"},{"rel":"permissions","href":"https://vco.example.com:8281/vco/api/workflows/6e04a460-4a45-4e16-9603-db2922c24462/permissions/"},{"rel":"interactions","href":"https://vco.example.com:8281/vco/api/workflows/6e04a460-4a45-4e16-9603-db2922c24462/interactions/"}]},"id":"6e04a460-4a45-4e16-9603-db2922c24462","name":"Request Component","version":"0.0.33","description":"","href":"https://vco.example.com:8281/vco/api/workflows/6e04a460-4a45-4e16-9603-db2922c24462/","customized-icon":false,"input-parameters":[{"name":"coreCount","type":"string"},{"name":"ramMB","type":"string"},{"name":"onBehalfOf","type":"string"},{"name":"machineCount","type":"string"},{"name":"businessUnit","type":"string"},{"name":"reservation","type":"string"},{"name":"location","type":"string"},{"name":"environment","type":"string"},{"name":"image","type":"string","description":"vCenter template name"},{"name":"runlist","type":"Array/string","description":"Chef Runlist for first run.  Leave empty for no Chef"},{"name":"nodename","type":"string","description":"Chef Nodename"},{"name":"component","type":"string"},{"name":"attributesJS","type":"string","description":"JSON object of vCenter Attributes to apply to VM(s)"}]}'''
+    @presentation_json = '''{"output-parameters":[{"name":"machineCount","type":"string"},{"name":"location","type":"string"},{"name":"image","type":"string","description":"vCenter template name"},{"name":"coreCount","type":"string"},{"name":"ramMB","type":"string"},{"name":"onBehalfOf","type":"string"},{"name":"businessUnit","type":"string"},{"name":"environment","type":"string"},{"name":"component","type":"string"},{"name":"reservation","type":"string"},{"name":"runlist","type":"Array/string","description":"Chef Runlist for first run.  Leave empty for no Chef"},{"name":"nodename","type":"string","description":"Chef Nodename"},{"name":"attributesJS","type":"string","description":"JSON object of vCenter Attributes to apply to VM(s)"}],"input-parameters":[{"name":"businessUnit","type":"string","description":"businessUnit"},{"name":"environment","type":"string","description":"environment"},{"name":"component","type":"string","description":"component"},{"name":"onBehalfOf","type":"string","description":"On Behalf of User: (user@domain format)"},{"name":"machineCount","type":"string","description":"machineCount"},{"name":"image","type":"string","description":"image"},{"name":"coreCount","type":"string","description":"coreCount"},{"name":"ramMB","type":"string","description":"ramSizeMB"},{"name":"runlist","type":"Array/string","description":"runlist"},{"name":"reservation","type":"string","description":"reservation"},{"name":"location","type":"string","description":"location"},{"name":"attributesJS","type":"string","description":"JSON object of vCenter Attributes to apply to VM(s)"},{"name":"nodename","type":"string","description":"Chef Nodename"}],"href":"https://vco.example.com:8281/vco/api/workflows/6e04a460-4a45-4e16-9603-db2922c24462/presentation/","name":"Request Component","id":"6e04a460-4a45-4e16-9603-db2922c24462","steps":[{"step":{"messages":[],"hidden":false,"elements":[{"fields":[{"display-name":"businessUnit","constraints":[{"@type":"mandatory"}],"@type":"field","fields":[],"id":"businessUnit","description":"businessUnit","hidden":false,"messages":[],"decorators":[{"array":{"elements":[{"string":{"value":"an"}},{"string":{"value":"aw"}},{"string":{"value":"soi"}}]},"@type":"drop-down"}],"type":"string"},{"display-name":"environment","constraints":[{"@type":"mandatory"}],"@type":"field","fields":[],"id":"environment","description":"environment","hidden":false,"messages":[],"decorators":[],"type":"string"},{"display-name":"component","constraints":[{"@type":"mandatory"}],"@type":"field","fields":[],"id":"component","description":"component","hidden":false,"messages":[],"decorators":[],"type":"string"},{"display-name":"On Behalf of User: (user@domain format)","constraints":[],"@type":"field","fields":[],"id":"onBehalfOf","description":"On Behalf of User: (user@domain format)","hidden":false,"messages":[],"decorators":[],"type":"string"},{"display-name":"machineCount","constraints":[],"@type":"field","fields":[],"id":"machineCount","description":"machineCount","hidden":false,"messages":[],"decorators":[{"array":{"elements":[{"string":{"value":"1"}},{"string":{"value":"2"}},{"string":{"value":"3"}},{"string":{"value":"4"}},{"string":{"value":"5"}},{"string":{"value":"6"}},{"string":{"value":"7"}},{"string":{"value":"8"}},{"string":{"value":"9"}},{"string":{"value":"10"}}]},"@type":"drop-down"}],"type":"string"},{"display-name":"image","constraints":[{"@type":"mandatory"}],"@type":"field","fields":[],"id":"image","description":"image","hidden":false,"messages":[],"decorators":[{"array":{"elements":[{"string":{"value":"vcaccentos65v8-agent"}},{"string":{"value":"win2012std"}},{"string":{"value":"vcac2012std"}},{"string":{"value":"centos-6.6-x86_64-20141203-1"}},{"string":{"value":"v8-centos65-agent"}},{"string":{"value":"vcac2008r2std"}},{"string":{"value":"oracle-6.5-x86_64-20141203-1"}},{"string":{"value":"centos65v8"}},{"string":{"value":"w2012r2std_coreservices"}},{"string":{"value":"2008r2std"}}]},"@type":"drop-down"}],"type":"string"},{"display-name":"coreCount","constraints":[{"@type":"mandatory"}],"@type":"field","fields":[],"id":"coreCount","description":"coreCount","hidden":false,"messages":[],"decorators":[{"@type":"refresh-on-change"},{"array":{"elements":[{"string":{"value":"1"}},{"string":{"value":"2"}},{"string":{"value":"4"}},{"string":{"value":"8"}}]},"@type":"drop-down"}],"type":"string"},{"display-name":"ramSizeMB","constraints":[{"@type":"mandatory"}],"@type":"field","fields":[],"id":"ramMB","description":"ramSizeMB","hidden":false,"messages":[],"decorators":[{"array":{"elements":[null]},"@type":"drop-down"}],"type":"string"},{"display-name":"runlist","constraints":[],"@type":"field","fields":[],"id":"runlist","description":"runlist","hidden":false,"messages":[],"decorators":[],"type":"Array/string"},{"display-name":"reservation","constraints":[{"@type":"mandatory"}],"@type":"field","fields":[],"id":"reservation","description":"reservation","hidden":false,"messages":[],"decorators":[],"type":"string"},{"display-name":"location","constraints":[],"@type":"field","fields":[],"id":"location","description":"location","hidden":false,"messages":[],"decorators":[],"type":"string"},{"display-name":"JSON object of vCenter Attributes to apply to VM(s)","constraints":[],"@type":"field","fields":[],"id":"attributesJS","description":"JSON object of vCenter Attributes to apply to VM(s)","hidden":false,"messages":[],"decorators":[{"@type":"multiline"}],"type":"string"},{"display-name":"Chef Nodename","constraints":[],"@type":"field","fields":[],"id":"nodename","description":"Chef Nodename","hidden":false,"messages":[],"decorators":[],"type":"string"}],"messages":[],"hidden":false,"@type":"group"}]}}],"relations":{"link":[{"rel":"up","href":"https://vco.example.com:8281/vco/api/workflows/6e04a460-4a45-4e16-9603-db2922c24462/"},{"rel":"instances","href":"https://vco.example.com:8281/vco/api/workflows/6e04a460-4a45-4e16-9603-db2922c24462/presentation/instances/"},{"rel":"add","href":"https://vco.example.com:8281/vco/api/workflows/6e04a460-4a45-4e16-9603-db2922c24462/presentation/instances/"}]}}'''
+    @param_string_json = '''{"type":"string","name":"stringparam","scope":"local","value":{"string":{"value":"squirrel!"}}}'''
+    @param_array_json = '''{"type":"Array/string","name":"arrayparam","scope":"local","value":{"array":{"elements":[{"string":{"value":"a"}},{"string":{"value":"b"}},{"string":{"value":"c"}}]}}}'''
+
+    # Mock the WorkflowService
+    @service = double('service')
+    allow(@service).to receive(:get_workflow_for_id) { @workflow_json }
+    allow(@service).to receive(:get_workflow_for_name) { @workflow_json }
+    allow(@service).to receive(:get_presentation) { @presentation_json }
+  end
+
+  it 'should parse a single string parameter' do
+    param_data = []
+    param_data << JSON.parse(@param_string_json)
+    wfparams = VcoWorkflows::Workflow.parse_parameters(param_data)
+
+    expect(wfparams).to_not eq(nil)
+    expect(wfparams.size).to eq(1)
+    expect(wfparams.key?('stringparam')).to eq(true)
+    expect(wfparams['stringparam'].type).to eql('string')
+    expect(wfparams['stringparam'].subtype).to eq(nil)
+    expect(wfparams['stringparam'].value).to eql('squirrel!')
+  end
+
+  it 'should parse a single Array parameter' do
+    param_data = []
+    param_data << JSON.parse(@param_array_json)
+    wfparams = VcoWorkflows::Workflow.parse_parameters(param_data)
+
+    expect(wfparams).to_not eq(nil)
+    expect(wfparams.size).to eq(1)
+    expect(wfparams.key?('arrayparam')).to eq(true)
+    expect(wfparams['arrayparam'].type).to eql('Array')
+    expect(wfparams['arrayparam'].subtype).to eql('string')
+    expect(wfparams['arrayparam'].value).to eql(%w(a b c))
+  end
+
+  it 'should parse an array of mixed parameters' do
+    param_data = []
+    param_data << JSON.parse(@param_string_json)
+    param_data << JSON.parse(@param_array_json)
+    wfparams = VcoWorkflows::Workflow.parse_parameters(param_data)
+
+    expect(wfparams).to_not eq(nil)
+    expect(wfparams.size).to eq(2)
+    expect(wfparams.key?('stringparam')).to eq(true)
+    expect(wfparams['stringparam'].type).to eql('string')
+    expect(wfparams['stringparam'].subtype).to eq(nil)
+    expect(wfparams['stringparam'].value).to eql('squirrel!')
+    expect(wfparams.key?('arrayparam')).to eq(true)
+    expect(wfparams['arrayparam'].type).to eql('Array')
+    expect(wfparams['arrayparam'].subtype).to eql('string')
+    expect(wfparams['arrayparam'].value).to eql(%w(a b c))
+  end
+
+  it 'should not explode' do
+    wf = VcoWorkflows::Workflow.new(@workflow_name, service: @service)
+
+    expect(wf).to_not eq(nil)
+  end
+
+  it 'should have input and output parameters' do
+    input_param_count = 13
+    output_param_count = 3
+    wf = VcoWorkflows::Workflow.new(@workflow_name, service: @service)
+
+    expect(wf.input_parameters.size).to eq(input_param_count)
+    expect(wf.output_parameters.size).to eq(output_param_count)
+  end
+
+  it 'should have required parameters' do
+    required_param_count = 7
+    wf = VcoWorkflows::Workflow.new(@workflow_name, service: @service)
+
+    expect(wf.required_parameters.size).to eq(required_param_count)
+  end
+
+  it 'should set and return a parameter value' do
+    wf = VcoWorkflows::Workflow.new(@workflow_name, service: @service)
+
+    expect(wf.set_parameter('coreCount', 4)).to eq(4)
+    expect(wf.input_parameters['coreCount'].value).to eq(4)
+    expect(wf.get_parameter('coreCount')).to eql(4)
+  end
+
+  it 'should execute' do
+    allow(@service).to receive(:execute_workflow) { @execution_id }
+    target_parameters = {
+      'coreCount'    => 2,
+      'ramMB'        => 2048,
+      'businessUnit' => 'aw',
+      'reservation'  => 'nonprodlinux',
+      'environment'  => 'dev1',
+      'image'        => 'centos-6.6-x86_64-20141203-1',
+      'component'    => 'api',
+      'onBehalfOf'   => 'svcacct@example.com',
+      'location'     => 'us_east',
+      'runlist'      => %w(role[loc_uswest] role[base] role[api]),
+      'machineCount' => 1
+    }
+
+    wf = VcoWorkflows::Workflow.new(@workflow_name, service: @service)
+    target_parameters.each { |k, v| wf.set_parameter(k, v) }
+
+    expect(wf.execute).to eql(@execution_id)
+  end
+
+  it 'should provide a WorkflowToken' do
+    token_json = '''{"relations":{"link":[{"href":"https://vco.example.com:8281/vco/api/workflows/6e04a460-4a45-4e16-9603-db2922c24462/executions/","rel":"up"},{"href":"https://vco.example.com:8281/vco/api/workflows/6e04a460-4a45-4e16-9603-db2922c24462/executions/ff8080814a1cb55c014a6481a9927a78/","rel":"remove"},{"href":"https://vco.example.com:8281/vco/api/workflows/6e04a460-4a45-4e16-9603-db2922c24462/executions/ff8080814a1cb55c014a6481a9927a78/logs/","rel":"logs"},{"href":"https://vco.example.com:8281/vco/api/workflows/6e04a460-4a45-4e16-9603-db2922c24462/executions/ff8080814a1cb55c014a6481a9927a78/state/","rel":"state"}]},"id":"ff8080814a1cb55c014a6481a9927a78","state":"completed","name":"Request Component","href":"https://vco.example.com:8281/vco/api/workflows/6e04a460-4a45-4e16-9603-db2922c24462/executions/ff8080814a1cb55c014a6481a9927a78/","start-date":1419025426833,"end-date":1419026124320,"started-by":"someuser@EXAMPLE.COM","input-parameters":[{"value":{"string":{"value":"2"}},"type":"string","name":"coreCount","scope":"local"},{"value":{"string":{"value":"2048"}},"type":"string","name":"ramMB","scope":"local"},{"value":{"string":{"value":"svcacct@example.com"}},"type":"string","name":"onBehalfOf","scope":"local"},{"value":{"string":{"value":"1"}},"type":"string","name":"machineCount","scope":"local"},{"value":{"string":{"value":"aw"}},"type":"string","name":"businessUnit","scope":"local"},{"value":{"string":{"value":"nonprodlinux"}},"type":"string","name":"reservation","scope":"local"},{"value":{"string":{"value":"us_east"}},"type":"string","name":"location","scope":"local"},{"value":{"string":{"value":"dev1"}},"type":"string","name":"environment","scope":"local"},{"value":{"string":{"value":"centos-6.6-x86_64-20141203-1"}},"type":"string","name":"image","scope":"local"},{"value":{"array":{"elements":[{"string":{"value":"role[loc_uswest]"}},{"string":{"value":"role[base]"}},{"string":{"value":"role[api]"}}]}},"type":"Array/string","name":"runlist","scope":"local"},{"value":{"string":{"value":""}},"type":"string","name":"nodename","scope":"local"},{"value":{"string":{"value":"api"}},"type":"string","name":"component","scope":"local"},{"value":{"string":{"value":""}},"type":"string","name":"attributesJS","scope":"local"}],"output-parameters":[{"value":{"string":{"value":"SUCCESSFUL"}},"type":"string","name":"result","scope":"local"},{"value":{"number":{"value":326.0}},"type":"number","name":"requestNumber","scope":"local"},{"value":{"string":{"value":"Request succeeded. Created vm00378."}},"type":"string","name":"requestCompletionDetails","scope":"local"}]}'''
+    allow(@service).to receive(:get_execution) { token_json }
+
+    wf = VcoWorkflows::Workflow.new(@workflow_name, service: @service)
+    wftoken = wf.token(@execution_id)
+
+    expect(wftoken).to_not eq(nil)
+    expect(wftoken.workflow_id).to eq(wf.id)
+    expect(wftoken.id).to eq(@execution_id)
+    expect(wftoken.alive?).to eq(false)
+    expect(wftoken.state).to eql('completed')
+  end
+
+  it 'should provide a WorkflowExectionLog' do
+    log_json = '''{"logs":[{"entry":{"severity":"info","time-stamp":1419026124333,"user":"gruiz-ade","short-description":"Workflow \'Request Component\' has completed","long-description":"Workflow \'Request Component\' has completed"}},{"entry":{"severity":"info","time-stamp":1419026123927,"user":"gruiz-ade","short-description":"Workflow \'Request Component\' has resumed","long-description":"Workflow \'Request Component\' has resumed"}},{"entry":{"severity":"info","time-stamp":1419025439183,"user":"gruiz-ade","short-description":"Workflow is paused","long-description":"Workflow \'Request Component\' has paused while waiting on signal"}},{"entry":{"severity":"info","time-stamp":1419025426870,"user":"gruiz-ade","short-description":"Workflow \'Request Component\' has started","long-description":"Workflow \'Request Component\' has started"}}]}'''
+    allow(@service).to receive(:get_log) { log_json }
+
+    wf = VcoWorkflows::Workflow.new(@workflow_name, service: @service)
+    wflog = wf.log(@execution_id)
+
+    expect(wflog).to_not eq(nil)
+  end
+end
+# rubocop:enable LineLength