Wyn Enterprise: Using Integration URLs

An integration URL allows a user to embed Wyn documents, datasets, data sources, images, and other resource items available on the server database into his web application. A user can specify the URL for the Wyn resource within the IFrame of his web application. Apart from this, a user can use the integration URL directly in the web browser for accessing the respective portals without entering any login details and for customizing the viewing experience of the end-users.

This topic describes the structure of the integration URL, steps to embed a Wyn resource into a web application, and the usage of parameters for customizing the interface.

Integration URL Structure

The structure for the integration URL is as follows:

server/module/command/documentid?[dp]&[others]
  • server is the customer installed URL of the Wyn Enterprise Portal
  • module takes the following values -
    • data sources
    • datasets
    • dashboards
    • reports
    • web pages
    • templates
    • floor plans
    • images
    • themes
  • command takes the following values -
    • create - opens a new document in the designer for designing
    • view - opens the document in the document viewer
    • edit - opens the document in the designer for editing
  • documentID refers to the document identity, which is unique for every document
  • dp is the short name for document parameters which can be of 'string', 'integer', 'float', 'datetime', and 'multidimension' type. The syntax for dp is:

     &dp={"parameter 1 name":["parameter 1 value 1","parameter 1 value 2","parameter 1 value 2"],"parameter 2 name":["parameter 2 value 1","parameter 2 value 2","Parameter 2 value 3"]}`
    

    Note that:

    • Separate the parameter name and value with a colon (:). For example, dp={"Parameter1":[2000.111]}
    • Enclose the parameter name and value in double quotes (" "). For example, dp={"Parameter1":["Japan"]}.
    • Separate multiple parameters using commas (,). For example, dp={"Parameter1":[2000], "Parameter2":["Wyn Dashboard"], "Parameter3":["2020-01-01T00:00:00"]}.
  • others contains additional parameters such as:
    • token -
      it is the token id generated by the admin.
    • lng -
      it accepts the following values like en, zh, zh-tw, pl, and es.
    • theme -
      it supports values such as default, ars, blue, red, forest, dark-forest, light, warm-light, and green.
    • baseUrl -
      it is the Wyn server host, such as http://www.wyn.com or http://127.0.0.1:51980.
    • size - it can be set to fitheight, fittoheight, fitwidth, fittowidth, fitscreen, fittoscreen, and auto (when 'Fixed Size' property for the dashboard is set to 'true', the key would be ineffective).
    • toolbar -
      it controls the visibility of the toolbar on preview; it can be set to auto, hide, and show.
    • hideActions -
      set it to 'true' to hide the interface options that appears on clicking the More button or are available in the Workspace toolbar.
      The supported hide actions are logout, rename, openInNewWindow, refresh, preview, delete, download, copyUrl, copyReport, copyDashboard, copyDataset, copySemanticModel, reporting:exportReport, reporting:editReport, reporting:copyAsTemplate, reporting:createReportWithTemplate, reporting:editTemplate, reporting:previewRevision, reporting:editRevision, dashboards:editDashboard, dashboards:createWith, semantic:editSemanticModel, modifyDataSource, modifyDataset, refreshDataset, modifyTheme, batchCheckBox, reconfigDataSource, appendData, and modifyFloorPlan.
    • hideavatarmenu -
      set it to 'true' to hide the Avatar menu displayed on the bottom-left corner of the portal.
    • hidewelcomescreen -
      set it to 'true' to hide the Welcome screen when integrating the Document portal.
    • hidenav -
      set it to 'true' to hide the Navigation menu on the left of the Document and Resource portals.
    • scenario -
      it is the name of the dashboard scenario (case sensitive). This parameter is only valid for dashboards.
    • lite -
      it specifies the dashboard viewer mode as standard or lite (when set to 'true' it enables the lite viewer mode and 'False' enables the standard viewer mode). This parameter is only valid for dashboards.
    • loadChart -
      it controls the load animation effect when a chart is initially loaded in the Viewer. This effect can also be seen when you forcibly reload a chart or refresh the data while previewing the report. Set it to 'true' to enable the load animation effect, and 'False' to disable the load animation effect. This parameter is only valid for reports.
    • hoverChart -
      it controls the hover effect on charts on mouse hover. Set it to 'true' to enable the hover effect, and 'False' to disable the hover effect. This parameter is only valid for reports.
    • hoverTable -
      it controls the hover effect on table and tablix rows on mouse hover. Set it to 'true' to enable the hover effect, and 'False' to disable the hover effect. This parameter is only valid for reports.
    • hoverTableBackgroundColor -
      it specifies the background color on mouse hover over the table and tablix rows, and supports the following values like $theme (background color depends on the portal theme background color), $origin (background color remains unchanged), red (background color is based on the specified color value), or %2330a0a0 (background color is based on the specified hex value). This parameter is only valid for reports.:
    • hoverTableTextColor -
      It specifies the text color on mouse hover over the table and tablix rows, and supports the following values, like $theme (text color depends on the portal theme text color), $origin (text color remains unchanged), red (text color is based on the specified color value), or %2330a0a0 (background color is based on the specified hex value). This parameter is only valid for reports.
    • actions -
      a list of actions that are available to the end-users and are separated by comma (,).
    • openfulldashboardmode -
      it can have anyone value from these two values, either newwindow or redirect. This parameter is only valid for dashboards.
    • pageNumber -
      it is the page number of the resource to be displayed.
    • toolbar -
      it controls the visibility of the toolbar on preview; it can be set to auto, hide, and show.
    • hideActions -
      set it to 'true' to hide the interface options that appears on clicking the More button or are available in the Workspace toolbar.
      The supported hide actions are logout, rename, openInNewWindow, refresh, preview, delete, download, copyUrl, copyReport, copyDashboard, copyDataset, copySemanticModel, reporting:exportReport, reporting:editReport, reporting:copyAsTemplate, reporting:createReportWithTemplate, reporting:editTemplate, reporting:previewRevision, reporting:editRevision, dashboards:editDashboard, dashboards:createWith, semantic:editSemanticModel, modifyDataSource, modifyDataset, refreshDataset, modifyTheme, batchCheckBox, reconfigDataSource, appendData, and modifyFloorPlan.
    • hideavatarmenu -
      set it to 'true' to hide the Avatar menu displayed on the bottom-left corner of the portal.
    • hidewelcomescreen -
      set it to 'true' to hide the Welcome screen when integrating the Document portal.
    • hidenav -
      set it to 'true' to hide the Navigation menu on the left of the Document and Resource portals.
    • scenario -
      it is the name of the dashboard scenario (case sensitive). This parameter is only valid for dashboards.
    • lite -
      it specifies the dashboard viewer mode as standard or lite (when set to 'true' it enables the lite viewer mode and 'False' enables the standard viewer mode). This parameter is only valid for dashboards.
    • loadChart -
      it controls the load animation effect when a chart is initially loaded in the Viewer. This effect can also be seen when you forcibly reload a chart or refresh the data while previewing the report. Set it to 'true' to enable the load animation effect, and 'False' to disable the load animation effect. This parameter is only valid for reports.
    • hoverChart -
      it controls the hover effect on charts on mouse hover. Set it to 'true' to enable the hover effect, and 'False' to disable the hover effect. This parameter is only valid for reports.
    • hoverTable -
      it controls the hover effect on table and tablix rows on mouse hover. Set it to 'true' to enable the hover effect, and 'False' to disable the hover effect. This parameter is only valid for reports.
    • hoverTableBackgroundColor -
      it specifies the background color on mouse hover over the table and tablix rows, and supports the following values like $theme (background color depends on the portal theme background color), $origin (background color remains unchanged), red (background color is based on the specified color value), or %2330a0a0 (background color is based on the specified hex value). This parameter is only valid for reports.:
    • hoverTableTextColor -
      It specifies the text color on mouse hover over the table and tablix rows, and supports the following values, like $theme (text color depends on the portal theme text color), $origin (text color remains unchanged), red (text color is based on the specified color value), or %2330a0a0 (background color is based on the specified hex value). This parameter is only valid for reports.
    • actions -
      a list of actions that are available to the end-users and are separated by comma (,).
    • openfulldashboardmode -
      it can have anyone value from these two values, either newwindow or redirect. This parameter is only valid for dashboards.
    • pageNumber -
      it is the page number of the resource to be displayed.

Examples for Integration URLs

The below table lists some basic examples for integration URLs.

Module Command Integration URL
data source create http://localhost:51980/datasources/create?token={token}
view http://localhost:51980/datasources/view/{datasourceID}?token={token}
edit http://localhost:51980/datasources/edit/{datasourceID}?token={token}
dataset create http://localhost:51980/datasets/create?token={token}
view http://localhost:51980/datasets/view/{datasetID}?token={token}
edit http://localhost:51980/datasets/edit/{datasetID}?token={token}
dashboard create http://localhost:51980/dashboards/create?token={token}
view http://localhost:51980/dashboards/view/{dashboardID}?token={token}
edit http://localhost:51980/dashboards/edit/{dashboardID}?token={token}
report create http://localhost:51980/reports/create?token={token}
view http://localhost:51980/reports/view/{reportID}?token={token}
edit http://localhost:51980/reports/edit/{reportID}?token={token}
web page create http://localhost:51980/webpage/create?token={token}
view http://localhost:51980/reports/view/{webpageID}?token={token}
edit http://localhost:51980/reports/edit/{webpageID}?token={token}
floor plan create http://localhost:51980/floorPlans/create?token={token}
view http://localhost:51980/floorPlans/view/{floorplanID}?token={token}
edit http://localhost:51980/floorPlans/edit/{floorplanID}?token={token}
theme view http://localhost:51980/theme/view/{themeID}?token={token}
image view http://localhost:51980/images/view/{imageID}?token={token}

Embed using Integration URL

The following steps describe how to embed a Wyn document (or any other resource item) into a web application using the integration URL.

  1. Use the Copy URL option available in the Document (or Resource) Portal of Wyn Enterprise to extract this segment of URL, i.e. 'server/module/command/documentid'. For more information on 'Copy URL', visit this topic.

    Copy the document URL from the Document Portal

  2. Obtain the token from your Admin. The admin will generate the token from the Generate Token page of the Admin Portal.

    Get the Token

  3. Append the token to the document URL generated in step 1. This is what your resultant integration URL will look like:

    Dividing Integration URL into subparts

    You can now use this integration URL in your web application.

  4. Set the src attribute of the IFrame to the integration URL as shown.

    Embedding Wyn Using Integration URL

    You can now run your web application to see the results.

Portal Customization using Parameters

The integration URLs can be used to customize the Admin, Resource, and Document portals' interface using the following parameters.

hideActions parameter

Use hideActions parameter in the Document and Resource portals' integration URL to hide the interface options that appear on clicking the More button or are available in the Workspace toolbar.

Hide Interface Elements

The supported values are logout, rename, openInNewWindow, refresh, preview, delete, download, copyUrl, copyReport, copyDashboard, copyDataset, copySemanticModel, reporting:exportReport, reporting:editReport, reporting:copyAsTemplate, reporting:createReportWithTemplate, reporting:editTemplate, reporting:previewRevision, reporting:editRevision, dashboards:editDashboard, dashboards:createWith, semantic:editSemanticModel, modifyDataSource, modifyDataset, refreshDataset, modifyTheme, batchCheckBox, reconfigDataSource, appendData, and modifyFloorPlan.

Note:
1. You can also manage the hide actions for the integration URLs in the UI settings of the Admin Portal.
2. You can even specify multiple parameter values in the integration URL, and separate them using a comma.

Examples

Following are some common examples for 'hideActions':

  • Hide 'Filter' option:

    http://localhost:51980/integration/favorites/{documentID}?token={token}&hideActions=filter
    
  • Hide 'Preview' option:

    http://localhost:51980/categories/{categoryID}/documents/{documentID}?token={token}&hideActions=preview
    
  • Hide Report 'Editing' and 'Export' options:

    http://localhost:51980/categories/{categoryID}/documents/{documentID}?token={token}&hideActions=reporting:exportReport,reporting:editReport
    

hideavatarmenu parameter

The Avatar menu that shows the user's avatar, name, and organization can be hidden from the end-users using the hideavatarmenu parameter.

Hide Avatar Menu in the Document Portal

Examples

Following are some common examples for 'hideavatarmenu':

  • http://localhost:51980/integration/?token={token}&hideavatarmenu=true
    
  • http://localhost:51980/integration/resource/?token={token}&hideavatarmenu=true
    

hidenav parameter

The Navigation menu, Avatar menu, and Welcome screen can be hidden from the end-users using the hidenav parameter on the Document and Resource portals.

Navigation Menu in Document Portal

Examples

Following are some common examples for 'hidenav':

  • http://localhost:51980/integration/resource/?token={token}&hidenav=true
    
  • http://localhost:51980/integration/?token={token}&hidenav=true