Chapter 1   Overview


The iPlanet Application Server Enterprise Connector for PeopleSoft is used for building and delivering scalable applications that integrate the application server, with PeopleSoft Enterprise Resource Planning (ERP) management systems.

This chapter introduces the iPlanet Application Server Enterprise Connector for PeopleSoft and describes some fundamental concepts the administrator should be familiar with when setting up the connector for PeopleSoft. This chapter contains information about the following topics:

• Unified Integration Framework

• Three-tier Application Model

• High-level System Architecture

• Enterprise Connector Tools for PeopleSoft

• National Language Support

Unified Integration Framework

---

The Unified Integration Framework (UIF) is an application programming framework that provides a single Application Programming Interface (API) to access different Enterprise Information Systems (EIS). A connector is developed for each EIS to allow communication between the UIF API and the EIS, as sene Figure 1-1. The UIF API is the only API necessary to access the EIS.

Figure 1-1    Unified Integration Framework

The UIF enables development of server extensions that integrate with legacy systems, client-server applications, and third-party Internet solutions. These extensions provide a consistent access layer to disparate back end systems, dramatically reducing development effort. The framework provides support for features such as object-pooling, and distributed state and session management

A generic data repository is also part of the UIF, which is used to hold metadata parameters and other information about the back end system. For example, the metadata often describes the physical connection between systems, the data that is available, and methods you can use to process data.

The implementation of each connector is specific to the Enterprise Information Systems (EIS) since each EIS is different.

UIF Services

The UIF is a component of the iPlanet Application Server. The iPlanet Application Server plays a prominent role in a three-tier application model, (see Three-tier Application Model for a description). The UIF mediates between the iPlanet Application Server application and the EIS tier, namely the data sources and databases.

The UIF provides an API to access the following services:

• Runtime

• Data Object Services

• Repository and Metadata Services (not available to users)

Runtime

The UIF runtime services supply core services for resource management, thread management, communication and life cycle management, and exception management. The UIF runtime services understand and interpret metadata repository contents.

Data Object Services

The Data Object Services implements universal data representation common to all connectors. See the iPlanet Application Server Enterprise Connector for PeopleSoft Developer's Guide for a description of data objects.

Repository and Metadata Services

The UIF repository and metadata services model a persistent information hierarchy that supports data type definitions, and inheritance. It also manages the instances and reuse of data objects from data type definitions.

Three-tier Application Model

---

The machine and software involved are divided into the following three tiers:

• Client Tier

• Server Tier (iPlanet Application Server)

• EIS Tier

The connectors serve as an essential link allowing the server tier to communicate with the EIS tier, as shown in Figure 1-2. Communication between the application server and the EIS is facilitated by the UIF API. This layer of functionality resides as an added layer to the iPlanet Application Server, and enables data communication with diverse EIS's in a seamless and uniform manner.

Figure 1-2    Three-tier Web-based Computer Model

Client Tier

The client tier is represented as the user interface. Requests for data originate here, represented by web browsers or rich clients (such as a Java applet).

Server Tier

The server tier is represented by an application server and optionally a web server such as the iPlanet Web Server Enterprise Edition. The server tier houses the business logic (Enterprise Java Beans and/or your application servlets), and provides scalability, high availability load balancing, and integration with a variety of data sources.

EIS Tier

The EIS tier is represented by an ERP systems database or another EIS data system, such as CICS.

High-level System Architecture

---

When the iPlanet Application Server startup process begins, the UIF loads the connector into the process. Before you receive a client request, the daemon needs to be started manually. See Launching the Daemon in Chapter 2. The connector notifies the daemon of the request using a proprietary protocol. The daemon either creates a new worker process to process the request or passes on the request to an idle worker process. The actual conversation to the EIS is done by the worker process. The worker process returns the results to the connector using the proprietary protocol. Figure 1-3 displays the system flow of the iPlanet Application Server.

Figure 1-3    System Flow

Enterprise Connector Tools for PeopleSoft

---

The Enterprise Connector Tools are as follows:

• Management Console - includes User Mapping and Data Mining Tools
  • User Mapping - allows you to map user IDs for access into the EIS, and to edit and manage data sources.

    A data source represents the connection to the EIS.

  • Data Mining Tool - includes capabilities such as determining the available functions in the EIS, translating and reformatting data, and loading data into the data repository.

• Repository Browser - allows you to browse data in the repository. You can view the available functions (input and output parameters) for the EIS.

The Management Console

The iPlanet Application Server Enterprise Connector for PeopleSoft has an interactive Management Console Tool. This tool is used by the data source administrator to do the following:

• data mine function objects and data types from the EIS metadata, and populate the repository with these data-mined definitions

• administer repository contents for creating new data sources, editing settings, and altering pooling settings

• populate user-mapping tables in the data repository

For more information on the Management Console, see Chapter 3 "Managing Data".

The Repository Browser

The Repository Browser allows the user to explore the repository contents. Repository contents are modified/populated using the import function. The import function is also available as a browser function and as a command-line tool, and imports XML under a specified repository node. Additionally, the export function is available as a browser function and as a command-line tool and exports a selected subtree as an XML document. For more information on the Repository Browser, see Chapter 3 "Managing Data".

---

Caution

The Repository Browser should not be used for editing even though import, export, and delete actions on repository nodes are enabled. Only advanced administrators should use the available functions.

---

National Language Support

---

Although UIF provides Nation Language Support, the PeopleSoft Message Agent API only supports the ASCII character set. Therefore, NLS entries in the repository cannot be modified.