How to ... Deploy the Jabber demo in salesforce.com

This demo shows you how to install the Jabber SDK into your browser and, by using the salesforce.com development sandbox, enable the salesforce.com site to display Presence status and also allow for Click to Call and Click to Chat from within the Browser.

Please also take a look at the Salesforce proof-of-concept video at
http://developer.cisco.com/web/jabber-developer/web-tool-kit-in-use

Step 1: Identifying Salesforce.com system ID

  1. Login into Salesforce.com using your account by going to https://login.salesforce.com
  2. The system id appears as a salesforce.com subdomain:
    System ID appears as a salesforce.com subdomain

Step 2: Adjust links in distribution files for local deployment

  1. Extract the Jabber SDK Demo distribution zip file to a local directory
  2. Browse the extracted directory
  3. In the following files under sfdc directory
    1. Apex.JabberCommand.xhtml
    2. Apex.Jabber.xhtml
    3. Messages&alerts.html
  4. Search for and replace all occurrences of the following URLs:
    1. Replace https://cebtgwy.ciscocebt.com/glwstatic/ with your local HTTP server where demo files are located
    2. Replace https://c.na14.visual.force.com with https://c.XYZ.visual.force.com where XYZ is an instance of your salesforce.com system (e.g. ap1)
    3. Replace https://na14.salesforce.com with https://XYZ.salesforce.com where XYZ is an instance of your salesforce.com instance (e.g. ap1)

Step 3: Customize User Object

  1. Open 'Your name' > Setup > App Setup > Customize > Users > Fields and add following custom fields to the User object (type=text, length=255 and visible for all roles)
    1. CUCM Address
    2. CUPS Address
    3. Jabber ID
    4. Jabber Password
    5. UCM User

    All fields should be of type Text with length (255). During creation wizard select "Visible" checkbox for all roles.

    Verify that "Add Field" checkbox is check for "User Layout", and click "Save" and

User custom fields

Step 4: Create Visual Force Pages and Apex Objects

Apex class image

Visual force pages

  1. Open 'Your name' > Setup > App Setup > Develop > Apex Classes
  2. The attached ZIP file contains a list of files with ".apex" extension. For each file in the following list, create a new class by clicking "New button" and copying the content of the file into the online editor (the order is important), and click "Save" after copying each file:
    1. Apex.XMLDom.apex
    2. Apex.startHereController.apex
  3. Open 'Your name' > Setup > App Setup > Develop > Pages
  4. Create new Pages by replacing the default content and copying the content of each one of the following files in the distribution under sfdc directory
    1. Apex.loadSessionId.xhtml – Page label/name "loadSessionId"
    2. b. Apex.Jabber.xhtml – Page label/name "Jabber"
    3. Apex.JabberCommand.xhtml – Page label/name "JabberCommand"

Step 5: Add Jabber SDK scripts to Salesforce.com pages

  1. Open 'Your name' > Setup > App Setup > Customize > Home > Home Page Components
    1. Click "Edit" next to Messages & Alerts
    2. Copy the content of messages&alerts.html file in distribution under sfdc directory into Messages & Alerts text box.
      Note: There should be no empty lines in text box.
    3. Open 'Your name' > Setup > App Setup > Home > Home Page Layouts
    4. dEdit the "DE Default" layout and check Messages & Alerts checkbox
    5. Click "Next" button
    6. Click "Save" button
    7. Open 'Your name' > Setup > App Setup > Customize > User Interface
    8. Check "Show Custom Sidebar Components on All Pages" checkbox
    9. Click "Save"

Step 6: Set Users' Properties

  1. Open 'Your name' > Setup > Administration Setup > Manage Users > Users
  2. For each user
    1. Click "Edit"
    2. Set the following properties
      1. Extension – user's CUCM extension number
      2. CUCM Address – IP address of CUCM server
      3. CUPS Address – BOSH HTTP URL on CUPS (e.g. https://cups-server:7335/httpbinding)
      4. Jabber ID – user's JID (e.g. john@acme.com)
      5. Jabber Password – user's CUCM/CUPS password
        Note: This field contains clear text.
      6. UCM User – user name in CUCM (e.g. john )

Set Users properties

Step 7: Accessing Salesforce.com UI with Jabber SDK

  1. Access https://XYZ.salesforce.com/apex/Jabber?cid=500/o where XYZ is your Salesforce.com instance
  2. Create a new sample case
  3. At every page where user name appears, presence, click to call and click to chat controls will be appended

Note: The URL in the browser's address bar should remain
https://XYZ.salesforce.com/apex/Jabber?cid=500/o

Subscribe

Provide us with your name and email address and we'll keep you updated with Jabber developments.