#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 requiers you to install the following two pacakges
- Install the Apex Selenium package.
- Install the Cinnamon package.
##Set Up Cinnamon Follow these steps to set up Cinnamon in your organization.
- Select Cinnamon from App drop-down list
- Go to Settings tab
- Provide the configuration settings that are shown in the following screenshot, and then enter your Sauce Labs username and access key
- Selenium Proxy URL
ondemand.saucelabs.com
- Selenium Port
80
- Sauce Username
<Your Sauce Username>
- Sauce Access Key
<Your Sauce Access Key>
- Go to Setup -> Security Controls -> Remote Site Settings. Click Edit link on the self remote site.
- 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 thena15
instance.
- Click Cinnamon Settings tab and then the
Connect to Your Org Under Test
button - Log in to Your Org Under Test and click Allow button
After authentication is completed, you'll see Cinnamon being connected to your Org Under Test
Now, you are set up and ready to run a Cinnamon test.
##Run a Cinnamon Test
- Go to Setup -> Develop -> Apex Classes
- Create two classes
TestCinnamonSampleTest
andAccountPageObject
- Paste the sample classes: TestCinnamonSampleTest and AccountPageObject
- Click the Test Console tab.
- Select the
TestCinnamonSampleTest
that now appears in the Test Console page, and then click the Execute Test button. The test should be executed successfully. - Click the Passed link to view the test execution detail
##Log and Track Issues and Bugs Use Github Issues to log and track issues and bugs.