CAF Html - caf_h

WARNING: This tag has been deprecated. Applets are no longer supported by many modern browsers. Consider alternatives.

A control that displays a Java applet. The control's value attribute must name the jar containing the applet, or the control's href facet must contain a Portlet URL control that names the jar containing the applet. However, if the applet uses only a single class file, the control's codebase attribute must specify the base URL for the applet's class file.

Name the applet class using the control's code attribute such as MyApplet.class. If the applet is a serialized object, name the applet using the control's object attribute.

Children

UIParameter children specify applet parameters. All other children specify content to display if browser does not support plug-ins.

A client-side script that invokes a server-side action when called by some other client-side code using an asynchronous request. This control must be contained by a standard JavaServer Faces form.

You can download an article and an accompanying code sample describing how to work with the refresh attribute of this control from the Software AG Community website:

• Article: Refreshing Multiple Controls with Async Command Controls in CAF
• Code sample: multi_refresh_sample.zip

Children

Control Parameter children are added as request parameters to the submitted form when the command is invoked.

A client-side script that invokes a server-side action on a timed interval using an asynchronous request. This control must be contained by a standard JavaServer Faces form.

You can download an article and an accompanying code sample describing how to work with the refresh attribute of this control from the Software AG Community website:

• Article: Refreshing Multiple Controls with Async Command Controls in CAF
• Code sample: multi_refresh_sample.zip

Children

Any. Control Parameter children are added as request parameters to the submitted form when the command is invoked.

An icon that exports the contents of a specified table to a syndication feed such as a RSS/Atom. You must contain the Atom Feed Icon in a Form. You must set the Form control's requireSessionToken property to false.

To provide custom content for the export, for example to provide custom feed metadata like title or last updated date, you can bind the Atom Feed Icon control's feedProvider property value to a custom com.webmethods.caf.faces.data.IContentProvider instance, or bind the Atom Feed Icon control's entriesProvider property to a separate com.webmethods.caf.faces.data.ITableContentProvider instance.

An IContentProvider designed for atom feed metadata is the com.webmethods.caf.faces.data.export.AtomFeedExportProvider class. It maps the properties of an existing IContentProvider to a custom set of feed metadata elements or attributes with each element or attribute's content specified using a binding expression.

An ITableContentProvider designed for atom entry metadata is the com.webmethods.caf.faces.data.export.AtomEntriesExportProvider class. It maps the content of an existing ITableContentProvider to a custom set of entry metadata elements or attributes with each element or attribute's content also specified using a binding expression.

The following example demonstrates the creation of an AtomFeedExportProvider and an AtomEntriesExportProvider in custom page bean methods. You bind the properties for which these methods are getters, myAtomFeedProvider and myAtomEntriesProvider to the Atom Feed Icon control's feedProvider and entriesProvider property values.

This example assumes that you have an existing table content provider for the raw table data, accessible using the getMyExistingTableContentProvider() method. The getMyAtomFeedProvider() method creates a map of property name/value pairs for the feed metadata, specifying the standard atom id, title, and author elements, and including a custom newToday property to render as an attribute because its value is a simple String value. Although the AtomFeedExportProvider allows for remapping keys from the feed's original content provider, in this example the content provider is just a static map, so there is no need to do so. The keys are generated with the AtomFeedExportProvider static createDefaultKeys() method performs an identity mapping by mapping each property to itself. You can use this static method to get the default set of keys for a dynamic content-provider, and remap just one or two custom properties, without changing the remaining properties.

The getMyAtomEntriesProvider() method maps the three standard atom entry elements, id, title, and updated, plus two custom properties, priority and priorityName to row data, using binding expressions. You must specify the name of the row variable as the third argument to the AtomEntriesExportProvider constructor. For each atom entry, the content of the entry's id element is generated from the value of the table row's projectId and id properties. The content of the entry's title element is generated from the value of the table row's title property

public IContentProvider getMyAtomFeedProvider() {
   Map feedProperties = new HashMap();
   // standard atom metadata
   feedProperties.put("id", "issues");
   feedProperties.put("title", "Issues");
   feedProperties.put("author", "DevTrack");
   // custom metadata
   feedProperties.put("newToday", getNewToday());
   MapContentProvider feed = new MapContentProvider(feedProperties);
   Map keys = AtomFeedExportProvider.createDefaultKeys(feed,"feed");
   return new AtomFeedExportProvider(feed, keys, "feed"); }
public ITableContentProvider getMyAtomEntriesProvider() {
   ITableContentProvider existingProvider =
      getMyExistingTableContentProvider();
   Map keys = new HashMap(); // standard atom metadata keys.put("id",
   createValueBinding("#{row.projectId}_#{row.id}")); keys.put("title",
   createValueBinding("#{row.title}")); keys.put("updated",
   createValueBinding("#{row.lastModifiedDate}"));
   // custom metadata
   keys.put("priority", createValueBinding("#{row.priorityValue}"));
   keys.put("priorityName", createValueBinding("#{row.priorityName}"));
   return new AtomEntriesExportProvider(existingProvider,keys, "row"); }

This example shows how you might render the atom feed. The export processing handles escaping property values, for example, the Name should be "MWS" value is escaped as Name should be "MWS"):

<?xml version="1.0" encoding="UTF-8"?>
<feed xml:base="http://mws:8585/" xml:lang="en-US"
   xmlns="http://www.w3.org/2005/Atom"
      xmlns:x="http://webmethods.com/caf/faces/data/export/atom/custom"
   x:newToday="2">
   <id>issues</id>
   <title>Issues</title>
   <updated>2007-05-22T21:18:40Z</updated>
   <author>
      <name>DevTrack</name>
   </author>
   <generator uri="http://webmethods.com/caf/faces/data/export/atom"
      version="1.0">webMethods CAF AtomExportBean</generator>
   <entry x:priority="1" x:priorityName="Critical">
      <id>higgins_123</id>
      <title>Nothing Works</title>
      <updated>2007-05-22T21:18:40Z</updated>
   </entry>
   <entry x:priority="3" x:priorityName="Medium">
      <id>higgins_ABC</id>
      <title>Name should be 'MWS'</title>
      <updated>2007-05-22T12:22:33Z</updated>
   </entry>
   <entry x:priority="4" x:priorityName="Low">
      <id>getraer_TLC</id>
      <title>I like monkey</title>
      <updated>2007-03-02T01:12:11Z</updated>
   </entry>
</feed>

To render custom properties such as the newToday feed property and the priority and priorityName entry properties as elements, you can compose their values using Map or IContentProvider objects. Use the content key to indicate if the Map property or the IContentProvider should render as the content of the custom element.

In the following example, the feed's newToday property is built out of a map with the map's content property set to a String value. The feed's newToday property renders as an element with the specified String value as the element's content.

In the following example, the entries' priority property is built out of a map, with the map's content property bound to the current table row's priorityName property, and the map's number property bound to the current table row's priorityValue property. As a result, each entry's priority property renders as an element, with the table row's priorityName property as the entry's priority element's content, and the table row's priorityValue property as the number attribute of the entry's priority element.

public IContentProvider getMyAtomFeedProvider() {
   Map feedProperties = new HashMap();
   // standard atom metadata
   feedProperties.put("id", "issues");
   feedProperties.put("title", "Issues");
   feedProperties.put("author", "DevTrack");
   // custom metadata
   Map newToday = new HashMap();
   newToday.put("content", getNewToday());
   feedProperties.put("newToday", newToday);
   MapContentProvider feed = new MapContentProvider(feedProperties);
   Map keys = AtomFeedExportProvider.createDefaultKeys(feed, "feed");
   return new AtomFeedExportProvider(feed, keys, "feed");
}
public ITableContentProvider getMyAtomEntriesProvider() {
   ITableContentProvider existingProvider =
   getMyExistingTableContentProvider();
   Map keys = new HashMap(); // standard atom metadata keys.put("id",
   createValueBinding("#{row.projectId}_#{row.id}")); keys.put("title",
   createValueBinding("#{row.title}")); keys.put("updated",
   createValueBinding("#{row.lastModifiedDate}"));
   // custom metadata
   Map priority = new HashMap();
   priority.put("content", createValueBinding("#{row.priorityName}"));
   priority.put("number", createValueBinding("#{row.priorityValue}"));
   feedProperties.put("priority", priority);
   return new AtomEntriesExportProvider(existingProvider, keys, "row");}

You could render the atom feed as follows:

<?xml version="1.0" encoding="UTF-8"?>
<feed xml:base="http://mws:8585/" xml:lang="en-US"
   xmlns="http://www.w3.org/2005/Atom"
      xmlns:x="http://webmethods.com/caf/faces/data/export/atom/custom">
      <x:newToday>2</x:newToday>
      <id>issues</id>
      <title>Issues</title>
      <updated>2007-05-22T21:18:40Z</updated>
      <author>
         <name>DevTrack</name>
      </author>
      <generator uri="http://webmethods.com/caf/faces/data/export/atom"
         version="1.0">webMethods CAF AtomExportBean</generator>
      <entry>
         <x:priority number="1">Critical</x:priority>
         <id>higgins_123</id>
         <title>Nothing Works</title>
         <updated>2007-05-22T21:18:40Z</updated>
      </entry>
      <entry>
         <x:priority number="3">Medium</x:priority>
         <id>higgins_ABC</id>
         <title>Name should be 'MWS'</title>
         <updated>2007-05-22T12:22:33Z</updated>
      </entry>
      <entry>
         <x:priority number="4">Low</x:priority>
         <id>getraer_TLC</id>
         <title>I like monkey</title>
         <updated>2007-03-02T01:12:11Z</updated>
      </entry>
</feed>


You can specify a substitute URL for the syndication feed, using this control's feedUrl property. You must manually generate the feed at that location using a servlet.

Using a Feed Reader

When a user attempts to subscribe to a feed generated in this manner, the user's feed reader first must log into My webMethods Server. The user must use a desktop-based feed reader. The user can add a Web-based feed reader when My webMethods Server is accessible outside of the corporate firewall, or when the Web-based feed reader is hosted within the same firewall as My webMethods Server. The user must also configure the feed with My webMethods Server credentials by adding username and password parameters to the feed URL. For example, if the atom feed URL was the following:

http://mws:8585/meta/default/wm_xt_fabricfolder/0000005202?export=atom

The user can add his or her username and password to the URL as in the following:

http://mws:8585/meta/default/wm_xt_fabricfolder/0000005202?export=atom&username=alice&password=alicepassword

Some feed readers also allow specifying authentication credentials directly in the user interface. To enable the feed reader to authenticate the credentials, a system administrator must set the feed�s authentication scheme to use the basic authentication scheme. For more information on setting a page's authentication scheme, see the Portlet URL Script control.

Children

Any. Children are displayed as the icon label, after the icon.

javax.faces.Parameter children are added as request parameters to the link.

com.webmethods.caf.faces.portleturl.PortletUrlScript children can hook into clientside JavaScript events such as onClick.

WARNING: This tag has been deprecated. Replace with an Attachments List control

A control that enables the user to view a list of files, and add or remove files from the list. The list of files is referenced by the control's Attachments Provider property, which must be bound to an instance of com.webmethods.caf.faces.data.attachments.IAttachmentsProvider.

The Attachments Panel also provides the following:

1. An Add Attachments user interface that enables adding multiple attachments.
2. A set of validators to limit the MIME types, file extensions, and maximum file size. You can also create validator messages, along with custom validators for the Attachments Panel control.

To enable drag-and-drop functionality, implement the Attachments List control.

Formats a table containing data in chart form rather than in a table structure.

The data comes from a javax.faces.model.DataModel object. A standard ordered collection list container such as java.util.List is automatically wrapped in an ITableContentProvider container.

The following containers are wrapped automatically:

• java.lang.Object array
• java.util.List

Each item in a table row is mapped to the chart label item or a chart data item. The chart then uses the chart label items and chart data items to render the chart according to the item values.

Specifies the legends for the chart that is displayed in the rendered chart.

This control specifies either the color legend, which is displayed next to the chart, or the column legend for a bar chart, depending on the row or column setting. You can add only a single label column.

A hidden (data-only) column for a table. The content of this hidden column can be accessed using a client-side script.

A table column that displays a scroll bar that pages the table. The best practice is to use the Scrollbar Column with an Async Table that has its clientSideCache property set to true.

A control that draws a link to sort a table by a specified column. This functionality is incorporated automatically by the header in a Standard Column header.

If you add this control to a column's header or footer, you set the column's sort property to the appropriate sort key and click the link to maintain the current form state. If you place the Column Sort Link control in a different location on a page, you must specify the control's for property. To perform form sorting the Column Sort Link control, you must place the control in a command Form.

To enable restful sorting, you must set this target table's sortParamName property to the name of the request parameter from which the target table derives its sort property. For more information, see the Table control.

Children

Any. Children are used as the link's label.

A data table column that automatically limits its content to a single line and to the specified width of the column. Like a Standard Column, the content of the column will be rendered multiple times, one for each row displayed by the table. See the Standard Column control for more information about using columns.

Children

Any.

A client-side script that invokes a server-side action when called by client-side code. This control must be contained by a standard JavaServer Faces form.

Children

Control Parameter children are added as request parameters to the submitted form when the command is invoked.

A link that invokes a server-side action when clicked. This control must be contained by a standard JavaServer Faces form.

Children

Any. Children are displayed as link label after the content of the value property. Control Parameter children are added as request parameters to the submitted form when the link is clicked.

Enables a user to drag a user interface control.

If the move property is set to true, and if the target control is successfully dragged and dropped, and the target's Handle Drop behavior sets the CAF.Draggable.current.result flag to move, the target control's HTML content is removed from the current page. Otherwise, dragging and dropping has no effect on the target control.

The Allow Drag handler is invoked every time a user tries to drag the control with the Custom Drag behavior. The handler is passed two arguments, draggable and event. The draggable argument is the target control's CAF.Draggable object. The event argument is the browser mouse event that precipitates the drag. The handler should return true if the target control is draggable and false if control is not draggable.

A custom HTML element; use UIParameter children to specify attributes.

Children

Any. UIParameter children specify the HTML element's custom attributes.

An icon that adds a row to a table or list. To update the table, you must bind the table to com.webmethods.caf.faces.data.IUpdateableTableContentProvider.. The row is added to a table when the enclosing form is posted to the server and it passes validation.

A table whose content is populated from either a javax.faces.model.DataModel object, or a com.webmethods.caf.faces.data.ITableContentProvider object. For more information, see the Async Table control.

Each item in the list is mapped to a row in the table. Columns are configured by adding column children. With a categorized table, the column with the primary sort, a sort ordinal of 1, is rendered as the category for the group of rows with the same value for the specified column. All other columns are rendered once for each row.

To demonstrate how the Categorized Table differs from a regular Table, consider the following regular Table, which is sorted first by Product, then by Quantity:

The following illustrates the same data as a Categorized Table. Rows with the same value for the Product column are displayed as a category of rows, grouped by the Product column value:

The Async Table pages and sorts using asynchronous requests. For more information, see the Async Table control.

Children

javax.faces.Column, Basic Column control

An asynchronous list box control with content that comes from a com.webmethods.caf.faces.data.ITableContentProvider object.

Standard list-like containers are wrapped automatically as an ITableContentProvider. The following containers are wrapped automatically:

• java.lang.Object array
• java.util.List
• javax.sql.rowset.CachedRowset

Each item in the data model is mapped to a row in the list. The content of the list is rendered multiple times, once for each row displayed. The difference between the async list and a regular list is that the async list pages asynchronously. See the Async Table control (caf_h\dataAsyncTable) for more information about configuring its asynchronous properties.

The suppressInputs property is deprecated, and should not be used. To restrict the controls that are submitted and processed when a control is refreshed, place the control inside of a Disjoint Form control. Only the controls in that disjoint form will be submitted and processed.

Children

Any.

A common search result tree control. Encapsulates the standard My webMethods Server search result tree look-and-feel.

You can use the Async Search Result Tree control in any generic portlet application. In Composite Application Framework, the Async Search Result Tree control is used in the Search Results portlet of a Search Bar/Search Result portlet application. A Search Results portlet can be created using the New Portlet wizard, selecting the Search Results Portlet option on the first page of the wizard. The two portlets are connected using wiring. You can wire the portlets using the lastSearchState property of the Search Bar portlet to the queryString property of the Search Results portlet.

If you generate a new Search Results portlet with Composite Application Framework, you do not have to add any preferences manually. Preferences are generated automatically for you. For more information, see information about setting preferences for the Search Results portlet in the portlet preferences description in the webMethods CAF Development Help.

When specifying the initialDepth attribute, use 0 to indicate roots only; 1 to indicate roots and children; 2 to indicate roots, children and grandchildren, etc.

Similarly, when specifying the refillDepth attribute, use 0 to indicate children only; 1 to indicate children and grandchildren; 2 to indicate children, grandchildren, and great grandchildren, etc.

Children

javax.faces.Column, Basic Column control

A table whose content is populated from either a javax.faces.model.DataModel object, or a com.webmethods.caf.faces.data.ITableContentProvider object.

The Async Table pages and sorts using asynchronous requests. When the Async Table control's clientSideCache property is set to true, the table caches rows that it has retrieved from the server until the page is refreshed, or the table or a parent of the table is refreshed. You can refresh the Async Table using the refresh() method of its client-side model. You can also use the Refresh Interval control to refresh the table on a timed basis.

You can configure the Async Table to buffer in its cache rows on either side of the visible page. When the bufferMin and bufferMax properties are set to positive integers, the table ensures that at least the bufferMin number of rows are cached on either side of the visible page.

• If the minimum number of rows is not buffered, the Async Table control retrieves the bufferMax number of rows on either side of the visible page to store in the cache.
• If the bufferChunk property is set to zero (0), the Async Table control retrieves the rows as one group.
• If the bufferChunk property is set to a positive integer, the Async Table control uses multiple asynchronous requests to retrieve the specific number of rows set in the bufferChunk property

For example, an Async Table has the following property settings:

    clientSideCache=true
    bufferMin=10
    bufferMax=100
    bufferChunk=0


In this example, the Async Table displays rows 1 through 10 of 1000. When the page is rendered initially, the Async Table displays rows 1 - 10, and buffer rows 11 - 110. If the user pages forward to rows 91 - 100, these rows are in the client-side cache, and the user can display the rows immediately without an additional request. If the user pages forward to rows 101 - 110, these rows are also in the client-side cache, and the user can see the rows immediately. However, the buffer now contains less than 10 rows on the next side of the visible page. The buffer contains zero rows, so the Async Table must request rows 111 - 210. If the user jumps to rows 991 - 1000, these rows are not in the client-side cache and neither are the previous 10 rows. This requires that the Async Table send a request for the rows 891 - 1000, displaying the last 10 rows in the table, and buffering the previous 100 rows.

In this second example, the Async Table has the following property settings:

    clientSideCache=true
    bufferMin=50
    bufferMax=50
    bufferChunk=10


In this second example, the Async Table displays rows 1 - 10 of 1000. When the page is rendered initially, the Async Table displays rows 1 - 10. As the Async Table waits for the user to do something, it makes 5 asynchronous requests, each for 10 more rows, buffering 50 rows on the next side of the cache. If the user pages forward to rows 11 - 20, these rows are available in the client-side cache and can display immediately without an additional request. However, the buffer contains less than 50 rows on the next side of the visible page. The buffer contains the next 40 rows. The Async Table must request rows 61 - 70. If the user jumps to rows 991 - 1000, these rows are not in the client-side cache. The Async Table must request rows 991 - 1000 to display the requested rows. The Async Table makes 5 more asynchronous requests, each retrieving 10 more previous rows, bringing the buffer up to 50 on the previous side of the cache.

Children

javax.faces.Column, Basic Column control

A tree populated with content from a com.webmethods.caf.faces.data.tree.ITreeContentProvider object. An ITreeContentProvider presents a flattened view of the tree, iterating over the tree structure in depth-first order. The Async Tree control differs from the standard Tree control in that the Async Tree control initially displays only a small portion of the tree and uses asynchronous requests to display other portions as a user expands nodes on the client.

LazyNodeTreeContentProvider

For large trees, use the LazyNodeTreeContentProvider, which is designed to access a tree's nodes only as needed, making it suitable for use with a data source that would normally require many queries to construct the full tree.

To use the LazyNodeTreeContentProvider, you must:

• Expose your data as a tree of com.webmethods.caf.faces.data.tree.INode objects.
• Configure your INode implementation to call the getChildren() method to confirm whether the node has children or not. If the node has children, a "+" icon is added to the node in the user interface. Lazy loading is still applied, as the method does not work recursively down the tree.

If the node has children, they are loaded when the user expands the node in the user interface. As a result, only a relatively small number of the tree nodes must load their children in a large data tree.

You can initialize the LazyNodeTreeContentProvider with a list of root nodes or with a single root node. You can configure the initial state of the LazyNodeTreeContentProvider to a certain depth by using its setOpenToDepth() method, where 0 indicates completely closed, 1 indicates show children, 2 indicates show children and grandchildren. For example:

INode root = new MyNodeImpl("my root info");
ITreeContentProvider tree = new LazyNodeTreeContentProvider(root);
tree.setOpenToDepth(1);


Columns and Rows

Just like the Table control, columns can be added to the Tree control to display content for each tree row. Table columns (including special columns, like Select Row columns) work in Trees exactly the same as they do in Tables. Additionally, special tree-specific Tree Toggle column controls enable users to expand and collapse tree rows. It is recommended that each tree include a Tree Toggle control.

You can sort columns by specifying a key in the column's sort property value. For more information, see the Standard Column control.

Asynchronous Properties

Use the Async Tree control's initialDepth, progressDelay, progressFlashOnComplete, progressMsg, refillDepth, refreshOnShow, and suppressInputs attributes to customize the tree's asynchronous behavior.

• Use the initialDepth property to set the number of tree nodes loaded the first time on the client.

  When specifying the initialDepth attribute, use 0 to indicate roots only; 1 to indicate roots and children; 2 to indicate roots, children and grandchildren, etc.

• Use the refillDepth property to determine how many levels of nodes are loaded when the user tries to expand a node, and the node's children are not available on the client.

  When specifying the refillDepth attribute, use 0 to indicate children only; 1 to indicate children and grandchildren; 2 to indicate children, grandchildren, and great grandchildren, etc.

Children

javax.faces.Column, Basic Column control

A table whose content is populated from a javax.faces.model.DataModel or a com.webmethods.caf.faces.data.ITableContentProvider object. Standard list-like containers such as java.util.List are wrapped automatically as an ITableContentProvider. The following containers are wrapped automatically:

• java.lang.Object array
• java.util.List
• javax.sql.rowset.CachedRowset

Each item in the list is mapped to a row in the table. Columns are configured by adding column children. With a categorized table, the column with the primary sort, a sort ordinal of 1, is rendered as the category for the group of rows that have the same value for that column. All other columns are rendered once for each row.

To demonstrate how a Categorized Table differs from a regular Table, consider the following regular Table, which is sorted first by Product, then by Quantity:

The following illustrates the same data as a Categorized Table. Rows with the same value for the Product column are displayed as a category of rows, grouped by the Product column value:

Children

javax.faces.Column, Standard Column control

Specifies a control that traverses a com.webmethods.caf.faces.data.ITableContentProvider object displaying the control's content for each row in the provider.

Standard list-like containers are wrapped automatically as an ITableContentProvider. The following containers are wrapped automatically:

• java.lang.Object array
• java.util.List
• javax.sql.rowset.CachedRowset

Each item in the data model is mapped to a row in the list. The content of the list is rendered multiple times, once for each row displayed. The difference between the async list and a regular list is that the async list pages asynchronously. See the Async Table control (caf_h\dataAsyncTable) for more information about configuring its asynchronous properties.

To enable restful paging, you must set the list's firstParamName property to the name of the request parameter from which the list derives its first property. For example, conider a case where the list binds the myFirst request parameter to its first property, where an example URL is /myTable?myFirst=10. Using a value binding expression, #{param.myFirst}, you would set the value of the list's firstParamName property to "myFirst". Note that to bind the value of a request parameter to the list's first property, you must manually convert the request parameter value to a primitive int (see the getMyFirst() method below). The list does not need to be contained within a Command Form to do restful paging.

To enable restful page sizing, you must set the list's rowsParamName property to the name of the request parameter from which the list derives its rows property. For example, if the list binds the myRows request parameter to its rows property, where an example URL might be /myTable?myRows=10, you would set the value of the list's rowsParamName property to "myRows". To bind the value of a request parameter to the list's rows property, you must manually convert the request parameter value to a primitive int, see the getMyRows() method below for an example. The list does not need to be contained within a Command Form to do restful paging.

// Convert "myFirst" request parameter to a primitive int.
public int getMyFirst() {
   FacesContext context = FacesContext.getCurrentInstance();
   String s = (String) context.getExternalContext().getRequestParameterMap().get("myFirst");
   if (s != null)
      return Integer.parseInt(s);
   return 0;
}

// Convert "myRows" request parameter to a primitive int.
public int getMyRows() {
   FacesContext context = FacesContext.getCurrentInstance();
   String s = (String) context.getExternalContext().getRequestParameterMap().get("myRows");
   if (s != null)
      return Integer.parseInt(s);
   return 10;
}


Children

Any.

A button that moves the selected row or rows down one row in a table or list. You must bind the table or list to a com.webmethods.caf.faces.data.IReorderableTableContentProvider. The row is added to a table when the enclosing form is posted to the server and it passes validation.

Children

Any. Children are displayed as button label after the value of the label property.

A link that moves the selected row or rows down one row in a table or list. You must bind the table or list to a com.webmethods.caf.faces.data.IReorderableTableContentProvider. The row is added to a table when the enclosing form is posted to the server and it passes validation.

Children

Any. Children are displayed as link label after the value of the label property.

An icon that moves the selected row or rows up one row in a table or list. You must bind the table or list to a com.webmethods.caf.faces.data.IReorderableTableContentProvider. The row is added to a table when the enclosing form is posted to the server and it passes validation.

A control that draws page numbers as links, such as pages 1...12 13 14 15 16 17 18 19...100, which enable a user to jump higher numbered pages or lower number pages.

When you put the Data Pages control in a table's header or footer, form paging is enabled. Click a link to maintain the current form state. If you place this control in a different location on a page, you must specify the control's for property. This control must be contained within a command Form to do "form" paging.

To enable "restful" paging, you must set this target table's firstParamName property to the name of the request parameter from which the target table derives its first property. For more information, see the Table control.

A button that removes a row from a table or list. You must bind the table or list to a com.webmethods.caf.faces.data.IUpdateableTableContentProvider. The row is removed from a table when the enclosing form is posted to the server and it passes validation.

Children

Any. Children are displayed as button label after the value of the label property.

A link that removes a row from a table or list. You must bind the table or list to a com.webmethods.caf.faces.data.IUpdateableTableContentProvider. The row is removed from a table when the enclosing form is posted to the server and it passes validation.

Children

Any. Children are displayed as link label after the value of the label property.

A search result tree control that encapsulates the My webMethods Server search result tree look-and-feel.

You can use the Search Result Tree control in any generic application. In Composite Application Framework, the Search Result Tree is used in the Search Results portlet of a Search portlet application project. The search bar and search results portlets are connected using wiring. Wire the lastSearchState property of the Search Bar portlet to the queryString property of the Search Results portlet.

Children

javax.faces.Column, Basic Column control

A check box that selects all rows or clears all selected rows in the table's visible page. You must implement the com.webmethods.caf.faces.data.ISelectableTableContentProvider interface to enable user row selection. The ISelectableTableContentProvider interface enables two states for table rows, selected or unselected. In selected state, specified rows are selected explicitly. In unselected state, all rows are implicitly selected, and only specified rows are unselected.

A link that toggles the selection mode of the containing row in a table. To enable users to select rows, the table's content provider must implement the com.webmethods.caf.faces.data.ISelectableTableContentProvider interface. This interface enables selecting rows in selected or unselected mode. In selected mode, the user must explicitly select a set of rows. In the unselected mode, all rows are implicitly selected and only specified rows are unselected.

You can disable links on a per-row basis by supplying a binding expression for the disabled property.

Children

Any. Children are displayed as a link label after the value of the label property.

A check box with four states for selecting the containing row in a tree. The four check box states are off, on, mixed-off, and mixed-on. Changing the selection state of descendant rows toggles only the mixed state of a row. For example, when all descendants of a selected row are deselected, the selected row remains selected. The user can select individual rows independent of the state of their descendants. You can disable check boxes on a per-row basis by supplying a binding expression for the disabled property.

To enable selecting rows, the tree's content provider must implement the com.webmethods.caf.faces.data.ISelectableTableContentProvide interface. The interface enables selecting rows that are in selected or unselected mode. In selected mode, specified rows are selected explicitly. In unselected mode, all rows are implicitly selected, and only specified rows are unselected. The tree's content provider might implement the com.webmethods.caf.faces.data.tree.ISelectableTreeContentProvider interface that enables the content provider to optimize mixed state calculations.

A list control with content that comes from a com.webmethods.caf.faces.data.ITableContentProvider object.

Standard list-like containers are wrapped automatically as an ITableContentProvider. The following containers are wrapped automatically:

• java.lang.Object array
• java.util.List
• javax.sql.rowset.CachedRowset

Each item in the data model is mapped to a row in the list. The content of the list is rendered multiple times, once for each row displayed. The difference between the async list and a regular list is that the async list pages asynchronously. See the Async Table control (caf_h\dataAsyncTable) for more information about configuring its asynchronous properties.

To enable restful paging, you must set the list's firstParamName property to the name of the request parameter from which the list derives its first property. For example, consider a case where the list binds the myFirst request parameter to its first property, where an example URL is /myTable?myFirst=10. Using a value binding expression, #{param.myFirst}, you would set the value of the list's firstParamName property to "myFirst". Note that to bind the value of a request parameter to the list's first property, you must manually convert the request parameter value to a primitive int (see the getMyFirst() method below). The list does not need to be contained within a Command Form to do restful paging.

To enable restful page sizing, you must set the list's rowsParamName property to the name of the request parameter from which the list derives its rows property. For example, if the list binds the myRows request parameter to its rows property, where an example URL might be /myTable?myRows=10, you would set the value of the list's rowsParamName property to "myRows". To bind the value of a request parameter to the list's rows property, you must manually convert the request parameter value to a primitive int, see the getMyRows() method below for an example. The list does not need to be contained within a Command Form to do restful paging.

// Convert "myFirst" request parameter to a primitive int.
public int getMyFirst() {
   FacesContext context = FacesContext.getCurrentInstance();
   String s = (String) context.getExternalContext().getRequestParameterMap().get("myFirst");
   if (s != null)
      return Integer.parseInt(s);
   return 0;
}

// Convert "myRows" request parameter to a primitive int.
public int getMyRows() {
   FacesContext context = FacesContext.getCurrentInstance();
   String s = (String) context.getExternalContext().getRequestParameterMap().get("myRows");
   if (s != null)
      return Integer.parseInt(s);
   return 10;
}


• The marker attribute does not apply to "ol" or "ul" types. Supported values can be a selection from the drop-down list on the Display tab in the control's Properties view, or any raw html string. Default is no marker.
• The layout attribute supported values can be selected from the drop-down list on the Display tab in the control's Properties view. Default is vertical.

Children

Any.

A list of tabs loaded with content from a com.webmethods.caf.faces.data.ITableContentProvider object. For information about data types and restful paging, see the Simple List control (caf_h\dataSimpleList).

Children

Any.

A table that displays the number of selected rows in the table.

If you drop this control into a table's header or footer, you need to do nothing else. If you place this control elsewhere on a page, you must specify the control's for property.

A special tree column that allows the user to toggle tree rows expanded and collapsed. The Tree Toggle control enables content. The tree renders the content of the column multiple times, once for each row displayed by the tree. The control's header facet automatically incorporates the functionality of the Column Sort Link control.

The control also optionally specifies the sorting behavior for the column. For more information, see the Standard Column control.

Children

Any.

Enables a user to add, remove, copy, or reorder the rows in a table by dragging the rows to perform the action.

If the Reorder attribute is set to true, the com.webmethods.caf.faces.data.IReorderableTableContentProvider interface for the target table's content provider is used to persist the new row order. The new row ordering is not sent to the server until the table's enclosing form is posted to the server after passing validation.

If the Add or Remove attributes are set to true, the target table's interface content-provider com.webmethods.caf.faces.data.IUpdateableTableContentProvider is used to persist the changes. The updated table information is not sent to the server until the table's enclosing form is posted to the server after passing validation.

If the Copy attribute is set to true and the Remove attribute is set to false, dragging a row from one table to a destination table adds a new row to the other table, without removing the original row from the first table. The destination table must have the Add attribute set to true. If the Remove attribute is set to true, the Copy attribute is ignored and dragging a row from one table to another removes the original row from the first table.

To populate the controls of a newly added row, the Drag to Move Rows behavior copies the value of controls with the same local ID from the dropped row into the new row.

For more information about adding, removing, and reordering rows, see "CAF.Table.Row.Model" in the CAF Development Help.

To customize Drag to Move Rows behavior, you can specify custom JavaScript code to execute when:

• The user starts dragging a row which initiates the allowDrag handler.
• The user drags a row over the table which initiates the allowDrop handler.
• The user drops a row on the table which initiates the handleDrop handler.

The allowDrag handler is invoked every time a user tries to drag a row in this behavior's target table. It is passed two arguments, draggable and event. The draggable argument is the dragged row's CAF.Draggable object; the event argument is the browser mouse event that precipitates the drag. The handler should return true if the row if draggable is enabled, and false if dragging is not enabled.

The allowDrop handler is invoked every time a user tries to drag a row over the Drag to Move Rows target table's boundaries. allowDrop is passed two arguments, src and dst. The src argument is the dragged HTML element, which is a container for a temporary copy of the original row element in a temporary table. The dst argument is the HTML drop-target element, which is a container for the target table. The handler should return true if the row can be dropped and false if it cannot.

If the allowDrop handler returned true or was not specified, the handleDrop handler is invoked every time a user tries to drop a row on the Drag to Move Rows behavior's target table. It is passed two arguments: src and dst. The src argument is the dragged HTML element, which is a container for a temporary copy of the original row element, into a temporary table. The dst argument is the HTML drop-target element, which is a container for the target table.

The handler should return true if it fully handled the drop, and false to allow the default handleDrop processing to execute when the dropped row is from another table. If add is allowed to create a new row and copy the values of controls with the same local ID from the original dropped row to the new row; and when the dropped row is from the same table and reorder is allowed, to move the row to its new location.

For more information, see "CAF.Draggable Class" in the CAF Development Help.

Enables the user to resize a target control by dragging the target control's edges. Changes to the size of the control are not persisted.

If the target control is a table, resizing the vertical size of the table changes the number of rows-per-page displayed by the table. Use an Async Table with the clientSideCache attribute set to true (enables lazy loading).

Displays a Flash movie (SWF file). The control's value attribute must specify the movie source, or the control's href facet must contain a Portlet Url control that specifies the movie source.

You must specify the height and width values for the SWF file in the default view.

Children

UIParameter children specify movie parameters. All other children specify content to display if the browser does not have the minimum required version of the Flash Player installed (alternate content).

Displays a message (such as validation messages) associated with a specific control with a fixed, specialized look-and-feel.

Displays the value of this control as formatted plain text. Preserves plain-text formatting (for example, newlines, tabs, and spaces).

A Google map. To use this control, you must configure the control's key property with a valid Google Maps API key. For more information, see Google Maps API Family. When registering a key, you must specify the host name and port number of the server. Use the host name and port number the user can see in the browser address bar when accessing the portlet or Web application. For example, if the user accesses the application using http://mws.example.com/, you need to use http://mws.example.com/ when registering for a key.

If the map is not rendered during the initial page load, that is, if the map is rendered only as part of an async refresh and not as part of the initial page, you must include a Google Map Key control as part of the initial page, configured with the Google Maps API key. Otherwise, you can ignore the Google Map Key control.

The center of the map is specified using the latitude and longitude property values. You can also specify the center of the map as follows:

• The map's initialAddress property, if the latitude and longitude are both set to 0. You can format the address as a natural-language address; you can concatenate multiple lines into a single line with spaces, for example, 600 108th Ave NE, Bellevue, WA 98004 USA. You can specify a two-letter ISO-3166 country code using the initialCountry property as a country/locale hint, though it is generally not needed.
• Auto-centering among the map's initial markers, if the map's latitude and longitude are both set to 0, its initialAddress is blank, and the map has markers.

You can add a variety of controls to the Google Map control:

• Use the Map Navigation Control to add map navigation controls such as a zoom control, and a map type control.
• Use Map Marker children of a Map Marker Group control to add individual markers to the map.
• Use a Dynamic Map Marker List control to add a list of markers from a dynamic data source such as an array of rows from a SQL result set or an array of items from a Web service result to the map.

Scripting

The Google Maps API is a full-featured, client-side JavaScript API, and is fully accessible for use with the CAF Google Maps controls.

To access the GMap2 object, the Google Maps API map object, associated with a Google Map control, use the map property of the control's CAF client-side model object. The following example looks up the GMap2 object of the Google Map control model with an ID of myMap, and uses the Google Maps API to zoom in one level:

var map = CAF.model("#{caf:cid("myMap")}").map;
map.zoomIn();

Client-Side Model

The CAF client-side model object for the Google Map control extends from the CAF.Input.Model object. For more information, see information about the client-side model see "Client-Side Model" in the webMethods CAF Development Help.

The value of the model object is the coordinates of the map's center in String form, for example, 37.0625;-95.67706. The following script centers a Google Map control with an ID of myMap over the city of Bellevue, Washington:

CAF.model("#{caf:cid("myMap")}")
     .setValue("37.0625;-95.677068");

The CAF.GMap.stringToGLatLng() and CAF.GMap.gLatLngToString() functions convert string coordinates to and from a GLatLng object, the Google Maps API coordinates object.

You can also use the CAF client-side model to set a map's center with a natural-language address. The following script centers a Google Map control with an ID of myMap over the city of Bellevue, Washington:

CAF.model("#{caf:cid("myMap")}")
     .setAddress("600 108th Ave NE, Bellevue, WA 98004");

You can also auto-center a map among the map's markers with the client-side model's autoCenter() method. The following script centers a Google Map control with an ID of myMap among the markers on the map:

CAF.model("#{caf:cid("myMap")}").autoCenter(true);

Pass a value of true to the autoCenter() method to automatically zoom so that all markers on the map are visible; pass a value of false or nothing to auto-center without changing the zoom level.

Script Controls

You can also use the standard Script-category controls like Return Value Script or Invoke Script to manipulate the map with the standard client-side actions, such as getValue or setValue. You can also use the custom Return Map Value Script and Invoke Map Script controls to access special map-only properties and actions, such as getLatitude or setAddress. The Return Map Coords Script control enables specifying the latitude and longitude coordinates when invoking the setValue or setCoords action.

Children

Map Navigation control, Dynamic Map Marker List control, Map Marker Group control, or Invoke Map Script control

A control that connects a standard client-side JavaScript control-model action to a parent control's (or specified for control's) client-side event. The following standard actions are available:

• raise actuates the command control specified by the control property
• setDisabled enables or disables the input control specified by the control property, based on the value of the value property or value facet; true to disable, false to enable.
• setValue sets the value of the control specified by the control property to the value of the value property or value facet.
• setVisible shows or hides the control specified by the control property, based on the value of the value property or value facet; true to show, false to hide.
• toggle shows the control specified by the control property if the control is hidden, hides the control specified by the control property if the control is visible.

In addition, the following map-specific actions are available:

• setCoords: (map or marker) sets the map's center or the marker's location to the specified string coordinate pair, for example, "37.0625;-95.677068".
• setAddress: (map or marker) sets the map's center or the marker's location to the specified natural-language address, for example, "600 108th Ave NE Bellevue, WA 98004".
• setZoom: (map-only) sets the map's zoom level to a number between 1 (whole world) and about 20 (city block).
• setMapType: (map-only) sets the map-type to either G_NORMAL_MAP, G_SATELLITE_MAP, or G_HYBRID_MAP.
• autoCenter: (map-only) centers the map among the map's markers.
• autoZoom: (map-only) zooms the map to fit the map's markers.
• setLabel: (marker-only) sets the marker's ToolTip to the specified value.
• setDescription: (marker-only) sets the contents of the marker's information (bubble) window to the specified value.
• showInfoWindow: (marker-only) opens the marker's information (bubble) window.
• hideInfoWindow: (marker-only) closes the marker's information (bubble) window.

You can nest other script controls inside the value facet of this script control to provide a value for actions that require a value.

Children

The Control Reference control can specify multiple controls to invoke client-side model actions.

An individual marker in a Map Marker Group control. The marker's location is specified using its latitude and longitude property values or using the marker's initialAddress property when the latitude and longitude are both set to 0. You can format the address as a natural-language address with multiple lines concatenated into a single line with spaces, for example, 123 Main Street, Bellevue, WA 98004 USA. You can specify a two-letter SO-3166 country code using the initialCountry property as a country/locale hint.

You can specify the marker's icon using properties such as the icon property. Use the standard Composite Application Framework marker icons by configuring the marker's icon property with the icon name such as red, orange, or yellow. You can also use a custom icon by configuring the icon property with the URL of the icon such as http://maps.google.com/mapfiles/arrow.png. You can configure the marker's selected icon similarly using the selectedImage property.

The content of the marker is used to render the marker's information (bubble) window. A user can click a marker to display its information window, and also to select the marker, if the marker's clickable property is set to true. A user can drag the marker to a new location if the marker's draggable property is set to true.

Scripting

The Google Maps API is a full-featured, client-side JavaScript API, and is fully accessible for use with the CAF Google Maps controls. For more information, refer to Google documenation about Google Maps API.

To access the GMarker object (the Google Maps API marker object) associated with this control, use the getOverlay() method of the control's CAF client-side model object. The following example looks up the GMarker object of the Map Marker control model with an ID of "myMarker", and uses the Google Maps API to hide the marker:

var marker = CAF.model("#{caf:cid("myMarker")}")
   .getOverlay();
marker.hide();

Client-Side Model

The CAF client-side model object for this control extends from the CAF.Table.Row.Model object. For more information, see information about the client-side model in the webMethods CAF Development Help.

The object's value is the marker's ID. You can get the coordinates of the marker's location, in string form (for example, 37.0625;-95.677068) by using the getCoords() method of the client-side model. The following script gets the coordinates of the marker with an ID of "myMarker":

var coords = CAF.model("#{caf:cid("myMarker")}").getCoords();

The CAF.GMap.stringToGLatLng() and CAF.GMap.gLatLngToString() functions convert string coordinates to and from a GLatLng object (the Google Maps API coordinates object). To set the coordinates, you must change the marker model's coordinates setting using the model's setCoords() method and then update the marker group with the changed marker model using the marker group model's set() method. The following script sets the marker with an ID of "myMarker" in a marker group with an ID of "myMarkerGroup":

CAF.model("#{caf:cid("myMarkerGroup")}")
   .set(CAF.model("#{caf:cid("myMarker")}")
   .setCoords("37.0625;-95.677068"));

You can use the CAF client-side model to set a marker's location with a natural-language address. The following script sets the location of the marker with an ID of "myMap":

CAF.model("#{caf:cid("myMarkerGroup")}")
   .set(CAF.model("#{caf:cid("myMarker")}")
   .setAddress("600 108th Ave NE,
      Bellevue, WA 98004"));

Script Controls

You can use the standard script-type controls like Return Value Script or Invoke Script to manipulate the marker a marker with the standard client-side actions such as getValue. You can also use the custom Return Map Value Script and Invoke Map Script controls to access special map-only properties and actions such as getLatitude or setAddress. Additionally, the Return Map Coords Script control enables specifying the latitude and longitude coordinates when invoking the setValue or setCoords action.

Children

Any. Composite Application Framework renders children as the content of the marker's information, bubble, window.

A control that adds a navigation control to a Google map created using the Google Map control. The following types are supported:

• GSmallMapControl: a condensed set of buttons for navigation and zoom
• GLargeMapControl: full-size navigation and zoom buttons
• GSmallZoomControl: zoom-in and zoom-out buttons
• GScaleControl: a geographic scale indicator
• GMapTypeControl: map-type buttons
• GOverviewMapControl: a mini-map cut-out that displays a zoomed-out version of the main map view

A client-side JavaScript function that returns values to a Google Map control from client-side JavaScript control models. Typical use for this client-side JavaScript is to define value for the following script controls:

• Parameter control
• Invoke Script control
• Invoke Map Script control

The following standard actions are available:

• isDisabled: true if the control is disabled; false if the control is enabled.
• isVisible: true if the control is visible; false if the control is hidden.
• getValue: gets the control's value.

• getCoords: (map or marker) gets the map's center or the marker's location as a string coordinate pair (for example, "37.0625;-95.677068").
• getLatitude: (map or marker) gets the latitude of the map's center or the marker's location as a floating-point number (for example, 37.0625).
• getLongitude: (map or marker) gets the longitude of the map's center or the marker's location as a floating-point number (for example, -95.677068).
• getZoom: (map-only) gets the map's zoom level.
• getMapType: (map-only) gets the map-type.
• getLabel: (marker-only) gets the marker's ToolTip.
• getDescription: (marker-only) gets the contents of the marker's information (bubble) window
• isSelected: (marker-only) true if the marker is selected; false if the marker is not selected.

Children

You can use the Control Reference control to specify multiple controls to get the value of.

Includes the contents of an HTML file into the current page, as specified by the control's value attribute. The value attribute must reference an HTML file in the current Web application, relative to the web application's WebContent directory. For example, the HTML file myfile.html, located in the files subdirectory of the WebContent directory, can be referenced by specifying a value of /files/myfile.html.

If the file is in the current web application and you set the evaluate attribute to true, JSF expressions embedded in the file are evaluated on every request.

Includes an external JavaScript file in the page, as defined in the control's value attribute. Valid values include the URL of an external script file, such as http://mycompany.com/car.js, or when the value property begins with a slash(/), it can reference a JavaScript file in the current Web application, relative to the web application's WebContent directory.

For example, when the file myfile.js script located in the myfolder subdirectory of the WebContent directory, you can reference the script using the value/myfolder/myfile.js. If the script is in the current Web application and you set the evaluate attribute to true, the JSF expressions embedded in the file are evaluated on every request.

A text input control with an auto-complete popup menu. The Autocomplete Text Input control's behavior is equivalent to other single-select controls, such as a Dropdown. Selection options are defined by specifying javax.faces.SelectItem or javax.faces.SelectItems as children of this control. For more information, see the control documentation for the standard JSF controls Option and Option Group.

If the control has a single Option Group bound to a provider that implements com.webmethods.caf.faces.data.IFilterableSelectItemGroupProvider, and the provider's isFilterable() method returns a value of true, filtering the list of auto-complete values is done on the server by the provider, using the provider's filter attribute to sort and select from the collection of items returned by its getSelectItemContentProviders() method. The default ISelectItemGroupProvider, which is com.webmethods.caf.faces.data.object.DefaultSelectItemContentProvider, implements the IFilterableSelectItemGroupProvider. However, the default returns false for the isFilterable()method.

If the control is not bound to a provider that implements IFilterableSelectItemGroupProvider, then auto-completion is done only on the client, using the standard common search keyword rules such as * = wildcard, space = and, quotes = exact phrase.

You can set the default filter for this control using the filter attribute.

You can only use this control in a Form control.

Children

javax.faces.SelectItem (JSF Option control) and javax.faces.SelectItems (JSF Option Group control).

A control that inputs a calendar date range. Define the value property of the Date Range control as a com.webmethods.caf.faces.data.object.DateRange object. A Date Range object has three properties, fixedRange, relativeRange, and date. Use these attributes to specify one of the following:

• A fixed start and end date such as 2000-01-01 to 2000-02-01:
• fixedRange = A period of time in milliseconds
• relativeRange = DateRange.FIXED
• date = A start date, for a positive period of time, or an end date, for a negative period of time.
• A fixed period of time, relative to the current date such as the last thirty days:
• fixedRange = A period of time in milliseconds
• relativeRange = DateRange.FIXED
• date = Null
• A relative period time, relative to the current date such as this month:
• fixedRange = 0
• relativeRange = A period of time (an enumerated value) OR DateRange.FIXED
• date = Null

The Date Range object supports the following relativeRange property values:

• DateRange.FIXED: Not a relative-range, specified in milliseconds by fixedRange property.
• DateRange.THIS_DAY: Midnight this morning to the second before midnight tonight.
• DateRange.PREVIOUS_DAY: Midnight yesterday morning to the second before midnight last night.
• DateRange.NEXT_DAY: Midnight tomorrow morning to the second before midnight tomorrow night.
• DateRange.THIS_WEEK: Midnight on the first morning of the week such as Sunday in the US to the second before midnight on the last night of the week such as Saturday in the US.
• DateRange.PREVIOUS_WEEK: Midnight on the first morning of the previous week such as Sunday in the US to the second before midnight on the last night of the previous week such as Saturday in the US.
• DateRange.NEXT_WEEK: Midnight on the first morning of next week such as Sunday in the US to the second before midnight on the last night of next week such as Saturday in the US.
• DateRange.THIS_MONTH: Midnight on the first of the month to the second before midnight on the last night of the month such as 28th, 29th, 30th, or 31st.
• DateRange.PREVIOUS_MONTH: Midnight on the first of the previous month to the second before midnight on the last night of previous month such as 28th, 29th, 30th, or 31st.
• DateRange.NEXT_MONTH: Midnight on the first of next month to the second before midnight on the last night of next month such as 28th, 29th, 30th, or 31st.
• DateRange.THIS_YEAR: Midnight on January 1 of this year to the second before midnight on December 31 of this year.
• DateRange.PREVIOUS_YEAR: Midnight on January 1 of the previous year to the second before midnight on December 31 of the previous year.
• DateRange.NEXT_YEAR: Midnight on January 1 of next year to the second before midnight on December 31 of next year.

A Date Range object can calculate the appropriate start and end dates for its date-range, using its calculateStart() and calculateEnd() methods. For an infinite range, calculateStart() and calculateEnd() return null. The calculateStart() method is less than or equal to the calculateEnd() returned value.

You can only use this control in a Form control.

Specifies a multi-select list box that displays icons and extra-wide titles and descriptions. Selection options are defined by specifying javax.faces.SelectItem or javax.faces.SelectItems as children of this control. For more information, see the control documentation for the standard JSF controls Option and Option Group. The Extended Select-Many Listbox control's value is an array of selected values.

You can only use this control in a Form control.

Children

javax.faces.SelectItem (JSF Option control) and javax.faces.SelectItems (JSF Option Group control).

A control that enables a user to upload a file. The model for this control (the type of object to which you bind the control's value attribute) is javax.servlet.http.Part for a single file

For each Part object, you can get:

• The file's content-type using the getContentType() method.
• The file's original name using the getName() method.
• The file's full content using the getInputStream() method.

  When you are finished with a Part, call its delete() method to release its associated resources, such as its temp file on disk or bytes in memory.

  You can only use this control in a Form control.

  You can also upload files with asynchronous commands.

A WYSIWYG HTML editor input control. You can only use this control in a Form control.

When using the WYSIWYG HTML editor input control in a Modal Dialog, you must set the 'Lazy Load' property of the dialog to 'true'.

A password-style text input control. You can only use a Secret Input control in a Form control.

A swapbox that is two list boxes with options that shuttle between them. Selection options are specified using Option and Option Group children. The control's value is an array of selected values.

You cannot drop an input control outside of a Form control.

Children

• javax.faces.SelectItem, Option control
• javax.faces.SelectItems, Option Group control

A multi-line text input control. You can only use a Multi-Line Text Input control in a Form control.

Message output for a all components. This is an enhanced variation of the standard h:messages control.

A panel that encapsulates the style and behavior of a modeless dialog. A modeless dialog allows the user to continue to manipulate controls outside of the dialog, without having to choose an option in the dialog, usually by clicking a button, right away. The behavior of a Modeless Dialog is less restrictive than a Modal Dialog, which requires the user to make a selection before performing actions outside the dialog box. The Modeless Dialog control is initially hidden.

Like other hideable controls, you can switch this control between visible and hidden through the use of client-side JavaScript code. For more information, see the topics "Hideable Controls" and "Toggle Controls" in the section "User Interface Controls Concepts" in the webMethods CAF Development Help.

This control has four facets: title, submit, cancel, and other. The last three facets are intended to encapsulate the default layout for the submit, cancel, and miscellaneous other buttons. For example, if you place a Cancel button in the cancel facet, and an OK button in the submit facet, by default the modeless dialog lays out the cancel button in the far-right corner of the dialog, with the OK button directly to its left. The title facet is intended to display a title for the dialog.

Children

Any. Children of this control are displayed as the dialog's content.

A button that toggles the client-side visibility of a single control, or the server-side rendered property of a single control. For more information, see information about toggle controls in the webMethods CAF Development Help.

For more information about hiding controls, see information about concealable controls in webMethods CAF Development Help.

Children

Any. Children are displayed as a button label after the content of the value property.

A link that toggles the client-side visibility of a single control, or the server-side rendered property of a single non-hideable control. For more information, see information about toggle controls in the webMethods CAF Development Help.

For more information about hiding controls, see information about concealable controls in webMethods CAF Development Help.

Children

Any. Children are displayed as a link label after the content of the value property.

A control that renders parameterized text. The control formats text with parameters using java.text.MessageFormat#format().

Displays a simple horizontal section separator.

A label for a form field.

A control that renders text.

Displays the contents of the panel in a block-level HTML div element.

Children

Any.

Displays the contents of the panel in a block-level HTML div element. The Disableable Panel provides a disabled attribute, which affects the client-side state of the contained controls.

The client-side disabled state of the Disableable Panel is set with the setDisabled(disabled) method of the control's client-side model. For more information, see the topic "Client-Side Model" in the CAF Development Help.

Children

Any.

An inline panel that toggles between visible and hidden using JavaScript. Toggle controls encapsulate the JavaScript within controls that are created and configured visually, using the Composite Application Framework. For more information about hiding controls, see information about concealable controls in webMethods CAF Development Help.

Children

Any.

A panel that renders a portlet-like grouping UI around a large section of content, for example, multiple property groups.

The Disabled attribute in this control affects only the client-side disabled state of contained controls and not the server-side state. The client-side disabled state of this and other controls is toggled with the setDisabled(disabled) method on the control's client-side model.

Children

Any.

A container for a group of form fields around a group of related property lines. For more information, see Property Line.

The Disabled attribute in this control affects only the client-side disabled state of contained controls and not the server-side state. The client-side disabled state of this and other controls is toggled with the setDisabled(disabled) method on the control's client-side model.

A container for a sub-group of form fields. Renders a sub-grouping UI around a group of form fields.

The disabled attribute of the Property Sub-Group control affects only the client-side disabled state of contained controls and not their server-side state. The client-side disabled state of controls are toggled with the setDisabled(disabled) method of the control's client-side model.

A panel that provides the user with a search query builder.

Although this control can be used in any generic JSF application, it is typically used in the Search Bar portlet of a Search Bar/Search Results portlet pair. You can create an integrated Search Bar portlet with the New Portlet wizard, selecting the Search Bar Portlet option on the first page of the wizard. The two portlets are connected by wiring; the lastSearchState property of the Search Bar portlet is wired to the queryString property of the Search Results portlet.

Divides a Static Row control into cells. It is best to set the width of each Static Cell to a percentage such that the width of all the cells in the row add up to 100%. Cells without width settings may wrap in unexpected ways.

A container for a group of submit buttons.

The Submit Group control contains Submit, Cancel, Previous, and Next buttons and provides a standard location and default width for the buttons. Place the Submit, Cancel, Previous, and Next buttons in their respective facets; you can add other buttons as non-facet children of the panel.

Children

Any.

Web application top-level navigation control as a list of links. Selecting or hovering over one of the top-level links displays the children of that page as a pop-up menu of second-level links.

A progress bar dialog that overlays another panel or the entire page when toggled to visible through client-side JavaScript code. For more information, see the topic "Hideable Controls" in the section "User Interface Controls Concepts" in the webMethods CAF Development Help.

A button that asynchronously refreshes the content of a specified control.

Children

Any. Children are displayed as button label (after value of the label attribute).

A client-side script that asynchronously refreshes the content of a specified control at a specified interval.

A control that adds a JavaScript block to the current page, containing the JavaScript code specified by the control's value attribute.

A control that connects client-side JavaScript functions to parent control client-side events. To connect to a client-side event, place the Custom Script control as a child of a parent Input or Output control. Children com.webmethods.caf.faces.script.ScriptParameter controls are used to define parameters to use inside custom script code blocks. For more information, see the Parameter control.

Children

com.webmethods.caf.faces.script.ScriptParameter, see the Parameter control; children specify additional parameters used in the custom script code.

A control used to specify parameters for the Custom Script control. The parameter defines a client-side named variable whose value is set depending on the configured valueType. It is specified directly, taken from the client control, or returned back from another JavaScript function.

Specifies a Boolean check box that is a standard JavaServer Faces control. You can only use this control in a Form control.

Specifies a user interface control that contains a group of check boxes. Selection options are defined by specifying javax.faces.SelectItem or javax.faces.SelectItems as children of this control. For more information, see the control documentation for the standard JSF controls Option and Option Group. The control's value attribute (the current selection values) is expressed as an array of values.

You can only use this control in a Form control.

Set the other attribute to true to add a value to the list of options in the Checkbox Group. When the other property is set to true, an Other button is rendered at the end of the list of check boxes. When the user clicks the Other button, a dialog box opens and prompts the user for a new value. When the user clicks the OK button, a new check box item is added to the group with the user-specified value. Default is false.

Children

javax.faces.SelectItem (JSF Option control) and javax.faces.SelectItems (JSF Option Group control).

A button control that behaves like a select-one group control. Clicking the button toggles it through the options in the group. Selection options are defined by specifying javax.faces.SelectItem or javax.faces.SelectItems as children of this control. For more information, see the control documentation for the standard JSF controls Option and Option Group.

You can only use this control in a Form control.

Children

javax.faces.SelectItem (JSF Option control) and javax.faces.SelectItems (JSF Option Group control).

Specifies a link that behaves like a select-one group. Clicking the link toggles it through the options in the group. Selection options are defined by specifying javax.faces.SelectItem or javax.faces.SelectItems as children of this control. For more information, see the control documentation for the standard JSF controls Option and Option Group.

You can only use this control in a Form control.

Children

javax.faces.SelectItem (JSF Option control) and javax.faces.SelectItems (JSF Option Group control).

A single-select dropdown. The selection options are specified using javax.faces.SelectItem, Option and javax.faces.SelectItems Option Group children.

You can only use the Dropdown control in a Form control.

Children

• javax.faces.SelectItem, Option control
• javax.faces.SelectItems, Option Group control).

A group of radio buttons. Selection options are specified using Option and Option Group children. The selection options are specified using javax.faces.SelectItem, Option and javax.faces.SelectItems Option Group children.

You can only use the Radio Button Group control in a Form control.

Children

• javax.faces.SelectItem, Option control
• javax.faces.SelectItems, Option Group control).

WARNING: This tag has been deprecated. Replace with a Form tag.

A JSF command form that posts directly to the JSF servlet instead of the containing portlet.

Displays faces messages for specific components, such as validation messages, with a customizable look-and-feel.

Synchronizes the client-side values of two or more controls.

A control that executes the toggle behavior for a toggle control.

Typically, you place a toggle control before the controls it toggles, and in these instances, an Initiate Toggle control is not needed. However, if you place a toggle control after one of the controls it toggles, you need to add an Initiate Toggle control to the view. Place the Initiate Toggle control before the first of of the controls that are toggled and at the same level as the toggle control. For example, if the toggle control is in a table column, the Initiate Toggle control is the first control in the first column of the table. Set the Initiate Toggle control's for property to identify the toggle control with which it is associated.

A single-select dropdown list that toggles among a group of controls. Selection options are defined by specifying javax.faces.SelectItem or javax.faces.SelectItems as children of this control. For more information, see the control documentation for the standard JSF controls Option and Option Group..

You can only use this control in a Form control.

Children

javax.faces.SelectItem (JSF Option control) and javax.faces.SelectItems (JSF Option Group control).

A radio button group that toggles the client-side visibility of a group of concealable controls, or the server-side rendered property of a group of non-concealable controls. Only the selected control from this group specified by the value property of the Toggle Radio Button Group control is visible. For more information, see information about toggle controls in webMethods CAF Development Help.

For more information about hiding controls, see information about concealable controls in webMethods CAF Development Help.

Specify the selection options using javax.faces.SelectItem and javax.faces.SelectItems with each value specifying a control ID. Selecting an option whose value does not specify a control ID hides all controls in the group. For more information, see the Option control or the Option Group control.

Children

• javax.faces.SelectItem, Option control
• javax.faces.SelectItems, Option Group control

A panel rendered as tool tip for another control, as specified by the for attribute.