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

Defining Symbolic URLs

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

This task is a step in Process of Creating Portal Agents.

To define a symbolic URL

  1. Navigate to the Administration - Integration screen, and then 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 of the fields are defined in the following table:



    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 might have many symbolic URLs pointing to one host. If the host name changes, then 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...

    NOTE:  Use the Secure Sockets Layer protocol (SSL) with symbolic URLs to ensure that communication is secure. For more information about using SSL, see Siebel Security Guide.

    For applications that use form-base authentication, the URL is identified by the action attribute of the <form> tag. For more information, see Determining the Login Requirements.

    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. For more information, see Portal Agent Restrictions.

    For detailed descriptions of each disposition type, see About Portal Agents.

    Web Application Name

    Associates a Web application with this symbolic URL. For more information about Web applications, see Defining Web Applications.

Siebel Portal Framework Guide Copyright © 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices.