Infrastructure Facades - EnterWorks_Process_Exchange_(EPX) - 10.6

EnterWorks EPX Programmers Reference

Product type
Software
Portfolio
Verify
Product family
EnterWorks
Product
Precisely EnterWorks > EnterWorks Process Exchange (EPX)
Version
10.6
Language
English
Product name
Precisely EnterWorks
Title
EnterWorks EPX Programmers Reference
Topic type
Programming Reference
Reference
First publish date
2007
  • Security Facade - this facade provides APIs for accessing the list of available EPX server environments and for client authentication against these environments. There are also APIs to access control information for logged-in client sessions. To create an instance of the SecurityFacade, use the following:

private SecurityFacade securityFacade_ =

(SecurityFacade)

FacadeFactory.getInstance().getFacadeInstance

(FacadeFactory.FACADE_SECURITY);

The following is an example using the SecurityFacade to get server profiles:

Collection profiles = securityFacade_.getServerProfiles();

The following is an example using the SecurityFacade to retrieve a session profile (serverProfileParam is the member of the collection profiles - as obtained in previous example – that matches the client’s server expectations):

boolean allowExpiration = false;

String userParam = “xyzUser”;

String passwordParam = “123”;

Session Profile sessionProfile_ =

securityFacade_.login(userParam, passwordParam,

serverProfileParam, allowExpiration );

  • Administration Facade - this facade provides APIs for general administration of the data related to servers, users, groups, server profiles, and reference codes. LDAP utility classes are also provided. To create an instance of the AdministrationFacade, use the following:

private AdministrationFacade administrationFacade_ =

(AdministrationFacade)

FacadeFactory.getInstance().getFacadeInstance

(FacadeFactory.FACADE_ADMINISTRATION);

The following is an example using the AdministrationFacade to create a group (sessionProfileParam is obtained as described in the SecurityFacade example):

GroupVO groupParam = new GroupVO();

// client assigns all groupParam attributes here

GroupVO group =

administrationFacade_.createGroup(

sessionProfileParam, groupParam);

  • Audit Facade - this facade provides APIs for creating new EPX audit entries and searching EPX audit entries. To create an instance of the AuditFacade, use the following:

private AuditFacade auditFacade_ =

(AuditFacade)FacadeFactory.getInstance()

.getFacadeInstance (FacadeFactory.FACADE_AUDIT);

The following is an example using the AuditFacade to retrieve object types that are marked for audit (sessionProfileParam is obtained as described in the SecurityFacade example):

Collection objectTypesRefCodes =

auditFacade_.getAuditObjectTypeList

(sessionProfileParam);

  • Query Facade - this facade provides APIs for querying the EPX persistence store for object data in a manner similar to using Sun's JDBC technology. The facade is used primarily to reduce the amount of network traffic and processing overhead of retrieving fully-populated EPX Java objects. To create an instance of the QueryBeansFacade, use the following:

private QueryBeansFacade queryFacade_ =

QueryBeansFacade.getInstance();

The following is an example using the QueryBeansFacade to run a query (sessionProfileParam is obtained as described in the SecurityFacade example):

QuerySpecification specificationParam =

new QuerySpecification();

// client assigns all specificationParam attributes here

QueryResult result = queryFacade_.runQuery

(sessionProfileParam, specificationParam,

passwordParam);