Siebel Portal Framework Guide > Integrating External Content > Portal Agent Administration >

Defining Symbolic URLs

You use the Symbolic URL Administration view to specify how the HTTP request to the external application should be constructed and to define any arguments and values to be sent as part of the request.

To define a Symbolic URL

1. Navigate to Site Map > Administration - Integration > WI Symbolic URL List.
2. From the drop-down menu, select Symbolic URL Administration.
3. In the Symbolic URL Administration list view, enter a new record.

   Some fields are defined in the following table:

   Field	Description
   URL	Use the URL field to enter a URL for the external application. A best practice is to substitute the host's Virtual Name, the one that you defined in the Host Administration view, for the host's actual name. Doing this makes administering host names easier, because you may have many symbolic URLs pointing to one host. If the host name changes, you only need to change it in the Host Administration applet rather than having to change it in several Symbolic URL definitions. For example, https://Virtual_Host/path... For applications that use form-base authentication, the URL is identified by the action attribute of the Form tag. See Determining the Login Requirements for more information.
   Host Name	The Virtual Name of the host defined in the Host Administration view.
   Fixup Name	Name of the fixup type defined in the Fixup Administration view. The fixup type defines how links embedded in the external HTML content are rendered. For example: Default. Use this fixup type with the IFrame disposition type. Link fixup is inside the view. This fixup does not affect any of the links. The links (relative or absolute) remain as they are with the content being passed back in its original form. InsideApplet. This fixup converts all of the relative links to absolute links and any links using a host defined in the Host Administration view are proxied in order to maintain SWE context. OutsideApplication. This fixup converts all of the relative links to absolute links using the host and path of the parent URL. No links are proxied.
   Multivalue Treatment	Determines how arguments are handled. Possible values are: Comma Separated. Instructs SWE to insert a comma between the values defined in the Symbolic URL arguments when appending the arguments to the URL. It inserts a comma after the value in the first Argument Value field and the first value in the second Argument Value field. The second Argument Value field is simply a text string entered by the user. Separate Arguments. Instructs SWE to enter separate arguments for each value defined in the two Argument Value fields. Use First Record Only. Uses the first record in the current record set.
   SSO Disposition	The value selected in this field determines how the HTTP request is constructed and sent and how the external content is rendered in the user interface. Possible values are: Inline. Proxies the request through the Siebel Server and displays content inline with other applets on a view. IFrame. Uses the <iframe> tag to display content inline with other applets on a view. Web Control. Uses an ActiveX control to display content inline with other applets on a view. Browsers displaying symbolic URLs of type Web Control must be set to handle ActiveX controls. For more information about browser security settings, see Siebel Security Guide. Form Redirect. SWE constructs a form which it sends back to the browser, which the browser then sends to the external host. The content received is displayed in a new window. Server Redirect. SWE sends the browser a 302 Response with the value of the external host's URL in the header. The browser is redirected to the external host. The content received is displayed in a new window. Note that for Server Redirect there is a required Symbolic URL argument. See Portal Agent Restrictions for a description. See Understanding Portal Agents for detailed descriptions of each Disposition Type.
   Web Application Name	Associates a Web Application with this Symbolic URL. For more information about Web Applications, see Defining Web Applications.