Working with View Parameters
This applies to: Managed Dashboards, Managed Reports
View Parameters in the Symphony embed library are defined the same way they would be defined via the query string. The following example sets a view parameter to a value and then loads the embedded application.
var dundasBIUrl = 'https://placeholder.dundas-bi-url.com/';
document.addEventListener("DOMContentLoaded", function (event) {
// *****************************************************************************
// It is usually best practice to get the logon token at the server.
// Credentials should not be specified directly in script unless they should be
// freely available to users.
// *****************************************************************************
dundas.embed.logon.getLogonToken(
dundasBIUrl,
{
"accountName": "viewer",
"password": "1234",
"isWindowsLogOn": true
},
function(getLogOnTokenResultData) {
var dundasApp = dundas.embed.create(
document.getElementById('dundasBI2'),
{
dundasBIUrl: dundasBIUrl,
controllerType: dundas.embed.ControllerType.DASHBOARD,
fileSystemId: 'f22ce55f-04cd-4207-9dd7-2cadeb44b96c',
logonTokenId: getLogOnTokenResultData.logOnToken
});
dundasApp.parameterValues = [
// The object is created by passing the name,
// and then the value formatted in the same way
// that would be defined via the query string
new dundas.embed.ParameterValue(
// The name of the view parameter
"viewParameter2",
// The value formatted to be passed in the
// same way as if was passed via query string.
"!" + 25000 + "~" + dundas.embed.tokens.basic.OPEN_RANGE
)
];
dundasApp.load();
}
);
});
Note:
For more information, see Pass parameter values via query string.
Token Helpers
For convenience purposes, token helpers have been added that can be used in the values of the ParameterValue object.
Basic
dundas.embed.tokens.basic.ALLdundas.embed.tokens.basic.DEFAULTdundas.embed.tokens.basic.NO_SELECTIONdundas.embed.tokens.basic.NULLdundas.embed.tokens.basic.OPEN_RANGE
SingleDate
dundas.embed.tokens.SingleDate.BEGINNING_OF_CURRENT_DAYdundas.embed.tokens.SingleDate.BEGINNING_OF_CURRENT_MONTHdundas.embed.tokens.SingleDate.BEGINNING_OF_CURRENT_QUARTERdundas.embed.tokens.SingleDate.BEGINNING_OF_CURRENT_WEEKdundas.embed.tokens.SingleDate.BEGINNING_OF_CURRENT_YEARdundas.embed.tokens.SingleDate.END_OF_CURRENT_YEAR
DateRange
dundas.embed.tokens.DateRange.CURRENT_DAYdundas.embed.tokens.DateRange.CURRENT_MONTHdundas.embed.tokens.DateRange.CURRENT_QUARTERdundas.embed.tokens.DateRange.CURRENT_WEEKdundas.embed.tokens.DateRange.CURRENT_YEARdundas.embed.tokens.DateRange.MONTH_TO_DATEdundas.embed.tokens.DateRange.PREVIOUS_DAYdundas.embed.tokens.DateRange.PREVIOUS_MONTHdundas.embed.tokens.DateRange.PREVIOUS_QUARTERdundas.embed.tokens.DateRange.PREVIOUS_WEEKdundas.embed.tokens.DateRange.PREVIOUS_YEARdundas.embed.tokens.DateRange.QUARTER_TO_DATEdundas.embed.tokens.DateRange.TODAYdundas.embed.tokens.DateRange.YEAR_TO_DATE