Professional Documents
Culture Documents
Page 2 of 40
5.8.1 Configure Details.....................................................................................................................................21
5.8.2 Configure Mappings................................................................................................................................22
5.9 Configure Locations.................................................................................................................26
5.10 Configure Data Load Rules.....................................................................................................27
5.10.1 Configuring Data Load Rules for ERP Sources......................................................................................27
5.10.2 Configuring Data Load Rules for File-Based Data Loads......................................................................29
5.11 Configure Data Load Mapping................................................................................................30
5.11.1 Rules Assigning ARM Profile IDs.........................................................................................................31
5.11.2 Rules Assigning ARM Balance Source Types.........................................................................................33
5.11.3 Import Data Load Mappings...................................................................................................................34
7. Appendix 2: Troubleshooting............................................................................................................42
7.1 ODI Studio Error Message.......................................................................................................42
8. Index....................................................................................................................................................43
Page 3 of 40
1. Overview
Integration of account balances is core to the effective functioning of an account reconciliation solution. FCMs
Account Reconciliation Manager (ARM) uses Oracle Hyperion Financial Data Quality Management ERP
Integration Adapter for Oracle Applications (ERPi) to load balances from source systems and map the balances
to reconciliations.
ERPi supports two naming conventions for data load files: Static File Name, or Static File Name plus a Period
Suffix. The convention used is based on the Data Load Rule configured for the file.
ARM supports reconciliation of balances in up to 3 currency buckets. The names of buckets are configurable
within ARM, but are generally classified like the following:
Entered: The currency in which the transaction occurred
Functional: The currency of the entity that owns the ledger
Reporting: An enterprise-wide reporting currency (typically the consolidation currency)
If the reconciliation process requires reconciliation of balances in more than one currency bucket, then balances
must be imported for each bucket and a separate file is required for each set of balances. In this case, the static file
name should include the currency bucket name to enable proper configuration of the import files.
Staging (managed by ERPi) The staging phase extracts balances from the source system, assigns an
ARM Profile ID and balance Source Type (source system or sub-system), and stores the balances in the
ERPi staging table (TDataseg) by Location and Period. Within the staging table, there is a one-to-one
relationship to balances in the source system (no summarization has occurred). The staging table
maintains only the latest data load for each Location/Period combination. When balances are imported
multiple times for the same Location/Period (for example, when importing multiple sets of preliminary
balances for a period), only the latest data load is maintained, ensuring data volumes are managed
appropriately.
Load (managed by ARM) The load phase summarizes the balances by Period, Location, Profile ID,
balance Source Type, currency bucket, and currency code and loads the balances into ARM. These
balances are permanently stored in ARM but are subject to updating if changed balances are imported in
the future.
Post-Processing (managed by ARM) the post-processing phase performs the following actions:
o Changes the status of reconciliations Open with Reviewer or Closed to Open with Preparer
if the reconciliation balances changed
o Runs the auto reconciliation routines
o Flags reconciliations containing normal balance violations (cases where the balance is expected to
be a debit and a credit balance exists, or vice versa)
While configuration of data loads has to occur within ERPi, its important to note that data loads should be
initiated from within ARM. Although ERPi enables data loads to be initiated from within ERPi, doing so will
limit execution to the first phase (Staging). The Load and Post-Processing phases will not occur. To execute a
complete data load (encompassing all three phases), data loads must be initiated within ARM by an Administrator
from the Manage Periods dialog.
Location is the level at which a data load is executed in ARM. A Location is associated with one source system,
but can import data from multiple ledgers from that system. Each Location is assigned an Import Format, one or
more Data Load Rules, and a Data Load Mapping.
The Import Format determines which fields (columns) are extracted from the source system and how the data is
stored in the ERPi staging table.
The Data Load Rules determine which records (rows) are extracted from the source system, including which
balance types are selected (Entered/Functional), whether zero balances are included, and whether currency rates
are imported along with the balances (for ERP sources only).
The Data Load Mapping determines which ARM Profile ID and balance Source Type is assigned to each
balance imported. Source Type refers to the classification of a balance as either a source system balance or a
subsystem balance.
Oracle EBS Accounts Payable Subledger Open Interface or File-Based Data Load
Oracle EBS Accounts Receivable Subledger Open Interface or File-Based Data Load
If balances are imported from multiple ledgers within a single source system and the ledgers contain different
charts of accounts or period configurations, then a separate Location is required for each configuration.
Balances within a single Location can only be assigned to a single Profile ID in ARM. Therefore, if the same
source system accounts need to be reconciled as part of two different reconciliation processes (for example, as
part of the Balance Sheet Reconciliation Process and the Consolidation System Reconciliation Process), then a
separate Location must exist for each Process (because in this case, two Profile IDs will exist in ARM: one for
each process).
When performing multiple reconciliation processes for the same source system balances, we recommend naming
the Locations with a combination of the source system name and the process name. For example:
BSProcess_EBS_GL (Oracle EBS general ledger balances for the Balance Sheet Reconciliation Process)
BSProcess_EBS_AP (Oracle EBS Accounts Payable subledger balances for the Balance Sheet
Reconciliation Process)
ConsolProcess_ EBS_GL (Oracle EBS general ledger balances for the Consolidation System
Reconciliation Process)
4.1.2 Same Source System Account reconciled in 2 different Profiles in a Single Process
On rare occasions, the same source system account may be included in two different reconciliations as part of the
same reconciliation process in ARM. Within a single Location in ERPi, a source system balance can only be
assigned to a single Profile ID in ARM. Therefore, to accommodate a second assignment, a second Location must
be created for the same source system. Only those accounts subject to a second Profile ID assignment are mapped
in this Location. The rest of the accounts are ignored.
Option Value
ODI Agent URL The host and port should be the same as was configured during ODI installation. For
example: http://10.149.101.173:20910/oracleodiagent
ODI User Name SUPERVISOR
ODI Password SUNOPSIS
ODI Execution WORKREP
Repository
ODI Master Repository WORKREP
Driver
ODI Master Repository Must match the Master Repository schema created during ODI installation
URL
ODI Master Repository Must match the Master Repository schema created during ODI installation
User
ODI Master Repository Must match the Master Repository schema created during ODI installation
Password
Application Root This is the folder into which import files will be placed when data is imported from
Directory file-based sources. This folder must be located on the ODI server, and sharing should
be configured so that it is accessible by the server upon which ERPi is installed and
from computers responsible for placing files into the folder. The
Open_Interface_Adapter.xml file should also be placed into this folder. This xml file
can be obtained from:
<EPM_ORACLE_HOME>\products\FinancialDataQuality\odi\11.1.2.2.00\adapters
folder
File Archive Directory This is the folder into which import files are archived. The folder must be created
under the Application Root Directory.
3. Click the Target Application link located within the Setup section on the Tasks navigator.
5. Select Account Reconciliation Manager from the Select Application dialog and click the OK button.
Configuration of the Target Application Dimension Details enables users to specify how columns in the staging
table will be used for storing values from source systems. Only those source system values configured as
Dimensions will exist in the staging table.
The staging table contains a fixed definition, including a series of standard fields of pre-determined use by ERPi,
and a series of 20 user defined fields (UD1-UD20) that can be used by Target Applications for application-specific
purposes. In ARMs case, UD1 is reserved for storing the balance Source Type (the setting that classifies balances
in ARM as either source system or subsystem balances). UD2-UD20 can be used to store other information
required to be imported from the source systems.
3. Assign a Dimension Name and select from the list of User Defined columns in the staging table to store
the value in
Global Mapping is where ERPi periods are created and where default mappings are established between:
ERPi and Target Applications like ARM
ERPi and source systems
If ERPi is used for importing balances to other EPM applications, then values may be present on the Global
Mapping tab that are tailored to a different application. This is OK. ARM uses the values on the Application
Mapping tab (not the Global Mapping tab). However, Application Mappings can only be created for periods
existing on the Global Mappings tab. Hence, both are required.
Begin by ensuring that the list of periods required by ARM exists on the Global Mapping tab. To add periods:
1. Click on the Global Mapping tab.
2. Click the Add icon to add a row to the Global Mapping table.
3. For each period added, provide the following values:
a. Period Key: Period Key is the unique identifier for the period and must be a date value. Period
End Date would be a good value to use as the Period Key.
b. Prior Period Key: The Period Key associated with the preceding period. The Period Key does
not have to exist in ERPi in order to be used in the Prior Period Key column.
c. Period Name: Period Name is a secondary identifier for the period. The value must also be
unique, but may include alpha-numeric characters.
d. Target Period Month: Provide the name of the period exactly as it exists in ARM.
a. Year Target: Year is a required value, but it does not affect processing for ARM. Provide the year
associated with the corresponding ARM period.
b. Click the Save button to save the mapping. Repeat steps 2 & 3 until all periods have been added.
Note that the Target Period Quarter, Target Period year, and Target Period Day columns should be left blank. A
sample Global Mapping is provided below:
Source Mappings define the relationship between ERPi periods and source system periods. Select the Explicit
option if mappings must be configured at the GL Calendar level to support ledgers that use different period
calendars.
For additional instructions on configuring Source Mappings, refer to the ERPi Administrator guide, as procedures
are specific to each source system.
If ARM has been configured as a single currency environment, then create a single Category on both the Global
Mapping and Application Mapping tabs with the following values:
When configuring the Application Mapping values, select Account Reconciliation Manager as the Target
Application.
If ARM has been configured as a multi-currency environment, then for each enabled currency bucket in ARM,
add a corresponding Category in ERPi on both the Global Mapping and Application Mapping tabs. When
configuring the Application Mapping values, select Account Reconciliation Manager as the Target Application.
Note that the Target Category value must exactly match the bucket name in ARM.
9. Refer to the ERPi Administrator Guide for instructions on configuring each type of source system, as
instructions are type-specific. If detailed logging is desired, set the Log Level to 5.
11. On the Import dialog, select Open_Interface_Adapter.xml and click the OK button.
2. Select the Source System Type from the list of types provided.
13. Select the associated Source System from the list provided, which are derived from Source System
configuration.
1. On the Entities tab, place a checkmark next to the ledgers (EBS/Fusion) or Business Units (PeopleSoft)
from which balances should be imported.
Within the same source system, if multiple accounting entities (ledgers/business units) exist that contain the same
chart of accounts and have balances that will be assigned the same currency bucket, then an Entity Group can be
created for these entities. When configuring Data Load Rules, a single Rule can be created for the Entity Group,
rather than having to create separate rules for each entity.
Consider an example of an EBS general ledger that contains the following individual ledgers (all of which utilize
the same chart of accounts):
Ledger A Contains entered and functional currency balances for all transactions associated with
Entity A.
Ledger B Contains entered and functional currency balances for all transactions associated with
Entity B.
Ledger C Contains entered and functional currency balances for all transactions associated with
Entity C.
In this case, an Entity Group could be created for Ledger A, B, & C, since they share the same chart of accounts
and currency bucket configuration.
To configure Entity Groups:
1. Click the Entity Groups tab.
2. Click the Add button.
4. In the Entity Group Entities table, place a checkmark next to each Accounting Entity that should be
included in the Entity Group.
5. Press the Save button.
1. Provide a Name for the Import Format. In general, it is good practice to include the Source Name and
information about the ledger configuration in the Name of the Import Format. This will make it easier to
select the proper Import Format when configuring the Location.
2. Select the Source System
3. Select a representative Accounting Entity (a ledger that contains the correct chart of accounts
configuration). Note that the Import Format can be used to load balances from any Accounting Entity or
Entity Group that shares the same chart of accounts. The actual selection of the chart of accounts to use
occurs within the Data Load Rule configuration.
4. Select the Account Reconciliation Manager as the Target Application.
5. Click the Save button.
The Mappings section determines how data from the source system is stored in the ERPi staging table. The
procedures vary based on the type of source system for which the Import Format is being configured.
3. Map the column in the file containing the Currency Code to the Currency Target.
The following image demonstrates how the sample file, once configured, would appear in ERPi.
The first 5 rows in the file should be skipped, since it contains heading information. In addition, the rows
containing the column headers and the heading underlines should also be skipped. Since these rows repeat on
each page, theyll need to be skipped every time they appear. The following image demonstrates how ERPi was
configured to ignore these rows.
2. Select a Location by clicking the Search Location icon. After selecting a Location, the Target should
display Account Reconciliation Manager. Period and Category may contain values; these can be
ignored. These are default values that are ignored by ARM when data loads are run.
3. Click the Add button in the Data Rule Summary section to add a Data Load Rule.
If the Location references an ERP source system, perform the following procedures:
1. In the Details section:
a. Name: Provide a Name for the Data Load Rule. In general, it is good practice to include in the
Data Load Rule name descriptive information about the source system from which balances are
obtained and the currency bucket to be assigned to the balances.
b. Category: Select the currency bucket to be assigned to the balances from the Category selection.
c. Include Adjustment Periods: If Adjustment periods should be included, select Yes. Otherwise,
select No.
i. If the ledgers associated with this Data Load Rule are the primary (not translated)
ledgers, then Entered and Functional currency types are typically mapped to the Entered
and Functional currency buckets within ARM:
1. Select Entered if Category = Entered (or its equivalent in ARM)
2. Select Functional if Category = Functional (or its equivalent in ARM)
ii. If the ledgers associated with this Data Load Rule are translated ledgers, then the Entered
currency type is not mapped since it was already mapped from the primary ledger. The
Functional currency bucket (containing the translated balances) is mapped to the
Reporting currency bucket in ARM:
1. Select Functional if Category = Reporting (or its equivalent in ARM)
e. Ledger Group: Select the appropriate Ledger Group.
f. Ledger: Select the appropriate Ledger.
g. Exchange Rate Options: Select the same currency rate that is used to revalue period-end balances
in the source system.
h. Click the Save button.
M Month M7
MM 07
MMM Jul
MMMM July
d Day d1
dd 01
MMM Jul
y Year yy 12
yyyy 2012
For ARM, mapping rules to assign ARM Profile IDs are expected to be configured using the Multi-Dimension
method, which enables Profile IDs to be assigned to source system accounts based on values contained in one or
more source account segments.
To manually create mapping rules to assign ARM Profile IDs, perform the following procedures (refer to the
Import Data Load Mappings for instructions on importing mapping rules):
1. Select Profile from the Dimension selection. This means that the mapping rules specified will be used
for assigning an ARM Profile ID.
3. Target Value: Enter the ARM Profile ID, or click the browse icon to select from the list of Profile IDs.
4. Rule Name: We recommend using the ARM Profile ID as the rule name, too.
5. Click the Add button to add criteria for determining which source system accounts are assigned this
Profile ID. For example, if assigning Profile ID 100-1510 to all accounts where Company Code = 100 and
Account = 1510, then two rows should be added to the Multi-Dimension table:
a. The first row contains a condition on the source system Company segment:
i. Dimension: Company
ii. Condition: Explicit (the source segment value must exactly match the value specified in
the Value field in order for the Profile ID to be assigned)
iii. Value: 100
b. The second row contains a condition on the source system Account segment:
i. Dimension: Account
ii. Condition: Explicit
iii. Value: 1510
The segments that appear in the Dimension selection are those that were configured as LOOKUP
Dimensions. When multiple criteria are specified by adding multiple rows to the Multi-Dimension table,
all specified criteria must be met in order for the Profile ID to be assigned (the criteria are joined together
with an implicit AND conjunction).
Balance Source Types enable ARM to classify a balance as either a source system balance or a subsystem balance.
Consider the following examples:
A reconciliation is performed as part of the Balance Sheet reconciliation process in ARM, comparing a
general ledger balance to the corresponding AP Subledger balance. The objective of the reconciliation is
to verify that the general ledger balance is correct. In this case, the general ledger balance should be
assigned a Source Type of source system, and the AP subledger balance should be assigned a Source
Type of sub-system.
A reconciliation is performed as part of the Consolidation System reconciliation process in ARM,
comparing balances in HFM to the general ledger balances. The objective of the reconciliation is to verify
that the HFM balance is correct. In this case, the HFM balance should be assigned a Source Type of
source system, and the general ledger balances should be assigned a Source Type of sub-system.
The key point to remember is that Source Type source system should be assigned to the balance to be
reconciled, whereas the Source Type sub-system should be assigned to balances used for comparison purposes.
Mapping rules to assign balance Source Types are expected to be configured using the Like method, which
enables Source Types to be assigned to source system accounts based on a single wildcard criteria.
To configure mapping rules to assign Source Types, perform the following procedures:
1. Select Source Type from the Dimension selection. This means that the mapping rules specified will be
used for assigning an ARM balance Source Type.
4. Source Value: Enter * to select all source values, since all source values will be assigned the same
Target Value.
5. Target Value: Click the browse icon and select the appropriate value (source system or sub-system) from
the list provided.
6. Rule Name: We recommend using the Target Value as the Rule Name, for simplicity.
Note that an IGNORE mapping rule is not required for the Source Type dimension. The IGNORE rule configured
for the Profile dimension will cause the same accounts to be ignored for the Source Type dimension.
Customers using ERPi to import balances to ARM will have at least one mapping rule for every reconciliation
performed in ARM. For many companies, thousands of mapping rules will exist. Therefore, importation of
mapping rules is a feature expected to be used widely, as it offers a far more efficient method for configuring
mapping rules than entering each rule manually. We recommend turning off the validate option when importing
large numbers of mappings. Invalid mappings will be detected during data import, and can be corrected at that
time.
Company UD2
Account UD3
Note the file does not contain a header row. Column A contains the mapping criteria, column B contains the
Target Account, column C contains the rule name, and column D contains a description of the rule (description is
optional, so this column may be blank).
The mapping criteria column is prefixed with #MULTIDIM, which identifies to ERPi that Multi-Dimension
mapping is being used. Following this prefix, the mapping criteria column contains a concatenation of all of the
criteria required to assign a Profile ID to a source system account. Row 1, for example, will assign Profile ID 100-
1500 to any source system account where Company (UD2) equals 100 and Account (UD3) equals 1510.
Since mapping rules are generally related to ARM profile segment values, once the structure of the mapping file is
understood, the concatenate function in spreadsheet programs should provide a handy mechanism for creating
import files based on ARM Profile Segment values.
To use the concatenate function, split the text from Column A into the following component columns, leaving
empty columns for the segment values:
Then, copy the ARM Profile Segment values into the empty columns:
Add a concatenate function to column F that concatenates the values from columns A-E:
Copy the formulas in columns F, G, & H to each row to be imported. Then, when you are ready to finalize the
import file, copy the columns F-H, and paste special to paste the values. Then delete columns A-E, and your
import file should be ready:
4. Select the Dimension for which mapping rules are being created (either Profile or Source Type), click the
Export button, and choose the Current Dimension option.
5. In the Specify file location dialog, provide a file name, and click the Ok button. Once the import is
complete, click on the name of the file in the file list and choose to save the file to your computer. Once
saved, you can edit the file.