Apply Custom Logos and Dashboard Styles

About Custom Logo and Dashboard Styles

As an administrator you can customize your reporting environment by creating a theme that displays custom logo, branding text, page style and so on.

When working with themes, note the following:

You can create multiple themes, but only one theme can be active at one time.
If you deactivate a theme, you revert to the default Oracle theme, unless you select a different one.
Themes are applied on pages with analyses and dashboards, but not to visualization workbooks.
You create themes in the Manage Themes area of the Administration page.
When you activate a theme, you apply it to the browser session of the currently signed-in administrator and to the browser sessions of end-users as they sign in.
If Oracle Analytics is running on multiple instances, then duplicate and activate them for each instance.

Change the Default Style for Analyses and Dashboards

Administrators create themes to change the default logo, colors, and heading styles for analyzes and dashboards.

In the Classic Home page, click the user profile icon and then click Administration.
Click Manage Themes.
To apply an existing dashboard style, select one from the Theme list, click Active, then click Save.
To create a new dashboard style, in the Theme list, click New Theme to display the New Theme dialog.
In Theme Name, the name that you specify here is displayed in the Style list on the Dashboard Properties dialog.
In Logo, specify the page logo that you want displayed in the top left hand corner. To replace the default Oracle logo, click Select Logo and navigate to and select a different logo in PNG, JPG, or JPEG format. Logos can't exceed 136 pixels in width by 28 pixels in height.
In Header Title, specify the branding information that you want displayed in the top left hand corner next to the logo.
In Active, click to apply the currently displayed theme when you click Save. If you click Active, then click Back without saving changes, the new theme isn’t applied.

This diagram shows you what theme options affect different areas of the reporting environment.

Description of custom_logo_and_styles_new.png follows
Description of the illustration custom_logo_and_styles_new.png

Manage Themes

Administrators manage themes to change the default logo, colors, and heading styles for reporting pages, dashboards, and analyses.

In the Classic Home page, click the user profile icon and then click Administration.
Click Manage Themes.
Optional: To apply a previously created theme, select the theme you want from the Theme list, click Active, then click Save, then click Back.
Optional: To revert to the default Oracle theme, clear the Active option, click Save, then click Back.
Optional: To remove a theme completely, select the theme you want to remove, click Delete, then click Back.

Customize Links on the Classic Home Page

You can configure the Classic home page to display custom links. For example, you might add a link to a website showing the local weather, or a link to the Oracle Analytics home page to enable business analysts to navigate from the Classic home page to workbooks and visualizations.

In this example, links are added for "My Weather" and "Analytics Cloud Home".
Description of customlinksclassic.png follows
Description of the illustration customlinksclassic.png

To add custom links, add XML code to the Custom Links XML system setting. To access the System Settings page, go to the Oracle Analytics home page, click Navigator, then Console, then System Settings, then Analytic Content).
Description of custom-links.png follows
Description of the illustration custom-links.png

You can use XML code to specify links and attributes, including the following:

The text for the link (either a static string or a message name to use for localization).
A target URL.
Whether the target link opens in the current page or opens in a new tab or window.
The relative ordering of links in the header.
An optional icon to use with the link.

This example displays two custom links to the left of the Catalog link in the global header of the Classic home page.

<?xml version="1.0" encoding="utf-8"?>
<customLinks xmlns="com.siebel.analytics.web/customlinks/v1">
   <link id="1" name="My Weather" description="Local weather site" src="https://www.example.com/weather" target="blank" >
       <locations>
           <location name="header" insertBefore="catalog"/>
       </locations>
   </link>
   <link id="1" name="Analytics Cloud Home" description="OAC Viz Home Page" src="https://<OAC example URL>.analytics.ocp.oraclecloud.com/ui/dv/?pageid=home" target="blank" >
       <locations>
           <location name="header" insertBefore="catalog"/>
       </locations>
   </link>
</customLinks>

Note:

To obtain the link for Oracle Analytics home page, log into Oracle Analytics, copy the URL, and paste it into the src="<target link>" element (as shown in the example XML code).

This table describes the elements and attributes that you can specify for custom links.

Element or Attribute	Optional?	Data Type	Description
`link: accessibility`	Optional	Boolean	Specifies that in accessibility mode, the link is available only when the accessibility attribute is set to true. Values are true and false, and false is the default. In previous updates, the `vpat` attribute served the same purpose as the accessibility attribute. The `vpat` attribute has been deprecated.
`link: description`	Optional	String	Specifies the description of the link (not translated).
`link: iconSmall`	Optional	String	Specifies the file name of an icon to display with the link in the global header. The display of icons is controlled by the fmap syntax.
`link: id`	Required	String	Use as a unique ID that specifies the position of the link. You can include IDs for custom links to position them relative to default links.
`link: localizedDesc`	Optional	String	Specifies the message ID of the link (translated), which takes precedence over the non-translated description.
`link: localizedName`	Optional	String	Specifies the message ID of the link that's translated, which takes precedence over the non-translated name.
`link: name`	Required	String	Specifies the name of the link that isn't translated.
`link: privilege`	Optional	String	Specifies the name of privileges that a user must be granted to see the link. The privileges are indicated as an expression, as shown in the following example: `privileges.Access['Global Answers']&&` `privileges.Access['Global Delivers']`
`link: src`	Required	String	Specifies the URL for the link.
`link: target`	Optional	String	Specifies the browser window in which to open the link. The values are: self: Opens in same window in which Oracle Analytics is running. blank: Opens in a new window. any-name: Opens in a window with the specified name.
`location: insertBefore`	Optional	String	Specifies the ID of an existing link to the left of which you want to add the custom link. For example, to add a custom link to the left of the Catalog link, specifiy `<location name="header" insertBefore="catalog"/>`. Valid IDs: `admin` `catalog` `dashboard` `favorites` `help` `home` `logout` `new` `open` `user` If you make a mistake and specify an invalid ID, the link is inserted in a default location.
`location: name`	Required	String	Use this attribute if you include the locations parent element. The values are: header: Specifies to include the link in the global header.
`locations`	Optional	Not Applicable	Use as the parent element for specifying the locations of the links to add. If you don’t specify a location, then by default links are included before the Help link in the global header and at the end of the Get Started section.