Skip to Content
Author's profile photo Ginger Gatling

Integrating Alerts into UWL – it’s no problem!

If you are using the alert framework in any SAP system, it is easy to integrate the alerts into Universal Worklist. This means alerts from BI, XI, ERP, R/3 can all be delivered to the same location where you get your workflow items, Collaboration Tasks, and KM notfications – no more looking in multiple inboxes!

Come join us as we step through how you configure alerts for Universal Worklist. Then we will walk through raising a test alert. The end result will be a test alert that appears in UWL.

Basic setup to test an alert going to UWL

Steps done in UWL

  1. Register the system in UWL and select Alert Connector
  2. Register work item types

Steps done in the alert framework

  1. In transaction code ALRTCATDEF, create a new category.
  2. Add yourself as a fixed recipient for the alert.
  3. Run program RSALERTTEST to raise your alert.

Detailed steps on adding the alert system to UWL

1. Select System Administration – System Configuration- Knowledge Management – Universal Worklist and selectUWL System Configuration .

image

2. Select New and for the connect be SURE to select AlertConnector.

image

NOTE: The system alias MUST MATCH the system alias from the system definition.

image

3. Register your systems – that’s it!

image

At this point, if you have alerts that are in people’s alert inboxes, they will appear in UWL. If you have done this step but do not have alerts already, use the following steps to quickly create a test alert.

1. In your central alert system go to transaction code ALRTCATDEF.

image

2. Select the “Long and Short Text” tab to add text for your alert.

3.To define activities that should happen due to the alert, select the “Optional Subsequent Activities” tab. The activities must be provided via a URL. For our test, we will enter a company URL.

4. Add a recipient to receive the alert. For our test, we will add a Fixed Recipient so that the test goes to us.

image

5. Go to transaction code SA38 and execute program RSALERTTEST. Enter the alert category you created in ALRTCATDEF. You will receive a unique alert ID and the alert will route to your user ID.

image

6. Go to the UWL and the alert will be there!

image

So, if you are already using the alert framework in multiple systems, you can very easily start sending your alerts to the Universal Worklist! Now in UWL you can receive alerts, business workflow items, KM notifications, and Collaboration Tasks – all in one location!

Assigned Tags

      26 Comments
      You must be Logged on to comment or reply to a post.
      Author's profile photo Former Member
      Former Member
      Hi Ginger

      Thanks for giving a step by step approach on using Alerts in UWL.

      Is there is a possiblity of creating alert iview, something similar to Notifications IView.

      Thanks

      Regards
      Senthil

      Author's profile photo Ginger Gatling
      Ginger Gatling
      Blog Post Author
      Hi Senthil,
      The alert inbox is a BSP - so I guess you could create an iview for that.  Transaction code ALRTINBOX is the inbox that is native to the alert framework.  UWL is reading this inbox to get the alerts.
      -ginger
      Author's profile photo Former Member
      Former Member
      Hi Ginger,
      When I register the new alert system, I got error:
      System R3: Fri Jun 17 11:17:14 EST 2005 (Connector) :javax.resource.ResourceException:Failed getting the following function metadata from repository: SALRT_GET_CATEGORIES

      Do I need to define alert framework before the registration?

      Thanks!

      -Yong Chen

      Author's profile photo Ginger Gatling
      Ginger Gatling
      Blog Post Author
      Hello Yong,
      Do you have any alert categories defined?   I've always had an alert category created already. 

      Thanks,
      Ginger
      ps. Are you on NW04 SPS 4 or SPS9?

      Author's profile photo Former Member
      Former Member
      Hi Ginger,

      I tried to run the transaction on the R/3 (4.6C)system, it tells me the Transaction ALRTCATDEF does not exist.

      Can you tell me how to define it?

      Thanks!
      -Yong

      Author's profile photo Ginger Gatling
      Ginger Gatling
      Blog Post Author
      Hi Yong,
      I don't think you can raise the alert on a 4.6C system.  I think there was a reply that said you can do it with a plug-in, but I can't find a note on it.  I think Matt Kangas would know this - I'll ask him.
      Ginger
      Author's profile photo Former Member
      Former Member
      Ginger,

      We are running NW04 SP12.

      -Yong

      Author's profile photo Ginger Gatling
      Ginger Gatling
      Blog Post Author
      Hello Yong,
      You must be on a WAS 6.20 for the Alert Framework. However, the alert framework maybe able to include a 4.6C system (the alert would occur in 4.6C, but be rendered via you WAS 6.20).

      See if you have a FM on your 4.6C system, SALERT*. 

      I got this from the online help (help.sap.com).
      Alert Management (ALM) is an ideal solution if you can identify specific business or technical situations that are critical and could jeopardize efficient operation, and you want specific parties to be informed if these situations arise.

      The ALM server has to be a SAP Web AS as of release 6.20. The local application systems can be a SAP Web AS as of release 4.6C.

      For local systems of SAP Web AS release 6.10 or lower you need a specific workplace plugin.

      I can't seem to find a note on which plug-in you need. 

      Author's profile photo Hari Krishna Nalluri
      Hari Krishna Nalluri
      Hi Ginger,
      Thanks for the step by step instructions. It really helped us gettig started. We have followed these steps but the alerts are not showing up in UWL. Surprisingly there is NO ALRTINBOX transaction in R/3 though there seems to be a BSP application named ALERTINBOX. Alert tab of UWL shows a successful connection status. When we executed the rsalerttest program, it runs successfully and returns an alert id.
      Since we don't have ALRTINBOX in R/3 side, we don't know if the alerts are triggered properly or not.  Non-existance of transaction ALRTINBOX making me thing if we are missing anything? Any idea where we are going wrong? Appreciate your help.

      Regards
      Hari

      Author's profile photo Ginger Gatling
      Ginger Gatling
      Blog Post Author
      Hi Hari,
      The alert framekwork begins on web application server 6.20.  So, R/3 release 4.7.  What R/3 release are you on?
      Regards
      Ginger
      Author's profile photo Hari Krishna Nalluri
      Hari Krishna Nalluri
      Hi Ginger,

      We are using SAP enterprise version, SAP BASIS release 420. We are wondering if we need to install anything more as the R/3 transaction ALRTINBOX doesn't exist. Pls advise.

      Thanks
      Hari

      Author's profile photo Ginger Gatling
      Ginger Gatling
      Blog Post Author
      Hi Hari,
      You have to be on 4.7 to use the alert framework. The alert framework requires web application server 6.20.   What you can do is define the alert on a WAS 6.20 or higher system.  Do you have  WAS 6.40 box?  Define it there, in your 4.6C system use SALERT_CREATE_API to create the alert on the WAS system. 

      Try that out.
      Ginger

      Author's profile photo Former Member
      Former Member
      Hi Ginger,
      I want create an alert manually via FUNCTION MODULE "SALERT_CREATE" in SAP R/3
      Enterprise for test purpose. First I defined a new alert category via SAP
      transaction code "alrtcatdef", and assigned Fixed Alert Recipients to my own sap
      user ID, then I run FUNCTION MODULE "SALERT_CREATE", input the IP_CAT vaule use this
      new alert category name which I just difined,unfortunately I always get the
      exception message:Alert has no recipients,but I already assigned the Fixed Alert
      Recipients early in defined alert category step. Any idea about this?

      Thanks,

      Jeffrey

      Author's profile photo Former Member
      Former Member
      Hi Ginger,
      thank you for providing this details information how to use CAF and UWL. We followed your directions to set up alert category and connection to UWL in portal.
      I have one question that I couldn't figure out on my own and was wondering if you have any idea: how to remove default message ("View for Alert ...." [URL link] ) from email that alert framework sends out. THe reason why we want to remove it is that we want user to go directly to UWL and not to be able to browse directly to alert link. I can add another custom link and message but can't remove default one. 
      Please let me know if you have any ideas.
      Appretiate your help,
      Victor.
      Author's profile photo Former Member
      Former Member
      I'm trying to make AlertConnetor for SAP R/3 (Basis 6.2) in UWL.

      I created Test Category in transaction code ALRTCATDEF and run program
      RSALERTTEST to raise test alert.

      I received an alert message in BSP Application ALERTINBOX
      (http://essdev.dongbuchem.com:8000/sap
      (bD1rbyZjPTcxMA==)/bc/bsp/sap/ALERTINBOX/index.htm)
      But I didn't get an alert message in UWL.

      When I checked the connection status.
      There is a following error message in connection status page.

      Exception type:com.sap.mw.jco.JCO$Exception Message:Field TITLE not a
      member of SALRTTDISP

      And then I check the SALRTTDISP table in R3 backend system. There is no TITLE field in this table.

      Please reply for me.

      Author's profile photo Ginger Gatling
      Ginger Gatling
      Blog Post Author
      Hi,
      Hmm....I think it might be an anomaly for 6.2 - I've never tried to connect a 6.2 system.  Unless someone has a work-around, I'm afraid you'll need to enter a ticket.   I just double-checked and the UWL does support 6.20 backend systems and above for alerts - so the registration should work.   Sorry I don't have a work around.
      -ginger
      Author's profile photo Gopalkrishna Baliga
      Gopalkrishna Baliga
      I have a requirement where I have to send the alerts triggered in XI BPM (for any system or business errors) to Portal's universal worklist. XI and the portal are two separate systems.

      In XI BPM I have control step to trigger alerts.

      I am using XI3.0 (PI 7.0) and Portal 7.0

      1. What configurations are needed to achieve this?
      2. How will the userids in Portal be enabled so that they receive alerts from XI in UWL? Do I have to do anything special from userid perspective?
      3. Are there any limitations?

      Author's profile photo Ginger Gatling
      Ginger Gatling
      Blog Post Author
      Hello,
      To integrate alerts from XI into UWL go to the UWL connectors and add the XI system.  Keep in mind the XI system must first be added to the portal system landscape, then add the connector to UWL and the XI alerts will appear.  Of course, this assumes you updated ALRTCATDEF on the XI system and defined who should get the alerts.   You really just do the same steps mentioned here, just do the on the XI system.  The issue happens with the alert container.  In XI you use the "Process Control" step to raise an alert.  This does raise an alert, but it doesn't send any context to the alert container - at least I don't think it does.   I know one time for a demo instead of using the "Process Control" step in the XI integration process, we did a send step and called the alert FM to raise the alert and passed data to the alert container.  But, first start with the process control step you are raising - just give the alert category that you setup in ALRTCATDEF on the XI system - add the XI system to the UWL and the alerts will be there.  I hope this helps.
      Ginger
      Author's profile photo Former Member
      Former Member
      Ginger,

      is there a way to have 2 separate alerts in one output in Visual Composer?  If there is a way, is there detail instructions somewhere?

      For example, we are trying to create a separate traffic signal for Planned vs Unplanned PM, and another traffic signal for Planned vs Completed PM data, but we would like both traffic signals to appear in one output.  Thanks!

      Author's profile photo Ginger Gatling
      Ginger Gatling
      Blog Post Author
      Hello,
      I don't know enough about Visual Composer to know if this is possible or not.  I woudl think you would need a FM to call an SLRT API to get both alerts and combine them and VC reads your custom FM - but I'm not certain. Could you please post this on the VC forum?
      Sorry I can't be of more help.
      -ginger
      Author's profile photo Former Member
      Former Member
      Hi Ginger,
      After this integration, can UWL be interfaced with other external system to notify users through sms, fax, email?
      Is there any API for this?
      Author's profile photo Ginger Gatling
      Ginger Gatling
      Blog Post Author
      Hi Steven,
      The alert itself can go directly to sms, fax, email.  Check out the online help for alerts:

      http://help.sap.com/saphelp_nw70/helpdata/en/53/02153cdcf89e56e10000000a11405a/frameset.htm

      Best regards
      Ginger

      Author's profile photo Former Member
      Former Member
      Hi,
          I have done all the steps you have mentioned in the blog, but couldn't able to see the alerts in UWL. But I am able to see them in the alert inbox of PI. What would be the mistake I have done. Please help me.
      Thanks & Regards,
      Vishnu.
      Author's profile photo Former Member
      Former Member
      Hi Ginger,

      I am not able to forward KM Notifications from one user to another . I checked whole uwl.standard.xml but i could not get sucess. Please try to help me out from that.

      Thanks in advance,
      Regards,
      Gurprit Bhatia

      Author's profile photo Former Member
      Former Member
      Ginger,

      I hope that you can help with this problem.  I have configured the UWL service as far as I could take it by flying blind.  I think that I am very close to getting things to work.  I have scheduled the SWN_SELSEN report to run every 15 minutes.  However, the report log shows the following error.

      "Unable to send 00000000 notifications due to errors"

      My hope is that you can help get things working.
      Is there some configuration item that I missed?

      Author's profile photo Ginger Gatling
      Ginger Gatling
      Blog Post Author
      Hi,
      You are trying to configured extended notifications, correct?   Try this online help and post a question in the forum...I know I've seen some things in the BPM forum on it.

      http://help.sap.com/saphelp_erp2005vp/helpdata/en/09/62a34098022a54e10000000a1550b0/frameset.htm

      -ginger