DEVELOP FOR ROCKDAISY

Embed analytics in your application

RockDaisy is a fully customizable responsive web application which means to you can seamlessly embed RockDaisy into an existing app and completely brand the UI (see how to brand RockDaisy). Since every report in RockDaisy is accessible via URL. All you need to do is have your existing app navigate to prebuilt RockDaisy reports/widgets by using the RockDaisy report URL. With RockDaisy Embedded—for application developers—you can embed visual analytics in your products, so your users and customers can gain valuable insights, and you can get to market fast. 

To embed RockDaisy in your application or portal, all you need to do is generate a url from your application in a specific format (see below) and call the RockDaisy application. This enables your app/portal to securely access RockDaisy dashboards, reports, and visualizations. 

Create rich, interactive reports with visual analytics for embedding with RockDaisy report designer portal. 

Authentication flow:

The RockDaisy platform utilizes OAuth2 authentication or can integrate with popular authentication solutions such as Azure Entra ID, Windows Active Directory (AD) and PingFederate. With Single Sign-On (SSO) providers, there are no additional steps required. Prior to integrating dashboards into your web application via OAuth2, authorization must be obtained. This can be accomplished by submitting a request as demonstrated in the example below (please note that you should replace the domain, user name, and password with appropriate values):

curl –location ‘https://sample.rockdaisy.com/oauth2/token’ \
–header ‘Content-Type: application/x-www-form-urlencoded’ \
–data-urlencode ‘grant_type=password’ \
–data-urlencode ‘username=test@rockdaisy.com’ \
–data-urlencode ‘password=*********’

The best practice regarding the auth user is to create a new user account (for example, embed@rockdaisy.com) and assign appropriate permissions.

Once you have received a successful response (status codes 200 or 204), you may proceed with the process of embedding the dashboard. The platform will automatically set all the necessary cookies (via the response’s Set-Cookie header). Therefore, it is important to ensure that the withCredentials property is enabled for jQuery/XMLHttpRequest (XHR) requests.

Dashobard embedding:

You can embed any Saved Dashboard or App Dashboard from the platform into your application using iFrames. See the HTML example below (please note that prior to making any requests, authentication is required):

<iframe src=”https://sample.rockdaisy.com/view/280?filters=@OrganizationId%3D81%26@TeamId%3D85&hideLeftMenu=true”></iframe>

App Dashboard Query Parameters:

It is possible to modify the overall appearance of the dashboard with additional query parameters passed to the URL.

Query Parameter

Description

fullScreen

hides left navigation menu & dashboad header area

filters

includes App Dashboard Filters in the following format: @Parameter1=Value1,Value2. It is required to encode the value  part (e.g. @ – %40, & – %26, = – %3D)

hideLeftMenu

hides left navigation menu

drilldown

hides top navigation bar menu if anything passed, otherwise empty

hideHeaders

hides all the report headers on the dashboard

allowExporting

parameter that hide / shows export dashboard feature

hideHeaderLogo

hides the client logo in the top left corner

hideMobileMenu

makes mobile view to be kinda full-screen

hideReportsHeaders

Example of usage:

SELECT ‘https://sample.rockdaisy.com/view/2?fullScreen=true’ as Url – Full-Screen mode

SELECT ‘https://sample.rockdaisy.com/view/2?drilldown=true’ as Url – Drilldown mode

SELECT ‘https://sample.rockdaisy.com/view/2?hideHeaders=true’ as Url – Hidden Header

Passing parameters from your application to RockDaisy

select ‘https://yoursite.rockdaisy.com/view/510?filters=@RDPlayerId%3D’ + cast(@RDPlayerId as varchar(max)) + ‘&fullScreen=true’ as Url

Pass 2 parameters

select ‘https:// yoursite.rockdaisy.com/view/510?filters=%40RDPlayerId%3D’ + cast(@RDPlayerId as varchar(max)) + ‘%26%40Param2%3D’  + cast(@Param2 as varchar(max)) + ‘&fullScreen=true’ as Url

URL does not support spaces in variable values, e.g. @RDPlayerId=’Tom Brady’ will not work. browser will restrict & character in this case.

Url with date range and another parameter (URLEncode is used to handle spaces)

SELECT  ‘https:// yoursite.rockdaisy.com/view/510?filters=%40SSPlayerId=’+ cast(@SSPlayerId as varchar(max)) + ‘%26%40DateRange=’ + REPLACE(dbo.URLEncode(CONVERT(varchar, (CONVERT(datetimeoffset, dateadd(day,-30,cast(@StartDate as datetimeoffset)), 127)), 127) + ‘ – ‘ + CONVERT(varchar, (CONVERT(datetimeoffset, cast(@EndDate as datetimeoffset), 127)), 127)), ‘%’, ‘__’) + ‘&fullScreen=true’  as SavedDashboardUrl

Kiosk Mode

RockDaisy interactive kiosk mode provide audiences with engaging digital content and information through a user-friendly interface. This type of self-service solution has many uses and benefits, and can be used for a variety of purposes including retail sales, consumer/employee engagement, information sharing and more. RockDaisy kiosks can also function as digital signage when not in use.  Kiosk and signage content is completely customizable and can be easily updated using the RockDaisy report designer toolkit.

Slideshow Mode

RockDaisy slideshow is a collection of reports/dashboards arranged in sequence for presenting to an audience. Unlike a PowerPoint presentation, RockDaisy slideshow is fully interactive. This means anyone can interact by clicking, drilling down, and filtering anything being presented.

Any user can create a slide show by clicking the [Slideshow] button and then choosing existing reports to add. These reports will always show the most updated information when presented in a slideshow, as they connect back to the database on refresh.

Slideshows can be clicked thru manually or configured to auto play.

Develop Custom Visuals

When creating or editing a RockDaisy dashboard, you can use many different types of visuals. The icons for these visuals appear in the Visualizations pane. These visuals come pre-packaged when you install RockDaisy.

However, you aren’t limited to this set of visuals. RockDaisy custom visuals can be created using Kendo UI and Javascript. Contact info@rockdaisy.com for more information