Enterprise Learning Management 9.

0 Webcast Integration

Enterprise Learning Management Webcast and Calendaring

August 2006

Copyright Oracle Corporation 2006. All rights reserved.

Page 1 of 27

Enterprise Learning Management 9.0 Webcast Integration

Enterprise Learning Management 9.0 Webcast Integration

Copyright 2006, Oracle. All rights reserved. The Programs (which include both the software and documentation) contain proprietary information; they are provided under a license agreement containing restrictions on use and disclosure and are also protected by copyright, patent, and other intellectual and industrial property laws. Reverse engineering, disassembly, or decompilation of the Programs, except to the extent required to obtain interoperability with other independently created software or as specified by law, is prohibited. The information contained in this document is subject to change without notice. If you find any problems in the documentation, please report them to us in writing. This document is not warranted to be error-free. Except as may be expressly permitted in your license agreement for these Programs, no part of these Programs may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose. If the Programs are delivered to the United States Government or anyone licensing or using the Programs on behalf of the United States Government, the following notice is applicable: U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are commercial computer software or commercial technical data pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the Programs, including documentation and technical data, shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement, and, to the extent applicable, the additional rights set forth in FAR 52.227-19, Commercial Computer Software-- Restricted Rights (June 1987). Oracle Corporation, 500 Oracle Parkway, Redwood City, CA 94065. The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup, redundancy and other measures to ensure the safe use of such applications if the Programs are used for such purposes, and we disclaim liability for any damages caused by such use of the Programs. The Programs may provide links to Web sites and access to content, products, and services from third parties. Oracle is not responsible for the availability of, or any content provided on, third-party Web sites. You bear all risks associated with the use of such content. If you choose to purchase any products or services from a third party, the relationship is directly between you and the third party. Oracle is not responsible for: (a) the quality of third-party products or services; or (b) fulfilling any of the terms of the agreement with the third party, including delivery of products or services and warranty obligations related to purchased products or services. Oracle is not responsible for any loss or damage of any sort that you may incur from dealing with any third party. Oracle, JD Edwards, and PeopleSoft are registered trademarks of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. Open Source Disclosure Oracle takes no responsibility for its use or distribution of any open source or shareware software or documentation and disclaims any and all liability or damages resulting from use of said software or documentation. The following open source software may be used in Oracles PeopleSoft products and the following disclaimers are provided. Apache Software Foundation This product includes software developed by the Apache Software Foundation (http://www.apache.org/). Copyright 19992000. The Apache Software Foundation. All rights reserved. THIS SOFTWARE IS PROVIDED AS IS' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
Copyright Oracle Corporation 2006. All rights reserved.

Page 2 of 27

Enterprise Learning Management 9.0 Webcast Integration NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. OpenSSL Copyright 1998-2003 The OpenSSL Project. All rights reserved. This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/). THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT AS IS AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. SSLeay Copyright (C) 1995-1998 Eric Young. All rights reserved. This product includes cryptographic software written by Eric Young (eay@cryptsoft.com). This product includes software written by Tim Hudson (tjh@cryptsoft.com). Copyright (C) 1995-1998 Eric Young. All rights reserved. THIS SOFTWARE IS PROVIDED BY ERIC YOUNG AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDEING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Loki Library Copyright 2001 by Andrei Alexandrescu. This code accompanies the book: Alexandrescu, Andrei. Modern C++ Design: Generic Programming and Design Patterns Applied. Copyright (c) 2001. Addison-Wesley. Permission to use, copy, modify, distribute and sell this software for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. Helma Project Copyright 1999-2004 Helma Project. All rights reserved. THIS SOFTWARE IS PROVIDED AS IS AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE HELMA PROJECT OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Helma includes third party software released under different specific license terms. See the licenses directory in the Helma distribution for a list of these licenses. Sarissa Copyright 2004 Manos Batsis
Copyright Oracle Corporation 2006. All rights reserved.

Page 3 of 27

Enterprise Learning Management 9.0 Webcast Integration This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.

Copyright Oracle Corporation 2006. All rights reserved.

Page 4 of 27

Enterprise Learning Management 9.0 Webcast Integration

Table of Contents
1. Overview................................................................................................................................................. 6 2. Uploading a Vendor Configuration File ................................................................................................. 7 3. Webcast Integration Functionality........................................................................................................ 11 4. Calendaring Functionality..................................................................................................................... 13

Copyright Oracle Corporation 2006. All rights reserved.

Page 5 of 27

Enterprise Learning Management 9.0 Webcast Integration

1. Overview
This paper is intended to give interested parties a basic understanding of how to setup Webcast for integration with external vendors including WebEx, and Oracle Collaboration Suite. Also any vendor that supports calendaring functionality. This paper is primarily intended for learning administrators, and consultants with a technical background who understand messaging concepts. The following documentation is broken down into a few sections. Some of them are required to setup the application others have already been done and delivered with the system. Those steps that are already completed and not required are noted as such and only included in this document for information purposes.

Copyright Oracle Corporation 2006. All rights reserved.

Page 6 of 27

Enterprise Learning Management 9.0 Webcast Integration

2. Uploading a Vendor Configuration File

Note: The following steps are necessary to load a new Vendor and activate it. 1. Define the Service Configuration defaults by navigating to the Integration Broker Service Configuration page using the path: PeopleTools > Integration Broker > Configuration > Service Configuration.

2. Enter a value into the Target Location field and save the page. 3. Load the Gateways by navigating to the Integration Broker Service Configuration page using the path: PeopleTools > Integration Broker > Configuration > Gateways. 4. You should be brought into the page automatically for the Gateway ID = LOCAL. 5. Click on the Load Gateway Connectors button and then save the page.

Copyright Oracle Corporation 2006. All rights reserved.

Page 7 of 27

Enterprise Learning Management 9.0 Webcast Integration

6. Navigate to the Service Registry following the path: Set Up ELM > System Administration > Service Registry. 7. Click on the folder name Open Integration Framework

8. Click on the Add to service repository button. In the print screen its grayed out because we have already clicked it. It should be clickable in your system.

Copyright Oracle Corporation 2006. All rights reserved.

Page 8 of 27

Enterprise Learning Management 9.0 Webcast Integration

9. Load the Vendor Zip file: a. Navigate to Set Up ELM > Integration > Vendor, and click add.

b. Click on the Submit Configuration File button, locate your file and upload it. c. You will be brought to the next screen, Change the Status to Active and save the page.
Note: If you wish to upload a new Configuration File for the same vendor, navigate to this page for this vendor and select the Submit File link shown in the print screen below. Its in the Vendor Setup Group box in the lower right corner. Do not add a new vendor and upload another file, you will end up with two vendors with different IDs but the same name. This will not cause any harm in the system but when you select a vendor from the vendor drop down on the session page you will see two vendors with the same name. Also any sessions that you have already linked to the first vendor will still use that configuration not the new configuration.

Copyright Oracle Corporation 2006. All rights reserved.

Page 9 of 27

Enterprise Learning Management 9.0 Webcast Integration

Copyright Oracle Corporation 2006. All rights reserved.

Page 10 of 27

Enterprise Learning Management 9.0 Webcast Integration

3. Webcast Integration Functionality

Once all the setup is performed in the above steps the following new functionality will be available. Messages can be sent either real-time or in batch. This is determined by selecting the option Perform Real Time Transactions in the Extended setup page for the specific Vendor. Navigate to Setup ELM > Integration > Vendor. Select your Vendor and then select the Extended Setup link to get to this option. If you have chosen not to enable Real-Time Transactions then an Administrator is required to process the transactions manually by completing the following steps. 1. Navigate to the Vendor Message Management Page by following the path: Enterprise Learning > Vendor Message Management. You are able to search for messages using the search criteria available. 2. Select each message that you wish to publish and then click on the Publish button. Once the message is complete you will see the Status updated. You will be able to click on the Status link to navigate to the Integration Log in order to drill into more detail about the message. Successful messages are deleted from the log. You will see them as success while you are on the page, however when you leave the page and return at a later time you will only see messages awaiting to be published (pending) or those in the error state.

When it is mentioned below that a message is sent, this is to be read as either in Real-Time or Batch mode depending on your setup. For Integration with Oracle Collaboration Suite: 1. When an administrator creates a new Session for an active Activity with a component type of Webcast a message will be sent to the vendor to create the session on the vendor site and return two URLs, one to be used for this Activity when the Learner launches this session and the other for when the Instructor launches the Activity. 2. When an administrator edits an existing Session for an active Activity with a component type of Webcast a message will be sent to the vendor to update the session on the vendor site and return two URLs, one to be used for this Activity when the Learner launches this session and the other for when the Instructor launches the Activity. 3. When an administrator deletes an existing Session for an active Activity with a component type of Webcast a message will be sent to the vendor to delete the session on the vendor site. 4. Special circumstances: a. If the user creates a new session resulting in a message being inserted into the log table then deletes the session before the original create session message has been sent, the application will
Copyright Oracle Corporation 2006. All rights reserved.

Page 11 of 27

Enterprise Learning Management 9.0 Webcast Integration simply delete the original create session message from the log table and not insert a delete message. b. If the user creates a session resulting in a message being inserted into the log table then edits the session before the original create session message has been sent, the application will simply not insert the edit message into the log table. When the original create session message is sent it will send the most recent information and not need to send an edit message. c. If the user edits a session resulting in a message being inserted into the log table then edits the session again before the original create session message has been sent, the application will simply not insert the second edit message into the log table. When the original create session message is sent it will send the most recent information and not need to send a second edit message.

5. When an Activity is first created it begins with a status of Pending. No messages are sent for Activities unless they have a status of Active. When you change the status of an Activity from Pending to Active the Create message will be sent. When you change the status of an Activity from Active to Pending or to Inactive the delete/remove messages will be sent. 6. There is a new Host field in the instructor grid for Sessions. You need to select one instructor to be the host for this session. This instructor will be the person sent to the external system to be assigned as the host. If you do not select a Host the list of instructors in the grid is sorted alphanumerically and the first instructor in the list will be defaulted. 7. Oracle Collaboration Suite does not support the Add User message. This means that any instructor you assign to a session must already exist in the Collaboration Suite application. 8. Oracle Collaboration Suite does not support the Enroll and UnEnroll messages. To enroll learners or instructors in the Activity you must do it manually in the Collaboration Suite application.

Copyright Oracle Corporation 2006. All rights reserved.

Page 12 of 27

Enterprise Learning Management 9.0 Webcast Integration

4. Calendaring Functionality
Calendar Batch Process Upon successful enroll of learners to an activity with sessions, the enrollment process (self-enrollment, team-enrollment, mass-enrollment) evaluates whether or not the Auto Mark Calendar is activated, and for each learner with proper calendar vendor setup, the process creates an entry into a batch record (pending status) for the calendaring batch process to pick up and mark the learners calendar for that activity session. Similarly, when a learner drops an enrollment from an activity, the enrollment process creates an entry into the calendaring batch file for the batch process to unmark the learners calendar. The batch process application engine program LM_CALENDAR can be scheduled through process scheduler to invoke the execution as desired by the system administrator. The administrator may also manually invoke the calendaring batch process through Enterprise Learning ! Process Calendar

When you press the Search button, it will fill out the result grid and collapse the search box.

Copyright Oracle Corporation 2006. All rights reserved.

Page 13 of 27

Enterprise Learning Management 9.0 Webcast Integration

The search for Vendor is based on the PS_HRS_CAL_SRCH_VW that lists only active vendors of transaction group for calendar. Since we expect the list of calendar vendors to be small, it is available from a drop down list.

The Activity Code search option redirects to Lookup Activity Code search page and Learner ID search to Lookup Learner ID search page.

Copyright Oracle Corporation 2006. All rights reserved.

Page 14 of 27

Enterprise Learning Management 9.0 Webcast Integration

For search criterion that resulted in no matching rows, the standard No Search Results is displayed.

Otherwise the grid should display only the rows that meet the search criteria.

Copyright Oracle Corporation 2006. All rights reserved.

Page 15 of 27

Enterprise Learning Management 9.0 Webcast Integration

A Message Catalog entry produces the reminder note that the run-control will process all the data in the batch table.

Copyright Oracle Corporation 2006. All rights reserved.

Page 16 of 27

Enterprise Learning Management 9.0 Webcast Integration

For batch processing message logs:

Below is an example of message log on a successful completion of the calendar batch processing.

Copyright Oracle Corporation 2006. All rights reserved.

Page 17 of 27

Enterprise Learning Management 9.0 Webcast Integration

The process will send a notification to the Activity Administrator in an event the process failed to mark a learners calendar for that activity.

Copyright Oracle Corporation 2006. All rights reserved.

Page 18 of 27

Enterprise Learning Management 9.0 Webcast Integration

The following example is a notification that was sent to an administrators yahoo e-mail account.

Nicole Jarek has the business e-mail address.

Copyright Oracle Corporation 2006. All rights reserved.

Page 19 of 27

Enterprise Learning Management 9.0 Webcast Integration

The Activity Code IBS TERR MGMT WBT 01 administrator is Nicole Jarek.

If the administrator happens to have multiple activities, he will get one notification and the activities are listed in the list Activity code list as shown above.
Copyright Oracle Corporation 2006. All rights reserved.

Page 20 of 27

Enterprise Learning Management 9.0 Webcast Integration

Copyright Oracle Corporation 2006. All rights reserved.

Page 21 of 27

Enterprise Learning Management 9.0 Webcast Integration

Mark an Instructors Calendar. The system will mark the instructors calendar in real-time, if the instructor has setup his learner preference page with the proper calendar vendor and user-id and password and set to enable to mark his calendar.

Copyright Oracle Corporation 2006. All rights reserved.

Page 22 of 27

Enterprise Learning Management 9.0 Webcast Integration

However, the process will not mark the instructors calendar until the activity status is set to Active.

Copyright Oracle Corporation 2006. All rights reserved.

Page 23 of 27

Enterprise Learning Management 9.0 Webcast Integration

Since this activity is in Pending status the Update Instructor Calendar button is hidden as well.

Upon saving the new Active status, the system marks the instructors calendar.

Copyright Oracle Corporation 2006. All rights reserved.

Page 24 of 27

Enterprise Learning Management 9.0 Webcast Integration

The activity is active and Update Instructor Calendar button is visible. User can then modify the date or time of the session and by pressing the update button will update the instructors calendar entry.
Copyright Oracle Corporation 2006. All rights reserved.

Page 25 of 27

Enterprise Learning Management 9.0 Webcast Integration

Copyright Oracle Corporation 2006. All rights reserved.

Page 26 of 27

Enterprise Learning Management 9.0 Webcast Integration

Calendar Update. If the information on a session is modified, i.e. the time for the scheduled session is changed the system creates an entry in the calendar batch file to indicate that the activity session information need to be updated to the calendar of all enrolled learners to that activity.

The batch record entry has one row to represent an update to the activitys session. The batch process will validate all enrolled learners in that activity and make the update to the learners calendars with the new session information.

Copyright Oracle Corporation 2006. All rights reserved.

Page 27 of 27