tableau-mkt/eloqua-bdd

Provides Behat step definitions for common testing scenarios specific to Eloqua instances.

0.1.0 2015-11-23 21:49 UTC

README

This project aims to enable marketers to write Behat features and scenarios about their Eloqua instance. It provides step definitions for common testing scenarios specific to Eloqua instances. It is a work in progress.

Installation

The simplest way to install this framework is through Composer:

  1. If you don't already have it, install composer:
curl -sS https://getcomposer.org/installer | php
php composer.phar install
  1. Create a directory for your Eloqua BDD project
mkdir myorg-eloqua-features
  1. Install this project in your project root
cd myorg-eloqua-features
composer.phar require tableau-mkt/eloqua-bdd
  1. Initialize behat
./vendor/bin/behat --init

Configuration

You will need to create a behat.yml file at the root of your project. It should contain the following, at a minimum:

default:
  suites:
    default:
      contexts:
        - Behat\MinkExtension\Context\MinkContext
        - Eloqua\EloquaExtension\Context\Email
  extensions:
    Behat\MinkExtension:
      goutte: ~
    Eloqua\EloquaExtension:
      # Authentication Details
      site: YourEloquaSiteName
      login: YourEloqua.UserName
      password: Y0urP@ssw0rd
      # The base URL of your Eloqua Instance's Pod. Defaults to the following:
      baseUrl: https://secure.eloqua.com/API/REST

You probably don't want to store your Eloqua authentication details in plain text. To get around this, you can omit those details above and choose to store them in an environment variable like so. Maybe you encrypt that environment variable too.

export BEHAT_PARAMS='{"extensions" : {"Eloqua\\EloquaExtension" : {"password" : "Y0urP@ssw0rd"}}}'

Usage

Once things are installed and configured, you can start writing features. Here's an example feature to get you inspired:

Feature: Trial follow-up e-mail
  In order to prove that links in follow-up e-mails are valid
  As an e-mail recipient
  I should be directed to the upgrade page

  Scenario: Clicking links
    Given I am viewing the "Trial Followup" email
    When I click the "Upgrade Now" link in the email
    Then the response status code should be 200
    And the response should contain "Upgrade your plan"
    And print current URL

To list all step definitions, run the following: ./vendor/bin/behat -dl

For more information on writing features or scenarios, see the Behat docs.