Using Connect Enterprise Web Services

Meetings > Create meetings

Create meetings

A user must be an Administrator to create an Acrobat Connect meeting, which means the user is a member of the Meeting Hosts group. In the response from principal-list, this group has type=live-admins.

A meeting can be either public or private, and to create each, you need to set a specific combination of principal-id and permission-id:

• Public, equivalent to Anyone who has the URL for the meeting can enter the room
  principal-id=public-access&permission-id=view-hidden
• Private, equivalent to Only registered users and accepted guests can enter the room
  principal-id=public-access&permission-id=denied

If a meeting is private, registered users invited as meeting participants can enter by clicking the meeting room URL and logging in. Users who are not invited can log in as guests. The meeting host receives a guest's request to enter (known as knocking) and can accept or decline.

Create a public meeting and add host, presenter, and participants

1. Call principal-list to check that the user creating the Acrobat Connect meeting is a member of the live-admins group:

   https://example.com/api/xml?action=principal-list&group-id=624523
           &filter-is-member=true&filter-like-name=bob
   

2. Call sco-shortcuts to obtain the sco-id of the user's my-meetings folder:

   https://example.com/api/xml?action=sco-shortcuts
   

3. Parse the response for the sco element with type=my-meetings:

   <sco tree-id="624530" sco-id="2006258750" type="my-meetings">
     <domain-name>http://example.com</domain-name> 
   </sco>
   

4. Call sco-update to create the meeting room:

   https://example.com/api/xml?action=sco-update
       &type=meeting&name=October All Hands Meeting
       &folder-id=2006258750&date-begin=2006-10-01T09:00
       &date-end=2006-10-01T17:00&url-path=october
   

   The folder-id is the sco-id of the user's my-meetings folder.

5. Parse the response for the sco-id of the new meeting:

   <sco folder-id="2006258750" lang="en" account-id="624520" 
           type="meeting" icon="meeting" sco-id="2007184134" version="0">
       <date-begin>2006-10-01T09:00</date-begin> 
       <date-end>2006-10-01T17:00</date-end> 
       <url-path>/october/</url-path> 
       <name>October All Hands Meeting</name> 
   </sco>
   

   You might want to store the url-path to the meeting, if you plan to create a URL to the meeting room later.

6. Call permissions-update to make the meeting public. Use the sco-id of the meeting as the acl-id:

   https://example.com/api/xml?action=permissions-update&acl-id=2007018414
       &principal-id=public-access&permission-id=view-hidden
   

7. Call permissions-update to add a host, a presenter, and participants:

   https://example.com/api/xml?action=permissions-update
       &principal-id=2006258745&acl-id=2007018414&permission-id=host
   

8. Use a permission-id of host for the meeting host.
9. Use mini-host for the presenter.
10. Use view for meeting participants.
11. You can specify multiple trios of principal-id, acl-id, and permission-id on one call to permissions-update.
12. Create the URL to the meeting room (see "Create meeting room URLs").

Create a private meeting and add host, presenter, and participants

1. Log in as your application's Administrator user.
2. Follow the steps for creating a public meeting, but set the meeting permission to private:

   https://example.com/api/xml?action=permissions-update&acl-id=2007018414
       &principal-id=public-access&permission-id=denied
   

3. Call permissions-update again to add a host, a presenter, and guests.
4. Create the URL to the meeting room (see "Create meeting room URLs").

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/breeze/6/xml_api/03a_mee5.htm

Add Comment