Installation
Complete the following installation steps:
1. Download the FieldworkPIP.zip file from Oracle Software Delivery Cloud. (https://edelivery.oracle.com).
Note: For specific instructions about installing this integration on non-Windows/ Linux platforms, see Oracle Support Knowledge Article ID 1349320.1.
2. Extract the zip file to SERVICES_LOCATION. Example: /u01/SERVICES_LOCATION/soainfra/apps
Note: Ensure that you have the write permissions and override the files during extraction. Unzip in such a a way that it should merge the contents of existing directory structure of SERVICES_LOCATION/soainfra/apps/../../../../till the child by installation zip (FieldworkPIP.zip )
Example:
Linux :
$ unzip FieldworkPIP.zip
 
When unzip finds a file that already exists in the destination (SERVICES_LOCATION/soainfra/apps/../../../../) , it asks if you want to overwrite it. You can then type y to overwrite it, A to overwrite all files.
When you unzip the following directories will be merged into SERVICES_LOCATION/soainfra/apps.
The extracted folder structure on the server should appear as:
Installing the Integration
1. Source the environment variables using aiaenv.bat/aiaenv.sh.
Windows:
C:\Oracle\Middleware\Oracle_Home\user_projects\domains\soa_doma in\soa\aia\bin\aiaenv.bat
 
Linux:
source
/Oracle/Middleware/user_projects/domains/soa_domain/soa/aia/
bin/aiaenv.sh
 
2. Open a command prompt and execute the following installation command in Linux or Windows respectively.
Linux:
ant -f $SOA_HOME/aiafp/Install/AID/AIAInstallDriver.xml - DDeploymentPlan=$AIA_HOME/pips/FieldWork/DeploymentPlans/ FieldWorkDP.xml -DPropertiesFile=$DOMAIN_LOCATION/soa/aia/bin/ AIAInstallProperties.xml - DSupplementaryDeploymentPlan=$AIA_HOME/pips/FieldWork/ DeploymentPlans/FieldWorkSupplementaryDP.xml - DDeploymentPolicyFile=$AIA_HOME/pips/FieldWork/DeploymentPlans/ FieldWorkConditionalPolicy.xml -l $AIA_HOME/pips/FieldWork/ DeploymentPlans/FieldWorkDP.log
 
Windows:
ant -f %SOA_HOME%\aiafp\Install\AID\AIAInstallDriver.xml -DDeploymentPlan=%AIA_HOME%\pips\FieldWork\DeploymentPlans\FieldWorkDP.xml -DPropertiesFile=%DOMAIN_LOCATION%\soa\aia\bin\AIAInstallProperties.xml -DSupplementaryDeploymentPlan=%AIA_HOME%\pips\FieldWork\DeploymentPlans\FieldWorkSupplementaryDP.xml -DDeploymentPolicyFile=%AIA_HOME%\pips\FieldWork\DeploymentPlans\FieldWorkConditionalPolicy.xml -l %AIA_HOME%\pips\FieldWork\DeploymentPlans\FieldWorkDP.log
 
This initiates a prompt for the WebLogic admin user name and password. Enter these details to initiate the installation.
Post-Installation Validation
After completing the installation steps, use the following guidelines to validate based on your planned integration combination.
Installation Validation for Scenario 1, Scenario 2 and Scenario 4
Scenario 1: Integration + CC&B, MWM + WAMv1.x
Scenario 2: Integration + CC&B + MWM
Scenario 4: Integration + WAM v1.x + CC&B
 
1. Login to the Enterprise Manager console.
2. Navigate to SOA > soa-infra > default partition.
3. Verify that all composites are deployed and are in 'active' state. Following is a list of composites:
AIAAsyncErrorHandlingBPELProcess
AIAB2BErrorHandlerInterface
AIAB2BInterface
AIAErrorTaskAdministrationProcess
AIAReadJMSNotificationProcess
CCBGetMeterDataProvService
CreateCustomerInteractionOUCCBUtilitiesProvABCSImpl
CreateCustomerInteractionOUWAMUtilitiesReqABCSImpl
CreateInvoiceOUCCBUtilitiesJMSConsumer
CreateInvoiceOUCCBUtilitiesJMSProducer
CreateInvoiceOUCCBUtilitiesProvABCSImpl
CreateInvoiceOUWAMUtilitiesReqABCSImpl
CreateTimeSheetOUWAMUtilitiesProvABCSImpl
GetNDSRecordsOUCCBUtilitiesEBF
GetWOLineApptWinAvailOUCCBUtilitiesReqABCSImpl
GetWOLineApptWinAvailOUMWMUtilitiesProvABCSImplV2
ManageNDSRecordsUtilityEBF
ProcessNDSRecordOUCCBUtilitiesEBF
ProcessWorkOrderCompleteOUMWMUtilitiesReqABCSImplV2
ProcessWorkOrderCompleteOUWAMUtilitiesReqABCSImpl
ProcessWorkOrderCreateOUMWMUtilitiesReqABCSImplV2
ProcessWorkOrderCreateOUWAMUtilitiesReqABCSImpl
ProcessWorkOrderOUCCBUtilitiesJMSConsumer
ProcessWorkOrderOUCCBUtilitiesJMSProducer
ProcessWorkOrderOUCCBUtilitiesProvABCSImpl
ProcessWorkOrderOUCCBUtilitiesReqABCSImpl
ProcessWorkOrderOUMWMUtilitiesJMSConsumerV2
ProcessWorkOrderOUMWMUtilitiesJMSProducer
ProcessWorkOrderOUMWMUtilitiesProvABCSImplV2
ProcessWorkOrderOUWAMUtilitiesJMSConsumer
ProcessWorkOrderOUWAMUtilitiesJMSProducer
ProcessWorkOrderOUWAMUtilitiesProvABCSImpl
ProcessWorkOrderResponseOUCCBUtilitiesJMSConsumer
ProcessWorkOrderResponseOUCCBUtilitiesJMSProducer
ProcessWorkOrderResponseOUCCBUtilitiesProvABCSImpl
ProcessWorkOrderResponseOUMWMUtilitiesProvABCSImplV2
ProcessWorkOrderResponseOUWAMUtilitiesProvABCSImpl
ProcessWorkOrderStatusOUMWMUtilitiesReqABCSImplV2
ProcessWorkOrderUpdateOUWAMUtilitiesReqABCSImpl
QueryInstalledProductListOUCCBUtilitiesProvABCSImpl
QueryInstalledProductListOUMWMUtilitiesReqABCSImplV2
ReloadProcess
UtilitiesCustomerInteractionEBS
UtilitiesCustomerInteractionResponseEBS
UtilitiesInstalledProductEBSV2
UtilitiesInvoiceEBSV2
UtilitiesWorkOrderEBS
UtilitiesWorkOrderResponseEBS
ValidateInstalledProductOUCCBUtilitiesProvABCSImpl
ValidateInstalledProductOUMWMUtilitiesReqABCSImplV2
ValidateInstalledProductOUWAMUtilitiesReqABCSImpl
WAMGetMeterDataReqService
4. Login to the WebLogic admin console to validate.
JMS queues and connection factories related to this integration are created under Home > JMS Modules > AIAJMSModule.
AIA_OUCCBFAResponseJMSQueue
AIA_OUCCBFAResponseJMSQueue_ErrorQ
AIA_OUCCBInvoiceJMSQueue
AIA_OUCCBInvoiceJMSQueue_ErrorQ
AIA_OUCCBOUODMSPSyncReqQueue
AIA_OUCCBOUODMSPSyncReqQueue_ErrorQ
AIA_OUCCBWorkOrderJMSQueue
AIA_OUCCBWorkOrderJMSQueue_ErrorQ
AIA_OUMWMWorkOrderJMSQueue
AIA_OUMWMWorkOrderJMSQueue_ErrorQ
AIA_OUODMOUCCBSPSyncRespQueue
AIA_OUODMOUCCBSPSyncRespQueue_ErrorQ
AIA_OUWAMWorkOrderJMSQueue
AIA_OUWAMWorkOrderJMSQueue_ErrorQ
AIA_OUWAMAckResponseJMSQueue
AIA_OUWAMAckResponseJMSQueue_ErrorQ
AIAOUCCBCF
AIAOUMWMCF
AIAOUWAMCF
Datasources related to integration are created under Home > Data Sources. This is applicable only if Oracle Utilities Customer Care and Billing is included in your integration.
AIANDSDS
AIAOUCCBNDSDS
5. Verify that the csf-keys are created successfully.
a. Login to the Enterprise Manager console.
b. Navigate to WebLogic_Domain > soa_domain.
c. Right-click soa_domain, and then select Security > Credentials.
d. Expand the oracle.wsm.security map.
e. Verify that the following keys are available:
OU_CCB_01
OU_MWM_01
OU_WAM_01
FW_PIP_01
The AIA_OUCCB_NDS_USER is created in the SOA database. The credentials for this user can be obtained from the AIAInstallProperties.xml file aiands node.
6. Verify the installation logs for any errors.
7. Get the configuration file from MDS using the GetFieldWorkConfigFileDP.xml utility and validate all the module level properties, service level properties are present in the AIAConfigurationProperties.xml.
Installation Validation for Scenario 3
Integration + WAM v1.x + MWM
1. Login to the Enterprise Manager console.
2. Navigate to the SOA > soa-infra > default partition.
3. Verify that all composites are deployed and are in 'active' state. Following is a list of composites:
AIAAsyncErrorHandlingBPELProcess
AIAB2BErrorHandlerInterface
AIAB2BInterface
AIAErrorTaskAdministrationProcess
AIAReadJMSNotificationProcess
CCBGetMeterDataProvService
CreateCustomerInteractionOUCCBUtilitiesProvABCSImpl
CreateCustomerInteractionOUWAMUtilitiesReqABCSImpl
CreateInvoiceOUCCBUtilitiesJMSConsumer
CreateInvoiceOUCCBUtilitiesJMSProducer
CreateInvoiceOUCCBUtilitiesProvABCSImpl
CreateInvoiceOUWAMUtilitiesReqABCSImpl
CreateTimeSheetOUWAMUtilitiesProvABCSImpl
GetWOLineApptWinAvailOUCCBUtilitiesReqABCSImpl
GetWOLineApptWinAvailOUMWMUtilitiesProvABCSImplV2
OUCCBOUODMSPSyncReqEBF
OUODMOUCCBSPSyncRespEBF
ProcessWorkOrderCompleteOUMWMUtilitiesReqABCSImplV2
ProcessWorkOrderCompleteOUWAMUtilitiesReqABCSImpl
ProcessWorkOrderCreateOUMWMUtilitiesReqABCSImplV2
ProcessWorkOrderCreateOUWAMUtilitiesReqABCSImpl
ProcessWorkOrderOUCCBUtilitiesJMSConsumer
ProcessWorkOrderOUCCBUtilitiesJMSProducer
ProcessWorkOrderOUCCBUtilitiesProvABCSImpl
ProcessWorkOrderOUCCBUtilitiesReqABCSImpl
ProcessWorkOrderOUMWMUtilitiesJMSConsumerV2
ProcessWorkOrderOUMWMUtilitiesJMSProducer
ProcessWorkOrderOUMWMUtilitiesProvABCSImplV2
ProcessWorkOrderOUWAMUtilitiesJMSConsumer
ProcessWorkOrderOUWAMUtilitiesJMSProducer
ProcessWorkOrderOUWAMUtilitiesProvABCSImpl
ProcessWorkOrderResponseOUCCBUtilitiesJMSConsumer
ProcessWorkOrderResponseOUCCBUtilitiesJMSProducer
ProcessWorkOrderResponseOUCCBUtilitiesProvABCSImpl
ProcessWorkOrderResponseOUMWMUtilitiesProvABCSImplV2
ProcessWorkOrderResponseOUWAMUtilitiesProvABCSImpl
ProcessWorkOrderStatusOUMWMUtilitiesReqABCSImplV2
ProcessWorkOrderUpdateOUWAMUtilitiesReqABCSImpl
QueryInstalledProductListOUCCBUtilitiesProvABCSImpl
QueryInstalledProductListOUMWMUtilitiesReqABCSImplV2
ReloadProcess
UtilitiesCustomerInteractionEBS
UtilitiesCustomerInteractionResponseEBS
UtilitiesInstalledProductEBSV2
UtilitiesInvoiceEBSV2
UtilitiesWorkOrderEBS
UtilitiesWorkOrderResponseEBS
ValidateInstalledProductOUCCBUtilitiesProvABCSImpl
ValidateInstalledProductOUMWMUtilitiesReqABCSImplV2
ValidateInstalledProductOUWAMUtilitiesReqABCSImpl
WAMGetMeterDataReqService
4. Login to the weblogic admin console to validate the following.
JMS queues and connection factories related to this integration are created under Home > JMS Modules > AIAJMSModule.
AIA_OUCCBFAResponseJMSQueue
AIA_OUCCBFAResponseJMSQueue_ErrorQ
AIA_OUCCBOUODMSPSyncReqQueue
AIA_OUCCBOUODMSPSyncReqQueue_ErrorQ
AIA_OUMWMWorkOrderJMSQueue
AIA_OUMWMWorkOrderJMSQueue_ErrorQ
AIA_OUODMOUCCBSPSyncRespQueue
AIA_OUODMOUCCBSPSyncRespQueue_ErrorQ
AIA_OUWAMWorkOrderJMSQueue
AIA_OUWAMWorkOrderJMSQueue_ErrorQ
AIA_OUWAMAckResponseJMSQueue
AIA_OUWAMAckResponseJMSQueue_ErrorQ
AIAOUCCBCF
AIAOUMWMCF
AIAOUWAMCF
5. Verify that the csf-keys are created successfully.
a. Login to the Enterprise Manager console.
b. Navigate to WebLogic_Domain > soa_domain > soa_domain.
c. Right-click soa_domain, and then select Security > Credentials.
d. Expand the oracle.wsm.security map.
e. Verify that the following keys are available:
OU_CCB_01
OU_MWM_01
OU_WAM_01
FW_PIP_01
The AIA_OUCCB_NDS_USER user is created in the SOA database. The credentials for this user can be obtained from the AIAInstallProperties.xml file aiands node.
6. Verify the installation logs for any errors.
7. Get the configuration file from MDS using the GetFieldWorkConfigFileDP.xml utility and validate all the module level properties, service level properties are present in the AIAConfigurationProperties.xml.
Installation Validation for Scenario 5
Integration + WAM v2.x + MWM
After the successful installation of the PIP for WAMV2-MWM the following composites will be successfully deployed and can be validated in the Enterprise Manageer Console.
1. Login to the Enterprise Manager console.
2. Navigate to the SOA > soa-infra > default partition.
3. Verify that all composites are deployed and are in 'active' state. Following is the list of composites:
AIAAsyncErrorHandlingBPELProcess
AIAB2BErrorHandlerInterface
AIAB2BInterface
AIAErrorTaskAdministrationProcess
AIAReadJMSNotificationProcess
CCBGetMeterDataProvService
CreateCustomerInteractionOUCCBUtilitiesProvABCSImpl
CreateInvoiceOUCCBUtilitiesJMSConsumer
CreateInvoiceOUCCBUtilitiesJMSProducer
CreateInvoiceOUCCBUtilitiesProvABCSImpl
GetWOLineApptWinAvailOUCCBUtilitiesReqABCSImpl
GetWOLineApptWinAvailOUMWMUtilitiesProvABCSImplV2
OUCCBOUODMSPSyncReqEBF
OUODMOUCCBSPSyncRespEBF
ProcessWorkOrderCancelCompleteOUWAMUtilitiesReqABCSImplV2
ProcessWorkOrderCompleteOUMWMUtilitiesReqABCSImplV2
ProcessWorkOrderCreateOUMWMUtilitiesReqABCSImplV2
ProcessWorkOrderCreateUpdateOUWAMUtilitiesReqABCSImplV2
ProcessWorkOrderOUCCBUtilitiesJMSConsumer
ProcessWorkOrderOUCCBUtilitiesJMSProducer
ProcessWorkOrderOUCCBUtilitiesProvABCSImpl
ProcessWorkOrderOUCCBUtilitiesReqABCSImpl
ProcessWorkOrderOUMWMUtilitiesJMSConsumerV2
ProcessWorkOrderOUMWMUtilitiesJMSProducer
ProcessWorkOrderOUMWMUtilitiesProvABCSImplV2
ProcessWorkOrderOUWAMUtilitiesJMSConsumerV2
ProcessWorkOrderOUWAMUtilitiesJMSProducer
ProcessWorkOrderOUWAMUtilitiesProvABCSImplV2
ProcessWorkOrderResponseOUCCBUtilitiesJMSConsumer
ProcessWorkOrderResponseOUCCBUtilitiesJMSProducer
ProcessWorkOrderResponseOUCCBUtilitiesProvABCSImpl
ProcessWorkOrderResponseOUMWMUtilitiesProvABCSImplV2
ProcessWorkOrderResponseOUWAMUtilitiesJMSConsumerV2
ProcessWorkOrderResponseOUWAMUtilitiesJMSProducerV2
ProcessWorkOrderResponseOUWAMUtilitiesProvABCSImplV2
ProcessWorkOrderStatusOUMWMUtilitiesReqABCSImplV2
QueryInstalledProductListOUCCBUtilitiesProvABCSImpl
QueryInstalledProductListOUMWMUtilitiesReqABCSImplV2
ReloadProcess
UtilitiesInstalledProductEBSV2
UtilitiesWorkOrderEBS
UtilitiesWorkOrderResponseEBS
ValidateInstalledProductOUCCBUtilitiesProvABCSImpl
ValidateInstalledProductOUMWMUtilitiesReqABCSImplV2
4. Login to the weblogic admin console to validate. JMS queues and connection factories related to this integration are created under HOME > JMS Modules > AIAJMSModule.
AIA_OUCCBFAResponseJMSQueue
AIA_OUCCBFAResponseJMSQueue_ErrorQ
AIA_OUCCBInvoiceJMSQueue
AIA_OUCCBInvoiceJMSQueue_ErrorQ
AIA_OUCCBOUODMSPSyncReqQueue
AIA_OUCCBOUODMSPSyncReqQueue_ErrorQ
AIA_OUCCBWorkOrderJMSQueue
AIA_OUCCBWorkOrderJMSQueue_ErrorQ
AIA_OUMWMWorkOrderJMSQueue
AIA_OUMWMWorkOrderJMSQueue_ErrorQ
AIA_OUODMOUCCBSPSyncRespQueue
AIA_OUODMOUCCBSPSyncRespQueue_ErrorQ
AIA_OUWAMWorkOrderJMSQueue
AIA_OUWAMWorkOrderJMSQueue_ErrorQ
AIA_OUWAMAckResponseJMSQueue
AIA_OUWAMAckResponseJMSQueue_ErrorQ
5. Verify that the csf-keys are created successfully.
a. Login to the Enterprise Manager console.
b. Navigate to WebLogic_Domain > soa_domain.
c. Right-click soa_domain, and then select Security > Credentials.
d. Expand the oracle.wsm.security map.
e. Verify that the following keys are available:
OU_CCB_01
OU_MWM_01
OU_WAM_01
FW_PIP_01
The AIA_OUCCB_NDS_USER user is created in the SOA database. The credentials for this user can be obtained from the AIAInstallProperties.xml file aiands node.
6. Verify the installation logs for any errors.
7. Get the configuration file from MDS using the GetFieldWorkConfigFileDP.xml utility and validate all the module level properties, service level properties are present in the AIAConfigurationProperties.xml.
Installation Validation for Scenario 6 and Scenario 7
Scenario 6: Integration + WAM v2.x + CCB
Scenario 7: Integration + WAM v2.x + CCB + MWM
1. Login to the Enterprise Manager console.
2. Navigate to the SOA > soa-infra > default partition.
3. Verify that all composites are deployed and are in 'active' state. Following is the list of composites:
AIAAsyncErrorHandlingBPELProcess
AIAB2BErrorHandlerInterface
AIAB2BInterface
AIAErrorTaskAdministrationProcess
AIAReadJMSNotificationProcess
CCBGetMeterDataProvService
CreateCustomerInteractionOUCCBUtilitiesProvABCSImpl
CreateInvoiceOUCCBUtilitiesJMSConsumer
CreateInvoiceOUCCBUtilitiesJMSProducer
CreateInvoiceOUCCBUtilitiesProvABCSImpl
GetNDSRecordsOUCCBUtilitiesEBF
GetWOLineApptWinAvailOUCCBUtilitiesReqABCSImpl
GetWOLineApptWinAvailOUMWMUtilitiesProvABCSImplV2
ManageNDSRecordsUtilityEBF
OUCCBOUODMSPSyncReqEBF
OUODMOUCCBSPSyncRespEBF
ProcessNDSRecordOUCCBUtilitiesEBF
ProcessWorkOrderCancelCompleteOUWAMUtilitiesReqABCSImplV2
ProcessWorkOrderCompleteOUMWMUtilitiesReqABCSImplV2
ProcessWorkOrderCreateOUMWMUtilitiesReqABCSImplV2
ProcessWorkOrderCreateUpdateOUWAMUtilitiesReqABCSImplV2
ProcessWorkOrderOUCCBUtilitiesJMSConsumer
ProcessWorkOrderOUCCBUtilitiesJMSProducer
ProcessWorkOrderOUCCBUtilitiesProvABCSImpl
ProcessWorkOrderOUCCBUtilitiesReqABCSImpl
ProcessWorkOrderOUMWMUtilitiesJMSConsumerV2
ProcessWorkOrderOUMWMUtilitiesJMSProducer
ProcessWorkOrderOUMWMUtilitiesProvABCSImplV2
ProcessWorkOrderOUWAMUtilitiesJMSConsumerV2
ProcessWorkOrderOUWAMUtilitiesJMSProducer
ProcessWorkOrderOUWAMUtilitiesProvABCSImplV2
ProcessWorkOrderResponseOUCCBUtilitiesJMSConsumer
ProcessWorkOrderResponseOUCCBUtilitiesJMSProducer
ProcessWorkOrderResponseOUCCBUtilitiesProvABCSImpl
ProcessWorkOrderResponseOUMWMUtilitiesProvABCSImplV2
ProcessWorkOrderResponseOUWAMUtilitiesJMSConsumerV2
ProcessWorkOrderResponseOUWAMUtilitiesJMSProducerV2
ProcessWorkOrderResponseOUWAMUtilitiesProvABCSImplV2
ProcessWorkOrderStatusOUMWMUtilitiesReqABCSImplV2
QueryInstalledProductListOUCCBUtilitiesProvABCSImpl
QueryInstalledProductListOUMWMUtilitiesReqABCSImplV2
ReloadProcess
UtilitiesInstalledProductEBSV2
UtilitiesWorkOrderEBS
UtilitiesWorkOrderResponseEBS
ValidateInstalledProductOUCCBUtilitiesProvABCSImpl
ValidateInstalledProductOUMWMUtilitiesReqABCSImplV2
4. Login to the WebLogic admin console to validate. JMS queues and connection factories related to this integration are created under HOME > JMS Modules > AIAJMSModule.
AIA_OUCCBFAResponseJMSQueue
AIA_OUCCBFAResponseJMSQueue_ErrorQ
AIA_OUCCBInvoiceJMSQueue
AIA_OUCCBInvoiceJMSQueue_ErrorQQueue
AIA_OUCCBOUODMSPSyncReqQueue
AIA_OUCCBOUODMSPSyncReqQueue_ErrorQ
AIA_OUCCBWorkOrderJMSQueue
AIA_OUCCBWorkOrderJMSQueue_ErrorQ
AIA_OUMWMWorkOrderJMSQueue
AIA_OUMWMWorkOrderJMSQueue_ErrorQ
AIA_OUODMOUCCBSPSyncRespQueue
AIA_OUODMOUCCBSPSyncRespQueue_ErrorQ
AIA_OUWAMAckResponseJMSQueue
AIA_OUWAMAckResponseJMSQueue_ErrorQ
AIA_OUWAMWorkOrderJMSQueue
AIA_OUWAMWorkOrderJMSQueue_ErrorQ
5. Verify that the csf-keys are created successfully.
a. Login to the Enterprise Manager console.
b. Navigate to WebLogic_Domain > soa_domain.
c. Right-click soa_domain, and then select Security > Credentials.
d. Expand the oracle.wsm.security map.
e. Verify that the following keys are available:
OU_CCB_01
OU_MWM_01
OU_WAM_01
FW_PIP_01
The AIA_OUCCB_NDS_USER user is created in the SOA database. The credentials for this user can be obtained from the AIAInstallProperties.xml file aiands node.
6. Verify the installation logs for any errors.
7. Get the configuration file from MDS using the GetFieldWorkConfigFileDP.xml utility and validate all the module level properties, service level properties are present in the AIAConfigurationProperties.xml.