IBM Maximo Enterprise Adapter for Oracle Applications Configuration Guide

Version 7.6

NoteBeforeusingthisinformationandtheproductitsupports,readtheinformationinNoticesonpage113

Thiseditionappliestoversion7,release6,modification0ofIBMMaximoEnterpriseAdapterforOracleApplicationsandtoallsubsequentreleasesandmodificationsuntilotherwiseindicatedinneweditions.

CopyrightInternationalBusinessMachinesCorporation20082015.Allrightsreserved.

USGovernmentUsersRestrictedRightsUse,duplicationordisclosurerestrictedbyGSAADPScheduleContractwithIBMCorp.

Contents

Chapter1:ConfiguringtheadapterinMaximoAssetManagement...................................... 1Addingsupportforflatstructures ................................................................ 1Specifyingandenablingtheendpointfortheadapter................................................ 2Enablingpublishchannelsandenterpriseservices .................................................. 3

Publishchannelsandenterpriseservices....................................................... 4Settingupintegrationcontrols ................................................................... 5

Integrationcontrols ......................................................................... 5Configuringcrontasks.......................................................................... 8

Configuringthecrontaskforinterfacetablepolling ............................................. 9ConfiguringcrontasksforJMSqueues......................................................... 9Configuringacrontaskformessagereprocessing.............................................. 10

Adjustingdatabasestobecompatible ............................................................ 11MatchingGLaccountformatsandcolumnlengths ............................................. 11Adjustingthesizeandtypeoftablesandcolumns.............................................. 13

Automaticallyupdatingthesizeandtypeoftablesandcolumns.............................. 13Manuallyupdatingthesizeandtypeoftablesandcolumns.................................. 15

AdjustingthesizeoftheCOMPTYPEdomain ................................................. 15Updatingthedatabase ...................................................................... 16

AddingOracleVendorstotheMaximoAssetManagementCompaniesMasterSet ..................... 16Settingactivedefaultitemstatus................................................................. 17

Chapter2:ConfiguringtheadapteronOracleEBusinessSuite ........................................ 19PL/SQLfilesfortheMaximoEnterpriseAdapter................................................... 20Creatingtheintegrationschema................................................................. 21CreatingtheMaximointerfacetablesintheOracleEBusinessSuitedatabase.......................... 22Configuringinstallationenvironmentvariables.................................................... 23RunningtheinstallationscriptonOracle ......................................................... 24Verifyingandfixinginstallationerrors ........................................................... 25MAXORACTLSintegrationcontrolandtheOracleEBusinessSuitedatabase ......................... 26

Chapter3:Configuringintegrationcontrolsandsynchronizingdata ................................... 31Activatingthecrontaskforinterfacetablepolling ................................................. 32Enablingtheexternalsystem .................................................................... 33SettingupOraclespecificintegrationcontrolvaluesinMaximoAssetManagement .................... 34

Generatingtheshowcats.outoutputfile ....................................................... 34Generatingtheshowmult.outoutputfile ...................................................... 34

SynchronizingOracleandMaximoAssetManagementGLcomponents .............................. 36SynchronizingOracleandMaximoAssetManagementChartofAccounts ............................ 38SynchronizingOracleEmployeesandMaximoAssetManagementLaborCodes ....................... 40SynchronizingOracleOrganizationsandLocationsandMaximoAssetManagementAddressCodes ..... 41

ListingOracleApplicationsEBusinessSuiteOrganizationsandLocationCodes ................... 41MappingOracleOrganizationsandLocationstoMaximoAssetManagementSystemAddressCodes . 41

SynchronizingOracleandMaximoAssetManagementCurrencies ................................... 43ListingOracleApplicationsEBusinessSuiteCurrencyCodes.................................... 43DefiningOracleCurrencyCodesinMaximoAssetManagement ................................. 43

SynchronizingOracleVendorsandMaximoAssetManagementCompanies .......................... 44UpdatingtheMaximoAssetManagementCompanyIDwithanRBNIandSuspenseAccount ....... 45

SynchronizingOracleInventoryOrganizationsandMaximoAssetManagementStoreroomLocations .... 46ListingOracleApplicationsEBusinessSuiteOrganizations ..................................... 46

Copyright IBM Corp. 2015

Contents

DefiningStoreroomsinMaximoAssetManagement ............................................ 46SynchronizingOracleOrderUnitsandMaximoAssetManagementUnitsofMeasure.................. 48

ListingOracleApplicationsEBusinessSuiteOrderUnits ....................................... 48DefiningUnitsofMeasureandConversionFactorsinMaximoAssetManagement ................. 48

AddingTaxCodestoMaximoAssetManagement................................................. 50ListingOracleApplicationsEBusinessSuiteTaxCodes......................................... 50DefiningOracleTaxCodesinMaximoAssetManagement ...................................... 50

SynchronizingOracleandMaximoAssetManagementItems........................................ 52SynchronizingOracleandMaximoAssetManagementItemBalances ................................ 54

TransferringOracleItemBalancestoMaximoAssetManagement................................ 54VerifyingItemBalancesinMaximoAssetManagement......................................... 54

Chapter4:MAXORASchemaTable ................................................................ 57Schemaobjectsforconcurrentjobsarchitecture .................................................... 57Schemaobjectsfordatabasetriggerarchitecture ................................................... 59Schemaobjectscommontobotharchitectures ..................................................... 60

Chapter5:Predefinedcomponentsfortheconcurrentjobsarchitecture ................................. 71

Chapter6:OracleApplicationsEBusinessSuiteConfiguration........................................ 75Creatingashiptolocation...................................................................... 76SettingupageneralledgertoimportjournalsfromMaximoAssetManagement ....................... 77SettingupaccountspayabletoimportinvoicesfromMaximoAssetManagement ...................... 79SendingpurchaseorderupdatesfromMaximoAssetManagementtoOracleApplications.............. 80Schedulingconcurrentjobstorun ............................................................... 81

Chapter7:OracleProjectAccountingConfigurations ................................................. 83ConfigurationPrerequisites ..................................................................... 84ConfigurationActivities ........................................................................ 85

UpdateDatabaseColumnLengths ........................................................... 86EnableNewPublishChannels,EnterpriseServices,andtheIntegrationEventListener .............. 87ConfigureProjectsspecificMaximoAssetManagementIntegrationControls ...................... 88AddFieldstoUserInterfaces ................................................................ 89

AddingFieldstotheWorkOrderTrackingApplication ..................................... 90AddingFieldstoPurchaseRequisitionApplication......................................... 96AddingFieldstothePurchaseOrderApplication........................................... 97AddingFieldstotheInvoiceApplication.................................................. 98AddingFieldstotheReceiptsApplication................................................. 99AddingFieldstotheIssuesandTransfersApplication ..................................... 102AddingFieldstotheCostManagementApplication ....................................... 104

PredefinedcontentforOracleProjectAccounting ............................................. 107SynchronizeOracleEmployeesandMaximoAssetManagementLaborCodes .................... 108

Notices......................................................................................... 113

Copyright IBM Corp. 2015

Configuring the adapter in Maximo Asset Management 1

YoumustconfiguretheadapterinMaximoAssetManagementtosendtransactionaldatabetweenMaximoAssetManagementandOracleEBusinessSuite.Afteryoucompletetheadapterconfiguration,MaximoAssetManagementcantransformdatafromitsformattoaformatthatiscompatiblewithOracleEBusinessSuiteandviceversa.

Adding support for flat structures

Ifyouusetheobjectstructureininterfacetablesorflatfiles,youmustenablethesupportforflatstructureinMaximoAssetManagement.Afteryoudoso,theobjectsarecheckedforduplicatecolumnnamesintheobjectstructure.Duplicatecolumnnamesproduceerrors.

Procedure

1 InMaximoAssetManagement,selectIntegration>ObjectStructures.

2 SelecttheSupportFlatStructurecheckboxforthefollowingobjectstructures:

MXCOA MXCRAFT MXGLCOMP MXGLTXN MXINVBAL MXINVENTORY MXINVISSUE MXINVOICE MXINVRES MXITEM MXLABOR MXPC MXPO MXPR MXPROJ MXRCVROTITM MXRECEIPT MXVENDOR

3 ClickSave.

4 Ifduplicatecolumnnamesexist,changethealiasnamebychoosingAdd/ModifyAliasfromtheSelectActionmenu.

1

Specifying and enabling the endpoint for the adapter

InMaximoAssetMana