Action Bar Custom Web Applets

The following table describes the elements and sections in the Action bar custom Web applet XML output file.

Table Elements and Sections in the Action Bar Custom Web Applet XML File

Description Element or Section

<DisplayName> contains the name of the custom Web applet.

<data:DisplayName>My Action Bar Applet
</data:DisplayName>

<DisplayNameCurrentUserLang> contains the name of the custom Web applet in the language of the currently logged-in user.

<data:DisplayNameCurrentUserLang>
 My Action Bar Applet
</data:DisplayNameCurrentUserLang>

<Description> contains the description of the custom Web applet.

<data:Description></data:Description>

<Height> specifies the height of the custom Web applet, in pixels.

<data:Height>200</data:Height>

If the custom Web applet is a Dashboard applet, then the details appear in the <DashboardType> section, as follows:

  • <DashboardPath> contains the path to the dashboard. The dashboard must be located directly in the Dashboards folder under Shared Folders and not at a deeper level.

  • <DashboardParameters> specifies any parameters that are to be applied at runtime. If any filter parameters are present, then the syntax of those parameters is validated when you insert or update a custom Web applet of the Dashboard type. For information about specifying parameters for embedded dashboards, see Oracle CRM On Demand Online Help.

  • <AlwaysRun> determines whether the custom Web applet will be executed if the applet is minimized (true) or will not be executed if the applet is minimized (false).

<data:DashboardType>
  <data:DashboardPath>
Company Wide Shared Folder : Dashboards : Accounts Dashboard
  </data:DashboardPath>
  <data:DashboardParameters>
P0=1&amp;P1=eq&amp;P2="Account"."Account ID"&amp;P3=%%%Row_Id%%%
  </data:DashboardParameters>
  <data:AlwaysRun>false</data:AlwaysRun>
</data:DashboardType>

If the custom Web applet is an HTML applet, then the details appear in the <HTMLType> section, as follows:

  • <HTMLHeader> contains the HTML code used in an <iframe> element within the HTML header of the page to which the custom Web applet is added.

  • <HTMLBody> contains the HTML code used in an <iframe> element within the HTML body of the page to which the custom Web applet is added.

  • <AlwaysRun> determines whether the custom Web applet will be executed if the applet is minimized (true) or will not be executed if the applet is minimized (false).

<data:HTMLType>
  <data:HTMLHeader></data:HTMLHeader>
  <data:HTMLBody></data:HTMLBody>
  <data:AlwaysRun>false</data:AlwaysRun>
</data:HTMLType>

If the custom Web applet is a Report applet, then the details appear in the <ReportType> section, as follows:

  • <ReportPath> contains the path to the analysis. The analysis must be located under Shared Folders.

  • <ReportParameters> specifies any parameters that are to be applied at runtime. If any filter parameters are present, then the syntax of those parameters is validated when you insert or update a custom Web applet of the Report type. For information about specifying parameters for embedded analyses, see Oracle CRM On Demand Online Help.

  • <RefreshLink> determines whether the Refresh link that allows users to refresh the data in the analysis is displayed at runtime (true) or is not displayed (false).

  • <PrintLink> determines whether the Print link that allows users to print the analysis is displayed at runtime (true) or is not displayed (false).

  • <ExportLink> determines whether the Export link that allows users to download the analysis is displayed at runtime (true) or is not displayed (false).

    Note: Displaying prompts for an analysis is not supported for Report applets in the Action bar, therefore the <ReportPrompts> element is not applicable for a Report applet in the Action bar.
  • <AlwaysRun> determines whether the custom Web applet will be executed if the applet is minimized (true) or will not be executed if the applet is minimized (false).

<data:ReportType>
  <data:ReportPath>
Company Wide Shared Folder : My Company Account Custom Analyses : Account Custom Analysis
  </data:ReportPath>
  <data:ReportParameters>
P0=1&amp;P1=eq&amp;P2="Account"."Account ID"&amp;P3=%%%Row_Id%%%
  </data:ReportParameters>
  <data:RefreshLink>true</data:RefreshLink>
  <data:PrintLink>true</data:PrintLink>
  <data:ExportLink>true</data:ExportLink>
  <data:AlwaysRun>false</data:AlwaysRun>
</data:ReportType> 

If the custom Web applet is an RSS feed applet, then the details appear in the <FeedType> section, as follows:

  • <URL> contains the URL that is invoked when the user clicks the hyperlink.

  • <OverrideURLFlag> determines whether the user can override the URL (true) or the user cannot override the URL (false).

  • <TargetWindow> specifies the window in which the custom Web applet opens. The valid values are as follows:

  • Current Window. The custom Web applet opens in the current window.

  • New Window. The custom Web applet opens in a new window.

<data:FeedType>
  <data:URL></data:URL> 
  <data:OverrideURLFlag>false</data:OverrideURLFlag>
  <data:TargetWindow>New Window
  </data:TargetWindow>
</data:FeedType>

If the custom Web applet is a URL applet, then the details appear in the <URLType> section, as follows:

  • <URL> contains the URL that is invoked when the user clicks the hyperlink.

  • <AlwaysRun> determines whether the custom Web applet will be executed if the applet is minimized (true) or will not be executed if the applet is minimized (false).

Note: Although it is possible to update or insert a custom Web applet of the URL type that contains a URL for an analysis or dashboard, this functionality is not fully supported, and the URL might not work after an upgrade.
<data:URLType>
  <data:URL>http://www.oracle.com</data:URL>
  <data:AlwaysRun>false</data:AlwaysRun>
</data:URLType>

The <ListOfTranslation> section contains the translation values for the custom Web applet.

<data:ListOfTranslation>
. . .
</data:ListOfTranslation>

The <Translation> section contains the translation values for one language:

<data:ListOfTranslation>
  <data:Translation>
    <data:LanguageCode>ENU</data:LanguageCode>
    <data:DisplayName>My Action Bar Applet
    </data:DisplayName>
  </data:Translation>
. . .
</data:ListOfTranslation>