Create a custom payment gateway

In order to create a custom payment gateway, you need to:

Define the custom payment gateway in payment gateways metadata file.
Create a custom enum to define authentication setting parameters. (optional)
Create a custom business object class extending com.crm.businessobject.paymentgateway.CRMBOPaymentGatewaySettingBean.
Create a user interface class extending com.crm.process.paymentgateway.CRMUIPaymentGatewaySettingBean
Create a custom process class extending com.crm.process.paymentgateway.CRMProcessPaymentGatewayBean
Create a custom search page.
Create a custom summary page for payment gateway requests.
Create a custom data entry page for the payment gateway.
Define the new menu options in menu options metadata file.
Define a custom module in modules metadata file.

Note that all data object, business object, user interface and process class names should start with the custom project directory name:

For this example we assume that <custom_project> = payeezy

1. Payment Gateways Metadata File

The new custom payment gateway must be defined in paymentgateways.xml file which is located under <custom_project>/src/main/resources/metadata/ directory.

2. Provisioning Parameters Enum

This enum will be used to define the authentication setting parameters. Note that 'order' property will be used to define the parameter's order on the screen.

MYCOMPANYTucanoParameters

package payeezy.dataobject.paymentgateway.payeezy;
import com.crm.dataobject.ICRMLookupEnum;

public enum PayeezyParameter implements ICRMLookupEnum{
	
	MODE("key_mode", "String",1),
	TEST_URL("key_url", "String",2),
	TEST_MERCHANT_TOKEN("key_merchant_token", "String",3),
	TEST_TA_TOKEN("key_transarmor_token", "String",4),
	TEST_API_KEY("key_api_key", "String",5),
	TEST_API_SECRET("key_api_secret", "String",6),
	TEST_JS_SECURITY_KEY("key_js_security_key", "String",7),
	LIVE_URL("key_url", "String",2),
	LIVE_MERCHANT_TOKEN("key_merchant_token", "String",3),
	LIVE_TA_TOKEN("key_transarmor_token", "String",4),
	LIVE_API_KEY("key_api_key", "String",5),
	LIVE_API_SECRET("key_api_secret", "String",6),
	LIVE_JS_SECURITY_KEY("key_js_security_key", "String",7);

	private String label;
	private String type;
	private Integer order;
	 
	private PayeezyParameter(String label, String type, Integer order) {
		this.label = label;
		this.type = type;
		this.order = order;
	}
	@Override
	public String getLabel() {
		return label;
	}
	public String getType() {
		return type;
	}
	public Integer getOrder() {
		return order;
	}
}

To achieve that, when you create a new provisioning provider object (CRMDOProvProvider) you have to create new object of your provisioning parameters data object class and set it to the 'parameters' property of the CRMDOProvProvider object:

MYCOMPANYCRMBOTucanoProviderBean

/**
  * Constructs a TUCANO provisioning provider.
  * 
  * @param mainDTO - the main data object
  * @return a TUCANO provisioning provider
  * @throws Exception
  */
@Override
protected CRMDO constructDO(CRMDO mainDTO) throws Exception {
		
	CRMDOProvProvider provProvider = (CRMDOProvProvider)super.constructDO(mainDTO);
	MYCOMPANYTucanoParameters tucanoParameters = new MYCOMPANYTucanoParameters();	
	provProvider.setProvisioningParameters(tucanoParameters);
	...
	
	return provProvider;		
}

More details on creating a provisioning provider business object class can be found in the next section.

3. Provisioning Provider Business Object Class

The new custom business object class must extend com.crm.businessobject.provisioning.CRMBOProvProviderBean and implement com.crm.businessobject.ICRMBOProvisioningProvider interface and its five methods:

getServiceCAID(CRMDOProvProvider provProvider,CRMDOProduct product) which should return a unique identification string (conditional access id) used by the provisioning provider to identify the given service.
getSmartcardCAID(CRMDOProvProvider provProvider,CRMDOInstalledItem installedItem) which should return a unique identification string (conditional access id) used by the provisioning provider to identify the given smartcard.
getSTBCAID(CRMDOProvProvider provProvider,CRMDOInstalledItem installedItem) which should return a unique identification string (conditional access id) used by the provisioning provider to identify the given set top box.
setXMLFromObjects(CRMDOProvProvider provProvider) which should construct a string XML that will keep all information about the provider's connection parameters and set it to CRMDOProvProvider object's 'parameters' String property.
setObjectsFromXML(CRMDOProvProvider provProvider) which should set CRMDOProvProvider object's connection parameter values using its 'parameters' String property value.

Other useful methods that you are recommended to implement are:

public CRMDOProvProvider loadEffective()
public CRMDOProvProvider loadEffective(Boolean applicationServerFiltering)
public CRMDOProvProvider load()

Methods you are recommended to override to add functionality:

protected CRMDO constructDO(CRMDO mainDTO)
protected LinkedHashMap<String, String> getMandatoryFields(CRMDO dto)
protected void validateOnSaveProvisioningProviderServices(CRMDOProvProvider provProvider)
protected void validateOnSaveProvisioningDistributors(CRMDOProvProvider provProvider)
protected void validateOnSaveProvisioningProviderPhysicalGood(CRMDOProvProvider provProvider)

MYCOMPANYCRMBOTucanoProviderBean.java

public class MYCOMPANYCRMBOTucanoProviderBean extends CRMBOProvProviderBean implements ICRMBOProvisioningProvider  {

	@EJB private MYCOMPANYTucanoProviderXMLUtilBean tucanoProviderXMLUtilBean;
	@EJB private CRMBOProvProviderServiceBean provProviderServiceBean;
	@EJB private CRMValidatorBean validatorBean;
	@EJB private CRMBOProvisioningDistributorBean provisioningDistributorBean;
    /**
     * Default constructor. 
     */
    public MYCOMPANYCRMBOTucanoProviderBean() {
    	// do nothing
    }
    /**
     * Loads the effective TUCANO provisioning provider
     * @return the effective TUCANO provisioning provider
     * @throws Exception
     */
	public CRMDOProvProvider loadEffective() throws Exception {
		return loadEffective(MYCOMPANYCRMProcessTucanoProviderBean.PROVIDER_PROTOCOL);
	}
	
	/**
	 * Loads the effective TUCANO provisioning provider
	 * @param applicationServerFiltering - if set to true filters out the results based on the provisioning provider's allowed application servers
	 * @return the effective TUCANO provisioning provider
	 * @throws Exception
	 */
	public CRMDOProvProvider loadEffective(Boolean applicationServerFiltering) throws Exception {
		return loadEffective(MYCOMPANYCRMProcessTucanoProviderBean.PROVIDER_PROTOCOL, applicationServerFiltering);
	}
	/**
	 * Loads the TUCANO provisioning provider
	 * @return the TUCANO provisioning provider
	 * @throws Exception
	 */
	public CRMDOProvProvider load() throws Exception {
		return loadByProtocol(MYCOMPANYCRMProcessTucanoProviderBean.PROVIDER_PROTOCOL);
	}
	
	/**
     * Constructs a TUCANO provisioning provider.
     * 
     * @param mainDTO - the main data object
     * @return a TUCANO provisioning provider
     * @throws Exception
     */
	@Override
	protected CRMDO constructDO(CRMDO mainDTO) throws Exception {
		
		CRMDOProvProvider provProvider = (CRMDOProvProvider)super.constructDO(mainDTO);
		
		MYCOMPANYTucanoParameters tucanoParameters = new MYCOMPANYTucanoParameters();	
		provProvider.setProvisioningParameters(tucanoParameters);
		
		provProvider.setProtocol(MYCOMPANYCRMProcessTucanoProviderBean.PROVIDER_PROTOCOL);
		provProvider.setLifeCycleState(ProvProviderLifeCycleState.NOT_EFFECTIVE);
		provProvider = setDefaultSettings(provProvider);
		
		return provProvider;		
	}
    
	/**
     * Returns the mandatory fields of the given provisioning provider.
     * 
     * @param dto - the provisioning provider to return the mandatory fields for
     * @return the mandatory fields of the provisioning provider
     * @throws Exception
     */
	@Override
	protected LinkedHashMap<String, String> getMandatoryFields(CRMDO dto) throws Exception {
		
		LinkedHashMap<String, String> mandatoryFields = super.getMandatoryFields(dto);
		
		mandatoryFields.put("key_url", "provisioningParameters/url");
		mandatoryFields.put("key_identity_key", "provisioningParameters/identityKey");
		mandatoryFields.put("key_username", "provisioningParameters/username");
		mandatoryFields.put("key_password", "provisioningParameters/password");
		mandatoryFields.put("key_language_id", "provisioningParameters/languageID");
		mandatoryFields.put("key_default_product_id", "provisioningParameters/defaultProductID");
		mandatoryFields.put("key_stb_material_id", "provisioningParameters/stbMaterialID");
		mandatoryFields.put("key_provider_id", "provisioningParameters/providerID");
		mandatoryFields.put("key_tve_adapter", "provisioningParameters/tveAdapter");
		mandatoryFields.put("key_jwt_key", "provisioningParameters/jwtKey");
		mandatoryFields.put("key_jwt_expiration_time_in_seconds", "provisioningParameters/jwtExpirationTimeInSeconds");
		mandatoryFields.put("key_address_country", "provisioningParameters/addressCountry");
		
		return mandatoryFields;
	}
	
	/**
	 * Sets provisioning provider's connection parameter values using its 'parameters' String property value
	 * @param provProvider - the provisioning provider to set the objects to
	 * @return the updated provisioning provider
	 */
	public CRMDOProvProvider setObjectsFromXML(CRMDOProvProvider provProvider) throws Exception {
		if (provProvider.getParameters()!=null)
		{	
			provProvider = tucanoProviderXMLUtilBean.loadConnectionParametersFromXml(provProvider);
		}
		
		return provProvider;
	}
	/**
	 * Constructs a String XML that will keep all information about the provider's connection parameters and set it to CRMDOProvProvider object's 'parameters' String property
	 * @param provProvider - the provisioning provider to construct the XML for
	 * @return the updated provisioning provider
	 */
	public CRMDOProvProvider setXMLFromObjects(CRMDOProvProvider provProvider) throws Exception {
		if (provProvider!=null)
		{
			provProvider = tucanoProviderXMLUtilBean.convertConnectionParametersToXML(provProvider);
		}
		
		return provProvider;
	}
	/**
	 * Returns a unique identification string (conditional access id) used by the provisioning provider to identify the given service
	 * @param provProvider - the provisioning provider to get the service ca id for
	 * @param product - the product to get its service ca id
	 * @return the product's service ca id
	 */
	public String getServiceCAID(CRMDOProvProvider provProvider, CRMDOProduct product) throws Exception {
		String serviceCAID = null;
		
		CRMDOProvProviderService provProviderService = provProviderServiceBean.load(provProvider, product); 
		
		if (provProviderService!=null)
		{
			serviceCAID = provProviderService.getValue();
		}
		
		return serviceCAID;
	}
	/**
	 * Returns a unique identification string (conditional access id) used by the provisioning provider to identify the given smartcard
	 * @param provProvider - the provisioning provider to get the smartcard ca id for
	 * @param installedItem - the smartcard installed item to get its ca id
	 * @return the smartcard ca id
	 */
	public String getSmartcardCAID(CRMDOProvProvider provProvider, CRMDOInstalledItem installedItem) throws Exception {
		return installedItem.getAltCode();
	}
	/**
	 * Returns a unique identification string (conditional access id) used by the provisioning provider to identify the given set-top box
	 * @param provProvider - the provisioning provider to get the set-top box ca id for
	 * @param installedItem - the set-top box installed item to get its ca id
	 * @return the set-top box ca id
	 */
	public String getSTBCAID(CRMDOProvProvider provProvider, CRMDOInstalledItem installedItem) throws Exception {
		return installedItem.getAltCode();
	}
	
	/**
	 * Validates a provisioning provider service on save.
	 * 
	 * @param provProvider - the provisioning provider to validate it's provisioning provider service
	 * @throws Exception
	 */
	@Override
	@SuppressWarnings({ "unchecked", "rawtypes" })
	protected void validateOnSaveProvisioningProviderServices(CRMDOProvProvider provProvider) throws Exception, AtLeastOneRecordException, MandatoryFieldException, InvalidValueException {
		if(!ServiceUtil.isInitialized(provProvider.getServices())
			|| provProvider.getServices() == null
			|| provProvider.getServices().size() == 0)
		{
			provProvider.setServices(new HashSet(provProviderServiceBean.load(provProvider)));
		}
			
		if(provProvider.getServices() != null && provProvider.getServices().size() > 0)
		{
			Iterator<CRMDOProvProviderService> iterServices	= provProvider.getServices().iterator();
			
			while (iterServices.hasNext())
			{
				CRMDOProvProviderService service = (CRMDOProvProviderService) iterServices.next();
				
				CRMDOProduct product 				= service.getProduct();
				if (service.getIsDeleted()!=null && service.getIsDeleted().equals(new Integer(0)) && product.getType().getIsForProvision().equals(new Integer(1) ) )
				{
					if (service.getValue() == null)
					{
						throw new MandatoryFieldException(getCRMSession(), "key_provisioning_system_identifier");
					}
					
					if(!StringUtil.isNumeric(service.getValue()))
			    	{
						throw new InvalidValueException(null,"Provisioning System Identifier."+StringUtil.getNumericExceptionMessage(service.getValue()));
			    	}
				}
			}
			
			provProviderServiceBean.validateOnSave(new ArrayList<CRMDO>(provProvider.getServices()));
			
			validatorBean.validateUniqueRecord(
					"provisioning provider service", 
					new ArrayList<CRMDO>(provProvider.getServices()), 
					new String[]{"product.code"}, 
					new String[]{"service"});
			
		}
		else
		{
			throw new AtLeastOneRecordException(getCRMSession(), "key_service");
		}
	}
	
	/**
	 * Validates a provisioning distributor on save.
	 * 
	 * @param provProvider - the provisioning provider to validate it's provisioning distributor
	 * @throws Exception
	 */
	@Override
	@SuppressWarnings({ "unchecked", "rawtypes" })
	protected void validateOnSaveProvisioningDistributors(CRMDOProvProvider provProvider) throws Exception, AtLeastOneRecordException {
		if(!ServiceUtil.isInitialized(provProvider.getProvisioningDistributors())
			|| provProvider.getProvisioningDistributors() == null
			|| provProvider.getProvisioningDistributors().size() == 0)
		{
			provProvider.setProvisioningDistributors(new HashSet(provisioningDistributorBean.load(provProvider)));
		}
		
		if(provProvider.getProvisioningDistributors() != null && provProvider.getProvisioningDistributors().size() > 0)
		{
			Iterator<CRMDOProvisioningDistributor> iter = provProvider.getProvisioningDistributors().iterator();
			Boolean nonDeletedExists = new Boolean(false);
			
			while(iter.hasNext())
			{
				CRMDOProvisioningDistributor provisioningDistributor = (CRMDOProvisioningDistributor)iter.next();
				
				if(!provisioningDistributor.isDeleted())
				{
					if(nonDeletedExists)
					{
						throw new OnlyOneRecordException(getCRMSession(), "key_provisioning_distributor");
					}	
					
					nonDeletedExists = new Boolean(true);
				}	
			}	
			
			if(provProvider.getLifeCycleState() != null && provProvider.getLifeCycleState().equals(ProvProviderLifeCycleState.EFFECTIVE) && !nonDeletedExists)
			{
				throw new AtLeastOneRecordException(getCRMSession(), "key_provisioning_distributors");
			}	
			
			provisioningDistributorBean.validateOnSave(new ArrayList<CRMDO>(provProvider.getProvisioningDistributors()));
		}
		else
		{
			if(provProvider.getLifeCycleState() != null && provProvider.getLifeCycleState().equals(ProvProviderLifeCycleState.EFFECTIVE))
			{
				throw new AtLeastOneRecordException(getCRMSession(), "key_provisioning_distributors");
			}	
		}
	}
	
	/**
	 * Validates a provisioning provider physical good on save.
	 * 
	 * @param provProvider - the provisioning provider to validate it's physical good
	 * @throws Exception
	 */
	@Override
	protected void validateOnSaveProvisioningProviderPhysicalGood(CRMDOProvProvider provProvider) throws Exception, AtLeastOneRecordException {
		if (isCollectionModified(provProvider.getPhysicalGoods()))
		{
			Set<CRMDOProvProviderPhysicalGood> physicalGoods = provProvider.getPhysicalGoods();
			Iterator<CRMDOProvProviderPhysicalGood> physicalGoodIter = physicalGoods.iterator();
			int physicalGoodCounter = 0;
			
			while (physicalGoodIter.hasNext())
			{
				CRMDOProvProviderPhysicalGood physicalGood	= physicalGoodIter.next();
				
				if (physicalGood.getIsDeleted().equals(new Integer(0)))
				{
					physicalGoodCounter++;
				}
			}
			
			if (physicalGoodCounter == 0)
			{
				throw new AtLeastOneRecordException(getCRMSession(), "key_physical_good");
			}
		}
		
		super.validateOnSaveProvisioningProviderPhysicalGood(provProvider);
	}
	
	...
}

4. User Interface Classes

a. Provisioning Provider User Interface Class

The first user interface class that should be created is the provisioning provider's user interface class and should extend com.crm.process.provisioning.CRMUIProvProviderBean.

This class's methods will by called by the provisioning provider data entry page.

MYCOMPANYCRMUITucanoServiceProvider.java

public class MYCOMPANYCRMUITucanoServiceProviderBean extends CRMUIProvProviderBean {

	@EJB private CRMBOProvProviderServiceBean provProviderServiceBean;
	@EJB private CRMBOProvisioningDistributorBean provisioningDistributorBean;
	@EJB private MYCOMPANYCRMBOTucanoProviderBean tucanoProviderBean;
	@EJB private CRMBOSubscriptionTypeBean subscriptionTypeBean;
	@EJB private MYCOMPANYTucanoProviderXMLUtilBean tucanoProviderXMLUtilBean;
	@EJB private CRMBOProductBean productBean;
	@EJB private CRMBOProductTypeBean productTypeBean;
	@EJB private CRMBOProvProviderPhysicalGoodBean provProviderPhysicalGoodBean;	
	
    /**
     * Default constructor. 
     */
    public MYCOMPANYCRMUITucanoServiceProviderBean() {
    	// do nothing
    }
    
    /**
     * Loads the effective TUCANO provisioning provider
     * @return the effective TUCANO provisioning provider
     * @throws Exception
     */
    public CRMDOProvProvider loadForm() throws Exception {
    	
    	CRMDOProvProvider provProvider = (CRMDOProvProvider)tucanoProviderBean.loadEffective(false);
		
    	if (provProvider==null)
    	{
    		provProvider = (MYCOMPANYCRMDOProvProvider)tucanoProviderBean.load();
        	
        	if (provProvider==null)
        	{
        		provProvider = (CRMDOProvProvider)createButton();
        		Set<CRMDOProvisioningDistributor> provisioningDistributors = new HashSet<CRMDOProvisioningDistributor>();
        		CRMDOProvisioningDistributor provisioningDistributor = (CRMDOProvisioningDistributor) provisioningDistributorBean.construct(provProvider);
    			provisioningDistributors.add(provisioningDistributor);
        		provProvider.setProvisioningDistributors(provisioningDistributors);
        		
        	}
        	else
        	{
        		provProvider = tucanoProviderXMLUtilBean.loadConnectionParametersFromXml(provProvider);
        	}	
    	}
    	else
    	{
    		provProvider = tucanoProviderXMLUtilBean.loadConnectionParametersFromXml(provProvider);
    	}    	
		return provProvider;
    }
    /**
     * Loads a provisioning provider given its id
     * @param provProviderID - the provisioning provider id
     * @return the provisioning provider
     * @throws Exception
     */
	@SuppressWarnings({ "rawtypes", "unchecked" })
	public CRMDOProvProvider loadForm(String provProviderID) throws Exception {
    	
    	CRMDOProvProvider provProvider = (CRMDOProvProvider)tucanoProviderBean.load(provProviderID);
		provProvider.setPhysicalGoods(new HashSet(loadPhysicalGoodsTab(provProvider)));
		provProvider.setProvisioningDistributors(new HashSet(loadDistributorsTab(provProvider)));
		
		if(provProvider.getProvisioningDistributors().size()==0)
		{
			Set<CRMDOProvisioningDistributor> provisioningDistributors = new HashSet<CRMDOProvisioningDistributor>();
			CRMDOProvisioningDistributor provisioningDistributor= (CRMDOProvisioningDistributor) provisioningDistributorBean.construct(provProvider);
			provisioningDistributors.add(provisioningDistributor);
			provProvider.setProvisioningDistributors(provisioningDistributors);
		}
		provProvider = tucanoProviderXMLUtilBean.loadConnectionParametersFromXml(provProvider);
		
		return provProvider;
    }
    
    public CRMDOProvProvider createButton() throws Exception {
    	return createButton(CRMProcessTucanoProviderBean.PROVIDER_PROTOCOL);
    }
 
    /**
     * Creates a new provisioning provider with the given protocol
     * @param protocol - the protocol to create the provisioning provider for
     * @return the new provisioning provider
     * @throws Exception
     */
    public CRMDOProvProvider createButton(String protocol) throws Exception {
    	
    	CRMDOProvProviderprovProvider = null;
    	
    	if (protocol!=null)
    	{    	
	    	if (protocol.equals(MYCOMPANYCRMProcessTucanoProviderBean.PROVIDER_PROTOCOL))
	    	{
	    		provProvider = (CRMDOProvProvider)tucanoProviderBean.construct();
	    	}
    	}
    	
    	return provProvider;
    }
    /**
     * Saves the given provisioning provider
     * @param provProvider - the provisioning provider to save
     * @return the saved provisioning provider
     * @throws Exception
     */
    public CRMDOProvProvider saveButton(CRMDOProvProvider provProvider) throws Exception {
    	
    	String provProviderProtocol = provProvider.getProtocol();
    	
    	if (provProviderProtocol.equals(MYCOMPANYCRMProcessTucanoProviderBean.PROVIDER_PROTOCOL))
    	{
    		tucanoProviderBean.validateConnectionParameters(provProvider);
    	
    		return (CRMDOProvProvider)tucanoProviderBean.validateAndSave(provProvider);	
    	}
    	
    	return provProvider;
    }
    
    /**
     * Loads the given provisioning provider
     * @param provProvider - the provisioning provider to load
     * @return the provisioning provider
     * @throws Exception
     */
	public CRMDOProvProvider editButton(CRMDOProvProvider provProvider) throws Exception {
		return (provProvider!=null && !provProvider.isNew()) ? loadForm(provProvider.getId()) : loadForm();
	}
	/**
	 * Deletes the given provisioning provider
	 * @param provProvider - the provisioning provider to delete
	 * @return the deleted provisioning provider
	 * @throws Exception
	 */
	public CRMDOProvProvider deleteButton(CRMDOProvProvider provProvider) throws Exception {
		
		String provProviderProtocol = provProvider.getProtocol();
    	
    	if (provProviderProtocol.equals(MYCOMPANYCRMProcessTucanoProviderBean.PROVIDER_PROTOCOL))
    	{
    		return (CRMDOProvProvider)tucanoProviderBean.validateAndDelete(provProvider);
    	}
    	
		return provProvider;
	}
	
	/**
	 * Adds a list of set-top-boxes to the provisioning provider.
	 * 
	 * @param  provProvider		        the provisioning provider related with the physical goods
	 * @param  productTypeIds			a list of product IDs
	 * @return                       	a list of the provisioning provider physical goods added
	 * @throws Exception
	 */
	public ArrayList<CRMDO> addSetTopBoxButton (CRMDOProvProvider provProvider, ArrayList<String> productTypeIds) throws Exception { 
		
		String className = productTypeBean.getDOName();
		String primaryId = "id";
		String propertyName = "productType";
		
		ArrayList<CRMDO> smartcards = provProviderPhysicalGoodBean.construct(provProvider, null, className, primaryId,propertyName, productTypeIds,	null);
	
		for(int i = 0; i < smartcards.size(); i++)
		{
			CRMDOProvProviderPhysicalGood smartcard = (CRMDOProvProviderPhysicalGood)smartcards.get(i);
			smartcard.setValue(ProvProviderPhysicalGood.DECODER);
		}
		
		return smartcards;
	}
}

b. Provisioning Request User Interface Class

The second user interface class that should be created is the provisioning provider's user interface class and should extend com.crm.process.provisioning.CRMUIProvisioningRequestBean.

This class's methods will by called by the provisioning provider requests summary pages.

MYCOMPANYCRMUITucanoServiceProvisioningRequest.java

public class MYCOMPANYCRMUITucanoServiceProvisioningRequestBean extends CRMUIProvisioningRequestBean {
    public MYCOMPANYCRMUITucanoServiceProvisioningRequestBean() {
    	// do nothing
    }
    	
    /**
     * Loads the provisioning request type options.
     *  
     * @return the provisioning request type options
     * @throws Exception
     */
    public LookupBuilder getTypeOptions() throws Exception {
    	return getTypeOptions(null);
    }
    
    /**
     * Loads the provisioning request type options.
     *  
     * @param emptyValue - an empty value for type 
     * @return the provisioning request type options
     * @throws Exception
     */
    public LookupBuilder getTypeOptions(String emptyValue) throws Exception {
    		
    	LookupBuilder builder = new LookupBuilder();
    		
    	if (emptyValue!=null)
    	{
    		builder.build("", emptyValue);
    	}
    	MYCOMPANYProvisioningRequestTypeCode[] requestTypes = MYCOMPANYProvisioningRequestTypeCode.values();
    		
   		for (int i=0; i<requestTypes.length; i++)
   		{
   			MYCOMPANYProvisioningRequestTypeCode requestType = requestTypes[i];
   			builder.build(requestType.toString(), requestType.getLabel());
   		}
    		
   		return builder;
   	}	
}

5. Provisioning Provider Process Class

a. Create Class and Implement a Method for Each Action

Use @Stateless(mappedName = "ejb/MYCOMPANYCRMProcessTucanoProvider") to define the mapped name of the provisioning provider EJB. The mapped name should match the one defined in provisioningproviders.xml metadata file.

The new process class must extend com.crm.process.provisioning.CRMProcessProviderBean and implement the following methods (which are defined as abstract in CRMProcessProviderBean parent class):

Note that the value of PORVIDER_PROTOCOL must be the same as <provproviderprotocol> tag's value as defined in provisioningproviders.xml

public String getProtocol()

MYCOMPANYCRMProcessTucanoProviderBean.java

@Stateless(mappedName = "ejb/MYCOMPANYCRMProcessTucanoProvider")
@LocalBean
public class MYCOMPANYCRMProcessTucanoProviderBean extends CRMProcessProviderBean {
	
	public static String PROVIDER_PROTOCOL = "TUCANO";
	
    /**
     * Default constructor. 
     */
	public MYCOMPANYCRMProcessTucanoProviderBean() {
        super();
    }
	public String getProtocol() throws Exception {
		return PROVIDER_PROTOCOL;
	}
	...
}

public CRMDOProvProvider setObjectsFromXML(CRMDOProvProvider provProvider)

This method is called whenever loadProvider(), loadEffectiveProvider(String protocol) and loadEffectiveProvider(String protocol , Boolean applicationServerFiltering) methods of CRMProcessProviderBean are called.