Bb::Collaborate::Ultra - Perl bindings for Blackboard Ultra virtual classrooms
Version 0.01.02
use Bb::Collaborate::Ultra::Connection; use Bb::Collaborate::Ultra::Session; use Bb::Collaborate::Ultra::User; use Bb::Collaborate::Ultra::LaunchContext; my %credentials = ( issuer => 'OUUK-REST-API12340ABCD', secret => 'ABCDEF0123456789AA', host => 'https://xx-csa.bbcollab.com', ); # connect to server my $connection = Bb::Collaborate::Ultra::Connection->new(\%credentials); $connection->connect; # create a virtual classroom, starts now runs, for 15 minutes my $start = time() + 60; my $end = $start + 900; my $session = Bb::Collaborate::Ultra::Session->post($connection, { name => 'Test Session', startTime => $start, endTime => $end, }, ); # define a session user my $user = Bb::Collaborate::Ultra::User->new({ extId => 'dwarring', displayName => 'David Warring', email => 'david.warring@gmail.com', firstName => 'David', lastName => 'Warring', }); # register the user. obtain a join URL my $launch_context = Bb::Collaborate::Ultra::LaunchContext->new({ launchingRole => 'moderator', editingPermission => 'writer', user => $user, }); my $url = $launch_context->join_session($session);
Blackboard Collaborate Ultra is software for virtual web classrooms. It is suitable for meetings, demonstrations web conferences, seminars, general training and support.
Bb-Ultra is a set of Perl bindings and entity definitions for the Collaborate REST services. These can be used to administer classrooms, including sessions, users and recordings.
This Perl 5 module provides bindings to the the Collaborate (*) Services RESTful API. These support the CRUD and processing operations for the scheduling and access to HTML sessions.
These services are described in https://xx-csa.bbcollab.com/documentation.
Each resource class is represented by a Perl 5 class:
The above classes are based on Bb::Collaborate::Ultra::DAO, which provides low level `post`, `get`, `patch` and `delete` methods. Where:
Some conversion is needed between JSON and Perl:
These conversions are applied on data being sent or received from the Collaborate Ultra server.
Authentication is via the OAuth 2.0 protocol, using the JWT Token Flow, as described in the documentation.
See Bb::Collaborate::Ultra::Connection for details.
Tjhis is a sample script to dump basic session logging for a completed session.
Copyright 2017 David Warring, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Bb::Collaborate::Ultra, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Bb::Collaborate::Ultra
CPAN shell
perl -MCPAN -e shell install Bb::Collaborate::Ultra
For more information on module installation, please visit the detailed CPAN module installation guide.