MACROMEDIA BREEZE-USING THE BREEZE XML WEB SERVICES, Руководство пользователя

Страница: 27 / 196

27
CHAPTER 3
Common Tasks
This chapter describes common scenarios for integrating Macromedia Breeze with external
applications or systems. These scenarios show how to accomplish several common tasks. To
perform each task, you call one or more actions on the Breeze server and then parse the XML tags
that the server returns. In some cases, you use returned information as parameter values for the
next action.
This chapter also provides sample code demonstrating how to perform some of the tasks using
Macromedia ColdFusion Markup Language (CFML).
Note: Not all the task descriptions include sample code. The syntax for calling an action is consistent
for all actions, so you can use the sample code from tasks that include it as models for code to
perform other tasks.
Each time you call an action on the Breeze server, you must include an access key and credentials
indicating which logged-in user is performing the action. For more information about the Breeze
security model, including information about access keys, see
“About security” on page 17 .
For detailed information about each action and each XML tag, see Chapter 4, “Action Reference,”
on page 37 and Chapter 5, “XML Results Reference,” on page 113 .
Calling your first action
You can enter a test URL in the address field of a browser window and see the XML response
from the server. You should be comfortable with actions in the browser before you write code. A
good action to call is
action-list
because it returns a list of all the other actions you can call.
To call an action in a browser, you need to know the following:
•
The domain of your breeze account.
For example,
breeze.yourcompany.com
.
•
The name of the action you want to call.
For a complete list of actions, see “Action Reference” on page 37 .