Setting Up Third Party Integration

This chapter provides an overview of third party integration and discusses how to:

• View delivered application classes.

• Synchronize data mapping tables.

• View delivered data mapping.

Understanding Third Party Integration

This section discusses the open integration framework and integration steps.

Open Integration Framework

PeopleSoft provides an open integration framework that enables you to integrate with Webcast and content management vendors to import activities into Enterprise Learning Management from an external source.

Here's a summary of how the integration works:

• For incoming data, an incoming message initiates the process.

  Using PeopleSoft PeopleTools Integration Broker, the open integration framework process reads the XML document contained in the message and uses the standard XSLT to transform the XML. Finally, the open integration framework maps the transformed data to the corresponding learning management data and processes that information.

• For outgoing data, such as requesting a Webcast learning component from a vendor, a functional process initiates the outgoing message.

  The process reads from the learning management tables and uses data mapping to create an XML document. This initial XML document may be changed into to a PeopleSoft XML document. Another change is then applied to either the initial XML document or to the subsequent PeopleSoft XML document, depending on the supplier’s needs, to create a final document. PeopleSoft PeopleTools Integration Broker then sends the final document.

Implementation Steps

PeopleSoft delivers the catalog import application classes that you need to integrate with third parties. You can view the application class types and classes on pages provided in the Set Up ELM menu.

PeopleSoft also delivers the data mapping required for importing files in standard formats. To complete the data mapping setup, you must run the Datamapping Sync process (HRS_DM_SYNC).

See Also

Setting Up and Using Activity Templates

Viewing Delivered Application Classes

To set up or view application classes, use the Application Class Registry component (HRS_APPCLASS).

This section provides an overview of application classes and discusses how to:

• View delivered application class types.

• View registered application classes.

Understanding Application Classes

The application class registry provides a flexible way to classify application classes. An application class type represents the specific interface, while the application classes that fall under that type implement that interface.

PeopleSoft delivers the application types and classes that you need to integrate Enterprise Learning Management with third-party Webcast and content sources.

See Also

Enterprise PeopleTools PeopleBook: PeopleCode Developer's Guide

Pages Used to View Delivered Application Classes

Viewing Delivered Application Class Types

Access the Application Class Type Setup page.

Name	The name describes this application class type.
Status	The current status of the class type. Values are: Active: Indicates a fully defined application class type. Deprecated: Indicates that the class type is in the process of being retired. While it is still usable, there should be a newer version available. In Progress: Indicates that the application class type is still in development. Retired: Indicates that the class type is no longer used and is maintained only for historical purposes.
Interface	The PeopleTools application class interface that the application class type is associated with.
Verification	Identifies the registered application class used to validate that application classes meet the type requirement.

Viewing Registered Application Classes

Access the Application Class Setup page.

Name	The name describes this application class.
Status	Status values are the same as for application class types. See Viewing Delivered Application Class Types.
Type	The application class type determines which interface and verification is used to validate that the application class meets the standard for the type.
Application Class	The official designation of the application class definition.

Synchronizing Data Mapping Tables

To synchronize data mapping tables, use the System Process Request (PRCSMULTI) component.

This section provides an overview and discusses how to run the Datamapping Sync process.

Understanding the Datamapping Sync Process

The first step in setting up data mapping is to run the Datamapping Sync Application Engine process (HRS_DM_SYNC). This process performs all of the data mapping for the catalog import process. The Datamapping Sync process copies the data from the original tables into the data mapping tables.

Note. To keep the tables in sync, re-run this process periodically as you add new data to the system .

Page Used to Run the Datamapping Sync Process

Running the Datamapping Sync Process

To run the Datamapping Sync process:

1. Access the Process Scheduler - System Process Requests page.

2. Enter a run control ID.

3. Click Run.

4. Select a process server.

5. Select the Datamapping Sync (HRS_DM_SYNC) process.

6. Click OK.

7. Click Process Monitor and verify that the process runs and posts successfully.

Viewing Delivered Data Mapping

To view or set up data mapping, use the Data Mapping Assignments (HRS_DM_MAP_SETUP), Category Setup (HRS_DM_CAT_SETUP), and Data Mapping (HRS_DM_MAPPING) components.

This section provides an overview of data mapping and discusses how to:

• View categories

• View key lists

• View value lists

• Map unmapped data

• Map keys

• Map values

Understanding Data Mapping

PeopleSoft delivers the data mapping required to import files in these standard formats:

• Aircraft Industry Computer Based Training Committee (AICC)

• Sharable Content Object Reference Model (SCORM) 1.2

• PeopleSoft XML

Data mapping assignments define how the system translates the words or phrases coming into the system into the words or phrases used by your system. You can set up data mapping definitions based on vendors or the 25 delivered categories such as objectives, catalog items, delivery methods, instructors, and so on. You can also create just one data mapping definition for everything coming into your system.

Data mapping categories are data objects that are used by the assigned maps to define how data is mapped. PeopleSoft delivers 25 data mapping categories:

• Catalog item.

• Category.

• Delivery method type.

• Instructor.

• Keyword.

• Keyword type.

• Language code.

• Objective.

• Person.

• Program.

• Review rating.

• Learner group

• Learning environment.

• Vendor.

• Currency codes.

• Reminder templates.

• Equipment.

• Facilities.

• Rooms.

• Materials.

• Learning component types.

• Learning component template.

• Roles.

• Frequency.

• Vendor product.

These delivered data mapping categories support the importing of learning components into activity templates. If you create a new data mapping category, you must also define an appropriate application class.

See Also

Creating Multiple Activities Using a Template (Catalog Import Process)

Pages Used to View Delivered Data Mapping

Viewing Categories

Access the Category Setup page.

AppClass (application class)	The application class associated with the category. Each category needs a corresponding appclass of the type Datamapping, that has been registered in the Application Class Registry component (HRS_APPCLASS). The category forms the definiton of the type of datamapping, while the appclass does the work of synchronizing the data from the original record into the datamapping tables.
Run Sync Now (run synchronization now)	Use when setting up new categories to synchronize the data associated with the selected data mapping category with the data actually existing in the corresponding component. This process populates the Key List and Value List pages.

Viewing Key Lists

Access the Key List page.

Subcategory	Serves as a secondary key for the data mapping functionality. Not all categories use the subcategory secondary key. Subcategories themselves must also be data mappings.
Keys	Displays the primary key for the category. These keys are determined by the data in the associated data mapping category tables. Click the key link to access the Key Data Mapping page. This page displays all the values that are mapped to the given key.

Viewing Value Lists

Access the Value List page.

The Value List page lists all the values that are being mapped to a category key. Click a link in the Keys column to access the Value Data Mapping page.

Mapping Unmapped Data

Access the Unmapped Data page.

Minimum Score	Identifies a threshold for the Make Suggestions search. Only results that are greater than or equal to the minimum score appear in the Key ID field. The score of every suggestion found appears to the right of each key ID item in parentheses.
Make Suggestions	Click to run a search that provides a suggested mapping based on the minimum score that you entered.

Mapping Keys

Access the Key Data Mapping page.

This page displays a complete list of all the values that are mapped to a given key.

Values

This group box enables you to add other values to the key. The values must be chosen from the unmapped data values.

Mapping Values

Access the Value Data Mapping page.

Displays all the keys that are mapped to the given value.

Keys

This group box displays all the keys that are mapped to the value and enables you to map more keys to the value. The keys that you add come from the unmapped data values.