To invoke a Nucleus form handler, send a Legacy REST Web Services request as described in the following table.

Request Component


HTTP Method


Functional Parameters

Submit the required property values of the form as functional parameters. Name each parameter with the property name it corresponds to. See Submitting Legacy REST Form Values.


Include the component pathname in the application path after /rest/bean/. Include the name of the form handler operation at the end of the path. See Nucleus Components.

The following example shows a Legacy REST Web Services request that invokes the create operation of /atg/store/profile/RegistrationFormHandler. The HTTP request includes functional parameters to supply the value property of the form handler. The data type of the value property is java.util.Dictionary; parameter names such as value.password correspond to the password key in the dictionary value.

curl -v -b cookies.txt -X POST \
-H "Content-Type: application/json" \
-d "{ "":"", "value.password":"mypassword",
"value.confirmPassword":"mypassword", "value.firstName":"Severe",
"value.lastName":"Heroux" }" \

* About to connect() to myserver port 8080 (#0)
*   Trying 12.34.567.890... connected
* Connected to myserver (12.34.567.890) port 8080 (#0)
> POST /rest/bean/atg/store/profile/RegistrationFormHandler/create HTTP/1.1
> User-Agent: curl/7.21.1 (i386-pc-win32) libcurl/7.21.1 zlib/1.2.5
> Host: myserver:8080
> Accept: */*
> Content-Type: application/json
> Content-Length: 147
< HTTP/1.1 200 OK
< Server: Apache-Coyote/1.1
< X-Powered-By: Servlet 2.5; JBoss-5.0/JBossWeb-2.1
< X-ATG-Version: version=
* Replaced cookie DYN_USER_ID="140003" for domain myserver, path /,
expire 1291317542
< Set-Cookie: DYN_USER_ID=140003; Expires=Thu, 02-Dec-2010 19:19:02 GMT; Path=/
* Replaced cookie DYN_USER_CONFIRM="1231cf3e7573bf936dbd29dbbbfe150b" for
domain myserver, path /, expire 1291317542
< Set-Cookie: DYN_USER_CONFIRM=1231cf3e7573bf936dbd29dbbbfe150b; Expires=Thu,
02-Dec-2010 19:19:02 GMT; Path=/
< Content-Type: application/xml;charset=UTF-8
< Transfer-Encoding: chunked
< Date: Tue, 02 Nov 2010 19:19:02 GMT
<?xml version="1.0" encoding="UTF-8"?>

* Connection #0 to host myserver left intact
* Closing connection #0

Copyright © 1997, 2013 Oracle and/or its affiliates. All rights reserved. Legal Notices