com.ibm.itim.apps.lifecycle
Class LifecycleManager

java.lang.Object
  |
  +--com.ibm.itim.apps.lifecycle.LifecycleManager

public class LifecycleManager
extends java.lang.Object

Provides lifecycle management capabilities on supported business domain objects, including Person and Account. It provides an interface to invoke global operations, static operations defined for specific type of object, or operations on the object instance. Please refer to "Designing and Implementing Workflows" in the IBM Tivoli Identity Manager InfoCenter for more information.


Constructor Summary
LifecycleManager(PlatformContext platform, javax.security.auth.Subject subject)
          Constructs the manager with a platform context and a subject.
 
Method Summary
 Request executeGlobalOperation(java.lang.String operationName, java.lang.Object[] args)
          Executes a global operation in the provisioning platform
 Request executeObjectOperation(DirectoryObject managedObject, java.lang.String operationName, java.lang.Object[] args)
          Executes an operation on a specific object in the provisioning platform
 Request executeStaticOperation(java.lang.String categoryName, java.lang.String profileName, java.lang.String operationName, java.lang.Object[] args)
          Executes a static operation on a specific type of object in the provisioning platform.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

LifecycleManager

public LifecycleManager(PlatformContext platform,
                        javax.security.auth.Subject subject)
Constructs the manager with a platform context and a subject.

Parameters:
platform - PlatformContext holding platform connection information.
subject - Subject representing the authenticated caller.
See Also:
PlatformContext, Subject
Method Detail

executeGlobalOperation

public Request executeGlobalOperation(java.lang.String operationName,
                                      java.lang.Object[] args)
                               throws java.rmi.RemoteException,
                                      AuthorizationException,
                                      ApplicationException
Executes a global operation in the provisioning platform

Parameters:
operationName - operation name as specified in the IBM Tivoli Identity Manager "Entity Type->Global->Define Operation" UI.
args - operation input parameters as specified in the workflow definition for the target operation. Use the workflow designer UI to view the workflow definition and discover the list of input parameters. The parameters must appear in the args array in the same order which they appear in the workflow designer. The workflowDataSyntax.xml file in the {itim-home}/data folder documents the Java to workflow data type mappings.
Returns:
Request object representing the operation's status.
Throws:
java.rmi.RemoteException - Thrown if unable to communicate with platform.
AuthorizationException - Thrown if client is unauthorized to create the person in the given container.
ApplicationException - Thrown if unable to submit the request. This may possibly be caused by the container being removed by another client previous to this call.
See Also:
Request

executeStaticOperation

public Request executeStaticOperation(java.lang.String categoryName,
                                      java.lang.String profileName,
                                      java.lang.String operationName,
                                      java.lang.Object[] args)
                               throws java.rmi.RemoteException,
                                      AuthorizationException,
                                      ApplicationException
Executes a static operation on a specific type of object in the provisioning platform. The object type is identified by its category name and its profile name

Parameters:
categoryName - the object category name. Must be one of the values defined in the com.ibm.itim.dataservices.model.ManagableCategoryConstant interface.
profileName - the object profile name. The name of the entity for which the target operation has been specified. This value must be null for entity type level operations.
operationName - operation name as specified in the IBM Tivoli Identity Manager "Entities/Entity Type Define Operation" UI.
args - operation input parameters as specified in the workflow definition for the target operation. Use the workflow designer UI to view the workflow definition and discover the list of input parameters. The parameters must appear in the args array in the same order which they appear in the workflow designer. The workflowDataSyntax.xml file in the {itim-home}/data folder documents the Java to workflow data type mappings.
Returns:
Request object representing the operation's status.
Throws:
java.rmi.RemoteException - Thrown if unable to communicate with platform.
AuthorizationException - Thrown if client is unauthorized to create the person in the given container.
ApplicationException - Thrown if unable to submit the request. This may possibly be caused by the container being removed by another client previous to this call.
See Also:
ManagableCategoryConstant, Request

executeObjectOperation

public Request executeObjectOperation(DirectoryObject managedObject,
                                      java.lang.String operationName,
                                      java.lang.Object[] args)
                               throws java.rmi.RemoteException,
                                      AuthorizationException,
                                      ApplicationException
Executes an operation on a specific object in the provisioning platform

Parameters:
managedObject - the target object for which the operation is invoked. This object must be of type Person or Account.
operationName - operation name as specified in the IBM Tivoli Identity Manager "Entities/Entity Type Define Operation" UI.
args - operation input parameters as specified in the workflow definition for the target operation. Use the workflow designer UI to view the workflow definition and discover the list of input parameters. The parameters must appear in the args array in the same order which they appear in the workflow designer. The workflowDataSyntax.xml file in the {itim-home}/data folder documents the Java to workflow data type mappings.
Returns:
Request object representing the operation's status.
Throws:
java.rmi.RemoteException - Thrown if unable to communicate with platform.
AuthorizationException - Thrown if client is unauthorized to create the person in the given container.
ApplicationException - Thrown if unable to submit the request. This may possibly be caused by the container being removed by another client previous to this call.
See Also:
Request, Person, Account


IBM Tivoli Identity Manager 4.6
© Copyright International Business Machines Corporation 2005. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.