Perl bindings for the Blackboard Collaborate Standard Bridge V3 API.

Blackboard Collaborate is software for virtual online classrooms. It is
suitable for meetings, demonstrations web conferences, seminars and
general training and support.

Bb::Collaborate::V3 is a set of Perl bindings and entity definitions for the
Collaborate Standard Bridge V3 SOAP services on SAS servers.

INSTALLATION
============
To install this module, run the following commands:

	perl Makefile.PL
	make
	make test
	make install

SERVER CONFIGURATION
====================

Session Admininstration System (SAS)
------------------------------------
Please ensure that the V3 API has been enabled and use the username, password
and end-point URL, as provided.

Elluminate Live Manager (ELM)
-----------------------------
Please ensure that your the standard bridge (V3) is enabled. To do this,
login to http://your_server.com/elmcontrol with an appropriate administrator
account.

Edit/create the appropriate server instance and tick 'Elluminate Standard
Bridge V3 ...' in the 'Bridge Selection' section.

You will then be asked to enter the API username and password. 

LIVE TESTING

    There are additional live tests in t/soap-*.t. By default, these
    either skipped or run offline.

    These may be run against a live server by setting up the environment
    variables, an running tests, as shown below:

        perl Makefile.PL
        make
        export BBC_TEST_URL=http://sdk_user@myserver.com/some_instance
        export BBC_TEST_PASS=secret
        make test

    WARNING: These tests will both create and delete various entities
    instances. For this reason you should by wary of running the live
    tests on production sites.

    Consider restricting live testing to designated development and test
    sites, or newly created site instances!

POST INSTALLATION

    The elive_query script can be used to check basic operation of Elive
    and access to your Elluminate server(s).

        % elive_query --adapter=v3 http://sdk_user@myserver/mysite
        Password: ******

    You can then try a simple query:

        elive> select * from serverVersions   
                      
        versionId|versionMaxFilmersLimit|versionMaxTalkersLimit|versionName
        ---------|----------------------|----------------------|-----------
        1001     |6                     |6                     |10.0.1     


SUPPORT AND DOCUMENTATION
=========================
After installing, you can find documentation for this module with the
perldoc command.

    perldoc Bb::Collaborate::V3

You can also look for information at:

    RT, CPAN's request tracker
        http://rt.cpan.org/NoAuth/Bugs.html?Dist=Bb-Collaborate-V3

    AnnoCPAN, Annotated CPAN documentation
        http://annocpan.org/dist/Bb-Collaborate-V3

    CPAN Ratings
        http://cpanratings.perl.org/d/Bb-Collaborate-V3

    Search CPAN
        http://search.cpan.org/dist/Bb-Collaborate-V3/

LICENSE AND COPYRIGHT

Copyright (C) 2015 David Warring

This program is free software; you can redistribute it and/or modify it
under the terms of either: the GNU General Public License as published
by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

