Setting Up Web Links
A Web link is a custom field that allows you to place a hyperlink to an external Web site or Web-based application in a record in Oracle CRM On Demand. You can use a Web link custom field to provide a convenient way for users to navigate to another Web page, including another page in Oracle CRM On Demand. You can create Web link custom fields for any record type. For example, you might define a Web link field for the account record type that updates the account details with values from another application. As with other custom fields, you must add Web Link fields to your record page layouts to make them visible to your users.
You can configure a Web link to simply open another Web site. You can also configure the Web link to pass specific information from the Oracle CRM On Demand record as a parameter in the URL. For example, you might create a Web link field to pass address information from an account record to a Web site that provides address-specific maps. Then, when the user clicks the Web link on the account record, a map for your account location is opened.
You can configure the Web link to appear only in certain circumstances. For example, you can specify the conditions that must be met before the Web link is displayed, and you can configure the link to appear only on the Detail pages to prevent users from clicking the link from the Edit pages.
NOTE: The contents of the Web link fields cannot be carried over to the new records when a lead is converted.
Before you begin. To configure Web Link fields, you must be familiar with the syntax of the target URL.
To set up the Web link
- In the upper-right corner of any page, click the Admin global link.
- In the Application Customization section, click the Application Customization link.
- In the Record Types Setup section, click the link for the required record type.
- In the Field Management section, click record type Field Setup.
- If the Web link field does not already exist, create a custom Web link field as described in Creating and Editing Fields.
- On the Fields page, click the Edit Web Link link for the custom field.
- On the Edit Web Link page, fill in the Window Properties:
- For Display Text, enter the label (display name) for the hyperlink, which the user sees in the layout.
Example: Click Here for Stock Ticker (underlined).
You can also include context-sensitive parameters in the Display Text field by placing the cursor in the Display Text field, and then selecting the User Fields or (Record Type) Fields list. A field parameter is placed in the Display Text field (designated by %%%fieldname%%%), which is replaced by the field value based on the current record.
NOTE: If your display text is too long to fit in the layout, it will be concatenated. Also, the information for any variables is added at run time.
- Select how you want Oracle CRM On Demand to behave when a user clicks the hyperlink:
- Open in Current window. Opens the hyperlinked page in the current window, replacing the current Oracle CRM On Demand session.
- Open in Custom Web Tab. Opens the hyperlinked page in a custom Web tab. Select the required Web tab from the Target Custom Web Tab list.
- Open in New window. Opens the hyperlinked page in a new window, leaving the current Oracle CRM On Demand window unchanged. Select the Parent Window Refresh check box if you want to refresh the parent window after the user closes the new window.
- For Display Options, select Detail Page, Edit Page, or Both, depending on whether you want the Web link to appear on Detail pages only, Edit pages only, or both Detail and Edit pages.
- Fill in the Link Properties:
- For Active Link Condition, enter an expression for a condition that controls whether the Web link is active on the Detail and Edit pages. You can click the fx icon next to the Active Link Condition field to open the Expression Builder window in which you can enter an expression. For information about the syntax that you can use for expressions, see Expression Builder.
For example, if you enter an expression like [Revenue] > 10000, the Web link is active only if the condition, Revenue value greater than 10000, is met.
If you do not enter an expression, the Web link is always active. If you enter an expression, and the condition is not met, the Web link is still displayed, but it is not active.
- For Display Link Condition, enter an expression for a condition that controls whether the Web link is visible on the Detail and Edit pages.
For example, if you enter an expression like [Revenue] > 10000, the Web link is displayed only if the condition, Revenue value greater than 10000, is met.
If you do not enter an expression, the Web link is always displayed.
The following applies to the expressions in the Display Link Condition, and Active Link Condition fields.
- New page. The visible and active expressions are not evaluated for new pages. They are set to TRUE by default. The only way to disable the link is to make the expression explicitly FALSE.
- Edit page. The visible and active expressions are set to TRUE by default. However, you can use the Expression Builder to add a new expression.
- For Url, enter the URL that is invoked when the user clicks the hyperlink, such as www.oracle.com.
NOTE: You can also include context-sensitive parameters by placing the cursor in the URL field, and then selecting the User Fields or (Record Type) Fields list. A field parameter is placed in the URL (designated by %%%fieldname%%%), which is replaced by the field value based on the current record when the user clicks the value.
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 when they click the Web link.
- For User fields, select an option from the User Fields list to add user parameter fields to the URL field or Display Text field at the current position of the cursor.
For example, if you choose User id from the list, %%%User id%%% is inserted into either the URL or the Display Text, depending on where your cursor is positioned. At run time, this parameter is replaced with the user ID of the user who is logged in.
- For record type fields, place your cursor in the URL or Display Text field where you want to add a parameter, and then select the field that you want to include from the list.
For example, if you select the field Row id, %%%Row id%%% is inserted into either the URL or the Display Text, depending on where your cursor is positioned. At run time, this parameter is replaced with the row ID of the current record.
NOTE: A placeholder for the name of a record type is indicated by the words, record type, in italics. For example, record type refers to the record type where you add the Web link custom field. For example, if you are editing a Web link for a contact record, this field appears as the Contacts Fields list.
- Click Save.
- Add the Web link field to the record type page layout, as described in Customizing Static Page Layouts.