Urgent - What is EPCM.raiseEvent()

Question

HI
Can anyone clear me abt <b>EPCM.raiseEvent("namespace","eventName","dataobject","sourceobid");</b>
I could not understand what this method doing and what those parameters.
Thanks
Shashank

Answer 1

Hi Shashank ,
Adding on to what others have altready said,
The EPCF service defines the Enterprise Portal Client Manager (EPCM) JavaScript object. With the methods of the EPCM object you can access the EPCF service functions as follows:
EPCM.[API_method_name]( [Params]* );
iViews can access the EPCM object from every Portal page or IFrame. Every iView of the Portal runtime contains the EPCM object. As a result every embedded or isolated iView can use the EPCF service with the method:<b>
EPCM.subscribeEvent(, eventName, eventHandler );</b>
The method<b>
EPCM.raiseEvent( nameSpace, eventName, dataObject [, sourceId])</b>
raises the event defined by the nameSpace and eventName arguments. The EPCF service calls every event handler registered for this event and passes the event object to the event handler. The event object is created by the EPCF service whenever an event is raised. It combines dataObject, eventName and sourceId (which may be null) into a single argument for the event handler.
The namespace is defined by the urn which is used to identify a resource/object by name on the internet,regardless of its location.
The name defines the name of the event .
For example:
in a page,i have two iviews between which i need to interact/pass data using javascript.
In iView1 we  raise the event by calling a javascript using a button like:
<SCRIPT language="JavaScript"  type="text/javascript">
function fun1( )
  var lnDotPos = document.domain.indexOf( "." );
  if (lnDotPos >= 0) document.domain = document.domain.substr( lnDotPos + 1 );
EPCM.raiseEvent("urn:com.sapportals.portal.sid","onSelect",window, "but1");
</SCRIPT>
<htmlb:button      id            = "but1"
                    text          = "Press Me"
                    onClientClick = "fun1()"
                    onClick       = "MyEvent" />
In iview2 we have to subscribe to this event on every page load/refresh using attribute onLoad of page as onLoad="fun1()"
function fun1( )
EPCM.subscribeEvent( "urn:com.sapportals.portal.sid", "onSelect", window , "handleEvent1");
function handleEvent1( )
alert("hello");
Similarly,say you want to subscribe to the portal logoff event ,which is raised when a user clicks on logoff link in portal.
This event is raised in the reserved namespace of portal and can be subscribed as
function fun1( )
EPCM.subscribeEvent( "urn:com.sapportals.portal:user", "logoff", window , "handleEvent1");
here the event logoff is the event raised in the portal namespace(urn:com.sapportals.portal:user) and has been subscribed to and calles the method handleEvent1.
Here fun1() is called on page load and after subscribing can call another javascript function handleEvent1().
Hope this helps a bit.(This is code used in my BSP application using EPCMPROXY(here shown as EPCM),modified to make you understand)
Regards,
Siddhartha