webMethods Designer Composite Application Framework Help

sizzledgooseΛογισμικό & κατασκευή λογ/κού

3 Νοε 2013 (πριν από 3 χρόνια και 11 μήνες)

6.155 εμφανίσεις

webMethods Designer
CAF Development Help
Version 7.2
December 2008
webMethods

Title Page

This document applies to webMethods Designer Version 7.2 and to all subsequent releases.
Specifications contained herein are subject to change and these changes will be reported in subsequent release notes or new editions.
Copyright © 2006—2008 Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, United States of America, and/or their suppliers. All
rights reserved.
The name Software AG, webMethods, and all Software AG product names are either trademarks or registered trademarks of Software AG and/or Software
AG USA, Inc. Other company and product names mentioned herein may be trademarks of their respective owners.
Document ID: DES-CAFH-72-20081212
Copyright
& Docu
-
ment ID

webMethods Designer CAF Development Help Version 7.2 3
Table of Contents
About This Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Additional Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
webMethods Central Documentation Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
webMethods Advantage Bookshelf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Software

AG Developer Community . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Part I.
webMethods CAF Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
1.
CAF Development Prerequisites and Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
CAF Development Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Software AG Information Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Software AG Training Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.
Getting Started with Web Application Development . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Introduction to the webMethods UI Developer Perspective . . . . . . . . . . . . . . . . . . . . . . . . . 24
Creating a Web Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Creating Web Applications for Tomcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Creating Web Applications for JBoss . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Creating Web Applications for Multiple Server Types . . . . . . . . . . . . . . . . . . . . . . . . . 28
Creating Web Applications for My webMethods Server . . . . . . . . . . . . . . . . . . . . . . . . 30
Adding a View File to a Web Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Adding a Control to a View File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Associating Web Applications with an Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Publishing a Web Application to the Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
3.
Developing Web Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Component Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Adding Component Libraries to a Web Application . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Removing Component Libraries from a Web Application . . . . . . . . . . . . . . . . . . . . . . . 37
Modifying How Component Libraries are Deployed . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Project Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Style Sheets in Web Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Applying CSS to an Individual Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Applying CSS to a View File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Importing a View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Page Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Page Templates and Content Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Page Templates and Control Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Navigation in Web Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
The Application Navigation Configuration Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Adding a Home Link to a Web Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Hiding Breadcrumbs on the Home Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Table of Contents
4 webMethods Designer CAF Development Help Version 7.2

Application Initialization Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
4.
Working with Application Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Installing and Configuring an Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Configuring the Apache Tomcat Servlet Container . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Configuring the JBoss Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Web Application Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Security on Tomcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Security on JBoss . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Security Roles for Web Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Deploying Component Libraries on an Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Making the Tomcat Server Re-render the Page Automatically . . . . . . . . . . . . . . . . . . . . . . 61
Running Servers in Debug Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
5.
Getting Started with Portlet Application Development . . . . . . . . . . . . . . . . . . . . . . . . . 63
Introduction to the My webMethods Perspective . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Creating a Portlet Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Adding a Portlet to a Portlet Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Adding a View File to a Portlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Adding a Control to a View File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Connecting to My webMethods Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Associating Portlet Applications with My webMethods Server . . . . . . . . . . . . . . . . . . . . . . . 73
Running Servers in Debug Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Publishing a Portlet Application to the Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Adding a Portlet to a My webMethods Server Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Uninstalling Portlet Applications from My webMethods Server . . . . . . . . . . . . . . . . . . . . . . 75
Troubleshooting Portlet Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
6.
webMethods CAF Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Portlet Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
JSR 168 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
JavaServer Faces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Ajax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
JSF Scopes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
7.
Views in webMethods CAF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
My webMethods Perspective Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Using the Portlet Application Configuration Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Using Security Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Creating a Security Role . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Binding a Security Role to a Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Using an Access Control Panel Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
User Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Using the Design Canvas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
The Design Canvas Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Manipulating Controls on the Design Canvas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
webMethods Designer CAF Development Help Version 7.2 5
Table of Contents

The Instant Preview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Live Preview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Debugging from the Design Canvas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Using the Bindings View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Creating a New Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Adding a New Property to a Page Bean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Customizing Initial Values for a Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Adding a Reference to Another Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Using the Data Source Explorer View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Connecting to a Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Creating a Database Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Using the MWS Admin View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Connecting to My webMethods Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
The MWS Admin View Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Authentication Credentials on the MWS Admin View . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Deploying Portlets to My webMethods Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Exporting from My webMethods Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Importing to My webMethods Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Renaming My webMethods Server on the MWS Admin View . . . . . . . . . . . . . . . . . . . 110
Changing Properties on the MWS Admin View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Other Actions You Can Perform on the MWS Admin View . . . . . . . . . . . . . . . . . . . . . 112
Displaying My webMethods Server in a Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Using the Outline View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Using the Package Navigator View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Using the Palette View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Moving Objects from the Palette View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Managing Favorites in the Palette View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Customizing the Palette View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
The Palette View Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Displaying Deprecated Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Filtering Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Using the Properties View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
The Properties View Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Actions in the Properties View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Adding Converters or Validators to a Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
Binding Data to a Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Binding the Properties of Java Beans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Using the Solutions View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Portlet Applications in the Solutions View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Creating a Portlet Application on the Solutions View . . . . . . . . . . . . . . . . . . . . . . 127
Creating a Portlet on the Solutions View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Creating a Portlet View File on the Solutions View . . . . . . . . . . . . . . . . . . . . . . . . 129
Web Applications in the Solutions View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Creating a Web Application on the Solutions View . . . . . . . . . . . . . . . . . . . . . . . . 130
Creating a Web Application View File on the Solutions View . . . . . . . . . . . . . . . . 130
Database Connectors in the Solutions View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Specifying an External Web Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Table of Contents
6 webMethods Designer CAF Development Help Version 7.2

8.
CAF Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Creating Portlet Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Using Preferences to Perform Wiring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Storing a Preference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Preferences to Show All Managed Beans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Async Search Result Table Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
Async Search Result Tree Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Search Result Table Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Search Result Tree Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
9.
Samples for the My webMethods Perspective . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Importing Samples into webMethods Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Common Sample Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Access Control Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Core Controls Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Core Provider Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
File Export Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Locale Order Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Localization Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Northwind Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Portlet Links Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Search Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Wired Config Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Wizard Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
10.
A Tutorial for Portlet Application Samples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Using the Portlet Tabs Tutorial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Portlet Tabs Tutorial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Create a Portlet Application Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Create a Portlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Create a List of Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Create the Tabs Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Create Some Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Create the Other Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Publish and View Portlets on My webMethods Server . . . . . . . . . . . . . . . . . . . . . . . . . 161
Part II.
User Interface Controls Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
11.
Controls Listed by Component Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
12.
User Interface Controls Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Control ID Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Hideable Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Toggle Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
Scriptaculous Effects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Client-Side Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
webMethods Designer CAF Development Help Version 7.2 7
Table of Contents

CAF.Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
CAF.Output.Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
CAF.Link.Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
CAF.Command.Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184
CAF.Input.Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
CAF.Checkbox.Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
CAF.Select.Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
CAF.Table.Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
CAF.Table.Row.Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
Template Row . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Paging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Listeners . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
CAF.Tree.Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Advanced Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
Image URLs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Skinning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
Table Row Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Adding and Removing Rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Moving Rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Selecting Rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Client-Side Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
CSV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
String . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Logger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Logger Bookmarklet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Logger and Firebug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
CAF.Dialog Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
CAF.Progress Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
CAF.Tooltip Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
CAF.Request Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
CAF.Updater Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
CAF.Draggable Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
CAF.Droppable Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
Filterable Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
CAF.Select.Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Examples of Filtering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Filtered Listbox (Medium List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Filtered Listbox (Large List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Filtered Swapbox (Medium List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Filtered Swapbox (Large List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Filtered Dropdown (Medium List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Filtered Combobox (Medium List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Autocomplete Text Field (Large List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Filtered Table (Current Page) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Filtered Table (Entire Table) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Table of Contents
8 webMethods Designer CAF Development Help Version 7.2

13.
Behavior Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
Custom Drag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Custom Drop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
Drag To Move Rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Drag To Reorder Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Drag To Resize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
Drag To Resize Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Raise On Change . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Synchronize Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
14.
Output Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Applet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
Control Label . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Custom Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Formatted Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
Formatted Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
Formatted Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Frame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Horizontal Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Icon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
Include HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Include Resource Bundle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Include Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Include Stylesheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Parameterized Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Refresh Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Refresh Icon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Refresh Interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Refresh Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Script Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Select-One Output Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Specific Formatted Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Specific Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Truncated Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
webMethods Designer CAF Development Help Version 7.2 9
Table of Contents

15.
Command Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Async Command Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Async Command Icon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
Async Command Interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Async Command Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Async Hidden Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
Command Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
Command Icon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
Command Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
Hidden Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
Servlet Command Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
16.
Dialog Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Modal Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Modeless Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
Portal Resource Picker Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
Principal Picker Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
Progress Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
17.
Input Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
Autocomplete Text Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
Checkbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
Checkbox Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
Combobox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
Date Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
Date Range Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
Dropdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
Extended Select-Many Listbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
Extended Select-One Listbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
File Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Filter Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
Hidden Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
HTML Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
In Place Text Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
Multi-Line Text Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
Option Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
Radio Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
Radio Button Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
Secret Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
Select-Many Listbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
Select-One Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
Select-One Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Select-One Listbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
Table of Contents
10 webMethods Designer CAF Development Help Version 7.2

Select-One Tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Simple Schedule Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
Swapbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373
Text Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
18.
List Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
Async List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
Async Listbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383
Async Tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
Listbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
Simple List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
Tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
19.
Logic Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
Async Iterator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
Content Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
Control Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
Else . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
If . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
Import View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
Iterator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
Load Resource Bundle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
Naming Container . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
20.
Map Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409
Dynamic Map Marker List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
Google Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
Google Map Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
Invoke Map Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
Map Marker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
Map Marker Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
Map Navigation Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
Return Map Coords Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
Return Map Value Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
21.
Panel Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
Access Control Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
Attachments Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
Block Edge Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
Block Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
Disableable Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
Grid Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440
Hideable Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442
Inline Hideable Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
Inline Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
Overlay Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
webMethods Designer CAF Development Help Version 7.2 11
Table of Contents

Page Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
Popup Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
Property Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
Property Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
Property Sub-Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455
Scrolling Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
Stack Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
Static Cell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
Static Row . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
Submit Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
Titlebar Tabs Wrapper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460
Tooltip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
22.
Portlet Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
Extended Portlet Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
Extended Portlet URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464
Portlet Include . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
Portlet Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
Portlet Simple Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468
Portlet URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
23.
Script Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
Control Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474
Custom Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474
Invoke Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477
Portlet Url Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
Portlet Url Script Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
Return Value Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484
24.
Search Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487
Async Search Result Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488
Async Search Result Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494
Search Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499
Search Result Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 502
Search Result Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506
25.
Table Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511
Async Categorized Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512
Async Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
Async Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523
Atom Feed Icon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528
Basic Column . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
Calendar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
Categorized Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541
Column Sort Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545
Table of Contents
12 webMethods Designer CAF Development Help Version 7.2

Data Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546
Data Prev/Next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547
Data Total . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548
Data Total Selected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549
Export Table Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550
Hidden Column . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552
Newsfeed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553
Row Headers Column . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554
Scrollbar Column . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
Standard Column . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564
Tree Toggle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570
Truncating Column . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571
26.
Table Row Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575
Add Row Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576
Add Row Icon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577
Add Row Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579
Move Row Down Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581
Move Row Down Icon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582
Move Row Down Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583
Move Row Up Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584
Move Row Up Icon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585
Move Row Up Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586
Remove Row Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587
Remove Row Icon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589
Remove Row Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591
Select All Rows Checkbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592
Select All Visible Rows Checkbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593
Select Row Checkbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594
Select Row Column . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595
Select Row Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
Select Row On Click . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
Select Row Quad-State Checkbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
Select Row Tri-State Checkbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
27.
Toggle Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601
Initiate Toggle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602
One Way Toggle Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602
One Way Toggle Checkbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
One Way Toggle Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605
Toggle Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606
Toggle Dropdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608
Toggle Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610
webMethods Designer CAF Development Help Version 7.2 13
Table of Contents

Toggle Radio Button Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612
Toggle Tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
28.
Webapp Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
Breadcrumbs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618
Popup Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619
Static Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621
Toggle Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623
Part III.
Converters Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625
29.
Converter Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627
Using Converters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628
Creating a Custom Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628
30.
Converters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631
Array Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 632
Big Decimal Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 632
Big Integer Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 633
Boolean Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 633
Byte Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 633
Character Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 634
Collection Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 634
Date and Time Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635
Double Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 636
Float Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 636
Integer Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 636
Iterator Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 636
Long Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 637
Map Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638
Number Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638
Short Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 640
String Array Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 640
WmPortal IURI Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 641
31.
Currency Converters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 643
Currency Big Decimal Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 644
Currency Big Integer Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 644
Currency Double Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645
Currency Float Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646
Currency Integer Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647
Currency Long Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 648
Currency Number Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649
Currency Short Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649
Table of Contents
14 webMethods Designer CAF Development Help Version 7.2

32.
Formatted Converters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 651
Formatted Big Decimal Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 652
Formatted Big Integer Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 652
Formatted Boolean Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653
Formatted Date Time Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 654
Formatted Double Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 655
Formatted Float Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 656
Formatted Integer Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657
Formatted Long Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657
Formatted Number Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658
Formatted Short Converter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659
Part IV.
Validators Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 661
33.
Validator Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663
Using Validators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664
Creating a Custom Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664
34.
Validators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667
Credit Card Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 668
Double Range Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 668
Email Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 669
Equal Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670
Exact RegExp Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670
Length Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 671
Long Range Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 671
One Of Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 672
RegExpr Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 673
35.
Formatted Validators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 675
Formatted Date Range Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676
Formatted Double Range Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 677
Formatted Long Range Validator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 677
Index
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
679

webMethods Designer CAF Development Help Version 7.2 15
About This Guide
This guide contains the Composite Application Framework online help in a PDF book
format. The information in this guide is the same information that you can view in the
webMethods Designer online help.
Document Conventions
Additional Information
You can find additional information about webMethods products at the locations
described below.
webMethods Central Documentation Directory
During product installation, you can download the webMethods product documentation
to a single directory called “_documentation.” This directory is located by default under
the webMethods installation directory.
Convention
Description
Bold Identifies elements on a user interface.
Narrow font Identifies storage locations for services on webMethods Integration
Server, using the convention folder.subfolder:service.
UPPERCASE Identifies keyboard keys. Keys you must press simultaneously are
joined with a plus sign (+).
Italic Identifies variables for which you must supply values specific to your
own situation or environment. Identifies new terms the first time they
occur in the text.
Monospace
font
Identifies text you must type or messages displayed by the system.
{ } Indicates a set of choices from which you must choose one. Type only
the information inside the curly braces. Do not type the { } symbols.
| Separates two mutually exclusive choices in a syntax line. Type one of
these choices. Do not type the | symbol.
[ ] Indicates one or more options. Type only the information inside the
square brackets. Do not type the [ ] symbols.
...Indicates that you can type multiple options of the same type. Type
only the information. Do not type the ellipsis (...).
Additional Information
16 webMethods Designer CAF Development Help Version 7.2

webMethods Advantage Bookshelf
The webMethods Advantage Web site at
http://advantage.webmethods.com
provides
you with important sources of information about webMethods products:
 Troubleshooting Information. The
webMethods Knowledge Base
provides
troubleshooting information for many webMethods products.
 Documentation Feedback. To provide feedback on webMethods documentation, go to
the
Documentation Feedback Form
on the
webMethods Bookshelf
.
 Additional Documentation. You can find documentation for all webMethods products on
the
webMethods Bookshelf
.
Software

AG Developer Community
Additional articles, demos, and tutorials are available on the
webMethods
portion of the
Software

AG Developer Community
. The various Developer Communities feature
technical information, useful resources, and online discussion forums, moderated by
Software

AG professionals, to help you do more with webMethods technology.
With the Software

AG Developer Communities, you can:
 Use the online discussion forums to exchange best practices and chat with other
experts.
 Expand your knowledge with product documentation, code samples, articles, online
seminars and tutorials.
 Link to external sites on open standards and many Web technology topics.
 See how other customers are streamlining their operations with technology from
Software

AG.

webMethods Designer CAF Development Help Version 7.2 17
I
webMethods CAF Development
webMethods Composite Application Framework (CAF) development allows you to
create Web application projects for use with application servers and portlet application
projects for use with My webMethods Server. A Web application is an application that a
user accesses over the Web on either the Internet or an intranet. As created in the
webMethods CAF, a Web application is made up of one or more views (pages) intended
to be displayed by an application server, such as Apache Tomcat or JBoss. A portlet
application is composed of one or more portlets, which in turn are made up of one or
more views (pages) intended to be displayed by My webMethods Server. webMethods
CAF is covered in the following online help topics:

“CAF Development Prerequisites and Resources” on page

19

“Getting Started with Web Application Development” on page

23

“Developing Web Applications” on page

35

“Working with Application Servers” on page

51

“Getting Started with Portlet Application Development” on page

63

“webMethods CAF Concepts” on page

77

“Views in webMethods CAF” on page

81

“Samples for the My webMethods Perspective” on page

143

“A Tutorial for Portlet Application Samples” on page

155
You will also find the following reference topics:

“User Interface Controls Reference” on page

163

“Converters” on page

631

“Validators” on page

667
18 webMethods Designer CAF Development Help Version 7.2

webMethods Designer CAF Development Help Version 7.2 19
CAF Development Prerequisites and Resources

1
CAF Development Prerequisites and Resources

CAF Development Prerequisites

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
20

Software AG Information Resources

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
20

Software AG Training Resources

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
21
CAF Development Prerequisites
20 webMethods Designer CAF Development Help Version 7.2

CAF Development Prerequisites
Before you develop Composite Application Framework (CAF) solutions or task solutions,
you should have a fundamental understanding of the following:
 The Eclipse development environment, including the use of perspectives, views, and
editors.
 Web development, including development of Web applications and Web services.
 The Java Platform, Enterprise Edition, formerly known as Java 2 Platform, Enterprise
Edition/J2EE (
http://java.sun.com/javaee/
).
 JavaServer Faces (JSF) technology (
http://java.sun.com/javaee/javaserverfaces/
).
 Concepts of service-oriented architecture (SOA).
Additionally, you should be familiar with the webMethods product suite and its
integrated approach for developing, deploying, and running Web-based applications.
Related Topics

“Software AG Information Resources” on page

20

“Software AG Training Resources” on page

21
Software AG Information Resources
The _documentation directory of your webMethods installation provides an excellent
repository of product-related information. For example, if you are interested in an
overview of the webMethods product suite or business process management, we
recommend examining the following Software AG documents:
 Understanding the webMethods Product Suite
 Getting Started with Business Process Management
Additionally, you might find the Software AG publication, BPM for Dummies: A Reference
Guide for the Rest of Us, of particular interest. This book addresses the business
management and information technology sides of BPM, and delves into the process-
centric foundation upon which BPM is built. You can download the entire book at no cost
from:
http://www.softwareag.com/corporate/res/books/default.asp
.
Related Topics

“CAF Development Prerequisites” on page

20
Note: The _documentation directory is installed as a separate component in the
webMethods Installer. If the _documentation directory is not installed on your
system, then you can install the directory by using the webMethods Installer, or you
can download any document of interest from the Advantage Bookshelf Web site:
http://advantage.webmethods.com/bookshelf_cross_components.
webMethods Designer CAF Development Help Version 7.2 21
CAF Development Prerequisites and Resources


“Software AG Training Resources” on page

21
Software AG Training Resources
You might choose to benefit from Software AG training before you use webMethods
products, although training is not a prerequisite. Software AG training provides
extensive coverage of webMethods Designer functionality, with hands-on sessions and
numerous exercises delivered by experienced Software AG instructors.
For more information about available training courses and to schedule training for your
organization, visit the webMethods Advantage Training center at
https://advantage.webmethods.com/training
.
Related Topics

“CAF Development Prerequisites” on page

20

“Software AG Information Resources” on page

20
Software AG Training Resources
22 webMethods Designer CAF Development Help Version 7.2


webMethods Designer CAF Development Help Version 7.2 23
2
Getting Started with Web Application Development

Introduction to the webMethods UI Developer Perspective

. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24

Creating a Web Application

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25

Adding a View File to a Web Application

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31

Adding a Control to a View File

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
32

Associating Web Applications with an Application Server

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33

Publishing a Web Application to the Server

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33
Introduction to the webMethods UI Developer Perspective
24 webMethods Designer CAF Development Help Version 7.2

Introduction to the webMethods UI Developer Perspective
A Web application is an application that a user accesses over the Web on either the
Internet or an intranet. As created in the webMethods CAF, a Web application is made up
of one or more views (pages) intended to be displayed by an application server, such as
Apache Tomcat or JBoss. Do not use this perspective to create portlet applications for My
webMethods Server (see
“Getting Started with Portlet Application Development” on
page

63
). To create Web applications, you use the webMethods UI Developer perspective.
1 To start Designer:

Start > Programs > webMethods7 > Tools > Designer.
2 In the Workspace Launcher window, accept the default workspace or click Browse
and navigate to the folder where you want the Eclipse workspace to reside, and then
click OK.
If you have installed only webMethods CAF, Designer opens in the webMethods UI
Developer perspective. If you have installed the BPMS Suite, Designer opens in the
Process Development perspective. To create Web application projects, change to the
webMethods UI Developer perspective.
3 If needed, in Designer:

Window > Open Perspective > Other > webMethods UI Developer.
4 Click OK.
The webMethods UI Developer perspective contains the following views. For more
information on views, see
“Views in webMethods CAF” on page

81
:
To open the webMethods UI Developer perspective
View
Description
Bindings A tree view that contains all data that can be used within this view
or within the entire Web application.
Data Source
Explorer
(Eclipse)
A tree view of data sources. Using this view you can connect to,
navigate, and interact with resources associated with a selected
connection profile, such as a database.
Outline (Eclipse) An outline of a view that is currently open in the design canvas.
This view is useful in locating specific controls within a complex
Web application and for moving controls from one location in the
Web application to another.
Palette A tree view of controls you can use to build Web applications. You
can drag controls from this view directly to the design canvas.
Problems
(Eclipse)
A display of system-generated errors, warnings, or information
associated with a resource. For example, if you save a Java source
file that contains syntax errors, the errors are automatically are
logged in this view.
webMethods Designer CAF Development Help Version 7.2 25
Getting Started with Web Application Development

In addition to the views, there are various editors:
Creating a Web Application
If you have the webMethods UI Developer perspective displayed (
“Introduction to the
webMethods UI Developer Perspective” on page

24
) and have defined an application
server on the local host (
“Installing and Configuring an Application Server” on page

52
),
you are ready to create a Web application project.
The configuration settings depend on what kind of application server you intend to use
for development. The following procedures describe a way to get started in creating Web
application projects. As you gain experience with webMethods CAF, you can modify
your the procedures as appropriate:

“Creating Web Applications for Tomcat” on page

26

“Creating Web Applications for JBoss” on page

27

“Creating Web Applications for Multiple Server Types” on page

28

“Creating Web Applications for My webMethods Server” on page

30
Project Explorer
(Eclipse)
A tree view of the resources in the workspace. From here, you can
open files for editing or select resources for operations such as
exporting.
Properties
(Eclipse)
A view of display names and values of properties for a resource
selected elsewhere in Designer. This view is useful in changing the
values of properties of controls in the design canvas.
Servers (Eclipse) A table of runtime environments associated with Designer. Once
configured, you can publish Web applications to the server.
Solutions A tree view that represents a logical representation of the
resources in the workspace which is simpler than the one
provided in the Project Explorer. You can perform selected
operations on resources shown in this view.
Editor
Description
Design canvas A JSF graphical editor in which you build portlets by adding
controls from the Palette view. This editor provides a logical view
of the Web application.
Java editor A source code editor that provides specialized features for editing
Java code.
View
Description
Creating a Web Application
26 webMethods Designer CAF Development Help Version 7.2

Creating Web Applications for Tomcat
The following procedure describes how to create a Web application for use with the
Tomcat servlet container. This procedure causes component libraries to be deployed as
part of the Web application when you publish it to the server. Before you can perform
this procedure, you need to have Tomcat configured on the local machine and defined as
a server in webMethods CAF, as described in
“Configuring the Apache Tomcat Servlet
Container” on page

52
.
1 In Designer:

File > New > Web Application Project.
If you do not see this menu item, try New > Other.
2 On the Select a Wizard page, expand webMethods > Composite Applications > Web
Application Project, and click Next.
3 In the Project Name field of the New Dynamic Web Project page, type a name for the
Web application.
The project name cannot have spaces or any of the following characters:
* | \ : " < > . / ?
4 From the Target Runtime list, choose Apache Tomcat.
5 From the Configuration list, choose the CAF Web Application.
6 From the Project Template list, choose a project template to be used for the Web
application and click Next.
For information on project templates, see
“Project Templates” on page

38
.
7 On the Project Facets page, click Next.
8 On the Web Module page, click Next.
9 For JSF Libraries on the JSF Capabilities page, choose the CAF Base JSF Runtime option
and select the Deploy check box.
This choice causes the CAF Base JSF Runtime component library to be deployed with
the Web application when you publish it to Tomcat. To deploy the component
libraries to the Tomcat servlet container, see
“Deploying Component Libraries on an
Application Server” on page

60
. To stop deploying the libraries with the Web
application, see
“Modifying How Component Libraries are Deployed” on page

37
.
10 Under Component Libraries, move CAF Base Controls to the right box and select the
Deploy check box.
To create a Web application project for Tomcat
Note: Do not include the MwS Controls or CAF Portlet Controls libraries. They are
suitable only for portlet application development.
webMethods Designer CAF Development Help Version 7.2 27
Getting Started with Web Application Development

11 Click Finish.
12 To associate the Web application you have created with the Tomcat servlet container,
see
“Associating Web Applications with an Application Server” on page

33
.
The Web application project is created. As you develop the Web application, any
additional libraries you need are automatically added. To add or remove libraries
manually, see
“Modifying How Component Libraries are Deployed” on page

37
.
Related Topics

“Configuring the Apache Tomcat Servlet Container” on page

52

“Modifying How Component Libraries are Deployed” on page

37

“Deploying Component Libraries on an Application Server” on page

60

“Associating Web Applications with an Application Server” on page

33
Creating Web Applications for JBoss
The following procedure describes how to create a Web application for use with the JBoss
application server. This procedure causes component libraries to be deployed as part of
the Web application when you publish it to the server. Before you can perform this
procedure, you need to have JBoss configured on the local machine and defined as a
server in webMethods CAF, as described in
“Configuring the JBoss Application Server”
on page

54
.
1 In Designer:

File > New > Web Application Project.
If you do not see this menu item, try New > Other.
2 On the Select a Wizard page, expand webMethods > Composite Applications > Web
Application Project, and click Next.
3 In the Project Name field of the New Dynamic Web Project page, type a name for the
Web application.
The project name cannot have spaces or any of the following characters:
* | \ : " < > . / ?
4 From the Target Runtime list, choose JBoss.
5 From the Configuration list, choose the CAF Web Application.
6 From the Project Template list, choose a project template to be used for the Web
application and click Next.
For information on project templates, see
“Project Templates” on page

38
.
7 On the Project Facets page, click Next.
To create a Web application project for JBoss
Creating a Web Application
28 webMethods Designer CAF Development Help Version 7.2

8 On the Web Module page, click Next.
9 For JSF Libraries on the JSF Capabilities page, choose the CAF Base JSF Runtime option
and clear the Deploy check box.
This choice causes the CAF Base JSF Runtime component library to be associated with
the Web application but not deployed with the application when you publish it to
JBoss. The libraries are already deployed on the server.
10 Under Component Libraries, move CAF Base Controls to the right box and select the
Deploy check box.
The links at the bottom of this page show how to deploy the component libraries to
the JBoss application server and how to stop deploying the libraries with the Web
application.
11 Click Finish.
12 To associate the Web application you have created with the JBoss application server,
see
“Associating Web Applications with an Application Server” on page

33
.
The Web application project is created. As you develop the Web application, any
additional libraries you need are automatically added. To add or remove libraries
manually, see
“Modifying How Component Libraries are Deployed” on page

37
.
Related Topics

“Configuring the JBoss Application Server” on page

54

“Modifying How Component Libraries are Deployed” on page

37

“Deploying Component Libraries on an Application Server” on page

60

“Associating Web Applications with an Application Server” on page

33
Creating Web Applications for Multiple Server Types
If you intend to create a Web application for use with multiple servers, one way to
approach it is to act as though you are creating the project for Tomcat, but deploying all
libraries to the server. Before you can perform this procedure, you need to have the
application servers configured on the local machine and defined as a servers in
webMethods CAF, as described in
“Installing and Configuring an Application Server” on
page

52
.
Note: The content of this step applies to JBoss version 4.2 and later. For earlier
versions of JBoss, you need to deploy CAF Base JSF Runtime with the Web
application or as a shared library (described in “Creating Web Applications for
Tomcat” on page 26).
Note: Do not include the MwS Controls or CAF Portlet Controls libraries. They are
suitable only for portlet application development.
webMethods Designer CAF Development Help Version 7.2 29
Getting Started with Web Application Development

1 In Designer:

File > New > Web Application Project.
If you do not see this menu item, try New > Other.
2 On the Select a Wizard page, expand webMethods > Composite Applications > Web
Application Project, and click Next.
3 In the Project Name field of the New Dynamic Web Project page, type a name for the
Web application.
The project name cannot have spaces or any of the following characters:
* | \ : " < > . / ?
4 From the Target Runtime list, choose Tomcat.
5 From the Configuration list, choose the CAF Web Application.
6 From the Project Template list, choose a project template to be used for the Web
application and click Next.
For information on project templates, see
“Project Templates” on page

38
.
7 On the Project Facets page, click Next.
8 On the Web Module page, click Next.
9 For JSF Libraries on the JSF Capabilities page, choose the CAF Base JSF Runtime option
and clear the Deploy check box.
This choice causes the CAF Base JSF Runtime component library to be associated with
the Web application but not deployed with the application when you publish it to the
server.
10 Under Component Libraries, move CAF Base Controls to the right box and clear the
Deploy check box.
This choice causes the CAF Base Controls component library to be associated with the
Web application but not deployed with the application when you publish it to the
server.
11 Click Finish.
12 To associate the Web application you have created with the application server, see
“Associating Web Applications with an Application Server” on page