{{appName}}

• Lightning console apps allow users to quickly find the information they need, and make edits while viewing multiple records on one screen .
• Lightning Console JavaScript API gives the programmatic access to Lightning console apps, so you can fully integrate Lightning console apps with the Lightning framework and extend them to meet your business needs

2 APIs

1. Workspace API: provides methods for opening, closing, and getting information about workspace tabs and subtabs.

   ---

   can be used in Lightning console apps only.
2. Utility bar API: provides methods that can be used from Lightning components in the utility bar to open, resize, or minimize a utility.

   ---

   can be used in Lightning apps with standard or console navigation

2 APIs - contd.

Tips for Rollling out Lightning Experience

Video:Lightning Sales Console Demo

Webniar:Supercharge Productivity With Lightning Console Apps

Webniar:Hacking the Salesforce Console

Lightning Console UI

1. navigation bar
2. workspace tabs
3. subtabs
4. recently viewed
5. split view pane
6. details area
7. feed
8. utilities - utility bar

Lightning Console - Utility Bar

1. The utility bar
2. The Chatter Feed utility
3. A utility label
4. A utility icon
5. The panel header
6. The panel header label
7. The panel header icon

workspaceAPI and utilityBarAPI components

• lightning:workspaceAPI: gives access to the Workspace API
• lightning:utilityBarAPI: gives access to the Utility Bar API

           

    
    
    
    


// -------
({
    openUtilityBar : function(component, event, helper) {
        var utilityAPI = component.find("utilitybar");
        utilityAPI.openUtility();
    }

    openTab : function(component, event, helper) {
        var workspaceAPI = component.find("workspace");
        workspaceAPI.openTab({
            url: ‘#/sObject/001R0000003HgssIAC/view’,
            focus: true
        }).then(function(response) {
            workspaceAPI.getTabInfo({
                tabId: response
            }).then(function(tabInfo) {
	            console.log(“The recordId for this tab is: “ + tabInfo.recordId);
            });
        })
        .catch(function(error) {
            console.log(error);
        });
    }
})

           
         

JavaScript Promises

           
// Methods in the Lightning Console JavaScript API return results using promises
({
    focusNewTab : function(component, event, helper) {
        var workspaceAPI = component.find("workspace");
        // get the tab ID of the focused tab
        workspaceAPI.openTab({
            url: '#/sObject/001R0000003HgssIAC/view',
            label: 'Global Media'
        }).then(function(response) {
            // respsone from the promise
            // Promises can simplify code that handles
            //   the success or failure of asynchronous calls
            workspaceAPI.focusTab({tabId : response});
       })
        .catch(function(error) {
          // Promises can simplify code that
          //  handles the success or failure of asynchronous calls
          /*
            The catch() method returns a promise and
              accepts a single function parameter that’s called if the promise is rejected.
              This function has one argument that shows the reason for the rejection.
              The promise returned by catch() is rejected if the function that is passed
              in either throws an error or returns a promise that’s rejected.
               Otherwise, the promise is resolved.
          */
            console.log(error);
        });
    }
})
           
         

Using Page Context in the Utility Bar API

    
   // implements force:hasRecordId and listens for changes to the record being viewed
   // When this component is added to a utility bar,
   //  it displays the recordId of the record currently being viewed.
      
          
          

                  
The current recordId is {!v.recordId}.
          
      
// controller
({
    onRecordIdChange : function(component, event, helper) {
        var newRecordId = component.get("v.recordId");
        console.log(newRecordId);
    }
})


    
  

Utility Bar showing the current recordId

Creating Lightning Console App

Creating Lightning Console App - Utility Bar

openTab() for Lightning Experience

    
    // component - has a button that, when pressed, opens a tab and sets the tab’s icon to the SLDS emoji icon.
    
        
        
    
    ({ // controller
     openTab : function(component, event, helper) {
        var workspace = component.find("workspace");
        workspace.openTab({
          url: '/sObject/001R0000003HgssIAC/view',
          focus: true,
          callback : function(error, response) {
              workspace.focusTab({tabId : response });
          }
       });
     }
  })
  
  

setTabIcon() for Lightning Experience

      
      // component - has a button that, when pressed, opens a tab.
      
      
      
     
      ({ // controller
       setFocusedTabIcon : function(component, event, helper) {
          var workspace = component.find("workspace");
          workspace.getFocusedTabInfo({
            callback : function(error, response) {
                var focusedTabId = response.tabId;
                workspace.setTabIcon({tabId : focusedTabId, icon: 'like', iconAlt: 'like' });
            }
         });
       }
    })
    
    

Lightning Events example

// Use events and handlers in your Lightning components and controllers
//  to respond to events like workspace tabs opening, closing, or
//  gaining focus.

// prints a line to the browser’s developer console
// when a tab is closed
  
  // component
    
        
        
    

  // controller
  ({
      onTabclosed : function(component, event, helper) {
          console.log("Tab closed.");
      },
  })
  

Features in Classic console not available in Lightning Console

• Resizeable split view - In Salesforce Classic, you can adjust the width of a pinned list. In Lightning Experience, you can’t adjust the width of split view.
• Custom keyboard shortcuts
• Interaction logs
• Dynamic list updates (push notifications)
• Multi-monitor—pop-out utilities ( multi-monitor components)
• Region presentation—size

References

• What Features Are Available in Lightning Console Apps?
• Create Lightning Console App
• Salesforce Console Developer Guide