NAME

Elive::Entity::Preload - Elluminate Preload instance class

DESCRIPTION

This is the entity class for meeting preloads.

    my $preloads = Elive::Entity::Preload->list(
                        filter =>  'mimeType=application/x-shockwave-flash',
                    );

    my $preload = Elive::Entity::Preload->retrieve($preload_id);

    my $type = $preload->type;

There are three possible types of preloads: media, plan and whiteboard.

METHODS

upload

    #
    # upload from a file
    #
    my $preload1 = Elive::Entity::Preload->upload('mypreloads/intro.wbd');

    #
    # upload in-memory data
    #
    my $preload2 = Elive::Entity::Preload->upload(
             {
                    type => 'whiteboard',
                    name => 'introduction.wbd',
                    ownerId => 357147617360,
                    data => $binary_data,
             },
         );

Upload data from a client and create a preload. If a mimeType is not supplied, it will be guessed from the name extension, using MIME::Types.

download

    my $preload = Elive::Entity::Preload->retrieve($preload_id);
    my $binary_data = $preload->download;

Download preload data.

import_from_server

    my $preload1 = Elive::Entity::Preload->import_from_server(
             {
                    type => 'whiteboard',
                    name => 'introduction.wbd',
                    ownerId => 357147617360,
                    fileName => $path_on_server
             },
         );

Create a preload from a file that is already present on the server's file-system. If a mimeType is not supplied, it will be guessed from the name or fileName extension using MIME::Types.

list_meeting_preloads

my $preloads = Elive::Entity::Preload->list_meeting_preloads($meeting_id);

Returns a list of preloads associated with the given meeting-Id or meeting object.

list

   my $all_preloads = Elive::Entity::Preload->list();

Lists all known preloads.

update

The update method is not available for preloads.

BUGS AND LIMITATIONS

• Under Elluminate 9.6.0 and LDAP, you may need to arbitrarily add a 'DomN:' prefix to the owner ID, when creating or updating a meeting.

      $preload->ownerId('Dom1:freddy');

• Elluminate 10.0 strips the file extension from the filename when whiteboard files are saved or uploaded (introduction.wbd => introduction). However, if the file lacks an extension to begin with, the request crashes with the confusing error message: "string index out of range: -1".

• As of ELM 3.3.5, The filter option appears to have no affect when passed to the list() method.