Like what you see? Have a play with our trial version.

Error rendering macro 'rw-search'

null

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

You can perform different tasks when redirecting a user to Yellowfin, such as suppressing the header, navigating to a particular report, displaying a particular dashboard, etc. This is done by defining user session options in the login token.

 


Session options can be passed in two ways:

  1. As part of a URL
  2. As part of a SSO call

...


Passing Session Options via URL

...

By including entry=TIMELINE and the disableheader session options in the above URL, the user will be taken to their Timeline page with the Yellowfin header disabled when they log in. 


Passing Session Options as Part of a SSO Call

...

Similarly, this example will disable the Yellowfin header, and redirect the user to their Timeline page. 


Available Session Options

...

Parameter KeyURL KeyDescription

YFTOOLBAR

yftoolbar

TRUE/FALSE. To hide the Yellowfin toolbar for this session.

ENTRY

entry

Determine the user's only entry point on completion of the login process. This is used in conjunction with other parameters to determine the content the user is shown. Possible values include:

  • DASHBOARD
  • REPORTLIST
  • BROWSE
  • BROWSETAB
  • CREATEREPORT
  • EDITREPORT
  • VIEWREPORT
  • VIEWSTORY
  • ADMINISTRATION
  • EDITDASHBOARD
  • VIEWDASHBOARD
  • VIEWSTORYBOARD
  • TIMELINE

REPORTID

reportid

Used with ENTRY = EDITREPORT or VIEWREPORT. This is the internal ID of the report to redirect to.

REPORTUUID

reportuuid

Used with ENTRY = EDITREPORT or VIEWREPORT. This is the UUID of the report to redirect to.

STORYBOARDUUID

storyboarduuid

Used with ENTRY = VIEWSTORYBOARD. This is the UUID of the storyboard to redirect to.

CONTENTUUIDcontentuuid

This is the internal UUID of the Yellowfin content that you wish to be redirect to. If used with ENTRY = VIEWSTORY, it serves as the internal Story UUID.

MOBILEDEVICE

mobiledevice

TRUE/FALSE. Takes the user to a mobile version of the Yellowfin interface.

REPORTNAME

reportname

Used with ENTRY = EDITREPORT or VIEWREPORT. This is the name of the report to redirect to.

DISABLESOURCEFILTERS 


TRUE/FALSE. Disables Source Filter or Client Reference Filters for this user, for this session. This allows the user to see all the data. This doesn't work for content based on Client Source Substitution.

DISABLEHEADER

disableheader

TRUE/FALSE. Hides the Yellowfin header for this session.

HIDEHEADER

hideheader

Same as DISABLEHEADER.

DISABLEFOOTER

disablefooter

TRUE/FALSE. Hides the Yellowfin footer for this session.

HIDEFOOTER

hidefooter

Same as DISABLEFOOTER.

DISABLESIDENAV

disablesidenav

TRUE/FALSE. Hides the Yellowfin side navigation for this session.

HIDESIDENAV

hidesidenav

Same as DISABLESIDENAV.

DISABLELOGOFF

disablelogoff

TRUE/FALSE. Hides the Yellowfin logoff link for this session.

HIDELOGOFF

hidelogoff

Same as DISABLELOGOFF.

REASONCODE

reasoncode

Custom string (80 ASCII characters) that will be dropped in all events generated by this session. Events are dropped in the Event table in the Yellowfin database.
This option can also be used with the JavaScript API.

REASONDESCRIPTION

reasondescription

Custom string (2048 ASCII characters) that will be dropped in all events generated by this session. Events are dropped in the Event table in the Yellowfin database.
This option can also be used with the JavaScript API.

DASHBOARDID

dashboardid

Used with ENTRY = EDITDASHBOARD or VIEWDASHBOARD. This is the internal ID of the dashboard tab to redirect to.

DASHBOARDUUID

dashboarduuid

Used with ENTRY = EDITDASHBOARD or VIEWDASHBOARD. This is the UUID of the dashboard tab to redirect to.

FILTER<ID>

filter<ID>

Used with ENTRY = VIEWREPORT. Overrides filter values for the given report. FILTER is appended to the internal ID of the filter, plus the string representation of the filter value. For example:

FILTER2134=MALE

You can pass multiple filters for a single report.

FILTERUUID<UUID>

filteruuid<UUID>

Used with ENTRY = VIEWDASHBOARD. Overrides filter values for the given dashboard.
FILTERUUID is prepended to the universal ID (UUID) of the filter, along with the string representation of the filter value. For example:

FILTERUUID653d1be5-9bfd-473c-b1a8-9924b6c8be08=Female

You can pass multiple filters to a single dashboard.

SOURCEFILTER_<FILTERCODE> 


Overrides the source filter values for this user, for this session.
SOURCEFILTER_ is appended with the Filter Type Code from the Source Filter setup page, plus the value you wish to give access to. For example:
SOURCEFILTER_COUNTRY=AU
You can pass multiple source filter values for the one session.
This option can also be used with the JavaScript API.

CONTENT_<INCLUDE/EXCLUDE>

 


Overrides the content access that a user has for this session.

CONTENT_ is appended with either INCLUDE or EXCLUDE. The value for this key is either the Content Category Code, or the Content Category UUID.

  • If you choose to INCLUDE content, then these will be the only Content Categories that the user will have access to.
  • If you choose to EXCLUDE content, then these excluded Content Categories will be removed from the content that the user normally has access to.

Content Inclusion and Exclusion is based on the Category level. All sub categories with the specified category are included or excluded.
An example of including/excluding with category codes and UUIDs:
CONTENT_INCLUDE=TUTORIAL
CONTENT_INCLUDE=c83357db-8aef-4ec7-ab72-fce34de9ee77
CONTENT_EXCLUDE=TUTORIAL
CONTENT_EXCLUDE=c83357db-8aef-4ec7-ab72-fce34de9ee77
It is not logical to use both INCLUDE and EXCLUDE for the same session.
This option can also be used with the JavaScript API.

LANGUAGE=<LANGUAGE_CODE>


Info

Not applicable


Overrides the language of the user's session with the one specified in this parameter. Note that doing so will invalidate the default language or any translation settings configured in the browser.

For example, passing LANGUAGE=JA will force the session's language to be Japanese.

 

 

 

 

...