acl-field-list

Get a list of the values for all the instances of a field name on your Adobe Connect Server account.

Availability

Breeze 5

Description

Returns a list of values for all instances of a field name on your Adobe Connect Server account.

For example, to list the first names of all users in the account, call acl-field-list with field-id=first-name.

You can call acl-field-info first to get a list of field names.

Request URL

 http://server_name/api/xml
  ?action=acl-field-list
  &field-id=string
  &session=BreezeSessionCookieValue
 http://server_name/api/xml   ?action=acl-field-list   &field-id=string   &session=BreezeSessionCookieValue
 http://server_name/api/xml 
     ?action=acl-field-list 
     &field-id=string 
     &session=BreezeSessionCookieValue

Parameters

Name

Type

Required

Description

field-id

String

Y

The name of a field in the access control list for which you want values and IDs. Only one field name is allowed.

session

String

N

The value of the BREEZESESSION cookie. Use this parameter if you do not use a client-side cookie management library.

Filters

Results cannot be filtered or sorted.

Response structure

<?xml version="1.0" encoding="utf-8" ?>
<results>
<status code=allowedValue />
<acl-field-list>
<acl acl-id=integer>
<value>string</value>
</acl>
  ...
</acl-field-list>
</results>
 <?xml version="1.0" encoding="utf-8" ?>  <results>   <status code=allowedValue />   <acl-field-list>   <acl acl-id=integer>   <value>string</value>   </acl>   ...   </acl-field-list>  </results>
 <?xml version="1.0" encoding="utf-8" ?>  
 <results>  
     <status code=allowedValue />  
     <acl-field-list>  
         <acl acl-id=integer>  
             <value>string</value>  
         </acl> 
         ... 
     </acl-field-list> 
 </results>

Response values

Element

Attribute

Type

Description

results

Container

All results the action returns.

status

Empty, with attributes

The status of the response.

code

Allowed value

A code indicating the response status (see status).

acl-field-list

Container

Information about all of the values in the account for the specified field.

acl

Container

Information about one value for the specified field.

acl-id

BIGINT

The ID of the principal, SCO, or account the field belongs to.

value

String

The value of the field.

Sample request

 https://example.com/api/xml?action=acl-field-list&field-id=first-name
 https://example.com/api/xml?action=acl-field-list&field-id=first-name
 https://example.com/api/xml?action=acl-field-list&field-id=first-name

Sample response

<?xml version="1.0" encoding="utf-8" ?>
<results>
<status code="ok"/>
<acl-field-list>
<acl acl-id="381223">
<value>John</value>
</acl>
<acl acl-id="381302">
<value>Daryl</value>
</acl>
<acl acl-id="381405">
<value>Mary</value>
</acl>
</acl-field-list>
</results>
 <?xml version="1.0" encoding="utf-8" ?>  <results>   <status code="ok"/>   <acl-field-list>   <acl acl-id="381223">   <value>John</value>   </acl>   <acl acl-id="381302">   <value>Daryl</value>   </acl>   <acl acl-id="381405">   <value>Mary</value>   </acl>   </acl-field-list>  </results>
 <?xml version="1.0" encoding="utf-8" ?> 
 <results> 
     <status code="ok"/> 
     <acl-field-list> 
         <acl acl-id="381223"> 
             <value>John</value> 
         </acl> 
         <acl acl-id="381302"> 
             <value>Daryl</value> 
         </acl> 
         <acl acl-id="381405"> 
             <value>Mary</value> 
         </acl> 
     </acl-field-list> 
 </results>

See also

Get help faster and easier

New user?