# <render:windowUrl> Tag

This tag lets you create links to windows based on labels and switch a window to a mode, state, or both.

You can use the <render:param> tag to append a query to the URL.

Note: If you use this tag in a JSP that is used in a struts or Java Page Flow application, in order for the URL to resolve correctly, Java Page Flow support must be enabled in the portal Web project's WEB-INF/netuix-config.xml file, as shown in the following example. Notice the <enable> element is set to true.

>     <!-- Enable or disable Pageflow support -->
>     <pageflow>
>         <enable>true</enable>
>     </pageflow>

## Syntax

<tagName attribute="value" />

## Attributes

var

Optional (String) - The variable that will contain the value of the URL.

scope

Optional (String) - This attribute has three primary variations:

PAGE SCOPE - (This is the default) The named reference remains available in this PageContext until the return from the current Servlet.service() invocation.
REQUEST SCOPE - The named reference remains available from the ServletRequest associated with the Servlet that until the current request is completed.

SESSION SCOPE - (Valid only if this page participates in a session). The named reference remains available from the HttpSession (if any) associated with the Servlet until the HttpSession is invalidated.

scheme

Optional (String) - The protocol for the URL. Should be "http" or "https". If you do not use this attribute, the protocol used to make the current request is used.

domain

Optional (String) - Sets the domain of the server to access, such as www.bea.com. If you do not use this attribute, the domain that was used to make the current request is used.

port

Optional (String) - Sets the server port to use for the domain. If you do not use this attribute, the port that was used to make the current request is used.

encodeSession

Optional (boolean) - Enables URL rewriting for enconding a session ID in the URL. If the value is set to "false," the URL is not encoded with the session ID. If you do not use this attribute, the default value is "true."

windowLabel

Required (String) - Sets the window label to link to.

windowMode

Optional (String) - Sets the window mode for which to display the linked window, such as "HELP" or "EDIT."

windowState

Optional (String) - Sets the window state in which to display the linked window, such as "MAXIMIZED" or "MINIMIZED."

template

Use the template defined within url-template-config.xml when outputting the url for this tag.

## Example

This example creates a URL to a help window, stores it as a variable, and uses the variable in the link. The window will be displayed maximized.

    <%@ page import="com.bea.netuix.servlets.controls.page.PagePresentationContext,
    com.bea.netuix.servlets.controls.page.BookPresentationContext"%>
    <%@ taglib uri="render.tld" prefix="render" %>
    .
    .
    .
    <render:windowUrl var="maxhelpurl" windowLabel="helpwindow" windowState="MAXIMIZED" windowMode="HELP" />
    <a href="<%=pageContext.getAttribute("maxhelpurl")%>">Help</a>

This tag is used in the Portal Search portlet.

Related Topics

Creating URLs to Portal Resources

<render:pageUrl> Tag

<render:jspContentUrl> Tag

<render:toggleButtonUrl> Tag

<render:param> Tag

##