Embedding DigDash in Web Sites URL Parameters

Last modified by jhurst on 2021/11/15 09:22

Introduction

DigDash can be embedded at multiple “levels” in external websites:

-Dashboard

-Dashboard page

-Information Flow

In this document we will present url that works in the following context:

Server name: ddsrv

Port: 8080

DigDash Domain: ddenterpriseapi

DigDash Dashboard Domain: digdash_dashboard

Dashboard

At this level you can embed multiple pages in an iframe.

URL : http://ddsrv:8080/digdash_dashboard/index.html

Available parameters:

  • login=<user> User to authenticate
     
  • pass=<password> Password for the user
  • domain=<domainname> DigDash Enteprise domain name
     Example: ddenterpriseapi
  • server=<server URL> DigDash Enterprise domain server URL
     Example : http://localhost:8080
  • hideBanner=<true|false> Hide (true) or show (false) the main title bar
  • hideFilters=<true|false> Hide (true) or show (false) the filter bar
  • <variableName>=<value> Specify a value for the variable variableName
  • <filterselection> See section V below

Example

http://ddsrv:8080/digdash_dashboard/index.html?server=http://localhost:8080&domain=ddenterpriseapi&login=user1&pass=pass1&hideBanner=true&hideFilters=true&var=1

Dashboard Page

At this level you can embed one page or all the pages of a dashboard role into an iframe

URL:

http://ddsrv:8080/digdash_dashboard/index.html?page=<user|role>[.<pagename>]

If you want one page you specify the page name otherwise you will get all the pages of the user or role selected.

Available parameters:

  • page=<user|role>[.<pagename>] Page name prefixed by role or user name
  • login=<user> User to authenticate
     
  • pass=<password> Password for the user
  • domain=<domainname> DigDash Enteprise domain name
     Example: ddenterpriseapi
  • server=<server URL> DigDash Enterprise domain server URL
     Example : http://localhost:8080
  • hideBanner=<true|false> Hide (true) or show (false) the main title bar
  • hideFilters=<true|false> Hide (true) or show (false) the filter bar
  • <variableName>=<value> Specify a value for the variable variableName
  • <filterselection> See section V below

Example

Information Flow

At this level you can embed one information flow (graphic component) of your information wallet into an iframe

URL: http://ddsrv:8080/ddenterpriseapi/viewflow?flowId=<flowid>

There is an easy way to get that URL for a specific flow from the information wallet configuration by clicking on “copy flow URL”

Available parameters:

  • flowId=<flow> Identifier for the flow to display
  • user=<user> User to authenticate
     
  • pass=<password> Password for the user
  • hideFilters=<true|false> Hide (true) or show (false) the filter bar
  • <variableName>=<variableValue> Specify the value of variable variableName
  • <filterselection> See section V below

Example:

http://ddsrv:8080/ddenterpriseapi/viewflow?flowId=2340fd0&user=user1&pass=pass1&hideFilters=true&var=1

Filters

You can specify pre-defined filters when for your iframe integration by setting some dimension filter parameters.

Filters are on the form:

DimensionName=FilterValue

If the dimension contains one or more Hierarchies you can select the desired Hierarchy and Level by adding

HDimensionName=HierarchyName

LDimensionName=LevelName

Example

http://ddsrv:8080/ddenterpriseapi/viewflow?flowId=2340fd0&user=user1&pass=pass1&Geo=France&HGeo=Geography&LGeo=Country