Get-Properties
DESCRIPTION
Creates a group from a Java property resource.
SYNTAX
<ie:webject name="Get-Properties" type="MGT">
<ie:param name="ATTRIBUTE" data="name"/>
<ie:param name="GROUP_OUT" data="group_name"/>
<ie:param name="SOURCE" data="uri_or_file_pathname"/>
</ie:webject>
PARAMETERS
|
Required
|
Select
|
Optional
|
|
|
ATTRIBUTE
|
|
|
GROUP_OUT
|
|
|
SOURCE
|
ATTRIBUTE
Specifies the names of the properties to fetch and place in the output group. If ATTRIBUTE is not specified, all of the properties from the specified SOURCE are placed in the output group. This parameter is optional.
GROUP_OUT
Specifies the name of the group to create that contains the queue identifiers of the objects in the message queue.
The GROUP_OUT contains exactly one element. Each attribute of the element represents one property name/value pair obtained from the property source. The name of the attribute is the same as the name of the corresponding property, and the value of the attribute is the same as the value of the property.
This parameter is optional.
SOURCE
Specifies the location of the properties that are returned by the Get-Properties webject. It may be specified as a relative or absolute URI:
◦ Relative URIs reference files that reside under the root file system directory that is defined for the local Info*Engine task processor
◦ Absolute URIs reference files that reside in the local file system, reside on a remote HTTP server, or are referenced through an accessible LDAP directory.
It may also be specified as a system filepath referencing a properties file such as wt.properties. The default for this optional parameter is to return the properties defined by the java.lang.System class in the GROUP_OUT.
EXAMPLE
The following Get-Properties example JSP page gets properties from a predetermined source and returns those properties in a group that you have named:
<%@page language="java" session="false"
errorPage="../IEError.jsp"%>
<%@taglib uri="http://www.ptc.com/infoengine/taglib/core"
prefix="ie"%>
<html>
<head><title>Get Properties</title></head>
<body>
<ie:webject name="Get-Properties" type="MGT">
<ie:param name="SOURCE" data="$(@FORM[]source[0])"
default=""/>
<ie:param name="GROUP_OUT" data="$(@FORM[]group_out[0])"
default=""/>
</ie:webject>
<ie:webject name="DISPLAY-TABLE" type="DSP"/>
</body>
</html>
To actually run this example, you would need to provide a form where the source and group_out variables are identified.