About Principals, Scos, And Ids - MACROMEDIA BREEZE-USING THE BREEZE XML WEB SERVICES Use Manual

For some actions, you can provide multiple parameters with the same name. For example, the
principals-delete
name-value pairs (each with the name
principal-id
on the Breeze server. The following CFML code example shows how to delete two specified users
in a single action call, by specifying two
variables called
baseurl
more information, see
<cfset idOne=12345>
<cfset idTwo=23456>
<cfhttp url="#baseurl#api/xml?action=principals-
delete&accesskey=#accesskey#&principal-id=#idOne#&principal-id=#idTwo#"
method="post">
<cfhttpparam type="Cookie" name="BREEZESESSION" value="#loginCookie#">
</cfhttp>
In some other actions, you can provide multiple sets of parameters. For example, the
membership-update
to make multiple updates in a single call, specify each of those parameters for principal and group,
and then specify them (using the same parameter names again) for another, and so on.

About principals, SCOs, and IDs

There are two basic kinds of entities in Breeze: principals and Shareable Content Objects (SCOs).
A principal is any entity that can have permissions that control how it can interact with SCOs.
The following are the most common types of principals:
A specific user.
user
A group of users.
group
There are other types of principals, known as primary groups:
and
course-admins
You can create and modify users and groups, but not primary groups.
A SCO is a Breeze document, such as a meeting or a presentation. Folders are also SCOs.
Breeze includes the following types of SCOs:
The root of a folder hierarchy. A tree's root is treated as an independent hierarchy; you
tree
can't determine the parent folder of a tree from inside the tree.
A folder on the server's hard disk, containing Breeze content.
folder
presentation
A course.
course
A meeting.
meeting
A Flash video file.
flv
A Flash SWF file.
swf
An image file.
image
16 Chapter 1: Architecture Overview
action takes a parameter named
, , and
accesskey
"Integrating Breeze with a directory service" on page
action takes parameters named
. For information about primary groups, see Using the Breeze Manager.
A presentation.
principal-id
principal-id
parameters. (This example relies on
principal-id
that you set during the login process. For
loginCookie
group-id
admins
; you can specify multiple
) when you call the action
28.)
, and
principal-id,
, ,
authors live-admins
group-
;
is-member
,