Configuring Instant Messaging in PeopleSoft MultiChannel Framework

Lotus Sametime will connect with AIM, Google Talk and Yahoo! Messenger through the IBM Lotus Sametime Gateway. The Gateway acts as an intermediary among Lotus Sametime and each public IM community by receiving instant messages, translating them into the proper protocol, and delivering them to recipients regardless of platform. Messenger will be added to the compatibility list within weeks, IBM added. The gateway allows you to have Sametime, AIM, Yahoo! And GoogleTalk contacts all in one single list, just as. Yahoo!奇摩即時通可以和Windows Live Messenger互通，但僅限於基本的對話功能而已，像是視訊、動畫快遞，以及其他雙方軟體所各有的獨特功能仍無法互通，Yahoo奇摩即時通與Microsoft Windows Live Messenger 的互通使用服務只提供到2013年12月14日止，同時停止服務的功能還. Launched in 1999, Yahoo Messenger has more than an estimated 94 million users who use to exchange instant messages with other Yahoo, Microsoft Windows Live Messenger or Lotus Sametime users sources: Time Warner and PC World.

This chapter provides an overview of instant messaging and discusses how to:

• Configure instant messaging.

• Use single button presence.

• Use the instant messaging sample pages.

See Also

Understanding Instant Messaging

PeopleSoft MCF extends the HTML chat functionality delivered in PeopleTools 8.42 to popular instant messaging networks. Users can initiate an outbound chat with a customer using instant messaging networks such as IBM/Lotus Sametime, or Yahoo! Messenger. This functionality enables an external user to participate in a business transaction through instant messaging.

PeopleSoft MCF enables instant messaging (IM) through public networks (GTALK,MSN and Yahoo! Messenger), an enterprise Lotus Sametime Connect network or XMPP Instant Messaging server.

You can enable a user to initiate an instant messaging session from any page using either a button or PeopleCode.

See PeopleTools 8.52: PeopleCode API Reference.

PeopleSoft users must install appropriate client software for supported instant messaging domain. However, users presence can also be detected without the installation of the client software.

Note. The instant messaging presence detection in PeopleTools is subject to the respective IM vendor’s network availability..Oracle is not responsible for the availability or performance of any of the IM networks or for any change in an IM vendor’s protocol that may render the IM Integration inoperable.

Configuring Instant Messaging Server details

In MCF you can enable instant messaging for :

• GTALK

• SAMETIME

• XMPP

• YAHOO

• MSN

This section discusses how to configure instant messaging.

The supported public instant messaging networks such as Yahoo and XMPP require installation of client software. Installation and configuration of the client software is the responsibility of your administrators and customers, and is beyond the scope of this document.

Lotus Sametime Connect is an instant messaging network running on an enterprise Sametime/Domino server, which must be configured to support PeopleSoft MultiChannel Framework instant messaging. To administer instant messaging with Sametime Connect, install Sametime Links and configure the server to enable anonymous users to connect to the server and query for the presence of other known users. Refer to your Lotus/Domino server documentation for more information.

For XMPP Instant Messaging servers, you will need to configure the XMPP domain in order to detect user presence, whereas other domains are configured by default.

Pages Used to Configure Instant Messaging Servers

Configuration for Yahoo

Select PeopleTools, MultiChannel Framework, Instant Messaging, Configuration.

Configuring XMPP Domains

To configure XMPP servers:

1. Select PeopleTools, MultiChannel Framework, Instant Messaging, Configuration.

2. Click the Search button and select XMPP.

3. Click the Configure XMPP Servers link from the Configuration page.

Configure as many XMPP domains as required.

Configuring IM Users for XMPP Servers

In order to obtain user presence information from configured XMPP IM servers, the user must login to the server. Each user needs to enter their userid and password for the XMPP server. If XMPP login information has been entered in user profile, the login process to the configured XMPP server will happen automatically when the PeopleSoft user signs on to PeopleSoft. This login process takes place in the background and will not stop the user from performing other operations.

Select My System Profile or PeopleTools, Security, User Profile, User Profile and click the Instant Messaging Information link.

Enter your user ID and password information for each XMPP domain you are using.

It is necessary to relogin to the application after configuring the settings.

Note. Username without domain has to be entered under UserId field. Example: ‘firstname.lastname’ for firstname.lastname@oracle.com.

Pages Used to Configure XMPP domains

Using the Instant Messaging Sample Pages

To demonstrate instant messaging, use the Instant Messaging Sample Pages (MCF_IM_DEMO_CMP) component.

This section discusses how to:

• Use the PeopleCode Sample page.

• Use the Button Sample page.

Pages Used to Test Instant Messaging

Below are the details:

Using the PeopleCode Sample Page

Select PeopleTools, MultiChannel Framework, Instant Messaging, Sample Pages and add a new value.

Note. The PeopleCode Sample does not support presence detection for GTALK and XMPP domains.

The PeopleCode Sample page demonstrates the use of instant messaging PeopleCode. The sample pages are intended for demonstration purposes and should not be used in production.

See MCF IM Classes.

Note. If you get a warning symbol with the network, even though you have specified the correct address of IM server, provide values for Proxy host and Proxy port in the pasappsrv.cfg file.

Using the Button Sample Page

Access the Button Sample page using the following navigation path:

PeopleTools, MultiChannel Framework, Instant Messaging, Sample Pages, Button Sample

The Button Sample page demonstrates the use of the instant messaging button implemented in PeopleSoft Application Designer. The sample pages are intended for demonstration purposes and should not be used in production.

See Specifying Type Properties for Push Buttons or Links.

Developing an Application with Instant Messaging Action Button for Presence Detection

In order to create an application with instant messaging action button for presence detection:

1. Create a page and add a button.

2. Click on properties of a push button and choose Instant Messaging Action for the destination field.

3. Choose a record and field name where screen name is in the format for the instant messaging domain, as listed in this table:

   Instant Messaging Domain	Required format of screen name
   YAHOO	screenname@YAHOO
   XMPP	screenname @DOMAIN@XMPP
   GTALK	screenname@GTALK

4. Save page.

Using Single Button Presence

The single presence icon represents a collective presence of all screen names. When a user moves the mouse pointer over a single presence icon, it will open a menu with all user screen names and their presence

This section provides an overview of presence detection and discusses how to:

• Configure servers.

• Configure screen names.

• Test single presence button.

• Develop an application with Single Presence button for presence detection.

Understanding Presence Detection

The IM Servlet is implemented and hosted in the web server for the purpose of communicating with IM servers to get presence information. Therefore, browsers can send http Get request to IM Servlet and get presence information. The IM Servlet directly communicates with non-XMPP IM servers to fetch presence information and uses Smack API to communicate with XMPP servers. To improve the performance and response time the IM Servlet supports bulk requests for getting presence of multiple screen names using one request. In order to get the presence of a buddy from an XMPP server, the user needs to login into the XMPP server and maintain an active session. For non-XMPP servers the user does not need to login into IM server to fetch the presence information. This active session is maintained in the IM Servlet.

This diagram shows the instant messaging feature:

Instant messaging architecture

1. Browser requests to get the presence from IM Servlet

2. For non-XMPP servers, IM Servlet will send http get request to corresponding Instant Messaging server to find out presence information. For XMPP servers, IM Servlet will contact XMPP server via smack API to get presence information.

3. Presence information is returned to IM Servlet.

4. Presence is sent to the client browser.

Pages Used to Configure Single Presence Button

Instant Messaging Servers Configuration for Single Presence Button

PeopleTools, MultiChannel Framework, Instant Messaging, Presence, Servers Configuration.

The configuration page is the same page used to configure instant messaging servers. When you select the page under the Presence menu, you can also configure Email, MSN and Skype.

See Also

Configuring Screen Names

Select PeopleTools, MultiChannel Framework, Instant Messaging, Presence, Screen names configuration.

Determining your Screen Name

The value of the ScreenName column will vary, depending on your Instant Messaging domain.

Creating a Google Chatback Badge

A Google Talk chatback badge of your Google Talk account enables other users to chatwith you even if they are not signed into a Google Talk account.

You can create a Google chatback badge using this URL: http://www.google.com/talk/service/badge/New.

Sametime Yahoo Messenger App

To create a Google chatback badge, login with your Gtalk User ID and Password. Logging in should create HTML code at the bottom of the page, which would look like the following:<IFRAME height=60 src='http://www.google.com/talk/service/badge/Show?tk=z01q6amlq2i6vrvn5mc3n4q4q465ignqb1up83grsoq6e82p0ghk9ru904bclggtah2r9r5vbt1nl5tia5g56u7h5gtft1frscu639ucjq0r006q2v6jt4cfk4i13j7cucbntvlnptrogt6d4lo0jph7tvu8hpnpjikk16fs6h4qlr9n213kcbla4sr0emkoco8&amp;w=200&amp;h=60' frameBorder=0 width=200 allowTransparency></IFRAME>

The badge value appears between tk= and &amp. The badge is used to determine the user’s presence information, which is also used as the Google user ID.

Refer to your Google documentation for more details.

Creating a MSN Badge

To create MSN user IDs:

1. Use your browser to point to the following URL: http://settings.messenger.live.com/applications/WebSettings.aspx

2. Sign on with MSN Credentials

3. Select the option Allow anyone on the web to see my presence and send me messages. Note: Any website can show your status and people you have blocked may see your presence on the web.

4. Click Save

5. Verify the MSN badge: <iframe src='http://settings.messenger.live.com/Conversation/IMMe.aspx?invitee=8e109e9602507581@apps.messenger.live.com&mkt=en-in' width='300' height='300' frameborder='0' scrolling='no'></iframe>

6. Select the Create HTML tab, and view the HTML appearing at the bottom of the page. The badge value appears after “invitee=” and ” @apps”. The system uses the badge to determine the user’s presence information which is also used as the MSN user ID.

Testing Single Presence Button

Select PeopleTools, MultiChannel Framework, Instant Messaging, Presence, Sample page.

The single presence icon represents a collective presence of all screen names. When a user moves the mouse pointer over a single presence icon, it will open a menu with all user screen names and their presence. If any of the screen names are online, you can click the online icon and it will launch the corresponding IM Messenger to send IM messages. When the user clicks on an email icon, it will launch default configured email client. When you click on Skype, it will launch Skype application and allow you to login to Skype and if skype is not installed there appears a dialog box with two buttons to download or upgrade skype

Developing a Sample Application with Single Presence Button

To develop a sample application with Single Presence Button:

1. Create a new page with two hidden HTML areas, one Hidden HTML area(as in, MCF_XMPPHEADER) is for keeping Javascript content, and the other HTML area (as in, MCF_IM_HTMLAREA) is for showing the presence icon.

2. Ensure that all screen names are in the required format and that they are available in a record (as in,MCF_IMSCRNAMES).

3. Write page PeopleCode for the page activate event:

See MCFIMSingleButton Class Methods.

Installing Instant Messenger Clients

Google and MSN are launched through web clients. It is not required to install the GTalk and MSN messenger.

Yahoo needs Yahoo messenger to be installed on the client machine and can also be configured in Pidgin

XMPP needs Pidgin client installed on client machine.

Working with Domain Offline and Online Buttons

This table shows the various state of your Instant Messenger:

Debugging IM

When troubleshooting or monitoring the IMServlet, you can view the IMServlet.log to gather information specific to the IMServlet.

Viewing IMServlet Logs

The log file is located in:

PIA_HOMEserversPIAlogs

Since IMServlet is using web server logging, IM Log configuration can be done in the following location:

PIA_HOMEpiaconfigproperties logging.properties

Levels OFF, INFO, SEVERE can be set via com.peoplesoft.pt.mcf.im.level according to the needs.

Sametime Connect

By default, log is set to SEVERE as the following: com.peoplesoft.pt.mcf.im.level = SEVERE

Sametime Chat Download

Sametime Yahoo Messenger Email