https://github.com/forcedotcom/cinnamon

Cinnamon is a Force.com app that enables you to build and run Selenium tests to validate custom UI pages with Visualforce/Javascript in your Salesforce org.
https://github.com/forcedotcom/cinnamon

Last synced: 2 months ago
JSON representation

Cinnamon is a Force.com app that enables you to build and run Selenium tests to validate custom UI pages with Visualforce/Javascript in your Salesforce org.

• Host: GitHub
• URL: https://github.com/forcedotcom/cinnamon
• Owner: forcedotcom
• Archived: true
• Created: 2014-05-07T19:35:36.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2018-06-26T20:06:21.000Z (about 6 years ago)
• Last Synced: 2024-04-14T19:33:29.015Z (3 months ago)
• Language: Apex
• Homepage: http://forcedotcom.github.io/cinnamon
• Size: 2.1 MB
• Stars: 66
• Watchers: 28
• Forks: 24
• Open Issues: 23
• Metadata Files:
  • Readme: README.md

Lists

• awesome-salesforce - Cinnamon - Cinnamon is a Force.com app that enables you to build and run Selenium tests to validate custom UI pages with Visualforce/Javascript in your Salesforce org. (Table of Contents / Developer Utilities)
• awesome-salesforce - Cinnamon - Cinnamon is a Force.com app that enables you to build and run Selenium tests to validate custom UI pages with Visualforce/Javascript in your Salesforce org. (Table of Contents / Developer Utilities)

README

        
#Welcome to Cinnamon!

Cinnamon is a Force.com app that enables you to build and run Selenium tests to validate your custom UI pages with Visualforce or Javascript in your Salesforce organization.

With Cinnamon, you can

* Create and execute Selenium Tests from within your Salesforce organization.

* Get out-of-box integration with Sauce Labs, which provides comprehensive OS and browser coverage.

* Connect to any of your Salesforce Developer Edition or sandbox organization via OAuth authentication.

* Easily create PageObject classes to interact with your UI pages for your tests

Before you can use Cinnamon, you'll need to install, setup and configure Cinnamon.  Please follow the instruction below to install and set up Cinnamon in your Salesforce organization.

##Install

Cinnamon requires you to install the following package

* Install the [Cinnamon package on a Developer Edition Org] (https://login.salesforce.com/packaging/installPackage.apexp?p0=04td0000000N4Fs)

* Install the [Cinnamon package on a Sandbox Org] (https://test.salesforce.com/packaging/installPackage.apexp?p0=04td0000000N4Fs)

##Set Up Cinnamon

Follow these steps to set up Cinnamon in your organization.

1. Select **Cinnamon** from App drop-down list

2. Go to **Settings** tab

3. Provide the configuration settings that are shown in the WebDriver Service Provider Settings section (for this example we are using Saucelabs)

 * Sauce Username ``

 * Sauce Access Key ``

 ![](https://raw.githubusercontent.com/forcedotcom/cinnamon/master/images/cinnamon_settings.png)

4. Go to **Setup -> Security Controls -> Remote Site Settings**.  Click Edit link on the **self** remote site.

 ![](https://raw.githubusercontent.com/forcedotcom/cinnamon/master/images/self_remote_site2.png)

5. Edit `self` setting to your instance

 * You can find your instance by checking the URL of  your organization.  For example, if the URL is `https://na15.salesforce.com`, your organization resides in the `na15` instance.

 ![](https://raw.githubusercontent.com/forcedotcom/cinnamon/master/images/self_remote_site.png)

6. Click **Cinnamon Settings** tab and then the `Connect to Your Org Under Test` button

 ![](https://raw.githubusercontent.com/forcedotcom/cinnamon/master/images/org_under_test.png)

7. Log in to Your Org Under Test and click **Allow** button

 ![](https://raw.githubusercontent.com/forcedotcom/cinnamon/master/images/login_dialogue.png)

After authentication is completed, you'll see Cinnamon being connected to your Org Under Test

 ![](https://raw.githubusercontent.com/forcedotcom/cinnamon/master/images/org_under_test2.png)

Now, you are set up and ready to run a Cinnamon test.

##Run a Cinnamon Test

1. Go to **Setup -> Develop -> Apex Classes**

2. Create the PageObject class [NewAccountPageObject](https:///github.com/yudiatsfdc/cinnamon/blob/master/src/classes/NewAccountPageObject.cls)

3. Create the Visualforce Page [NewAccountPage](https://github.com/yudiatsfdc/cinnamon/blob/master/src/pages/NewAccountPage.page)

4. Create the Test class [TestNewAccount](https://github.com/yudiatsfdc/cinnamon/blob/master/src/classes/TestNewAccount.cls) 

5. Click the **Test Console** tab.

 ![](https://raw.githubusercontent.com/forcedotcom/cinnamon/master/images/testconsole.png)

6. Select the `TestNewAccount` that now appears in the **Test Console** page, and then click the **Execute Test** button.  The test should be executed successfully.

 ![](https://raw.githubusercontent.com/forcedotcom/cinnamon/master/images/test_passed.png)

7. Click the **Passed** link to view the test execution detail

 ![](https://raw.githubusercontent.com/forcedotcom/cinnamon/master/images/testdetail.png)

##Log and Track Issues and Bugs

Use [Github Issues](https://github.com/forcedotcom/Cinnamon/issues) to log and track issues and bugs.