20
Presentations 2Go BlackBoard BuildingBlock Version 1.0.x for Blackboard 9.1 SP11 and higher updated December 2014

Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

  • Upload
    others

  • View
    2

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

Presentations 2Go BlackBoard BuildingBlock

Version 1.0.x

for Blackboard 9.1 SP11 and higher

updated December 2014

Page 2: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 1

Presentations 2Go BlackBoard Building Block v1.0.x Page | 1

Table of Contents 1 Introduction .................................................................................................................................... 2

1.1 About Presentations 2Go ........................................................................................................ 2

2 Installation guide............................................................................................................................. 4

2.1 Preparations ............................................................................................................................ 4

2.2 Upload Building Block ............................................................................................................. 5

2.3 Configure the Building Block settings (OPTIONAL) ................................................................. 8

2.4 Change Tool settings ............................................................................................................... 9

2.5 Check settings ....................................................................................................................... 11

3 Repository management ............................................................................................................... 12

3.1 Create .................................................................................................................................... 12

3.1.1 Presentations 2Go Video server preparations .............................................................. 12

3.1.2 Blackboard configuration .............................................................................................. 13

3.2 Edit ........................................................................................................................................ 14

3.3 Search Criteria ....................................................................................................................... 14

3.4 Access control ....................................................................................................................... 15

4 Teacher instructions...................................................................................................................... 16

4.1 Introduction .......................................................................................................................... 16

4.2 Create content ...................................................................................................................... 17

4.2.1 Information ................................................................................................................... 17

4.2.2 Optional Files ................................................................................................................ 18

4.2.3 Media Selection ............................................................................................................ 18

4.2.4 Search Criteria ............................................................................................................... 18

4.2.5 Options .......................................................................................................................... 19

Page 3: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 2

Presentations 2Go BlackBoard Building Block v1.0.x Page | 2

1 Introduction Thank you for choosing Presentations 2Go!

At Presentations 2Go, product function and quality are our top priority. We make every effort to

ensure that our products exceed our clients’ expectations. Regular contact with our customers

ensures product performance and reliability. We strive to continually enhance our products to

accommodate your needs.

1.1 About Presentations 2Go

Presentations 2Go is a high quality solution for effortless recording, storage and public distribution

of all your web lectures, online training, press conferences, product presentations, conferences,

congresses and other events or meetings

Video images of the speaker are automatically linked to the presentation, broadcast live and stored

online for re-use. Presentations 2Go is suitable for a wide range of purposes. You can begin with a

simple set-up that can gradually be expanded to a total online video streaming facility.

Note: A version of Presentations 2Go is available to suit every need. For a comparative table of

detailed specifications, visit our website: http://www.presentations2go.eu.

The Presentations 2Go team

Page 4: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 3

Presentations 2Go BlackBoard Building Block v1.0.x Page | 3

Page 5: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 4

Presentations 2Go BlackBoard Building Block v1.0.x Page | 4

2 Installation guide

2.1 Preparations

Before you install the Presentations 2Go Buildingblock, you need to enable custom database objects.

Go to System Admin

Select Building Blocks

Select Installed tools

Click Global Settings

Page 6: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 5

Presentations 2Go BlackBoard Building Block v1.0.x Page | 5

Change the database setting to either Prompt or Allow.

Confirm with Submit.

2.2 Upload Building Block

Once you have prepared your system you can upload and install the Building Block.

Go to System Admin

Select Building Blocks in the section Building Blocks

Select Installed tools

Now select

Browse to the WAR file on your local disk.

Submit to upload the file.

In case you forgot the first step you will get this warning. Please go back to 2.1 and adjust your

custom database settings.

Page 7: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 6

Presentations 2Go BlackBoard Building Block v1.0.x Page | 6

Otherwise you will now see the Building Block privileges.

Continue with Approve.

Page 8: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 7

Presentations 2Go BlackBoard Building Block v1.0.x Page | 7

Page 9: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 8

Presentations 2Go BlackBoard Building Block v1.0.x Page | 8

Successfully Installed Building Block

2.3 Configure the Building Block settings (OPTIONAL)

Right-click on the installed Building Block and select settings.

Insert your key to unlock the building block

Change the email address and submit to confirm

2.4 Logging

You can download detailed log files when logging is enabled.

Page 10: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 9

Presentations 2Go BlackBoard Building Block v1.0.x Page | 9

2.5 Change Tool settings

Once the Building Block is installed, it will not yet be visible as content tool.

Tools are not yet visible

Go to System Admin

Select Tools in Tools and Utilities

Enable tools via System Admin

Page 11: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 10

Presentations 2Go BlackBoard Building Block v1.0.x Page | 10

Scroll down to Presentations2Go and turn the features on. Make sure you select New and

Existing courses/organizations

Confirm your settings with Submit at the bottom or top of the page.

Turn on all Presentations 2Go features

You might also want to check the Course Tools under Course settings.

Check also the course settings

Now you need to create a repository first. To learn more about managing and configuring

Repositories read chapter 3.

Page 12: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 11

Presentations 2Go BlackBoard Building Block v1.0.x Page | 11

2.6 Check settings

Once all settings are correct and you have created your first repository (see chapter 3), you should

see P2Go Item and P2Go List in your build content menu. Also there should be a Presentations 2Go

Mash-up feature in the normal BlackBoard items.

Page 13: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 12

Presentations 2Go BlackBoard Building Block v1.0.x Page | 12

3 Repository management A BlackBoard server can offer multiple Presentations 2Go repositories with this BuildingBlock. You

can define multiple virtual repositories all pointing to the same Presentations 2Go Videoserver.

However, it is also possible to assign multiple Presentations 2Go Videoservers, each with multiple

virtual repositories.

Each repository can have different BlackBoard managers assigned to it. As repository manager you

can update and configure your own repository settings.

3.1 Create

To create a new repository you need to have some basic information.

1. The API url usually https://yourserver.com/p2g/plugins/Catalogue.aspx

2. The Secret key file of a Presentations 2Go group

3. Optional search criteria.

3.1.1 Presentations 2Go Video server preparations

Create a group in the Presentations 2Go Video server (e.g. BlackBoard)

Now click more to find the secret key

Click Download Secret Key

Copy the secret key to your Clipboard

Page 14: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 13

Presentations 2Go BlackBoard Building Block v1.0.x Page | 13

3.1.2 Blackboard configuration

Sign-in to BlackBoard

Select System Admin menu

Click Presentations 2Go Repositories

Here you will find all existing repositories and the

option to create new ones.

Click Create Repository

Give your repository a representative name

Enter the URL to the Presentations 2Go Video server

Enter the exact same Authorization group name as used in Presentations 2Go video server

group name.

Paste the key your copied to clipboard earlier.

Page 15: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 14

Presentations 2Go BlackBoard Building Block v1.0.x Page | 14

Now first Submit your settings before you can continue.

3.2 Edit

Once you have defined the basic configuration settings you can refine your repository with search

criteria.

Right-click the new repository and select edit

3.3 Search Criteria

You can limit your repository output to fit additional criteria. Multiple criteria can be given; only

items that satisfy all criteria will be available to the teachers. Text searches are case-insensitive.

Add additional criteria with Add Criteria

In addition to literal values you can also use variables in your search definition. These variables will

be replaces by real values at the time (and in the context) where the search is executed. The

supported variables are:

${course.title} title of the course

${course.id} the course id; for example INTP01.2013-2014.1a

${course.short} the short course id; for example INTP01

Page 16: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 15

Presentations 2Go BlackBoard Building Block v1.0.x Page | 15

${course.year} the year, if available in course id; example 2013-2014

${course.period} the period, if available in the course id; example 1a

${course.yearWithPeriod} combination of year and period; example 2013-2014.1a

${today} today's date (remember: at the time the search runs!)

${today.minus.N} where N is a positive number; days in the past from today

3.4 Access control

Access to add items from the repository into a course can be restricted to people who have a specific

institution role or who are enrolled in a certain course (or organization).

Important: this restriction is only in effect while adding recordings to the course; once the recording

is added everyone in the course can view it.

Page 17: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 16

Presentations 2Go BlackBoard Building Block v1.0.x Page | 16

4 Teacher instructions

4.1 Introduction

Once the Presentations 2Go buildingblock is in place, it allows users with certain roles to insert a

single item or smart lists into a course.

There are three methods to insert content

1. Mash-up method; Select a video to show in a regular content item

2. P2Go item; Select a video to show in your content item.

3. P2Go list; A P2Go List is a dynamic list. Each time a student opens the list item, the items are

updated to meet the list search criteria.

Course documents list with Presentations 2Go content

Example of dynamic list

Page 18: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 17

Presentations 2Go BlackBoard Building Block v1.0.x Page | 17

Hover over the title to retrieve slides (when available)

4.2 Create content

Open your course in Edit mode

Select Build Content

Select your content item to create

4.2.1 Information

Use the information section to give your List or item a title and

description.

Page 19: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 18

Presentations 2Go BlackBoard Building Block v1.0.x Page | 18

4.2.2 Optional Files

Optional you can add additional files like PDFs or PPTs below the list items.

4.2.3 Media Selection

Video material is stored in repositories. You will only see repositories that you are authorized to use.

The content available per repositories is already restricted by the blackboard administrator.

4.2.4 Search Criteria

Add criteria to show only a subset of available recordings (you can also leave the criteria blank to

include all videos). Use the international date format (example: 1999-12-31) when using date

criteria. It is also possible to use a special date value ${today.minus.N} where N is a positive number;

this signifies a number of days in the past relative to the day when someone clicks on this item.

Example: `publication date < ("before") ${today.minus.7}` will daily generate a new list with

recordings that are at that time at lease one week old.

Now you can add search criteria. The criteria behave like AND queries and are added to the criteria

already defined in the repository definitions.

The lists with search fields and values are dynamic and retrieved automatically from the

Presentations 2Go Video server.

Page 20: Presentations 2Go BlackBoard BuildingBlockPresentations 2Go BlackBoard Building Block v1.0.x Page | 8 Successfully Installed Building Block 2.3 Configure the Building Block settings

V0.9 Webpart installation manual www.presentations2go.eu March 2010 P a g e | 19

Presentations 2Go BlackBoard Building Block v1.0.x Page | 19

Show results of present criteria

Add new query

Remove query

Smart filters

In addition to literal values you can also use variables in your search definition. These variables will

be replaces by real values at the time (and in the context) where the search is executed. The

supported variables are:

${course.title} title of the course

${course.id} the course id; for example INTP01.2013-2014.1a

${course.short} the short course id; for example INTP01

${course.year} the year, if available in course id; example 2013-2014

${course.period} the period, if available in the course id; example 1a

${course.yearWithPeriod} combination of year and period; example 2013-2014.1a

${today} today's date (remember: at the time the search runs!)

${today.minus.N} where N is a positive number; days in the past from today

4.2.5 Options

Use the Option features to restrict or time your item visibility.