com.sap.portal.pcm.iview

Interface IiViews

All Superinterfaces:

com.sap.portal.pcm.IObjectsManager

public interface IiViews
extends com.sap.portal.pcm.IObjectsManager

The interface for the iView object management service that provides helper methods for working with iViews.
The main task of an IiViews object is to create a descriptor for creating an iView object, as shown in the following example:

   import com.sap.portal.pcm.CreateMethod;
   import com.sapportals.portal.prt.jndisupport.InitialContext;
   import com.sapportals.portal.pcd.gl.IPcdContext;
   import javax.naming.Context;
   

   IUser user = request.getUser();
   

   IiViews iSrv = (IiViews)PortalRuntime.getRuntimeResources().getService(IiViews.KEY);
   String targetUrl = "pcd:portal_content/myFolder/myIView";
   try
   {
                INewObjectDescriptor iDesc = 
     (INewObjectDescriptor)iSrv.instantiateDescriptor(createMethod, targetUrl, user);
   }
   catch (OperationFailedException e)
   {
                                                        // ...  
   } 
   catch (ObjectNotFoundException e)
   {
                                                        // ...                          
   }
   Hashtable env = new Hashtable();     
   env.put(Context.INITIAL_CONTEXT_FACTORY, "com.sapportals.portal.pcd.gl.PcdInitialContextFactory");   
   env.put(Context.SECURITY_PRINCIPAL, user);
   try
   {                            
                InitialContext iCtx = 
                new com.sapportals.portal.prt.jndisupport.InitialContext(env);                          
                Context ctx = (Context)iCtx.lookup(folderName); 
                                                        //the PCD name of the folder
                ctx.bind("myNewiView", iDesc);
   }
   catch (NamingException e)
   {    
                                                        // ...
   }
 

When creating an object from a PCD template object, the object can be created as either NEW or a DELTA_LINK. For other object types, only the NEW CreateMethod is available.
The target URL is the JNDI name of a template on which the object is based. The target can be:

• a PCD URL (for example, pcd:/portal_content/Test/testiView01 or portal_content/Test/testiView01)
• an application component (for example ApplicationName.ComponentName or par:/applications/ApplicationName/components/ComponentName)
• an external URL (for example otherPrefix:/Test/TestObj01)

See Also:

IiView, IPages, ILayouts

Field Summary

static String	KEY The service key.
static String	OCLASS_IVIEW

Method Summary

Methods inherited from interface com.sap.portal.pcm.IObjectsManager

getDefaultAttributes, instantiateDescriptor, instantiateDescriptor, instantiateDescriptor

Field Detail

KEY

static final String KEY

The service key.

See Also:

Constant Field Values

OCLASS_IVIEW

static final String OCLASS_IVIEW

See Also:

Constant Field Values

Access Rights

This class can be accessed from:

SC	DC	Public Part	ACH
[sap.com] EP-RUNTIME	[sap.com] tc/ep/semantics/api	api	EP-PIN
[sap.com] KMC-WPC	[sap.com] tc/kmc/wpc/wpcfacade	api	EP-PIN-WPC-WCM