Once you create users and Adobe Connect meetings, you may need to calculate meeting usage. Meeting usage is often calculated in one of these ways:
The time each user spends in a specific meeting, in minutes per user
The number of concurrent meeting participants
The time a user spends in a meeting is measured by a transaction, which is the interaction between a principal and a SCO (in this case, between a user and a meeting). The date and time a transaction begins and ends are returned by report-bulk-consolidated-transactions.
-
Call report-bulk-consolidated-transactions, filtering for meetings and another value to identify the meeting, such as a date:
https://example.com/api/xml?action=report-bulk-consolidated-transactions &filter-type=meeting&filter-gt-date-created=2006-07-01
The second filter can be for the date the transaction began or ended, the principal-id of the user, the sco-id of a specific meeting, or another valid filter that meets your needs.
This call returns all transactions that meet the filter criteria. Be prepared for a large response.
The call also returns only users who logged in to the meeting as participants, not users who entered as guests.
-
<row transaction-id="2007071217" sco-id="2007071193" type="meeting" principal-id="2007003123" score="0"> <name>Thursday Meeting</name> <url>/thursday/</url> <login>jazz@doe.com</login> <user-name>jazzwayjazz doe</user-name> <status>completed</status> <date-created>2006-08-03T12:33:48.547-07:00</date-created> <date-closed>2006-08-03T12:34:04.093-07:00</date-closed> </row>
-
In your application, calculate the time difference between the two dates.
One way to do this (in Java™) is to write a utility method that converts the ISO 8601 datetime values returned in the response to a GregorianCalendar object. Then, convert each GregorianCalendar date to milliseconds, calculate the difference between the creation and closing times, and convert the difference to minutes.