Print      Open PDF Version of Online Help


Previous Topic

Next Topic

Creating RSS Feed Web Applets

Create this type of applet for RSS feeds that you want to embed in the application. Configure RSS feed applets so that embedded content is relevant to user roles.

You can allow users to configure RSS feed applets, but it is recommended that you make only a small number of applets configurable. If you add an RSS feed applet to the Action bar, and make the records available in a custom Web tab, users can read the feeds more easily, because they do not have to navigate to a different page.

NOTE: For information about the considerations that apply to using customized code in Oracle CRM On Demand, see Important Considerations for Customers Using Customized Code in Oracle CRM On Demand.

To create an RSS feed applet

NOTE: This is the final step in creating a Web applet, as described in the topics: Creating Web Applets for Record Types and Creating Global Web Applets.

On the Web Applet page, complete the following fields, and click Save.

Field

Comments

Type

Select Feed.

User and System Fields

 

Before you create a Web applet in Oracle CRM On Demand, carefully consider how you will use parameter field variables such as %%%User Id%%%, if the field contains characters that can be escaped as character entity references.

When you insert parameter field variables in HTML, characters in the field name like & are escaped as the corresponding character entity reference, (in this case &) and the browser expands the entity reference so that the referenced character is displayed. For example, you might want to create a homepage HTML Web applet with the company name: A&B Manufacturing. From the User and System Fields drop-down list, you can choose Company Name to insert the variable: %%%Company name%%% and at run time, this variable has the value A&B Manufacturing, which appears in the browser as A&B Manufacturing. However, character entity references are not expanded in JavaScript code, so in this case, put the variable in a referenceable context, retrieve it from the document DOM, then encode it as necessary. These differences are illustrated in the following example of Web Applet HTML code:

<span id=”companyname” style=”display:none” data-value=”%%%Company name%%%”></span>

<script type=”text/javascript”>

var var1 = ”%%%Company name%%%”;

var var2 = document.getElementById(“companyname”).getAttribute(“data-value”);

</script>

The value of var1 is “A&#38;B Manufacturing” and the value of var2 is “A&B Manufacturing”. The values of var1 and var2 are different because the browser expands entity references in HTML tags and data, but not within the <script> element.

Select an option from the User and System Fields drop-down list to add parameter fields to the URL field at the current position of the cursor.

For example, if you choose User id from the drop-down list, %%%User id%%% is inserted. At run time, this parameter is replaced with the user ID of the user who is signed in.

As another example, if you choose Host Name from the list, %%%Hostname%%% is inserted at the cursor position. At run-time, this parameter is replaced with the host name of the server where Oracle CRM On Demand is running. This is useful in configurations containing a URL to Oracle CRM On Demand as it is no longer necessary to manually modify the Oracle CRM On Demand host name when migrating from one environment to another.

For more information, see User and System Fields.

Record Type Fields

NOTE: This field is applicable only when the Location value is Detail Page.

Place your cursor in the URL field where you want to add a parameter, and then select the field that you want to include from the drop-down list.

For example, if you select the field Row id, %%%Row id%%% is inserted. At run-time, this parameter is replaced with the row ID of the current record.

Functions

Select EncodeURL from the picklist if your Oracle CRM On Demand URL requires further encoding to display it correctly.

URL

Enter the URL that is invoked when the user clicks the hyperlink, such as http://rss.news.yahoo.com/topstories.

You must include http:// in the URL. Make sure that the URL is a valid uniform resource identifier (URI). If it is not valid, then an error message is displayed instead of the embedded content when a user accesses the custom Web applet.

NOTE: For more information on the standardization of URLs in Oracle CRM On Demand, see About URL Standardization.

You can also include context-sensitive parameters in this field by placing the cursor in the URL field, and then selecting the User and System Fields drop-down list. This action places a field parameter in the URL (designated by %%%fieldname%%%), which is replaced by the field value, based on the current record when the applet calls the source URL.

If you do not specify any URL, the user is directed to a void URL when clicking the link.

NOTE: Each browser has a maximum URL length. If you specify a URL that exceeds this length, users might see indeterminate behavior on the browser.

Let users override URL

Configure RSS feed applets for content that is relevant to user roles. While you can enable users to configure RSS feed applets, it is recommended that you make only a small number of applets configurable.

Open Records in

Select a value depending on whether you want records to open in the current browser window or a new browser window. If you want to add the RSS feed applet to the Action Bar, remember that the feeds are easier to read in a new browser window. In doing this, it prevents the user needing to navigate to a different page.

Height

 

The height of the applet in pixels.

Modern Icon

Click the magnifying glass icon to select an icon for your Web applet.


Published 1/9/2017 Copyright © 2005, 2017, Oracle. All rights reserved. Legal Notices.