In order for someone to implement a new Lighthouse Widget the following steps must be followed:

  1. Technical Notes (this is usually already done by a developer):
    Create an entry in components table (IDMS_Dash_ComponentWidget) to reference its assembly, 
    which is 'OneDealer.Common.MVC.GridDashboardWidgets.TileLinkWidget.OmniChannelTileLinkUserTokenComponent, OneDealer.Common.MVC'.
    The link to do that is ~/SetupEntities/List/Dashboard/IDMS_Dash_ComponentWidget.
    The difference in this widget component with other similar widgets, is that it uses two dynamic format tokens to fill the Lighthouse User Token and the Logged in user Language

  2. Create an entry in widgets table (IDMS_Dash_Widget) that uses the component created on the previous step.
    The link to do that is ~/SetupEntities/List/Dashboard/IDMS_Dash_Widget.


  3. After that, you have to create edit the Admin Settings of your widget in order to set the preferred Url. 
    What you need to know here is that this widget can cover two dynamic parameters that are represented in the url as {0} and {1}. Where {0} is the Lighthouse User Token and {1} is the current logged in user language in ISO format (e.g. en-US)
    You must always use encoded urls in order for the IFrame to work
    Examples of urls:


    		Encoded Url with dynamic tokens (What you need to input in the field)Original Url (The url that will be constructed automatically by the system. Not what you input in the field.)
    Campaignhttps%3A%2F%2Fvendd6dev.test.devlh.com%2F%23%2FLoginUser%2F{0}%2Fcontent%252Fcampaigns253Flang%253D{1}

    https://vendd6dev.test.devlh.com/#/LoginUser/789/content/campaignsManagement?lang=el-GR

    Here campaigns defines that this will open the campaigns page

    CallCenterhttps%3A%2F%2Fvendd6dev.test.devlh.com%2F%23%2FLoginUser%2F{0}%2Fcontent%252FcallCenterGroupManagement%253Flang%253D{1}

    https://vendd6dev.test.devlh.com/#/LoginUser/789/content/callCenterGroupManagement?lang=el-GR

    Here callCenterGroup defines that this will open the call center


  4. Last but not least, fill table IDMS_CAMPAIGNUSER (Check Setup - Link OD User with Campaign Management user)
    The link to do that is ~/SetupEntities/List/Administration/IDMS_CAMPAIGNUSER
    Here you can bind each one-dealer user with a specific token and role. 
    This will allow the token to be resolved dynamically and not be written directly on the url.

Note: Similar functionality can be found on dynamic menus. For more info check here.

Write a comment…