Salesforce Classic is the older version of Salesforce. Salesforce Lightning is a fully updated interface that’s available at no cost for all Salesforce Classic users. If you're interested in switching, please see this article for more information from Salesforce.
If you're already using Salesforce Lightning, please see this article for corresponding instructions on setting it up on your Enplug display.
Follow the steps below to set up your Salesforce dashboard and get it up and running on our Webpage App.
Two-Factor Verification:
If you have two-factor verification enabled on your Salesforce account, you will need to give the device approval to bypass this. If not, click here to skip to the next step.
The best way to get around this is by setting up an approved IP address on Salesforce, which means that as long as the Enplug device is connected to the wifi network with the approved IP address, it won't need to go through the two-step verification.
Different wifi networks have different ways of assigning IP addresses. It's best to confirm this with your IT team, but there are several different ways of getting the IP address that you'll assign to your device:
- Static IP: If your office is set up with one IP address for the entire office, this makes the process very simple. Simply type "IP" into your URL bar, and it will display your IP address. You can also go to http://checkip.dyndns.org/, which returns your current IP address.
- Ranged IP address: If you have a range of IP addresses set up for your office, you'll need to contact your network administrator for this range.
- Dynamic IPs: If your Internet Service Provider (ISP) provides dynamic IPs, and you have two-factor verification enabled on Salesforce, unfortunately Enplug cannot bypass the two-factor identification. Please contact support for more information.
Once you find out the IP address that you'll use, you'll need to set up Salesforce to allow devices on that IP address to access your Salesforce dashboard.
- When you log in, on the left side of the screen there will be a column with various administrative options, as shown below. If you're already in another part of Salesforce, select "Setup" in the upper right corner, next to your name. Select "Security Controls", then the "Network Access" section underneath that.
- Then, click "New" to add a trusted IP address. You will see the page below, with fields for a "Start IP" and "End IP". You don't need to enter a description.
If you have a Static IP for your office, enter this as both start and end.
Alternately, if you have a range of IP addresses, enter the minimum as the Start IP Address, and the highest as the End IP Address.
Salesforce Dashboard Link
Open the Salesforce dashboard you'd like to show on your Enplug device, and copy the URL directly from your browser. It should look something like this: https://na30.salesforce.com/01Z36000000nUOyEAM/view?t=1467043528112
Add Salesforce to your Enplug Dashboard
1. Go to the Apps dropdown in the upper left corner of the Enplug dashboard, and select the Webpage app.
2. Click "Add Website" in the upper right.
3. Enter the URL you just copied into the "URL" field. Choose whatever name and duration you prefer.
4. Click "Advanced Settings". Fill in the following fields:
- Website Appearance: Mobile View
- Page rendering delay: 2
- Reload each time page is shown (should be checked)
- Auto-Reload: 10
- Scale text: 100
5. Scroll down to the Javascript Settings section. Fill in your username and password as shown below.
6. Finally, copy & paste the below Javascript into the text field. This will log your device into Salesforce using your username and password.
(function() {
if ( document ) {
try {
document.getElementById('username').value = webView.getUsername();
document.getElementById('password').value = webView.getPassword();
document.getElementById('rememberUn').checked = true;
document.getElementById('Login').click();
function autorefresh() {
document.getElementById('refreshInput').click();
setTimeout(autorefresh, 60000);
} autorefresh();
} catch(error){}
} else {
setTimeout(arguments.callee, 500);
}
})();
Tips and Tricks:
Notice this line of code:
frame.style.transform = 'translate3d( 0, -10%, 0)';
Depending on your screen orientation, you may want to modify this value in order to hide the dashboard header out of the screen. For landscape screens a value -10% works fine while -5% works best for portrait screens.
When running the Salesforce dashboard for the very first time, the script may fail and display a blank screen. This happens because the script needs to log into the Salesforce system. Simply press save again and the page should reload just fine and work reliably from this point forward.