NAME

Elive::Connection::SDK - Manage Elluminate Live SDK SOAP connections.

DESCRIPTION

This module handles logical connections to Elluminate Live! sites.

Most of the time, you won't need to use this module directly, rather you'll create a default connection via Elive:

    Elive->connect('https://someserver.com', 'someuser', 'somepass');

However, if you need to manage multiple sites and/or servers. You can have multiple connections:

    my $connection1
            = Elive::Connection->connect('https://someserver.com/site1',
                                        'user1' => 'pass1',
                                        timeout => 100,
              );

    my $connection2
            = Elive::Connection->connect('https://user2:pass2@someserver.com/site2');

connect

    my $ec1 = Elive::Connection::SDK->connect('https://someserver.com/test',
                                              'user1', 'pass1', debug => 1);

    my $url1 = $ec1->url;   #  'https://someserver.com/test'

    my $ec2 =  Elive::Connection::SDK->connect('http://user2:pass2@someserver.com/test', undef, undef, debug => 1);
    my $url2 = $ec2->url;   #  'http://someserver.com/test'

Establishes a SOAP connection over http/https. Retrieves the login user, to verify connectivity and authentication details.

disconnect

Closes a connection and frees any resources related to the connection.

soap

    my $soap_lite_obj = $connection->soap;

Returns the underlying SOAP::Lite object for the connection.

call

    my $som = $self->call( $cmd, %params );

Performs an Elluminate SOAP method call. Returns the response as a SOAP::SOM object.

login

Returns the login user as an object of type Elive::Entity::User.

server_details

Returns the server details as an object of type Elive::Entity::ServerDetails.

version

Return the Elluminate Live! Server version