Specifying a hyperlink in a PDF document
The context string in which a job runs is not available in the background job that generates a PDF document. To specify a hyperlink, such as a drill-through hyperlink, containing the appropriate Information Console context string in a PDF document, the administrator must specify the Information Console URL prefix by performing one of the following tasks:
In Configuration Console, update the setting for Information Console URL prefix in Volumes
➛Properties.
In acserverconfig.xml, manually edit the setting for IPortalURLPrefix.
How to update the setting for Information Console URL prefix
1 Open Configuration Console. Choose Advanced view.
2 In Advanced view, navigate to Volumes➛Properties.
3 In Information Console URL prefix, type the context string, as shown in
Figure 2‑27. For example, type:
http://urup:8900/iportal
4 Choose OK.
Configuration Console updates the setting for the system variable, IPortalURLPrefix, in acserverconfig.xml in AC_DATA_HOME\config\iHub2.
Figure 2‑27 Specifying Information Console URL prefix
How to manually edit the setting for IPortalURLPrefix
1 In Windows Explorer, navigate to AC_DATA_HOME\config\iHub2.
2 Open acserverconfig.xml in a text editor.
3 In acserverconfig.xml, edit the <Volume> setting, IPortalURLprefix, to contain the appropriate Information Console context string, as shown in
Listing 2‑1. For example, type:
IPortalURLPrefix="http://urup:8900/iportal"
4 Save the file.
Listing 2‑1 shows an example of an edited setting for IPortalURLprefix in acserverconfig.xml.
Listing 2‑1 Creating a .bat file to point iHub to portserv.exe
<Volumes>
<Volume
Name="urup"
EmailURLType="IPortal"
RSSESOAPPort="8900"
PrimaryServer="$$ServerName$$"
IPortalURLPrefix="http://urup:8900/iportal"
It is not necessary to restart iHub after changing the setting for IPortalURLPrefix. In AC_SERVER_HOME/etc, acmetadescription.xml specifies that any change to IPortalURLPrefix takes effect immediately, as shown in the following code excerpt:
<Variable
Name="IPortalURLPrefix"
Type="String"
Access="Public"
Required="False"
DisplayName="IPortal URL Prefix"
TakesEffect="Immediate"/>
