MACROMEDIA BREEZE-USING THE BREEZE XML WEB SERVICES, Use Manual

Page: 25 / 196

Where to go from here 25
The result in the browser should look similar to the following:
<?xml version="1.0" encoding="utf-8" ?>
<results>
<status code="ok" />
<my-courses>
<course sco-id="2649026" status="active" type="course">
<name>Understanding Filters Part 2</name>
<description>Second course in the series, covering important topics such
as date and range filtering.</description>
<url>admin.ibreeze.macromedia.com/p40583853/</url>
<date-created>2004-05-26T17:51:40.840-07:00</date-created>
<date-modified>2004-05-26T17:51:47.750-07:00</date-modified>
<date-begin>2004-05-24T14:00:00.000-07:00</date-begin>
<url-path>/p40583853/</url-path>
<expired>false</expired>
</course>
</my-courses>
</results>
If your filters are too stringent and no courses meet your criteria, the output looks like this:
<?xml version="1.0" encoding="utf-8" ?>
<results>
<status code="ok" />
<my-meetings />
</results>
Finally, as you experiment with filters and APIs in the browser, you might get an unexpected
response. For example, if you enter the wrong filter field name, which matches some other item in
the database, you could receive an XML response that starts with the following:
<?xml version="1.0" encoding="utf-8" ?>
<results>
<status code="internal-error">
To be production-ready, develop your code to handle unexpected errors and situations. Make sure
you check for unexpected status codes and inform your IT team when you encounter such a
situation.
Where to go from here
The Macromedia Breeze Resource Center has an article called Working with Filters that describes
how to build a sample application that uses filters to search and sort a list of courses. In the article,
you learn how to use filters with Breeze web services by working through a simple example that
retrieves the list of enrolled courses for a user and allows the user to search and sort the list. It also
explains the different ways that filters help you optimize retrieved data for use in other enterprise
systems.