Embedding Multiple Reflection for the Web Sessions in One Browser Session
Technical Note 1772
Last Reviewed 02-Jun-2011
Reflection for the Web 2011 (All Editions)
Reflection for the Web 2008 (All Editions)
This technical note describes how to embed multiple Reflection for the Web sessions in one browser session.
Note the following:
- The information in this technical note is primarily for users of Reflection for the Web 2008 R1. Beginning in Reflection for the Web 2008 R2, you can use JSP templates to embed dynamic Reflection sessions in custom web pages that you create, a more powerful and flexible means of working with embedded sessions. See Technical Note 2386 for more information.
- This embedding process works when using LDAP access control, but the user is prompted for an LDAP username and password for each Reflection for the Web session embedded in the web page.
Embedding the Sessions
Follow these steps to embed multiple Reflection sessions in one browser session.
- In a web browser, open the Reflection Links List page (that lists the available Reflection for the Web sessions):
https://<your server>:<HTTPS port number>/<management server context>/AdminStart.html
For example, if the server is www.ourcompany.com and the management server context is rweb (the default), the URL is:
Alternately, you may be able to access the links list page by clicking Start > Programs > Reflection for the Web > Administrative WebStation.
- Choose which sessions you want to embed into one web page.
Note: You can create a new terminal session to embed with an existing session. First, create the new session so it appears on the Links List.
- Confirm that each session that you want to embed is configured to display embedded in a web browser window by following these steps:
- In the Administrative WebStation, click Session Manager, and click one of the sessions you want to embed.
- On the Configure a Reflection Session page, click this radio button: Display session embedded in a web browser window.
- Click Save Settings.
- From the Links List, note the names of the terminal session you want to embed. These names will be used later to define "session name."
If the name of the terminal session contains any spaces or special characters, right-click the session's link and select "Copy URL to clipboard." This action embeds the link name in the URL listed in the Address field with the HTML indicators that denote spaces or special characters. Paste the URL into a text editor and make a note of the link name, including the special characters.
For example, a session link titled "Sales Data" is represented by red text in the following URL:
- Create an HTML page, similar to the sample below, which contains IFRAME tags to include dynamic Reflection for the Web sessions. Note: To avoid truncating the RWeb sessions, make sure that the applet size defined in the Administrative WebStation's Session Manager tool is smaller than your IFRAME size in the HTML file.
In the following sample, [session name] is the link name you noted in step 4.
Note: This sample uses the default application context of "rweb." If you are not using the default context, edit the code to match your environment.
- Save the HTML file to the <servlet runner directory>\ReflectionData\deploy directory. Depending on your platform and Reflection for the Web product, the default location is typically one of the following:
C:\Documents and Settings\All Users\Application Data\Attachmate\ReflectionServer\ReflectionData\deploy
- Access the Reflection for the Web links list page. Click the new link for the two sessions. You must use the Access Mapper to make the new session accessible to an end user.
Review the following code to see a finished example.