Aip 1312 Impg
Aip 1312 Impg
Aip 1312 Impg
Implementation Guide
Release 13.1.2
March 2010
Oracle® Advanced Inventory Planning Implementation Guide, Release 13.1.2
iii
Contents
Send Us Your Comments................................................................................................ xi
Preface ............................................................................................................................ xiii
Audience .............................................................................................................................. xiii
Related Documents............................................................................................................. xiii
Customer Support............................................................................................................... xiv
Review Patch Documentation ........................................................................................... xiv
Oracle Retail Documentation on the Oracle Technology Network.............................. xiv
Conventions......................................................................................................................... xiv
1 Overview ......................................................................................................................... 1
2 Pre-Implementation Considerations ............................................................................ 3
Overview..................................................................................................................................3
3 Building a Production AIP RPAS Domain ................................................................... 7
Introduction .............................................................................................................................7
Hierarchy Data Overview...............................................................................................8
Production AIP RPAS Domain Build Overview .........................................................9
Manipulate the Hierarchy Data, Part One..................................................................10
Run the AIP RPAS Installer..........................................................................................11
Configuring the AIP Solution ......................................................................................12
Insert External System Data into the AIP RPAS Domain.........................................13
Generate Load-Ready AIP Hierarchy Data................................................................14
Create the AIP RPAS Global Domain Configuration XML File ..............................15
Manipulate the Hierarchy Data, Part Two .................................................................16
Build the AIP RPAS Global Domain ...........................................................................17
AIP RPAS Domain Build Completion Summary ......................................................18
Move the RPAS Domain (Optional) ............................................................................19
Configure the RPAS Client to Use the Domain .........................................................19
Post Installation Instructions ...............................................................................................20
4 System Configuration.................................................................................................. 21
Setting Environment Variables ...........................................................................................21
Configuring AIP RPAS Environment Variables........................................................21
Configuring AIP Online Environment Variables ......................................................24
Using the Scheduler to Run AIP Batch Processes.............................................................27
Pre-Critical Path Tasks ..................................................................................................28
Critical Path Tasks .........................................................................................................31
Post Critical Path Tasks.................................................................................................33
Interval Batch Tasks.......................................................................................................35
v
5 AIP Online Configurations .......................................................................................... 39
AIP Online UNIX Environment ..........................................................................................39
config.xml .......................................................................................................................39
Integration Directories ..................................................................................................40
Shared Files.....................................................................................................................40
Importing Configuration Files .....................................................................................41
Export Configuration Files ..................................................................................................42
Oracle Database.....................................................................................................................42
SYSTEM_PARAMETERS..............................................................................................43
RESTART_CONTROL ..................................................................................................48
ORDER_NUMBER.........................................................................................................48
ORDER_PURGE_PERIOD............................................................................................48
ORDER_DEFINITION ..................................................................................................48
ORDER CYCLES ............................................................................................................49
DATA_PURGE_PARAMETERS..................................................................................52
WH_TYPE_INITIAL_PACK_TYPE.............................................................................54
SUPPLIER .......................................................................................................................54
STOCKING_POINT.......................................................................................................54
SHIP_TO_WH_TYPE_SOURCE ..................................................................................54
SHIP_TO_WH_TYPE_DEST ........................................................................................54
ALERT_DEFINITION ...................................................................................................55
ALERT_DEFINITION_DESC.......................................................................................55
ALERT_STATUS_DESC................................................................................................55
AIP Application Server ........................................................................................................56
db.properties ..................................................................................................................56
main.properties ..............................................................................................................57
rcapps.properties ...........................................................................................................59
security.properties .........................................................................................................60
strings_en.properties .....................................................................................................60
Config.properties ..................................................................................................................61
6 AIP RPAS Configurations ........................................................................................... 67
shortfallPriorityMatrix.xml..................................................................................................67
surplusStorePriorityMatrix.xml ..........................................................................................68
Measures ................................................................................................................................70
Modifying Measure Base Intersections Using Configuration Tools ..............................76
Import Configuration Files ..................................................................................................76
Moving Integration Data Source from RMS to a Non-RMS External System .......85
7 AIP Calendar Hierarchy ............................................................................................... 89
AIP Calendar Data – clnd.dat or clnd.csv.dat...................................................................89
Notes on manual construction .....................................................................................90
vi
8 Integration..................................................................................................................... 91
Overview of the Integrated Inventory Planning Suite.....................................................91
Integrated Inventory Planning Suite Data Flow........................................................91
Data Flow Description ..................................................................................................92
9 RMS Integration and Data Mapping ........................................................................... 95
RMS to AIP Data ...................................................................................................................95
Hierarchy Data ...............................................................................................................95
Measure Data..................................................................................................................99
File Formats ..................................................................................................................101
File Format Including Mapping to AIP RPAS Measure Format ...........................107
RMS RETL Extract and RMS-AIP Transformation Overview ......................................112
10 RDF Integration ........................................................................................................ 115
RDF to AIP Data..................................................................................................................115
Measure Data................................................................................................................115
iprdfdtdaltv.txt ....................................................................................................................116
sr0_rdfdtdmsk.txt................................................................................................................117
sr0_rdfdtdcnt.txt..................................................................................................................118
sr0_fcterrlvl1.txt ..................................................................................................................119
sr0_fcterrlvl2.txt ..................................................................................................................121
sr0_frclvl1_[1..n].txt ............................................................................................................122
sr0_frclvl2.txt .......................................................................................................................123
11 External System Integration ................................................................................... 125
External System to AIP Data .............................................................................................125
Hierarchy Data .............................................................................................................125
Measure Data................................................................................................................125
had.txt...................................................................................................................................127
intv.txt...................................................................................................................................128
default_wh.txt......................................................................................................................129
direct_store_format_pack_size.txt ....................................................................................131
direct_store_pack_size.txt..................................................................................................132
dm0_ofseffdt_.txt ................................................................................................................134
dm0_onseffdt_.txt ...............................................................................................................135
dmx_pcktyp.txt ...................................................................................................................136
dmx_pprsts.txt.....................................................................................................................138
dmx_shpto_.txt....................................................................................................................139
ipadrltntsi.txt .......................................................................................................................140
ipadendi.txt..........................................................................................................................141
ipadstai.txt............................................................................................................................143
ipavgrtslsi.txt .......................................................................................................................144
ipcmtmtde.txt ......................................................................................................................145
ipfctwkprfd.txt ....................................................................................................................146
ipfctwkprfe.txt .....................................................................................................................148
vii
iphldbckqtyi.txt ...................................................................................................................150
ipldssi.txt ..............................................................................................................................151
ipodcmti.txt..........................................................................................................................152
iprplstcdi.txt.........................................................................................................................154
iprpltcdi.txt ..........................................................................................................................155
ipslsi.txt ................................................................................................................................156
ipttlhlstki.txt.........................................................................................................................158
ipwhhldcpci.txt ...................................................................................................................159
item_attribute.txt.................................................................................................................160
item_attribute_type.txt.......................................................................................................162
rmse_order_purge.dat........................................................................................................163
sister_store.txt......................................................................................................................164
sister_wh.txt.........................................................................................................................165
sr0_ad_.txt ............................................................................................................................167
sr0_ad_go_.txt......................................................................................................................168
sr0_ad_irt.txt ........................................................................................................................170
sr0_ad_oth.txt ......................................................................................................................171
sr0_ad_rop.txt......................................................................................................................172
sr0_adjsls.txt.........................................................................................................................174
sr0_avgrosld_.txt .................................................................................................................175
sr0_co_.txt ............................................................................................................................176
sr0_dyscsls.txt......................................................................................................................177
sr0_expwrtoff.txt .................................................................................................................179
sr0_hstls_.txt ........................................................................................................................180
sr0_invadj.txt .......................................................................................................................181
sr0_knowndemand.txt........................................................................................................183
sr0_rplcde.txt .......................................................................................................................184
sr0_rplsubcde.txt.................................................................................................................185
sr0_ss_ld_.txt .......................................................................................................................186
sr0_tdgday.txt......................................................................................................................188
sr0_wkbsf_ld.txt ..................................................................................................................189
sr0_wstadj.txt.......................................................................................................................190
srx_poidst.txt .......................................................................................................................191
srx_prdrpr.txt ......................................................................................................................193
store_format_pack_size.txt ................................................................................................194
store_pack_size.txt ..............................................................................................................196
sku_cost.dat .........................................................................................................................197
SKU Cost – Online Load Process ...............................................................................199
sku_weight_volume.dat.....................................................................................................200
SKU Weight and Volume – Online Load Process ...................................................202
viii
12 RO Integration .......................................................................................................... 203
Store Measure Data.............................................................................................................203
STR_MINMAX .............................................................................................................203
STR_DYNAMIC...........................................................................................................205
STR_TIMESUPPLY ......................................................................................................207
STR_HYBRID................................................................................................................209
STR_POISSON..............................................................................................................211
STR_MINSS ..................................................................................................................212
STR_ROUpdate ............................................................................................................214
Warehouse Data Interfaces ................................................................................................215
WH_MINMAX .............................................................................................................216
WH_DYNAMIC...........................................................................................................218
WH_TIMESUPPLY......................................................................................................220
WH_HYBRID ...............................................................................................................222
WH_MINSS ..................................................................................................................224
WH_ROUpdate ............................................................................................................225
13 AIP to RMS Interfaces and Data Mapping ............................................................. 227
RIB Publications ..................................................................................................................227
AIP Message Flow ..............................................................................................................227
Purchase Order Messages..................................................................................................228
XORDERCRE................................................................................................................228
XORDERDTLCRE........................................................................................................228
XORDERMOD..............................................................................................................228
XORDERDTLMOD......................................................................................................228
Transfer Messages...............................................................................................................229
XTSFCRE.......................................................................................................................229
AIP to RMS Data .................................................................................................................229
Messages Layout..........................................................................................................230
Purchase Orders and Transfers Message Flow in AIP ...........................................232
Store – Purchase Orders and Transfers Message Flow...........................................233
Warehouse – Purchase Orders and Transfers Message Flow .......................................235
Data Formats for Creating Order – XORDERCRE ..................................................237
Create Order Layout – XORDERDTLCRE ...............................................................242
Modify Order Header Layout – XORDERMOD .....................................................244
Modify Order Layout – XORDERDTLMOD............................................................248
Create Transfer Layout – XTSFCRE ..........................................................................250
AIP Purchase Order Messages – RMS Load Process ..............................................254
AIP Transfer Messages – RMS Load Process ...........................................................256
XORDER Header – RMS ORDHEAD Mapping ......................................................257
XORDER Detail – ORDSKU & ORDLOC Mapping................................................263
XTSF Header – RMS TSFHEAD Mapping ...............................................................267
XTSF DTL – RMS TSFDETAIL Mapping..................................................................270
ix
14 AIP to External System Interfaces.......................................................................... 273
Overview..............................................................................................................................273
purchase_order.dat.1 ..........................................................................................................273
transfer_order.dat.1 ............................................................................................................275
15 AIP to RO Interfaces ................................................................................................ 279
STR_AIP_DATA..................................................................................................................279
WH_AIP_DATA .................................................................................................................281
16 First Day of AIP ........................................................................................................ 283
Introduction .........................................................................................................................283
Overview..............................................................................................................................283
The First Day of AIP Explained ........................................................................................283
Load Data......................................................................................................................284
Enable Automated Data Maintenance ......................................................................285
The First Day of AIP Execution.........................................................................................287
Step 1: Virtual Date (Vdate)...............................................................................................288
Step Details ...................................................................................................................288
Step Execution ..............................................................................................................288
Step 2: Build the SRP Implementation Parameters Workbook.....................................289
Step Details ...................................................................................................................289
Step Execution ..............................................................................................................289
Step 3: First Day of AIP on RPAS Batch...........................................................................289
Step Details ...................................................................................................................289
Step Execution ..............................................................................................................290
Step 4: First Day of AIP on Oracle Import .......................................................................291
Step Details ...................................................................................................................291
Step Execution ..............................................................................................................292
Step 5: First Day of AIP on Oracle Manual Setup...........................................................292
Step Details ...................................................................................................................292
Step Execution ..............................................................................................................293
Step 6: First Day of AIP on Oracle Automation..............................................................293
Step Details ...................................................................................................................293
Step Execution ..............................................................................................................293
Step 7: First Day of AIP on Oracle Import of Non-critical Alerts.................................293
Step Details ...................................................................................................................293
Step Execution ..............................................................................................................293
Step 8: Manual Setup of AIP..............................................................................................294
Step Details ...................................................................................................................294
Step Execution ..............................................................................................................294
x
Send Us Your Comments
Oracle Retail Advanced Inventory Planning, Implementation Guide, Release 13.1.2
Oracle welcomes customers' comments and suggestions on the quality and usefulness of
this document.
Your feedback is important, and helps us to best meet your needs as a user of our
products. For example:
Are the implementation steps correct and complete?
Did you understand the context of the procedures?
Did you find any errors in the information?
Does the structure of the information help you with your tasks?
Do you need different information or graphics? If so, where, and in what format?
Are the examples correct? Do you need more examples?
If you find any errors or have any other suggestions for improvement, then please tell us
your name, the name of the company who has licensed our products, the title and part
number of the documentation and the chapter, section, and page number (if available).
xi
Preface
The Oracle Retail Advanced Inventory Planning Implementation Guide describes post-
installation tasks that need to be performed in order to bring Advance Inventory
Planning online and ready for production use.
The Implementation Guide includes some or all of the following sections, depending
upon the release:
System configuration settings for the UNIX and AIP environments
Interfaces and data mappings between AIP and other systems
Audience
The Implementation Guide is intended for the AIP integrators and implementation staff,
as well as the retailer’s IT personnel.
The reader should have an in-depth understand the following concepts and applications
in order to perform the processes describes in this document:
UNIX system administration, shell scripts, and job scheduling
Oracle Retail Integration Bus (RIB)
Oracle Retail Predictive Application Server (RPAS)
Oracle Retail Demand Forecasting (RDF)
Oracle databases
Performance constraints based on the retailer’s infrastructure
Technical architecture for AIP
Retailer’s hierarchical (SKU/Store/Day) data
AIP batch processes
Related Documents
For more information, see the following documents in the Oracle Retail Advanced
Inventory Planning Release 13.1.2 documentation set:
Oracle Retail Advanced Inventory Planning Release Notes
Oracle Retail Advanced Inventory Planning Installation Guide
Oracle Retail Advanced Inventory Planning Data Management Online Online Help
Oracle Retail Advanced Inventory Planning Data Management Online User Guide
Oracle Retail Advanced Inventory Planning Order Management Online Help
Oracle Retail Advanced Inventory Planning Store Replenishment Planning User Guide
Oracle Retail Advanced Inventory Planning Warehouse Replenishment Planning User Guide
Oracle Retail Advanced Inventory Planning Operations Guide and Administration Guide
Oracle Retail Advanced Inventory Planning Data Model Volume 1 Oracle Data Model
Oracle Retail Advanced Inventory Planning Data Model Volume 2 Measure Reference Guide
The following documentation may also be needed when implementing AIP:
Oracle Retail Integration Bus (RIB) 13.1.1 documentation, based on type of
deployment
RETL 13.1 documentation
Oracle Retail Predictive Application Server (RPAS) documentation
xiii
Customer Support
To contact Oracle Customer Support, access My Oracle Support at the following URL:
https://support.oracle.com
When contacting Customer Support, please provide the following:
Product version and program/module name
Functional and technical description of the problem (include business impact)
Detailed step-by-step instructions to re-create
Exact error message received
Screen shots of each step you take
Conventions
Navigate: This is a navigate statement. It tells you how to get to the start of the procedure
and ends with a screen shot of the starting point and the statement “the Window Name
window opens.”
This is a code sample
It is used to display examples of code
xiv
1
Overview
Once AIP has been installed, you need to configure the system environment variables,
create integration files, and configure the system according to the retailer’s specifications.
This guide provides information on
Implementing the AIP solution.
Customizing AIP for the retailer’s environment and needs.
Integrating AIP with merchandising, forecasting, and other external systems.
For information on compatibility and hardware requirements, refer to the AIP Installation
Guide.
Overview 1
2
Pre-Implementation Considerations
Overview
When preparing to implement the Advanced Inventory Planning solution, you must
closely explore the retailer’s infrastructure, hierarchy data, and other factors that may
require customizing the AIP environment through the use of configuration files and
settings, custom scripts, and the RPAS Configuration Tool. Prepare your environment
and analyze your retail and data needs thoroughly before implementing AIP.
The following list provides some of the issues that the implementation team may need to
address prior to implementation:
1. Hierarchy Setup
Identify the attributes used by the Product, Location and Time hierarchies, as
well as their sources and update frequency.
Define the dimensions within each of the Hierarchies and determine the default
spreading settings.
Define any Alternate Hierarchies and identify the relationship of the required
Attributes that drive those Alternates.
Define User Defined Hierarchies to be used by planners.
The hierarchy setup mentioned above may vary depending on the extent that the
Configuration Tool will be used by the application.
2. Measure Settings
The following measure settings need to be addressed during implementation, which
can vary depending on the extent that the Configuration Tool will be used by the
application.
Metric/Measure definitions, usage, interaction and calculations.
Default Label to use when building measure labels
Default Data Type
Default NA Value
Default Base Intersection
Default Aggregation Method
Default Spread Method
Default Base State Read / Write Status at the base level
Default Agg State Read / Write Status at aggregated levels
3. Setting Custom Wizards
Determine if any custom wizards are required that don’t exist in the base application.
The use or implementation of wizards can vary depending on the extent that the
Configuration Tool will be used by the application.
4. Workbook Templates, Worksheets, Tabs, Formats
Workbooks can be created or refreshed through batch processing. By doing the
processing in batch at night, the end users are spared from the wait time associated
with each action. The Batch Processing section should outline when each of these
operations will take place.
Pre-Implementation Considerations 3
Overview
For these default auto workbook builds, the layout, formatting, hierarchies, wizard,
tabs, and worksheets must be defined.
Configuring the timing of data loads, refreshes, and purges/deletions of workbooks
must be set.
5. Daily and Weekly Batch Processing and scheduling
Configure the system for the following defaults:
Batch Processes
Week-ending Processes
Day Ending Processes
Data Updates
Restructures – Adds, Renames, Deletes
New Year Setup-- 53 weeks
Data Aging/Purging
Administrative Processes
Backups
6. Sizing Estimates/Hardware Requirements
A sizing estimate spreadsheet and hardware requirements should be supplied to the
client. These factors are dependent on the number of domains, intersection points,
number of workbooks, purge and delete strategy, planning horizon, retention of
data, etc.
7. Security Access and Viewing
User Setup/Security
To define Workbook Template Security, the system administrator will grant
individual users, or user groups, access to specific workbook templates. Granting
access to workbook templates provides users the ability to create, modify, save,
and commit workbooks for the assigned workbook templates. Users will
typically be assigned to “groups” based on their user application (or solution)
role. Users in the same group can be given access to workbook templates that
belong to that group alone. Users can be assigned to more than one “group” and
granted workbook template access without belonging to the user group that
typically uses a specific workbook template. Workbook access is either denied,
read only, or full access. Read only access will allow a user to create a workbook
for the template, but the user will not be able to edit any values or commit the
workbook. The read only workbook can be refreshed.
When users save a workbook, they assign one of three access permissions to the
workbook:
– World – Allow any user to open and edit the workbook.
– Group – Allow only those users in their same group to open and edit the
workbooks.
– User – Allow no other users to open and edit the workbook.
Workbook Limits
Another aspect of workbook security is the ability to set limits for the number of
workbooks that a user can have saved at any given time. Limits can be set at the
following levels:
– User per template
– User Group per template
– Globally per template for all users
The limits are evaluated in the above order, which means that a limit defined at
user-template overrides any values defined at group-template or global-template
levels. If the above limits are not defined, the default value is one billion. The
limits are checked when a user begins the workbook build process. If the user’s
limit has been reached, an error message appears that informs the user that the
workbook build process cannot be completed because the user has reached their
limit. The message also informs the user what that limit is. The wizard process
then terminates.
8. Data Management Automation
Creation of certain logical constructs in Data Management may be set automatically
depending on the setting of certain parameters.
Examine the system parameter configurations and determine which pieces of
automation will be turned on. Map out each supplier’s “Ship-to” value and each
warehouse’s “Warehouse Type” that will be needed to effectively automate the
supply chain setup for those processes that are enabled.
9. Reconciliation
The reconciliation period is set to a day if the method is Reconciliation day-on-day
and is set to a review period at source if the method is Reconciliation-over-time.
Therefore, it has to be determined which reconciliation method will be selected at
SKU level.
You must set a flag to have a SKU reconciled in a constrained scenario.
10. Replenishment Methods
Define the replenishment methods to be used. Rule out replenishment methods that
are not applicable.
11. Perishables functionality
Spoilage threshold is calculated using the Acceptable Loss parameter. Acceptable
loss is a user-managed parameter in SRP, defined either at the class/store format
level or the SKU/store/day level.
Users have the ability to determine when to use expected spoilage via a ‘Store use
inventory aging flag’. Constraints on the application of inventory aging are as
follows
a. A global limit (in number of days) on or inside which an item with product life
can be considered in the expected spoilage calculation.
b. An expected write-off’s user maintained measure.
Implementation Guide 5
Overview
The first constraint is used as a high limit in number of days for a product life and is
called ‘Store Inventory Aging Limit.’ Product life as entered by a user does not have
a limit. The effectiveness of product life needs to be controlled by a User. Therefore a
global limit respective to the product life is necessary and configurable. The second
constraint refers to the fact that aging is a calculated number, not an actual number.
The user may have an actual number of spoilage that is to be used. A measure
(expected write-off’s) can be entered by the user and if entered will override any
spoilage calculation and be used as the amount to spoil on the given day.
To summarize the user input for expected spoilage:
The product life of the inventory at the point of receipt into the final selling
destination. (SKU/Str/Day)
The “Store use inventory aging flag” (SKU)
The global limit for using inventory aging (Scalar)
Expected write-off’s (amount to spoil). (SKU/Str/Day)
12. Shelf capacity
If the Shelf Capacity flag is set to “True,” then shelf capacity will be considered when
setting boundaries.
13. Substitution and value added functionality
The linked product flag is only used for user review purposes in AIP and indicates
whether there is a value added/pre-priced commodity or banded item association
with that particular SKU. If there is a value added/pre-priced association, the linked
product flag is only True between the promotional start and end dates. This flag will
be set within RMS.
Also a Substitution Flag must be set at the SKU level within Data Management,
which sets that a SKU is substitutable across Demand Group.
14. User Specified Allocations
You must set the number of days of history required for using USA Indexed.
15. Alerts
Set the days that an alert will be run.
16. Store Reconciliation Matrix configuration
The number of store priorities is configurable; therefore, the Shortage and Stockless
Surplus Priority Matrices may grow or shrink. However no screens or workbooks are
provided to view and maintain the configuration.
The priority of each boundary, for each store priority, will depend on the number of
store priorities defined. The order in which each boundary is met is configurable
however no screens or workbooks are provided to view and maintain the
configuration.
17. Network Throughput settings
The WRP Network Threshold Maintenance workbook is used to maintain network
alert parameters. The WRP Network Threshold Maintenance workbook is available
at the global and local domain levels. All measures should reflect the value in the
domain during load and refresh times, and all editable measures should be
committed to the domain unless otherwise stated.
Directory Contents
Some of the data provided in the AIP package will be of no use to the client running AIP
in a production environment because the positions are sample positions only, while other
hierarchy data contain generic positions that do not need to be customized (e.g. hseq,
intv). Therefore a domain built on this data is suitable only for proof of installation
correctness, including viewing with the RPAS Client, but not suitable for production.
Note: The client must build the domain with the BCSK
hierarchy even if they are not using this functionality. A core
dump will occur during AIP RPAS batch processes if there is
a lack of BCSK hierarchy positions in the hierarchy
maintenance database (hmaint).
Note: In previous versions of AIP the calendar hierarchy
could be generated at domain build time using RPAS
functionality. In this version of AIP, the calendar hierarchy
must be loaded as a flat file alongside the other hierarchy
files. There is no calendar generator provided with the
version of RPAS compatible with this version of AIP. See
“AIP Calendar Hierarchy” chapter of this guide for detailed
information on file format of calendar hierarchy.
In addition to the hierarchy data listed in the above table, there are two additional files
contained in the $AIP_INSTALL/input directory. These are non-optional, non-sample,
base code files containing message strings, which must co-exist with the hierarchy data.
These must be left intact and must not be replaced. During domain creation, these files
are loaded into the domain. These message string data files are described in the following
table.
Implementation Guide 9
Introduction
At this point there is no further hierarchy manipulation that can be done to replace
sample hierarchy data files with non-sample hierarchy data files, without running
part of AIP RPAS batch. Therefore the
<AIP_Installer>/aip/aip/aip_install/aip.tar.zip file must be repacked so it can be
used by the AIP RPAS Installer.
5. Repack the aip.tar.zip archive using the following commands:
tar -cf aip.tar input configuration domain_build
zip aip.tar.zip aip.tar
Implementation Guide 11
Introduction
retaillogin.ksh script must be executed prior to running the AIP RPAS batch processes
because it sets some environment variables, including AIP-specific variables set by
aiplogin.ksh, which are needed for the next steps.
At this point you should source the retaillogin.ksh script to set your environment for the
remaining steps. It will call aiplogin.ksh which was created by the AIP RPAS Installer,
which will set the $AIP_INSTALL and $TEST_AIPDOMAIN environment variables.
cd <Path to retaillogin.ksh script>
. ./retaillogin.ksh
AIP is packaged with a base configuration that all implementations must use as a starting
point for any customization. This base configuration is stored within various files and
directories which are unpacked during installation. In order to modify this configuration
the configuration files must be loaded onto a Windows workstation in order to load them
into the RPAS Configuration Tools.
Because the RPAS Configuration Tools must run on a Windows workstation, in order to
customize the configuration, the $AIP_INSTALL/configuration/AIP directory must be
accessible from or copied to a Windows PC on a local or network drive.
The AIP solution is configurable to a limited degree. The following describes what you
may and may not customize with respect to maintaining the integrity of this release:
Clients cannot change existing measures or rules, or add rules to existing rule
groups. Doing so will result in a non-supported AIP configuration, which will yield
unpredictable results during the operation of AIP.
Clients may add additional measures, rule groups and workbooks. These will not be
modified or otherwise touched during the patch installation.
Clients may customize the domain Hierarchy contained in hierarchy.xml. In order to
insert a customized hierarchy.xml into the configuration, the modified (using the
RPAS Configuration Tools) hierarchy.xml must be copied to
$AIP_INSTALL/configuration/AIP/hierarchy.xml. This is where the domain build
will be looking for the hierarchy.
The AIP RPAS domain must be partitioned along the product hierarchy at the
subclass (scls) dimension. This is not configurable.
Basic instructions for running the RPAS Configuration Tools are as follows:
1. Double-click the ConfigTools.exe file in your RPAS Configuration Tools installation
directory to launch the RPAS Configuration Tools.
The AIP solution consists of one domain structure, named “AIP”.
2. From the File menu, select Open and navigate to the configuration directory on your
local or network drive.
3. Navigate to the configuration/AIP directory and select the AIP.xml file to open the
AIP domain configuration.
4. Perform any configuration tasks that are necessary, save and then close the AIP
configuration.
5. Once you are satisfied with the configuration, copy the configuration directory back
to $AIP_INSTALL before proceeding.
Implementation Guide 13
Introduction
1. The master AIP RPAS batch script “aip_batch.sh” reads from aip_env_rpas.sh to find
the locations of the domain and log path. The domain and log path variables
(AIPDOMAIN and RPAS_INTEGRATION_HOME) are defaulted to the
$TEST_AIPDOMAIN and $TEST_RPAS_INTEGEATION_HOME variables.
Therefore, add a definition of TEST_RPAS_INTEGRATION_HOME to
$AIP_INSTALL/aiplogin.ksh, or redefine the RPAS_INTEGRATION_HOME
variable inside $RPAS_HOME/bin/aip_env_rpas.sh. This is the location where the
logs will be written.
2. Execute the following command:
aip_batch.sh -f -s set_implementation_parameters -e convert_hierarchies_for_loading
This command instructs the AIP RPAS batch to run all first-day steps as scheduled in
the $RPAS_HOME/bin/aip_batch.sh script from the
set_implementation_parameters step through the convert_hierarchies_for_loading
step. These steps accomplish the task of creating RPAS loadable hierarchy files for
the following:
product (prod.dat)
warehouse (whse.dat)
supplier (hspl.dat)
location (loc.dat)
profile (prof.dat)
source stocking point (ssp.dat)
destination stocking point (dsp.dat)
These hierarchy data files are now located in $AIPDOMAIN/input directory.
If there are any errors resulting from these batch processes, see the log files written to
$TEST_RPAS_INTEGRATION_HOME to determine the error. If the logs indicate
that any measure data files are missing, ensure that 0-byte versions of these files are
located in the $AIPDOMAIN/interface/rms directory and rerun the above
aip_batch.sh command.
<subpositions>48_906_804,48_906_805,5_503_1401,5_503_1503,5_503_1504,5_530_246,5_531_658,5_699_817,66_213_48
2,66_214_553,66_223_394,66_224_1117,71_710_112,71_710_113,71_710_1497,7_562_1108</subpositions>
</subdomain>
</globaldomain>
</rpas>
If the desired global domain solution for the AIP module contains more than two local
domains, copy the <subdomain> … </subdomain> tag-set as many times as needed, then
customize each new copy of the tag-set.
Implementation Guide 15
Introduction
The <path> … </path> and <subpath> … </subpath> tags in the globaldomainconfig.xml files must be
modified, since they specify the absolute path to each component of each global domain.
This XML file currently contains DOMAINPATH as a placeholder, which you must replace
with the actual domain path components.
Example:
<path>/u01/acusys/rpas/Domains/aip</path>
<subpath>/u01/acusys/rpas/Domains/aip/ldom0</subpath>
<subpath>/u01/acusys/rpas/Domains/aip/ldom1</subpath>
where /u01/acusys/rpas/Domains/aip does NOT currently exist.
cp $TEST_AIPDOMAIN/input/prod.dat .
cp $TEST_AIPDOMAIN/input/whse.dat .
cp $TEST_AIPDOMAIN/input/hspl.dat .
cp $TEST_AIPDOMAIN/input/loc.dat .
cp $TEST_AIPDOMAIN/input/prof.dat .
cp $TEST_AIPDOMAIN/input/ssp.dat .
cp $TEST_AIPDOMAIN/input/dsp.dat .
cd <AIP_Installer>/aip/aip/aip_install
tar -cf aip.tar input configuration domain_build
zip aip.tar.zip aip.tar
It is important for the domain build process, described in the next section, to find the
customer hierarchy data in the <AIP_Installer>/aip/aip/aip_install/input directory
and the globaldomainconfig.xml file in the
<AIP_Installer>/aip/aip/aip_install/domain_build/AIP/config directory.
Implementation Guide 17
Introduction
Verify the domain build process for errors after the installation programs are
complete. In the event that errors occurred in the domain build, the user will be
alerted and should check the log file to determine the source of the error.
The log file may be scanned for errors by using any text editor or UNIX text search
commands. If an error occurs, it will most likely contain the word ‘error’, so the following
command might be useful for detecting if any build errors occurred:
grep –i error $AIP_INSTALL/build_logs/*.log
Other keywords to search for are “<E”, “not found”, and “exception”.
Once the domain build is completed, the sample positions from the Network Group
hierarchy should be removed. This is done in order that there will be no sample positions
in this hierarchy once the AIP Oracle export provides new hierarchy positions during
daily AIP RPAS batch.
Remove the Network Group hierarchy positions using the following commands:
touch $TEST_AIPDOMAIN/input/ntwg.dat
loadHier -d $TEST_AIPDOMAIN –load ntwg -checkParents -purgeAge 0
The -purgeAge option indicates that all positions in the hierarchy older than the number
specified (in days) should be removed from the hierarchy. Using 0 ensures all positions
are removed, and since there are no positions in the ntwg.dat file to be loaded, the
hierarchy is effectively cleared.
Empty Hierarchies:
Delivery Group Profile Order Cycle
Order Lead Time Cycle Network Group
Order Group
Implementation Guide 19
Post Installation Instructions
aip_env_rpas.sh
The variables displayed in the following table need to be defined properly within
aip_env_rpas.sh.
It is important to note that the values of the environment variables can be variables
themselves depending on the business needs. Such variables may add flexibility for
environment maintenance, patch testing, etc. and are used at the discretion of the
business.
For example:
If aip_env_rpas.sh contains
RPAS_INTEGRATION_HOME= "${TEST_RPAS_INTEGRATION_HOME}"
TEST_RPAS_INTEGRATION_HOME is a client specific environment variable whose value is the
correct path to the root integration directory. This and all other such variables must also
be defined in order to run the batch.
Finally, the variables below corresponding to directory paths must not contain white
space. For example, AIPDOMAIN may be defined as “/files1/aip/AIP1” but may not be
defined as “/files1/aip/AIP RPAS Domain”.
System Configuration 21
Setting Environment Variables
AIPDOMAIN Fully qualified path of the AIP RPAS global domain. The default value
(TEST_AIPDOMAIN) provided at the time of installation is a variable which
must also be defined apart of aip_env_rpas.sh if it is to be retained as the
value.
RPAS_INTEGRATION_HOME Fully qualified path of a readable/writeable directory that serves mainly as
a base for other path definitions later in aip_env_rpas.sh. Commonly set
equal to AIPDOMAIN. The default value
(TEST_RPAS_INTEGRATION_HOME) provided at the time of installation
is a variable which must also be defined apart of aip_env_rpas.sh if it is to be
retained as the value.
DEFAULT_DOMAIN Fully qualified path of the AIP RPAS local domain into which any new
subclass will be added.
BSA_TEMP_DIR Fully qualified path of readable/writeable directory where scripts may store
temporary files. Valid definition of this variable is required by the BSA
common scripts.
Note: THIS SHOULD NOT BE SET TO /tmp. Failures may occur due to
insufficient temporary workspace.
BSA_LOG_LEVEL Script logging threshold severity. Only log entries at this or higher severity
level will be written to the script logs. Must be one of { PROFILE | DEBUG |
INFORMATION | WARNING | ERROR }. Valid definition of this variable is
required by the BSA common scripts.
BSA_MAX_PARALLEL Script parallel process fan-out maximum. The number of processes that any
given process (script instance) may spawn. Valid definition of this variable is
required by the BSA common scripts.
BSA_LOG_HOME Fully qualified path of readable/writeable directory where script logs will
be rooted. Script logs are written into a hierarchy that parallels the script call
tree, rooted in a date stamped directory located in this specified directory.
Valid definition of this variable is required by the BSA common scripts.
BSA_LOG_TYPE Integer parameter that specifies the type of script log files to be written.
Must equal one of { 0 | 1 | 2 | 3 }. These values are defined as follows:
0 = No logging
1 = Text ".log" files;
2 = XML structured ".xml" file;
3 = Text and XML log files.
Valid definition of this variable is required by the BSA common scripts.
BSA_CONFIG_DIR Fully qualified path to directory that contains the BSA configuration file
bsa_prep_files.config. Valid definition of this variable is required by the BSA
common scripts.
BSA_ARCHIVE_DIR Fully qualified path to directory to which BSA file processing operations will
archive files. Valid definition of this variable is required by the BSA common
scripts.
RPAS_LOG_LEVEL RPAS binary logging threshold severity. Only log entries at this or higher
severity level will be written to the script logs from binaries that accept a –
loglevel argument. Must be one of
{ PROFILE | DEBUG | INFORMATION | WARNING | ERROR }.
RAW_RMS_DATA_DIR Fully qualified path to directory that contains untransformed RMS output
data.
RMS_SCHEMA_DIR Fully qualified path to the directory that contains the RETL schema files
corresponding to the untransformed RMS version 11+ output data.
RMS10_SCHEMA_DIR Fully qualified path to the directory that contains the RETL schema files
corresponding to the untransformed RMS version 10 output data.
AIP_SCHEMA_DIR Fully qualified path to directory that contains RETL schema files depicting
the transformed RMS output data.
RPAS_PAGE_SPLIT_PERCENTAGE This variable is used to optimize AIP performance. Do not alter this setting
without consulting AIP Technical Management.
ORACLE_AIP_PERISHABLE_ON This UNIX variable is set to YES (ORACLE_AIP_PERISHABLE_ON=yes)
when AIP is replenishing perishable products. This setting is case sensitive.
LIMIT_OF_SKPS_LOCAL_DOMAIN Maximum number of SKU-Pack Sizes allowed in a local domain when
considering where to add a new subclass received from Merchandising
System.
CYCLE_START_DATE The date in YYYYMMDD format, which denotes the start date for counting
day of fortnight and day of four-week period positions. This variable can be
customized if you are not using AIP-Oracle.
aip_ro_common.sh
The variables displayed in the following table need to be defined properly in order for
the Oracle Retail Replenishment Optimization (RO) integration controller scripts to
execute.
Installations not integrating with a replenishment optimization solution may disregard
these settings.
Environment Description
Variable
RO_INPUT The location of input data copied or transferred from the RO server.
RO_FILE_TYPE The file type for data exchange between AIP and RO. Must be either
‘csv’ or ‘txt’.
RPAS_TODAY
This value defines ‘TODAY’ for the AIP RPAS environment. It is used to ensure that the
replenishment batch can be run for a single calendar day, independent of the actual
server date. During a normal production run of the batch, this value should be set by the
VDATE (virtual date) value exported from AIP Online. This variable can be set for ad hoc
procedures, but it should be cleared after the procedure has completed as this may have
an adverse affect on the user workbooks.
Implementation Guide 23
Setting Environment Variables
INTEGRATION_HOME Fully qualified path to the interface home directory. The default value references
TEST_ONL_INTEGRATION_HOME, an externally defined variable. However, the
client may assign a hardcoded path to this value at their discretion.
ONL_OUTBOUND_DIR The default is ${INTEGRATION_HOME}/outbound. This variable defines the
directory location where the cron_export.sh script will put the files containing the data
exported from AIP Online. If bypassing the RIB the tsf_po_export.sh script will also
write the exported transfers and purchase order files to this directory. This must match
the ONL_OUTBOUND_DIR defined in aip_env_rpas.sh script, which may reside on a
different server.
ONL_INBOUND_DIR The default is ${INTEGRATION_HOME}/inbound. This variable defines the directory
location where cron_import.sh and cron_import_order.sh expect the inbound files
from RPAS to be sourced from.
BSA_ARCHIVE_DIR The default is ${INTEGRATION_HOME}/archive. This variable defines the directory
location where cron_import.sh and cron_import_order.sh scripts will send the input
data files for archiving.
BSA_LOG_HOME Fully qualified path of readable/writeable directory where script logs will be rooted.
Script logs are written into a hierarchy that parallels the script call tree, rooted in a date
stamped directory located in this specified directory. Valid definition of this variable is
required by the BSA common scripts. This variable is initially set to
${INTEGRATION_HOME}/logs.
BSA_CONFIG_DIR Fully qualified path to directory that contains the BSA configuration file
bsa_prep_files.config. Valid definition of this variable is required by the BSA common
scripts. This variable is initially set to ${INTEGRATION_HOME}/config.
BSA_TEMP_DIR Fully qualified path of readable/writeable directory where scripts may store
temporary files. Valid definition of this variable is required by the BSA common
scripts.
BSA_LOG_LEVEL Logging severity threshold for batch scripts. Only log entries at this or higher severity
level will be written to the script logs from procedures that accept the –loglevel
argument. Listed in increasing order of severity, one of the following levels must be
selected { PROFILE | DEBUG | INFORMATION | WARNING | ERROR }.
BSA_LOG_TYPE Integer parameter that specifies the type of script log files to be written. Must equal
one of { 0 | 1 | 2 | 3 }. These values are defined as follows:
0 = No logging
1 = Text ".log" files
2 = XML structured ".xml" file
3 = Text and XML log files
Valid definition of this variable is required by the BSA common scripts.
BSA_MAX_PARALLEL Script parallel process fan-out maximum. The number of processes that any given
process (script instance) may spawn. Valid definition of this variable is required by the
BSA common scripts.
DEFAULT_BSA_SQL_CRED_APP The default is DATABASE. It is used by bsa_sql.sh script to perform a lookup from the
config.xml file to connect to the AIP Online database.
RETL_MAX_HEAP_SIZE The default value is 700M. Raise this limit to improve performance on production
systems.
RETL_CONFIG_FILE File name containing database connection information. This variable is used by RETL
scripts. The default value references TEST_RETL_CONFIG_FILE, an externally defined
variable. However, the client may assign a hardcoded value at their discretion. In
either case, the variable should ultimately point to the fully-qualified path of a RETL
configuration file. An example config.xml file is included with AIP.
AIPDOMAIN Fully qualified path of the AIP RPAS global domain. The default value references
TEST_AIPDOMAIN, an externally defined variable. However, the client may assign a
hardcoded path to this value at their discretion.
HAVE_WIP Indicates if WIP is enabled to export and import data. The default value is set to false.
WIP is not implemented for this release of AIP..
ONL_SCHEMA_OWNER This variable sets the database schema owner. It is used by the store_source extract.
For example, if you are running AIP online extracts as "aipdev131user" but the schema
owner is "aipdev131", then regardless of the running database user,
ONL_SCHEMA_OWNER should be set to "aipdev131".
NLS_LANG This variable defines the character encoding of the RETL import files.
ONL_VDATE_DIR The directory location of the vdate.int file.
ONL_DATA_DIR This variable defines the location of data directory that contains the compressed and
zipped orders from AIP-RPAS. i.e. location where srp.tar.Z is placed for
cron_import_order.
RETL_INIT_HEAP_SIZE The default value is 200M. Raise this limit to improve performance on production
systems.
Implementation Guide 25
Setting Environment Variables
Example:
export RETL_THREAD_STACK_SIZE=200000
RETL
Once RETL is installed, the environment variables displayed in the table below should be
defined. Verify that these environment variables are properly defined.
Variable Description
User Path
When invoking online shell scripts, the user’s PATH must include the following
directories:
$INTEGRATION_HOME
$INTEGRATION_HOME/bsa
$INTEGRATION_HOME/config
$INTEGRATION_HOME/scripts
$RFX_HOME
$RFX_TMP
$ORACLE_HOME
For some variables defined in aip_env_online.sh, the value is defaulted to another
externally-defined variable. This approach provides flexibility in that multiple users can
use a single aip_env_online.sh but point to different test directories, domains, or RETL
configuration files. It is important to note that the test directories listed in the externally
defined variables must also be in the user’s PATH. Please refer to the AIP Installation
Guide for further details on defining variables in the .profile file.
Example:
If aip_env_online.sh contains
INTEGRATION_HOME= "${TEST_ONL_INTEGRATION_HOME}"
TEST_ONL_INTEGRATION_HOME is an environment variable whose value is the correct path
to the root integration directory. The path that is defined for TEST_ONL_INTEGRATION_HOME
must be in the user’s PATH.
Implementation Guide 27
Using the Scheduler to Run AIP Batch Processes
The table below provides information about the script or action performed in the Pre-
Critical Tasks process flow diagram. These steps include the scaling module scripts
which are only required by those Retailers who are supplier scaling and/or container
scaling.
Bring down the online application server and domain Oracle, RPAS
daemon to lockout users
vdate.sh inc export Oracle
cron_export.sh Oracle
Copy/FTP vdate.int file from RPAS
${INTEGRATION_HOME}/vdate to
${AIPDOMAIN}/interface/import/meas
Copy/FTP AIP Online export files from RPAS
${ONL_OUTBOUND_DIR} to
${AIPDOMAIN}/interface/export
Copy/FTP RMS data files to ${RAW_RMS_DATA_DIR}. RPAS
Perform uncompress and un-tar operations.
aip_t_master.ksh RPAS
Copy/FTP all external/custom data files to RPAS
${AIPDOMAIN}/interface/rms. Perform uncompress and
un-tar operations.
aip_batch.sh check_process_external_data RPAS
aip_batch.sh prep_onl_data RPAS
aip_batch.sh merge_hierarchies RPAS
aip_batch.sh convert_hierarchies_for_loading RPAS
aip_batch.sh reconfig_domain_partitions RPAS
aip_batch.sh load_all_hierarchies RPAS
aip_batch.sh load_onl_data RPAS
aip_batch.sh load_rms_dm_data RPAS
aip_batch.sh create_alerts RPAS
aip_batch.sh load_non_rms_external RPAS
aip_batch.sh auto_commit_wkbooks_batch RPAS
aip_batch.sh run_dm_batch RPAS
aip_batch.sh export_dm_data RPAS
Copy/FTP RPAS export files from Oracle
${AIPDOMAIN}/interface/export to
${INTEGRATION_HOME}/data.
cron_import.sh dm Oracle
Copy/FTP SKU dimension export files to Oracle
${ONL_INBOUND_DIR}. Perform uncompress and un-tar
operations.
Implementation Guide 29
Using the Scheduler to Run AIP Batch Processes
Implementation Guide 31
Using the Scheduler to Run AIP Batch Processes
The table below provides information about the critical path steps that need to be
performed.
Implementation Guide 33
Using the Scheduler to Run AIP Batch Processes
Example 1: For a particular virtual date the replenishment batch run occurs after the load
of RO data into AIP. The loaded replenishment methods and thresholds will be used in
the upcoming replenishment batch run.
Implementation Guide 35
Using the Scheduler to Run AIP Batch Processes
Export to RO
The diagram below displays the export of data from AIP to RO.
The table below provides information about the export steps that need to be performed.
These steps assume the data exported from AIP will be limited by the RO Update Flag,
and that this information is specified by the RO User. It also assumes that the next set of
sku/locations to be exported/optimized is not known until a time after the last import of
replenishment data (therefore the file is not imported with the last set of optimized
replenishment data files),
aip_export_to_ro.sh RPAS
Import from RO
The diagram below displays the import of replenishment optimization data from RO.
The table below provides information about the export steps that need to be performed.
aip_import_from_ro.sh RPAS
Implementation Guide 37
Using the Scheduler to Run AIP Batch Processes
Purging
Purging data is important to maintaining database sizing as well as improving user
experience. Purging data decreases the amount of data that a user has to sort through in
order to get to the data that is desired.
Purging should be executed on a routine basis of weekly or monthly
aip_purge.sh Oracle
Copy/FTP AIP Online purge_hierarchy.tar.Z file from RPAS
${ONL_EXPORT_DIR} to
${AIPDOMAIN}/interface/purge/import
purging_aip_batch.sh purging_prep_oracle_data RPAS
purging_aip_batch.sh purging_process_hierarchies RPAS
Copy/FTP additional hierarchies to ${AIPDOMAIN}/input RPAS
purging_aip_batch.sh purging_load_hierarchies RPAS
purging_aip_batch.sh purging_process_measures RPAS
config.xml
The RETL interface process, run from a UNIX-based platform, is designed to be fully
automated once configured. In addition to the environment variables described above
config.xml is required when invoking the RETL scripts. This file should be located in the
root integration directory on the UNIX server in which the AIP Online application is
installed.
This configuration file contains the database connection information required by RETL
for performing import and export operations. Refer to the RETL documentation for
detailed descriptions of element definitions. There are two operator sections that need to
be completed, one for oraread and one for orawrite. The oraread section defines the
properties required for all export operations on the database and the orawrite section
defines these for all import operations. Though both contain similar attributes, it’s
imperative that each section is defined as needed for the specific Oracle database
installation. This information is also dependent on the requirement that all databases can
be connected to via a properly defined tnsnames file and reachable by SQLPlus.
Example config.xml file:
<CONFIG>
<DEFAULTS operator="oraread">
<PROPERTY name="arraysize" value="5000" />
<PROPERTY name="dbname" value="DEV029i"/>
<PROPERTY name="connectstring" value="aiprmsint130user/retek"/>
<PROPERTY name="jdbcdriverstring" value="oracle.jdbc.driver.OracleDriver" />
<PROPERTY name="jdbcconnectionstring" value="jdbc:oracle:oci:@ " />
</DEFAULTS>
<DEFAULTS operator="orawrite">
<PROPERTY name="dbname" value="DEV029i"/>
<PROPERTY name="dbuserid" value="aiprmsint130user/retek"/>
<PROPERTY name="method" value="conventional"/>
<PROPERTY name="jdbcdriver" value="oci"/>
</DEFAULTS>
</CONFIG>
Integration Directories
The following directories must be created by the system administrator. They are required
and will cause errors if absent:
$INTEGRATION_HOME/inbound
$INTEGRATION_HOME/archive
Shared Files
When the AIP RPAS module is not installed on the same server as the AIP ONLINE
module, the shared credential and verification files must be present in both locations.
The following table lists the files and the appropriate location on the UNIX server. Copy
the files from the AIP RPAS server location to the AIP ONLINE server. Where the
destination directory does not exist, one should be made. All server locations are written
in reference to the aip_env_online.sh environment variables.
prep_files.sh $INTEGRATION_HOME/scripts/
bsa_prep_files.config $INTEGRATION_HOME/config
bsa_archive.sh $INTEGRATION_HOME/bsa
bsa_check_for_required_files.sh $INTEGRATION_HOME/bsa
bsa_common.sh $INTEGRATION_HOME/bsa
bsa_cred.sh $INTEGRATION_HOME/bsa
bsa_env.sh $INTEGRATION_HOME/bsa
bsa_prep_files.sh $INTEGRATION_HOME/bsa
bsa_logger.sh $INTEGRATION_HOME/bsa
bsa_para.sh $INTEGRATION_HOME/bsa
bsa_sort.sh $INTEGRATION_HOME/bsa
bsa_sql.sh $INTEGRATION_HOME/bsa
bsa_verify.sh $INTEGRATION_HOME/bsa
import_hierarchy.config
import_dm.config dm_banded_comm_in.sh
dm_is_prepriced_in.sh
dm_dir_store_frmt_pksz_in.sh
dm_dir_store_pksz_in.sh
dm_sis_store_in.sh
dm_sis_wh_in.sh
dm_store_frmt_pksz_in.sh
dm_store_pksz_in.sh
dm_value_added_comm_in.sh
dm_wh_prom_dates_in.sh
import_dm_alerts.config
import_sale_date.config
import_om.config om_po_recycling_in.sh
import_sku_attribute.config commodity_weight_volume_in.sh
commoditiy_cost_in.sh
Implementation Guide 41
Export Configuration Files
Note: Files that are optional for import may not be optional
for export. Some import files are optional because the data
can be loaded. Alternatively the data can be entered in the
DM online application. Regardless of how the data gets into
the Oracle database, this data is required by AIP RPAS to
run replenishment batch.
The configuration files are a command line argument passed to the parent script,
process_aiponline_data.sh. A modified configuration file or a specially constructed
configuration file can be passed to the parent script to aid restart/recovery or special
ad hoc processing.
The export configuration files are listed below.
export_hierarchy.config
export_dm.config
export_tsf_po.config
export_scale.config
export_hierarchy_purge.config
Oracle Database
The configurations performed in the Oracle database affect how the business uses AIP.
Each setting will be used when performing some action of supply chain setup—either
automatically or manually—or order execution and maintenance.
SYSTEM_PARAMETERS
The following table contains the configuration parameters contained in the
SYSTEM_PARAMETERS database table, the default value assigned to the parameter, and
a description about what the parameters controls. The default parameter values in the
table need to be set according to your individual business needs.
Implementation Guide 43
Oracle Database
Implementation Guide 45
Oracle Database
Implementation Guide 47
Oracle Database
In addition to the parameters listed above there a number of parameters that might be
tweaked for performance reasons. These parameters begin with the “BFL” prefix and
serve to limit the number of records retrieved at one time when executing a Bulk Fetch.
The parameters are specific to a procedure or function.
RESTART_CONTROL
The Oracle RESTART_CONTROL table defines the number of parallel subprocesses that
a high data volume process uses in shell script. For example:
Importing STORE SOURCE data from RPAS into Online
Exporting STORE SOURCE data from Online to RPAS
Importing INTO-STORE PURCHASE ORDERS from RPAS to Online
Importing INTO-STORE Transfers from RPAS to Online
Importing ON-SALE-OFF-SALE data from RPAS to Online
Executing ORDER-SCALING process in AIP Online.
The column NUM_THREADS controls the degree of parallelism while executing the
processes defined in column PROGRAM_NAME of this table.
ORDER_NUMBER
The Oracle ORDER_NUMBER table defines the valid range of order numbers for
purchase orders and transfers. The range of values should not overlap the range of
values allocated to any other system capable of generating orders. Update the
ORDER_NUMBER table to reflect the range of purchase order and transfer numbers that
are appropriate for AIP.
ORDER_PURGE_PERIOD
The Oracle ORDER_PURGE_PERIOD table defines the number of day an order remains
in the system after it has been set to a Closed status. Review the default purge periods
inserted in the table at installation time, and update the values for purchase order
purging and transfer purging when needed.
ORDER_DEFINITION
In AIP Online orders are held at order detail level (i.e. order line time level). When an
order number is generated, it is generated at order header level. The Oracle
ORDER_DEFINITION table holds information that specifies how order line items are
grouped into to order headers.
The following options are available for defining the level of grouping:
Source - Indicates if order sources are used in order header roundup.
SKU - Indicates if SKUs are used in order header roundup.
Pack Size - Indicates if pack sizes used in order header roundup.
Destination - Indicates if the order destinations are used in order header roundup.
Delivery Date - Indicates if delivery dates are used in order header roundup.
In the example below SKU (commodity) and pack size are not used in the order
definition. This means that for each order type an order number will be assigned to each
unique combination of source, destination, and delivery date. This will result in one too
many SKU pack sizes being grouped under a single order number for an order type.
ORDER CYCLES
The default order cycles created at implementation time are used by the batch processes
that automatically create Profiles and Order Groups. These order cycles can be modified
to match your business needs however they must remain in sync with the same special
default order cycles created in the RPAS platform.
PRFVS 15
PRFWS 1 1 1 1 1 1 1
STORE_ORDER_CYCLE
Implementation Guide 49
Oracle Database
STORE_ORDER_CYCLE_LEAD_TIME
2 1 -1 -1
2 2 15 15
2 3 -1 -1
2 4 -1 -1
2 5 -1 -1
2 6 -1 -1
2 7 -1 -1
3 1 1 1
3 2 1 1
3 3 1 1
3 4 1 1
3 5 1 1
3 6 1 1
3 7 1 1
OGVW 15
OGWW 1 1 1 1 1 1 1
ORDER_CYCLE
ORDER_CYCLE_LEAD_TIME
1 1 -1
1 2 15
1 3 -1
1 4 -1
1 5 -1
1 6 -1
1 7 -1
2 1 1
2 2 1
2 3 1
2 4 1
2 5 1
2 6 1
2 7 1
Implementation Guide 51
Oracle Database
DATA_PURGE_PARAMETERS
In order to purge invalid or ineffective hierarchy data from AIP Online tables, purge
parameters are used to configure the purge ages. These parameters are defined in a table
called PURGE_PARAMETER and are used by purging script aip_purge.sh to identify
invalid/ineffecttive data for purging. The default parameter values in the table need to
be set according to individual business needs.
STORE_ORDER_CYCLE_PURGE_AGE 366 The number of days a store order cycle remain in the
system before being purged, beginning from when the
order cycle is not assigned to at least one profile.
Implementation Guide 53
Oracle Database
WH_TYPE_INITIAL_PACK_TYPE
The Oracle WH_TYPE_INITIAL_PACK_TYPE table contains the warehouse type and
pack type associations that are used for defaulting warehouse orderable units and order
multiples. When the AIP Automated Data Maintenance batch processes run the pack
type value defined for the respective process will define which pack size should be used
for assignment first. If the pack size associated with the pack type is not valid for a given
warehouse of the assigned warehouse type, additional logic in the batch will determine
the next valid pack size to use.
The constraints on the table will need to be modified if additional warehouse types are
added to the system via the STOCKING_POINT table. The warehouse type describes the
destination warehouse type.
The process type identifies the process to which the warehouse type/pack type setting
applies – either warehouse orderable units or order multiples.
SUPPLIER
Prior to importing any supplier data, the column constraint on the SHIP_TO column
should be modified to match the SHIP_TO values that will be imported from the
merchandising system. If additional values are being added, the Ship-to source and
destination mappings must also be added to the SHIP_TO_WH_TYPE_SOURCE and
SHIP_TO_WH_TYPE_DEST tables.
STOCKING_POINT
Prior to importing any warehouse data, the column constraint on the WH_TYPE column
should be modified to match the WH_TYPE values that will be imported from the
merchandising system.
SHIP_TO_WH_TYPE_SOURCE
This Oracle table contains the mappings between Supplier SHIP_TO values and the
appropriate sources. These values are used when automatically generating Delivery
Groups and Order Groups. When the WH_TYPE column is null, the supplier will be
used as the source. A non-null WH_TYPE value indicates the warehouse that the
supplier ships to is an intermediate warehouse that does not ship directly to the store.
When the WH_TYPE is populated, the source of the Delivery Groups and Order Groups
created will be Warehouses that match the WH_TYPE.
SHIP_TO_WH_TYPE_DEST
This Oracle table contains the mappings between Supplier sources
(SHIP_TO_WH_TYPE_SOURCE) and the destinations. The destinations are used to
determine the valid warehouse chambers to assign to the delivery groups and order
groups. One SHIP_TO value can map to many sources and destination WH_TYPEs.
ALERT_DEFINITION
Every alert is assigned a priority based on the type of the alert. The priority assigned to
each alert type can be set in the ALERT_DEFINITION table. The priority setting currently
has no bearing on the rest of the system. It is simply a visual indicator of importance and
search mechanism for the user.
ALERT_DEFINITION_DESC
The Oracle ALERT_DEFINITION_DESC table contains the text of each alert, and the
corresponding SHORT_DESC or alert type description. The SHORT_DESC value is
displayed to the user as search criteria. You may modify the text of the SHORT_DESC,
however, the screen is optimized to display the values provided in the installation. It is
not recommended that you modify the LONG_DESC as the correct placement of the data
displayed to the user depends on the structure of the LONG_DESC text.
The LONG_DESC and SHORT_DESC can be translated for another LANG and
COUNTRY if desired.
ALERT_STATUS_DESC
Each alert that is imported or generated by AIP Automated Data Maintenance batch will
be assigned a status. The status is displayed to the user in the DM online screen. The user
can then modify the status of the alert by selecting a status option from a drop-down list.
The status options displayed in the list and their descriptions are contained in the
ALERT_STATUS_DESC table.
Adding a Status
The ALERT_STATUS_CODE indicates the chronological order of the statuses displayed
on the screen as well as the code that is saved indicating the alert’s current status.
When adding a status:
The smallest value will be automatically assigned to every new alert.
The largest value will be considered the final status indicating no more work needs
to be completed related to the alert.
It must be added to every set of LANG/COUNTRY combinations. Therefore, the
same set of ALERT_STATUS_CODE values must exist for every LANG and
COUNRTY on the table.
Implementation Guide 55
AIP Application Server
db.properties
File Location: <aip app server install location>/config
This file contains configuration values that are related to the system’s database. This file
tells the DM Online and OM Online application how to connect to the database. After
installation, this file should contain the correct information because it is set in the initial
run of the AIP Online application. However, it is a good idea to review the values in the
files for completeness and accuracy. The following table provides a description of the
values contained in the db.properties file.
common.prop.db This value defines the database that the system is utilizing. This value is set to
Oracle.
common.prop.oracle.sid This value is an Oracle parameter that defines the database name that the system
is utilizing. SID stands for system identifier.
common.prop.oracle.host This value is an Oracle parameter that refers to the database listener. This value
defines the “host:port” that the database listener is using. If Oracle database is
configured as clustered database, then this property should be left blank.
common.prop.oracle.schema This value is an Oracle parameter that defines the schema owner’s username. If
the username/password defined in common.prop.user is not the schema owner,
then this field must also be added and defined in order for the AIP Online
Administration screens to function properly.
common.prop.user This value is an Oracle parameter that defines the username/password of the
database. This can be a schema owner or a standard user.
common.prop.poolsize. This property represents the connection pool size that AIP application uses. This
does not include the connections that EJB might establish with the database.
Default value of this property is set to 40. The user is allowed to increase this
value but not to decrease it.
common.prop.oracle.dburl A required property to connect to clustered database. When using this
common.prop.oracle.host should be left blank.
main.properties
File Location: <aip app server install location>/config
The following table provides a description of the properties contained in the
main.properties file. This file is used by the Java enabled applications: DM online, OM,
and RIB publication via the OrderSenderBean.
Property Description
base This must match the context root of the ear or war file. This is "/" for a production
system, or "/test1" for the 1st of several test systems on a single physical computer.
securemode This is set to "1" to force connections to switch from http (non-secure) to https
(secure) upon logon. This value can also be set to "0" to prevent the connection from
being switched from non-secure to secure mode.
setfileattr.rcapps.properties This defines a file to contain color attributes. The default setting is
rcapps.properties.
#aip.prop.order.period.count=1
#aip.prop.order.period.start.1=08:00:00
#aip.prop.order.period.end.1=20:00:00
#aip.prop.order.time.interval=00:01:00
#aip.prop.order.po.message.family=XOrder
#aip.prop.order.po.message.type.name=msg_type
#aip.prop.order.po.queue.table.name=PO_MFQUEUE
#aip.prop.order.po.table.id.name= orderNo
#aip.prop.order.tsf.message.family=XTsf
#aip.prop.order.tsf.message.type.name=msg_type
#aip.prop.order.tsf.queue.table.name=TSF_MFQUEUE
#aip.prop.order.tsf.table.id.name= tsfNo
#aip.prop.order.max.message.bundle.size=10
#aip.prop.order.max.publishing.count=20
2. Save the main.properties file.
3. Have the application server administrator restart the server instance where the
OrderSenderBean and AIP Online application are deployed.
Implementation Guide 57
AIP Application Server
Property Description
aip.prop.order.period.count The number of periods in the day during which the OrderSenderBean
will invoke RIB publication. This value must be greater than zero if RIB-
based publication is to be used. In addition, at least one of the above two
properties must in set to ‘ON’.
aip.prop.order.po.message.family The purchase order message family name. This value is required by the
RIB to ensure proper validation of message payloads. This value should
be set to ‘XOrder’.
aip.prop.order.po.message.type.name This value can be used to indicate if the message is a header-create,
header-update, detail-create, or detail-update message. Although
message types are used to order the OrderSenderBean query, this parameter
value is not currently used.
aip.prop.order.po.queue.table.name The AIP Online table which OrderSenderBean queries to check for Purchase
Order related messages awaiting publication. This value should be
‘PO_MFQUEUE’.
aip.prop.order.po.table.id.name This value is used to group functionally related message content. For
example, all message content related to purchase order number 123
would be grouped. This value should be ‘orderNo’.
aip.prop.order.tsf.message.family The transfer message family name. This value is required by the RIB to
ensure proper validation of message payloads. This value should be set to
‘XTsf’.
aip.prop.order.tsf.message.type.name This value can be used to indicate if the message is a header-create,
header-update, detail-create, or detail-update message. Although
message types are used to order the OrderSenderBean query, this parameter
value is not currently used.
aip.prop.order.tsf.queue.table.name The AIP Online table which OrderSenderBean queries to check for Transfer
related messages awaiting publication. This value should be
‘TSF_MFQUEUE’.
Property Description
aip.prop.order.tsf.table.id.name This value is used to group functionally related message content. For
example, all message content related to transfer number 456 would be
grouped. This value should be ‘tsfNo’..
aip.prop.order.max.publishing.count The maximum number of messages per message bundle. For example,
multiple Purchase Order header create message can be grouped in one
message bundle to improve performance. The default value is 20, but this
value should be recalculated by the client based upon on-site performance
testing.
rcapps.properties
File Location: <aip app server install location>/config
These properties are applied to the main application login and navigation pages. These
property settings do not apply to the pop-up applet screens.
The color properties can be set to any 6 character hexadecimal value and are preceded
with the # symbol.
Hexadecimal color property examples:
#0000FF = blue
#FF0000 = red
The files defined for various properties are located off of the following base directory:
<OAS Home>/j2ee/<AIP Instance>/applications/<AIP Application>/AIPOnlineWAR
Property settings that contain path assignments are appended to the base directory
provided above. Use the complete path, base directory plus property path to locate
specific files as needed.
Example:
apptop.page=/fragments/apptop.jsp
apptop.jsp can be found in the following path:
<OAS Home>/j2ee/<AIP Instance>/applications/<AIP
Application>/AIPOnlineWAR/fragments
The following table provides a description of the properties contained in the
rcapps.properties file.
Property Description
Implementation Guide 59
AIP Application Server
Property Description
applet.codebase Applet default codebase. The default value is appclasses. This is not expected to ever
change.
apppage_top.page Contains the code content for the upper fragment of the page including the top and left
banners. The default value is /fragments/apppage_top.jsp
apptop.page Defines the standard top banner (normal and compact versions). The default value is
/fragments/apptop.jsp.
apptop_about.page Defines the content of the ‘about’ page. ‘About’ pages typically contain version numbers
and company information. ‘About’ pages are not supported by Oracle AIP. The default
value is /fragments/apptop_about.jsp.
head.page Contains the code content getting the configurations and saving them in variables used
throughout the page. The default value is /fragments/head.jsp.
appbot.page Defines the standard bottom banner. The default value is /fragments/appbot.jsp.
apppage_bot.page Contains the code content for the lower page fragment. The default value is
/fragments/apppage_bot.jsp.
securemode.allow Used to enable securemode.
Set to "*" to enable securemode on all clients, or set to "*, !Mac" to enable securemode on all
clients except those that are using a Macintosh.
webmeter.allow Used to display webmeter.
Set to "*" to display WebMeter for all clients, or "*, !Mac" to display WebMeter for all clients
except those that are using a Macintosh.
webmeter.page Defines the file containing code for the WebMeter page. The default is
/fragments/webmeter.jsp.
security.properties
File Location: <aip app server install location>/config
This file defines security administration settings for the application.
The following table provides a description of the properties contained in the
security.properties file.
Property Description
trackeradmin.prop.adminhosts This is a comma delimited list of "host/mask" values that are allowed to access
phantasm (the primary administration page).
strings_en.properties
This file provides the displayed text for the screens. Error text originating in the database
is not provided in this file and is not accessible for customization. Customizing this file
can have an affect on the visual presentation of the screen or popup message. The new
text should be of equal or similar character lengths as the modified text.
The file is located in the following server path:
<OAS Home>/j2ee/<AIP Instance>/applications/<AIP
Application>/AIPOnlineWAR/appclasses/res/com/retek/applet/strings_en.properties
Config.properties
This file contains configurable settings for Data Management and Order Management
that determine how certain screens appear immediately when opened. It also contains
settings which allow or prevent certain user activities on the screens.
This file is located in <OAS Home>/j2ee/<AIP Instance>/applications/<AIP
Application>/AIPOnlineWAR/appclasses/res/com/retek/applet.Data Management
Online Settings
The following table provides a description of properties found in the Config.properties
file that are used to define Data Management online (DMo) settings.
Property Description
Implementation Guide 61
Config.properties
Property Description
number also negates the benefits of paging, which is used to improve
screen rendering time performance and display information in a
more usable fashion. This property can be set to any value greater
than 0 and less than or equal to 9999999.
paginggrid.<screen name>.page.size Each screen that uses paging has its own pagesize setting. This
setting, when greater than 0, will override the default ‘pagesize’
setting. The same considerations for the default should be applied to
the individual screen settings. A value of -1 indicates that the default
should be used. The valid values for this property are -1 or any
number greater than 0 and less than or equal to 9999999.
scalinggroups.container.assignments.default This property indicates the default selection for Container
Assignments when creating new Scaling Groups.
0 for Same as Scaling Group
1 for Expand Scaling Group
Property Description
ordermanagement.order.type.default This setting defines which order type radio button is selected by
default. The available options are All, Transfers, or Purchase Orders.
This setting applies to all Order Management screens which allow
the user to search or select an order type. Valid values for this
property are as follows:
0 for All
1 for Purchase Orders
2 for Transfers
Note: The ordermanagement.viewable.order.type setting takes
precedence over this setting. If this setting conflicts with it, the
ordermanagement.viewable.order.type will be used instead.
ordermanagement.viewable.order.type This setting defines which order types users are able to view and
possibly manipulate. Users cannot perform any operations on orders
types that do not match this setting, nor can they view order types
that do not match this setting. This setting applies to all Order
Management screens. The valid values for this property are as
follows:
0 for All
1 for Purchase Orders
2 for Transfers
Note: Users may have privileges to the Order Create screen but they
will be unable to perform any operations if the
ordermanagement.viewable.order.type is not set to All or Purchase
Order.
ordermanagement.unit.of.measure.default Defines the unit of measure (UOM) radio button that is initially
selected when displaying OM Online screens containing UOM. Valid
values are 0 for cases, or 1 for eaches.
Property Description
ordermaintenance.order.display.format This setting defines the display format that is selected by default in
the Order Maintenance search criteria pop up. The valid options for
this property are 0 for the tree format and 1 for the grid format.
ordermaintenance.expand.all.default When the search results in the Order Maintenance screen are
displayed in a tree format, this setting is used to determine whether
the tree should be initially displayed in a collapsed or expanded
state. When collapsed, only the header level order information
appears. When expanded, all of the SKU-pack sizes and order
quantities associated with the order display. Valid values for this
property are 0 for collapsed or 1 for expanded.
ordermaintenance.update.quantity.default In the Order Maintenance screen, the user has the option of viewing
the quantity on the order as the total ordered quantity or as the
outstanding, un-received order quantity. This setting is used to
determine which radio button option will be initially selected on the
screen. The valid values for this property are 0 to view the total order
quantity, or 1 to view the unreceived order quantity.
ordermaintenance.supplier.tracking.default When moving the un-received purchase order quantity to a new
delivery date and/or destination, the user must specify whether the
supplier was the cause of the change or their business. The value that
is specified affects the supplier performance tracking. This property
defines which drop-down list option should be selected by default.
The valid values are as follows:
0 – Always Ask
1 – Supplier Initiated
2 – Business Initiated
The Always Ask option is recommended if the business will be
viewing and using the supplier performance tacking information.
This option forces the user to consciously select the appropriate
value.
If the business will not be using the supplier performance tracking
information, then either the Supplier Initiated or Business Initiated
option should be selected so that a value is always selected by
default. This prevents the user from having to randomly pick one of
the two options, as well as prevents the unnecessary popup which
appears when the Always Ask option is selected in the drop-down
list.
ordermaintenance.view.default This setting defines which view should be displayed initially in the
Order Maintenance Screen—the Standard View or the Extended
View. The extended view includes the Supplier Tracking value and
the Release Date. The additional columns displayed in the extended
view results in each column having a smaller display size. Valid
values for this property are 0 for the standard view and 1 for the
extended view.
ordermaintenance.allow.move.unreceived This setting allows the business to prevent users from changing the
destination and delivery date of a purchase order. The valid values
for this property are 0 to allow changing delivery dates and
destinations, or 1 to prohibit changing delivery dates and
destinations.
Implementation Guide 63
Config.properties
Property Description
Property Description
Implementation Guide 65
6
AIP RPAS Configurations
The AIP RPAS configurations listed in this section allow the business to manipulate AIP
to meet their business needs. The XML files, configuration files, measures, etc. are
applied to the replenishment processing to affect the plan that is produced.
shortfallPriorityMatrix.xml
The Shortfall Priority Matrix describes the order in which available inventory is allocated
when an inventory shortfall occurs. The matrix is organized across two axes, Destination
Types and Boundaries.
The Destination Types are the list of store priorities in the system plus a single entry for
warehouses (because warehouses do not have priorities). The list of store priorities is
configurable, but the default Destination Types are as follows:
Super High Priority Stores
High Priority Stores
Normal Priority Stores
All Warehouses
The four Boundaries in the Shortfall Priority Matrix are as follows:
CORT (Customer Orders over Review Time)
MSS (Minimum Sales Stock)
RP (Receipt Point)
RUTL (Receive Up To Level)
The following is the default Shortfall Priority Matrix.
Super High 1 4 5 6
High 2 7 9 11
Normal 3 8 10 12
Warehouse 13 14 15
Note that CORT is not a valid boundary for Warehouses because Warehouses do not deal
directly with customers.
The Shortfall Priority Matrix ranking is configurable. The configuration is specified using
an XML file, shortfallPriorityMatrix.xml, which is formatted as shown below.
<reconciliation-priority-matrix>
<boundary componentName="CustomerOrderOverReviewTime">
<group id="1" priority="1"/>
<group id="2" priority="2"/>
<group id="3" priority="3"/>
</boundary>
<boundary componentName="WarehouseMinimumStock">
<group id="0" priority="13"/>
</boundary>
<boundary componentName="MinimumSalesStock">
<group id="0" priority="13"/>
<group id="1" priority="4"/>
<group id="2" priority="7"/>
<group id="3" priority="8"/>
</boundary>
<boundary componentName="SupplyChainReceiptPoint">
<group id="0" priority="14"/>
<group id="1" priority="5"/>
<group id="2" priority="9"/>
<group id="3" priority="10"/>
</boundary>
<boundary componentName="SupplyChainReceiptUptoLevel">
<group id="0" priority="15"/>
<group id="1" priority="6"/>
<group id="2" priority="11"/>
<group id="3" priority="12"/>
</boundary>
Within the XML file, the "group id" corresponds to a destination priority, where “0” is
reserved for All Warehouses. The remaining destination priorities should match the store
priorities. For example, the default destination priorities are “1” for Super High Priority
Stores, “2” for High Priority Stores, “3” for Normal Priority Stores. The "componentName" is
the name of a numeric DataContainer which will contain the calculated allocation
boundary data.
For each group the allocation boundaries should only be prioritized in the following
ascending order: CORT < MSS < RP < RUTL. Since the allocation boundaries are
cumulative, undesirable results may be generated if this order is not followed.
It should also be noted that same priority numbers across multiple cells will not be
supported in the current release. Each cell within the matrix should be assigned a unique
priority number. Not doing so will result in erroneous results.
surplusStorePriorityMatrix.xml
The Surplus Store Priority Matrix describes the order in which available inventory is
allocated to stores when an inventory surplus occurs. This matrix is used when pushing
only to stores. There are two surplus matrices, surplusStorePriorityMatrix and
surplusAllPriorityMatrix, and which one is used for pushing depends on the valid
destinations served by a supplier with a fixed purchase quantity or stockless warehouse.
The surplusAllPriorityMatrix is not configurable and therefore is not listed in this guide.
The matrix is organized across two axes, Destination Types and Boundaries. The
Destination Types are the same as those in the shortfall version, but the Boundaries are
different.
Super High 1 6
High 2 5
Normal 3 4
Warehouse 7
All Destinations 1 2
When stepping through the Surplus Priority Matrix, the ‘Upper Boundary’ is simply the
appropriate Upper Boundary for the SKU and destination type. The ‘Lower Boundary’
on the other hand is always assumed to be zero. This is because when pushing inventory
to destinations, the inventory position of those destinations need not have reached any
particular lower boundary, because they may not have ordered anything. Therefore, by
treating the lower boundary as zero, it is possible to assess all destinations against the
Upper Boundary, regardless of their inventory position.
This matrix is configurable through direct access to the database. However, the rule that
must be observed is that for any given Destination Type (consider this a row in the
matrix), the boundaries must be addressed in increasing numerical order – there is no
point in giving destinations a quantity ‘Up to their Upper Boundary’ after giving them
inventory ‘Above their Upper Boundary’. Note that by definition, the ‘Above the Upper
Boundary’ cell has no upper numerical limit, and so as long as there are destinations
associated with a particular row to which inventory can be sent, an ‘Above Upper
Boundary’ cell will always exhaust all remaining inventory.
The Surplus Priority Matrix ranking is configurable. The configuration is specified using
an XML file, surplusStorePriorityMatrix.xml which is formatted as shown below.
<reconcilication-priority-matrix>
<boundary componentName="Above Upper Boundary">
<group id="1" priority="6" method="fair-share"/>
<group id="2" priority="5" method="fair-share"/>
<group id="3" priority="4" method="fair-share"/>
</boundary>
<boundary componentName="Up To Upper Boundary">
<group id="1" priority="1"/>
<group id="2" priority="2"/>
<group id="3" priority="3"/>
</boundary>
</reconcilication-priority-matrix>
Implementation Guide 69
Measures
Within the XML file, the group id corresponds to a destination grouping. The destination
priorities should match the store priorities. For example, the default destination priorities
are “1” for Super High Priority Stores, “2” for High Priority Stores, “3” for Normal
Priority Stores. The "componentName" is the name of a numeric DataContainer which will
contain the calculated allocation boundary data. The “method” currently has only one
valid designation (“fair-share”) and should not be changed.
For each group the allocation boundaries should only be prioritized in the following
ascending order: ‘Up To Upper Boundary’ < ‘Above Upper Boundary’. Since the
allocation boundaries are cumulative, undesirable results may be generated if this order
is not followed.
It should also be noted that same priority numbers across multiple cells will not be
supported in the current release. Each cell within the matrix should be assigned a unique
priority number. Not doing so will result in erroneous results.
Measures
aip_env_rpas.sh
In addition to the infrastructure-type environment variables listed in Chapter 4, “System
Configuration,” of this Oracle Retail Advanced Inventory Planning Implementation Guide, the
aip_env_rpas.sh script contains implementation parameters which the business must
customize. The values assigned to the variables in the “Implementation Parameters”
section of aip_env_rpas.sh will be assigned as values to selected AIP RPAS measures
during execution of the set_implementation_parms.sh script--which is run from
aip_batch.sh when the ‘first time’ parameter is True. See Chapter 13, “First Day of AIP,”
for details on running AIP batch with ‘first time’ parameter set to True.
The following table contains a description of the variables in aip_env_rpas.sh which
correspond to the Implementation Parameters for AIP RPAS.
Implementation Guide 71
Measures
Implementation Guide 73
Measures
Implementation Guide 75
Modifying Measure Base Intersections Using Configuration Tools
Note: The data file containing the data must match the
configured measure intersection.
After the presence of all required files has been validated a number of files are run
through a stocking point prefix-adding script as well as a binary executable called
interutil. These processes perform a myriad of formatting tasks including splitting files,
adding S, V or W prefixes to Stores, Suppliers, and Warehouses respectively, and
transforming RMS-sourced files from RMS SKU to AIP SKU or SKU-pack size. The list of
files containing measure data that are reformatted by interutil is determined by a second
set of configuration files.
The configuration files can be modified to prevent interutil from being run for files
that are in AIP RPAS loadable format.
Only files containing measure data are listed in the configuration files. Hierarchy
files must be provided in the predetermined format.
The table below provides information about each of the loadable configuration files.
Value Name File Name Description of Value and Purpose for Loading Early, Late-
precritical, or
Late (critical)
Implementation Guide 77
Import Configuration Files
Value Name File Name Description of Value and Purpose for Loading Early, Late-
precritical, or
Late (critical)
Value Name File Name Description of Value and Purpose for Loading Early, Late-
precritical, or
Late (critical)
Off Sale Dates dm0_ofseffdt_.txt Contains Store, SKU, Off Sale Dates. Determines the Early
date that the SKU will no longer be sold at the store.
This value is used in determining the off-supply
date which determines when AIP will no longer
replenish the SKU at the store. If this file value is
blank the system will use the
SYSTEM_HIGH_DATE (infinity) as the off-sale
date.
On Sale Dates dm0_onseffdt_.txt Contains Store, SKU, On Sale Dates. Determines Early
when the SKU will be sold at the store. This value is
used in determining the on-supply date which
determines when AIP will begin to replenish the
SKU at the store.
Pack Type dmx_pcktyp.txt Defines a single pack type for each SKU-pack size. Early
Pack Type is used in the Automation to set Location
Orderable Unit, Order Multiple, and store ordering
pack sizes (store/store format pack size).
Automation will not be able to assign a value if the
pack type is not defined for SKU-pack sizes.
Poisson srx_poidst.txt Poisson Distribution Table. Early
Distribution Table
Pre-Priced Status dmx_pprsts.txt Used to substitute a pre-priced item in place of a Early
standard item during a promotion. The Default
status of a SKU is 'False' or 'Not Pre-priced.'
Product Life (shelf sr0_prdlfe.txt Indicates the number of days a product can sit in Late
life) the store before is spoils. This value should only be
set for short life items that are at high risk of waste
due to spoilage.
Promotional dm0_pmsstasrc.txt Used for substituting a promotional item for a Early
Substitution End standard item during a promotion. Defines the end
Date (WH Source) of the promotional period.
Promotional dm0_pmsendsrc.txt Used for substituting a promotional item for a Early
Substitution Start standard item during a promotion. Defines the start
Date (WH Source) of the promotional period.
RDF Detail Alert sr0_rdfdtdmsk.txt Optional flag to load into AIP from forecasting Late-precritical
(for Store) system indicating there is an issue resolving in AIP,
the planning app, instead of the forecasting app.
RDF Detail Alert iprdfdtdaltv.txt Optional flag to load into AIP from the forecasting Late-precritical
(for Warehouse) system for resolving in AIP, the planning app,
instead of the forecasting app.
RDF Detail Alert sr0_rdfdtdcnt.txt Count of all RDF Detail alerts generated for a Late-precritical
Count SKU/store.
Sister Store sister_store.txt Defines a 'like store' for a New Store. When the file Early
is provided along with a future store open date the
system will copy the supply-chain of the existing
store to the new store.
Implementation Guide 79
Import Configuration Files
Value Name File Name Description of Value and Purpose for Loading Early, Late-
precritical, or
Late (critical)
Sister Warehouse sister_wh.txt Defines a 'like warehouse' for a New Warehouse. Early
When the file is provided along with a future
warehouse open date the system will copy the
supply-chain of the existing warehouse to the new
warehouse.
SKU Hierarchy item.txt Contains all SKUs that should exist in AIP. All files Early
(Product that contain a SKU intersection are dependent upon
Hierarchy) this file. SKUs begin to age when not
present/loaded from this file. If not yet purged, the
age of a SKU is reset if it is later re-loaded.
SKU Retail Price srx_prdrpr.txt SKU Retail Price interfaced via an external system Early
or custom RMS.
SPQ Commitment ipcmtmtde.txt This value can be entered in the workbooks or Early
Type Exception loaded (one or the other is expected). The SPQ
Commitment Type is only needed if Supplier
Purchase Quantities will be entered.
SPQ Order ipodcmti.txt This is the quantity that has been committed to be Early
Commit Quantity ordered/purchased from the supplier in a
particular week. The nature of the commitment is
defined in the SPQ commitment type. This value
can be entered manually in a workbook, or loaded.
Store Ad End ipadendi.txt Defines the end date of a Store Ad. Early
Date
Store Ad Start ipadstai.txt Defines the start date of a Store Ad. Early
Date
Store Adjusted sr0_adjsls.txt May be used in User Specified Allocations for Early
Sales Allocation on Rule Based Index.
Store Ads - Grand sr0_ad_go_.txt Determines which SKU/store/day has grand Early
Opening opening ads.
Store Ads - Inserts sr0_ad_irt.txt Indicates inserts ads exist for the listed Early
SKU/Store/Day.
Store Ads - Others sr0_ad_oth.txt Indicates ads classified as "other" non-standard ads Early
exist for the listed SKU/Store/Day
Store Ads - Run sr0_ad_rop.txt Indicates an Ad has been run as a result of extra Early
On Press Press for the listed SKU/Store/Day.
Store Ads sr0_ad_.txt Information to be viewed in the Workbooks. Flags Early
(advertisements) whether a SKU/store is included in any ads.
Store Average sr0_avgrosld_.txt Used to calculate the total Average Weekly Rate of Early
Weekly Rate of Sales across all stores served by a warehouse. The
Sale value is used when the warehouse replenishment
method is Factor ARS.
Store Current sr0_curinv_1.txt The quantity of inventory at the store that is Late
Inventory available to meet immediate demand.
Value Name File Name Description of Value and Purpose for Loading Early, Late-
precritical, or
Late (critical)
Store Hierarchy loc.txt Contains all Stores that should exist in AIP. All files Early
that contain a Store intersection are dependent
upon this file. Stores begin to age when not
present/loaded from this file. If not yet purged, the
age of a Store is reset if it is later re-loaded.
Store In-transit sr0_it_.txt In Transit quantities represent those orders which Late
Quantity have physically shipped to the destination.
Store Known sr0_knowndemand.txt Used in place of forecasted demand if loaded. Early
Demand
Store Loaded sr0_ss_ld_.txt Safety Stock for Loaded Safety Stock Dynamic Early
Safety Stock replenishment method.
Store On Order sr0_oo_.txt On Order Quantity represents those orders which Late
Quantity have been executed, but as of yet there is no
information regarding their physical shipment to
the destination.
Store Open Date sister_store.txt Defines the date that a new store is opening. This Early
date is used along with the Sister Store data to
perform a copy of the existing Store's supply-chain
to the new store. This value is also used for Walking
Store Lead Time automation.
Store RALT ipstrraltd.txt Contains the Default level intersection of Store Early
Default RATL. See Store RALT Global Default for full
explanation. The Default is not required. Default
values are needed if the Global Default is not the
desired value for a particular combination of
product and store.
Store RALT ipstrralte.txt Contains the Exception level intersection of Store Early
Exception RATL. See Store RALT Global Default for full
explanation. The Exception is not required.
Exception values are needed if the Global Default or
Default is not the desired value for a particular
combination of product and store.
Store RALT ipstrraltg.txt Contains the Receipt-to-Availability Lead Time Early
Global Default (RALT) to be applied when replenishing the
store(s). RALT is an integer representing the
number of days after receipt that an order is
available to start meeting demand. RALT should
currently be limited to a value of 0 or 1. The global
default is a higher level intersection than the default
and exception.
Store sr0_rplsubcde.txt This is for informational purposes only. It provides Early
Replenishment the planner more detailed information about how
Subtype Code the SKU is replenished at the store.
Store sr0_rplcde.txt This is for informational purposes only. It provides Early
Replenishment the planner information about how the SKU is
Type Code replenished at the store.
Implementation Guide 81
Import Configuration Files
Value Name File Name Description of Value and Purpose for Loading Early, Late-
precritical, or
Late (critical)
Store Trading sr0_tdgday.txt Used to calculate the In-Scope indicator for Alerts. Early
Days Typically a day will not be counted or considered
during alert calculations if it is not a trading day
(e.g. the business is not Open). By default all days
are trading days.
Supplier splr.txt Contains all Suppliers that should exist in AIP. All Early
Hierarchy files that contain a Supplier intersection are
dependent upon this file. Suppliers begin to age
when not present/loaded from this file. If not yet
purged, the age of a Supplier is reset if it is later re-
loaded.
Supplier Ship-to dmx_shpto.txt Provides a 'code' that maps the supplier to the types Early
of locations that it ships products to. The ship-to
mappings (configured in a table) are used to
automatically setup the supply-chain. If missing,
Automation will be unable to automatically setup
the supply chain for the new Supplier and its new
SKUs.
Supplier/SKU- dmx_prdspllks.txt Defines which SKU-pack Sizes are available from Early
pack size each Supplier.
Associations
Total Store ipavgrtslsi.txt Can be calculated by summing the values in Early
Average Rate of sr0_avgrosld_ for each store that is served by the
Sales warehouse, or loaded outright. It is used when the
warehouse replenishment method is Factor ARS.
Value Added dmx_vadprdasc.txt Used to substitute pre-priced/added value items Early
Product for standard items during a promotion. This file
Association contains the parent child relationship between the
SKUs.
Warehouse wr1_curinv.txt The quantity of inventory at the warehouse that is Late
Current Inventory available to meet immediate demand. This file is
required. A 0-byte 'empty' file may be provided in
place of actual values if inventory positions at the
warehouse are not available. Replenishment will
then fall into the 'contingency' processing for
missing warehouse inventory positions.
Warehouse whse.txt Contains all stockholding Warehouses that should Early
Hierarchy exist in AIP. All files that contain a Warehouse
intersection are dependent upon this file.
Warehouses begin to age when not present/loaded
from this file. If not yet purged, the age of a
Warehouse is reset if it is later re-loaded.
Warehouse ipslsi.txt Historic Weekly Sales are used in the Sales Week Early
Historical Weekly Range and Average Weekly Sales replenishment
Sales methods. The value will be used when warehouse
replenishment method is set to either of these
methods.
Value Name File Name Description of Value and Purpose for Loading Early, Late-
precritical, or
Late (critical)
Implementation Guide 83
Import Configuration Files
Value Name File Name Description of Value and Purpose for Loading Early, Late-
precritical, or
Late (critical)
Waste sr0_wstadj.txt This value contains the total of all Waste Late
Adjustments Adjustments made yesterday for the SKU at a
particular store. This value may be used for
calculating High Dissipation alerts. This value is
expected to be negative because waste decreases
inventory.
Week to Day ipfctwkprfd.txt Used to spread weekly forecasts to a daily level. Early
Forecast This file is needed when using weekly forecasts.
Percentage
Default
Week to Day ipfctwkprfe.txt Used to spread weekly forecasts to a daily level. Early
Forecast This file is only needed if an exception to the
Percentage default is needed.
Exception
Weekly Base Sales sr0_wkbsf_ld.txt A base line forecast at the weekly level that does not Late-precritical
Forecast include promotions. Used in calculated
Presentation Stock.
Weekly Forecast sr0_frclvl2_[1..n].txt The weekly forecast is optional for 3 reasons. 1. Late-precritical
Both a daily and weekly forecast are not required.
One can be provided and not the other (depending
on system configuration). 2. An updated forecast is
typically not reproduced daily, and is therefore not
required daily. 3. A forecast is not required if using
replenishment methods which use historical sales.
Weekly Forecast sr0_fcterrlvl2.txt Standard Deviation of the weekly forecast. Late-precritical
Standard
Deviation
Implementation Guide 85
Import Configuration Files
Setup
1. Add the data feed to the measdata_from_external.config configuration file. It is
located is in the following directory of the domain:
$AIPDOMAIN/interface/config/external/measdata_from_external.config
2. Remove the data feed from srp_rms_measures.config or wrp_rms_measures.config.
Also remove the data feed from inv_meas_ntier_prefix.config. These configuration
files are located in the following directories of the domain:
$AIPDOMAIN/interface/config/rms/srp_rms_measures.config
$AIPDOMAIN/interface/config/rms/wrp_rms_measures.config
$AIPDOMAIN/interface/config/rms/meas/inv_meas_ntier_prefix.config
Process
1. After the “early files” (as listed in earlyfiles.config) are placed into the domain, run
the appropriate aip_batch processes, as normal, to process external data.
2. After the “late files” (as listed in latefiles.config) are placed into the domain (in the
$INTERFACE_RMS_DIR directory), run the appropriate aip_batch steps, as normal,
to process inventory data.
Implementation Guide 87
7
AIP Calendar Hierarchy
AIP Calendar Data – clnd.dat or clnd.csv.dat
The table below provides information about the AIP clnd.dat file or clnd.csv.dat formats,
which contains AIP calendar hierarchy data.
For example:
MOD((TO_DATE('04/01/2007', 'MM/DD/YYYY') - TO_DATE('01/02/2000', 'MM/DD/YYYY')),
14) +1
2. Format the cycle day (01-14 for DOFN, 01-28 for DOFP) from the SQL statement
above and use it as the starting cycle day in the file.
3. Increment the DOFN value for each subsequent day to 14 then restart the count at 1.
Increment the DOFP value for each subsequent day to 28 then restart the count at 1.
This solution supports data sharing among these applications. Note that the data sharing
functionality is not dependent on the presence of all these applications. The defined data
sharing between any of the applications works for the entire suite as well as for a subset
of the applications.
Integration 91
Overview of the Integrated Inventory Planning Suite
From a Demand Forecasting Application (such as RDF) to a Replenishment System (such as AIP)
Sends time-phased demand forecasts (starting today and looking forward) at the
item/store level.
Sends the cumulative standard deviation of the forecast. This is needed for the
calculation of safety stock.
From APC RO to RO
Sends simulation information and statistics:
– Item/location/scenario level information
– Mean/variability/lead time grouping level information
– Mean/variability grouping/scenario level information
– Scenario level information
Implementation Guide 93
9
RMS Integration and Data Mapping
RMS to AIP Data
There are two types of data which RMS may provide to AIP:
Hierarchy data
Measure data
Hierarchy Data
Overview
The table below displays the hierarchy files that AIP may receive from RMS.
(†) RMS delivers only some fields in the location hierarchy. See below for details.
(*) These hierarchies go through a merge process with AIP-Oracle data prior to being
fully loaded into AIP-RPAS.
File Format
The Retail Extraction, Transformation, and Loading (RETL) tool, via the RMS-AIP
Transformation scripts, provides AIP with the file format displayed in the following
table.
Store 1 20 RMS
Store Description 21 60 RMS
Site 81 20 RMS
Site Description 101 40 RMS
Region 141 20 RMS
Region Description 161 40 RMS
Zone 201 20 RMS
Note: While RMS can extract pack items AIP does not
support RMS Formal Packs. All item related data must be for
the forecasted, selling SKU.
Mapping Table
The following table is used for mapping the RMS SKU to the AIP SKU pack size. This
information is sent in the item.txt file. (See comments above):
RMS SKU Order Multiple Pack Quantity AIP SKU Pack Size
Implementation Guide 97
RMS to AIP Data
Supplier 1 20 RMS
Supplier Description 21 40 RMS
Day RMS
DOFP AIP
DOFN AIP
DOW RMS
90 DOW Label AIP
DOS RMS
WOS AIP
WOY AIP
UMC AIP
UMC Label AIP
Month RMS
MOY AIP
Quarter RMS
Quarter Label AIP
Year RMS
Measure Data
Overview
AIP receives the following measure files from RMS:
Implementation Guide 99
RMS to AIP Data
Note: The last files, with *, are files coming from RMS to
AIP-Oracle and are NOT loaded into AIP-RPAS.
File Format Including Mapping to AIP RPAS Measure Format”) describes the mapping
between the RMS-AIP Transformation output format and the RPAS measure format. AIP
RPAS batch scripts contain logic to transform the data into the RPAS measure loadable
format.
When moving an integration data source from RMS to a non-RMS external system, as
described in Chapter 6, “AIP RPAS Configurations,” it is assumed that the RMS-AIP
Transformation process will not be run. Therefore, it is the user’s responsibility to create
the data files in the RPAS measure loadable format, as described in the second set of file
format tables, below. The “AIP Field”, “Start” and “Width” columns make up the RPAS
measure loadable format.
File Formats
The Retail Extraction, Transformation, and Loading (RETL) tool provides AIP with the
file formats displayed in the tables below.
Commodity-Supplier Links
Direct Suppliers
Note: RMS can also send the Store Current Inventory file in
partitions. For example, AIP interface code can handle
sr0_curinv_[1..n].txt where n is the partition number. The
data will always arrive from RMS RETL extract with at least
one partition, namely, sr0_curinv_1.txt.
On Orders Data
In Transit Data
Warehouse 1 20 Store 1 20
RMS SKU 21 20 Warehouse 21 20
Order Multiple 41 4 SKU 41 20
Store Promo Subs Start Date 45 8 Store Promo Subs Start 61 8
Date
Warehouse 1 20 Store 1 20
RMS SKU 21 20 Warehouse 21 20
Order Multiple 41 4 SKU 41 20
Store Promo. Subs. Date 45 8 Store Promo. Subs. Date 61 8
Supplier 1 20 Supplier 1 20
RMS SKU 21 20 Commodity-Pack Size 21 20
Order Multiple 41 4
SKU Supplier Links 45 1 Commodity-Supplier Links 41 1
Direct Suppliers
Supplier 1 20 Supplier 1 20
Direct Supplier 21 1 Direct Supplier 21 1
Store 1 20 Store 1 20
RMS SKU 21 20 SKU 21 20
Store current 41 8 Store Current Inventory 41 8
inventory
Day 1 9 Day 1 9
Store 10 20 Store 10 20
RMS SKU 30 20 SKU 30 20
Order Multiple 50 4
Store In Transits 54 8 Store Intransits 50 8
Day 1 9 Day 1 9
Store 10 20 Store 10 20
RMS SKU 30 20 SKU 30
Order Multiple 50 4
Store Orders 54 8 Store Orders 50 8
Day 1 9 Day 1 9
RMS SKU 10 20 SKU 10 20
Order Multiple 30 4
Store Product Life 34 8 Store Product Life 30 8
Warehouse 1 20 Warehouse 1 20
RMS SKU 21 20 Commodity-Pack Size 21 20
Order Multiple 41 4
Current Warehouse 45 8 Current Warehouse 41 8
Inventory Inventory
On Orders Data
Day 1 9 Day 1 9
Supplier 10 20 Supplier 10 20
Warehouse 30 20 Warehouse 30 20
RMS SKU 50 20 Commodity-Pack Size 50 20
Order Multiple 70 4
On Orders 74 8 On Orders 70 8
In Transit Data
Day 1 9 Day 1 9
Supplier 10 20 Supplier 10 20
Warehouse 30 20 Warehouse 30 20
RMS SKU 50 20 Commodity-Pack Size 50 20
Order Multiple 70 4
In Transit 74 8 In Transit 70 8
Day 1 9 Day 1 9
Warehouse 10 20 Warehouse 10 20
RMS SKU 30 20 Commodity-Pack Size 30 20
Order Multiple 50 4
Allocations in the Well 54 8 Allocations in the Well 50 8
Day 1 9 Day 1 9
Warehouse 10 20 Warehouse 10 20
RMS SKU 30 20 Commodity-Pack Size 30 20
Order Multiple 50 4
Transfers in the Well 54 8 Transfers in the Well 50 8
Day 1 9 Day 1 9
Store 10 20 Store 10 20
RMS SKU 30 20 SKU 30 20
Daily Sales 50 8 Daily Sales 50 8
Mapping Overview
Some of the data RMS RETL Extracts generate require transformation by an RMS-AIP
Transform Script. The RMS RETL Extracts and the RMS-AIP Transform Scripts which
transform them are listed below. Some of these RMS RETL Extracts are inputs to multiple
transform scripts to create different AIP input files. All of the transformations are for data
files that are loaded into AIP-RPAS.
Note that the RMS RETL Extracts listed below correspond to the RMS 13.1.2 name set.
Measure Data
Overview
AIP receives the following measure files from RDF:
iprdfdtdaltv.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name iprdfdtdaltv
Source Object Name iprdfdtdaltv.txt Target Object Database data/rdfdtdalt
Required/Optional Optional Target Object Load dstk_sku
Intersection
STR Store 1 20
SKU SKU 21 20
Value RDF Detail Alert 41 1
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Note that the RDF extract will only contain stores even though AIP reads the store into
the destination stocking point dimension which can hold warehouses, stores or suppliers.
Example of iprdfdtdaltv.txt Extract File Format:
S303 100048001 1
S303 100049004 1
sr0_rdfdtdmsk.txt
Data Element Details
Measure RDF Detail Alert Mask Contains Store, SKU and RDF
Detail Alert Mask flag.
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_rdfdtdmsk
Source Object Name sr0_rdfdtdmsk.txt Target Object Database data/sr0_rdfdtdmsk
Required/Optional Optional Target Object Load str_sku_
Intersection
STR Store 1 20
SKU SKU 21 20
Value RDF Detail Alert Mask 41 1
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_rdfdtdmsk.txt Extract File Format:
S441090 100048001 1
S402 100048001 1
sr0_rdfdtdcnt.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_rdfdtdcnt
Source Object Name sr0_rdfdtdcnt.txt Target Object Database data/sr0_rdfdtdcnt
Required/Optional Optional Target Object Load str_sku_
Intersection
STR Store 1 20
SKU SKU 21 20
Value RDF Detail Alert Count 41 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_rdfdtdcnt.txt Extract File Format:
S303 118525 5
sr0_fcterrlvl1.txt
Data Element Details
Measure Daily Store Forecast Standard Contains Store, SKU and Store
Deviation Forecast Standard Deviation
value.
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_fcterrlvl1
Source Object Name sr0_fcterrlvl1.txt Target Object Database data/sr0_fcterrlvl1
Required/Optional Optional Target Object Load str_sku
Intersection
STR Store 1 20
SKU SKU 21 20
Value Daily Store Forecast Standard Deviation 41 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_fcterrlvl1.txt Extract File Format:
S441090 100048001 1.000000
sr0_fcterrlvl2.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_fcterrlvl2
Source Object Name sr0_fcterrlvl2.txt Target Object Database data/sr0_fcterrlvl2
Required/Optional Optional Target Object Load sku_str_
Intersection
Source Fields Source Field Description Field Start Position Field Width
STR Store 1 20
SKU SKU 21 20
VALUE Weekly Store Forecast Standard Deviation 41 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive).
Example of sr0_fcterrlvl2.txt Extract File Format:
S441090 100048001 1.000000
sr0_frclvl1_[1..n].txt
Data Element Details
Measure Daily Store Demand Forecast Contains Day, Store, SKU and Daily Store
Demand Forecast value.
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_frclvl1
Source Object Name sr0_frclvl1_[1..n].txt Target Object Database data/sr0_frclvl1
Required/Optional Optional Target Object Load day_str_sku
Intersection
DAY Day 1 9
STR Store 10 20
SKU SKU 30 20
VALUE Daily Store Demand Forecast 50 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive)and all Day values should be
prefixed with a “D” (case sensitive). Although the intersection is at day, AIP is expecting
the entire forecast for the week to be on one day of that week. RDF places the week's
forecast on the last day of the week.
Example of sr0_frclvl1_[1..n].txt Extract File Format:
D20060420S411 100049004 1000
Note: The client may partition this data file for space or size
considerations, e.g. sr0_frclvl1_1.txt, sr0_frclvl1_2.txt,
sr0_frclvl1_3.txt, etc.
sr0_frclvl2.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_frclvl2
Source Object Name sr0_frclvl2_[1..n].txt Target Object Database data/sr0_frclvl2
Required/Optional Optional Target Object Load day_str_sku
Intersection
DAY Day 1 9
STR Store 10 20
SKU SKU 30 20
Value Weekly Store Demand Forecast 50 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive) and all Day values should be
prefixed with a “D” (case sensitive).
Example of sr0_frclvl2_[1..n].txt Extract File Format:
D20060401 100044001 1000
Note: The client may partition this data file for space or size
considerations, e.g. sr0_frclvl2_1.txt, sr0_frclvl2_2.txt,
sr0_frclvl2_3.txt, etc.
Hierarchy Data
The table below displays the hierarchy files that AIP receives from External System:
Measure Data
The table below displays the measure files AIP receives from External System.
had.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name had.txt
Source Object Name had.txt Target Object Database Global
Required/Optional Optional Target Object Load N/A
Intersection
Ad Ad 1 20
Ad Label Ad Description 21 40
Ad Ad String "A23456789100ABCDE00Q"
Formatting Conditions
None.
Example of had.txt Extract File Format:
A23456789100ABCDE00QNEW ADVERTISEMENT AA
B23456789100ABCDE00QNEW ADVERTISEMENT BB
intv.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name intv.txt
Source Object Name intv.txt Target Object Database Global
Required/Optional Optional Target Object Load N/A
Intersection
Interval Interval 1 20
Interval Description Interval Description 21 40
Formatting Conditions
None.
Example of intv.txt Extract File Format:
A23456789100ABCDE00QNEW INTERVAL AA
B23456789100ABCDE00QNEW INTERVAL BB
default_wh.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measures &
Oracle Data Point
Source Object Type Fixed Length Text File Target Object Name dmx_defwh_ &
dmx_defwh_csc &
Warehouse Type
Source Object Name default_wh.txt Target Object Database data/dmx_defwh_ &
data/dmx_defwh_csc &
Oracle Database
Required/Optional Optional Target Object Load str_
Intersection
STR Store 1 20
VALUE 1 Default Warehouse 21 20
VALUE 2 Default Warehouse Customer Service 41 20
Center
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Warehouses should be prefixed with a “W” (case sensitive) and all Stores should be
prefixed with an “S” (case sensitive).
Example of default_wh.txt Extract File Format:
S348 W1090 W1090
S402 W1105 W1150
Load Notes
AIP RPAS batch processes split this data file into two flat files which are loaded into two
AIP RPAS measures. Then the original file is packaged for transfer to and load by AIP
Oracle batch processes.
direct_store_format_pack_size.txt
Data Element Details
N/A Direct Store Format Pack Size Contains the pack size that
This information is not should be ordered when the store
loaded into an RPAS is ordering the SKU from the
measure. It is loaded into an Direct Supplier.
Oracle table only.
Data Origin System External Systems Target Object Type Oracle Data point
Source Object Type Fixed Length Text File Target Object Name Direct Store Format
Pack Size
Source Object Name direct_store_format_pack_size.txt Target Object Database Oracle DB
Required/Optional Optional Target Object Load N/A
Intersection
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive).
Example of direct_store_format_pack_size.txt file:
1 100053003 36 V505 2005010120051201
direct_store_pack_size.txt
Data Element Details
Data Origin System External Systems Target Object Type Oracle Data Point
Source Object Type Fixed Length Text File Target Object Name Direct Store Pack Size
Source Object Name direct_store_pack_size.txt Target Object Database Oracle Database
Required/Optional Optional Target Object Load N/A
Intersection
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive) and all Stores should
be prefixed with an “S” (case sensitive).
Example direct_store_pack_size.txt file:
S303 100053003 1 V505 2005010120051201
dm0_ofseffdt_.txt
A custom transformation must be created to properly format this file before it can be
loaded. The transformation should drop the Order multiple and only retain the single
unique on sale date and off sale date for the SKU/Store.
Data Origin System External Systems Target Object Type RPAS Measure
Source Table(s)/File(s) Fixed Length Text File Target Object Name Off-sale Effective Date
Source Object Name dm0_ofseffdt_.txt Target Object Database data/dm0_ofseffdt_
Required/Optional Required Target Object Load str_sku
Intersection
STR Store 1 20
RMS_SKU RMS SKU 21 20
ORDM Order Multiple 41 4
Value Off Sale Effective Date 45 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example dm0_ofseffdt_ file:
S303 100072001 20070101
S309 100072001 20070101
S348 100072001 20070101
S402 100072001 20070101
S411 100072001 20070101
dm0_onseffdt_.txt
A custom transformation must be created to properly format this file before it can be
loaded. The transformation should drop the Order multiple and only retain the single
unique on sale date and off sale date for the SKU/Store.
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fix Length Text File Target Object Name On-sale Effective Date
Source Object Name dm0_onseffdt_.txt Target Object Database data/dm0_onseffdt_
Required/Optional Required Target Object Load str_sku
Intersection
STR Store 1 20
RMS_SKU RMS SKU 21 20
ORDM Order Multiple 41 4
Value On Sale Effective Date 45 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example dm0_onseffdt_ file:
S303 100072001 20050101
S309 100072001 20050101
S348 100072001 20050101
S402 100072001 20050101
S411 100072001 20050101
dmx_pcktyp.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name dmx_pcktyp
Source Object Name dmx_pcktyp.txt Target Object Database data/dmx_pcktyp
Required/Optional Optional Target Object Load skps
Intersection
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
Even though the width of the value field is 24, only 6 characters can be utilized by this
field. The export of this data to AIP-Oracle contains only 6 characters of value.
Example of dmx_pcktyp.txt File:
100033002_1 EACH
100033002_4 CASE
dmx_pprsts.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name dmx_pprsts
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
None.
Example of dmx_pprsts.txt Extract File Format:
100033002_1 12
100033002_4 15
dmx_shpto_.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name dmx_shpto_
Source Object Name dmx_shpto_.txt Target Object Database data/dmx_shpto_
Required/Optional Required Target Object Load splr
Intersection
Supplier Supplier 1 20
Value Ship To 21 24
Target Data Field Name Target Field Description Data Type Condition/Format
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive).
Even though the width of the value field is 24, only 6 characters can be utilized by this
field. The export of this data to AIP-Oracle contains only 6 characters of value.
Example of dmx_shpto_.txt Extract File Format:
V166 CS_RG
V505 XD_GS
ipadrltntsi.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name ipadrltntsi
Source Object Name ipadrltntsi.txt Target Object Database data/adrltnts
Required/Optional Optional Target Object Load week_skug
Intersection
WEEK Week 1 8
SKUG SKU Group 9 20
VALUE Ad/Rollout Notes 29 24
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Weeks should be prefixed with “W” (case sensitive).
Example of ipadrltntsi.txt Extract File Format:
W44_2006100117118A Example Notes
ipadendi.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name ipadendi
Source Object Name ipadendi.txt Target Object Database data/ad
Required/Optional Optional Target Object Load ad
Intersection
AD Advertisement 1 20
Value Store Ad End Date 21 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
None.
Example of ipadendi.txt Extract File Format:
201CU50505 20060225
ipadstai.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name ipadstai
Source Object Name ipadstai.txt Target Object Database data/ad
Required/Optional Optional Target Object Load ad
Intersection
AD Advertisement 1 20
VALUE Store Ad Start Date 21 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
None.
Example of ipadstai.txt Extract File Format:
201CU50505 20060225
ipavgrtslsi.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name ipavgrtslsi
Source Object Name ipavgrtslsi.txt Target Object Database data/avgrtsls
Required/Optional Optional Target Object Load dstk_sku
Intersection
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive).
Example of ipavgrtslsi.txt Exact File Format:
W1090 100048001 123.5678
ipcmtmtde.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name ipcmtmtde
Source Object Name ipcmtmtde.txt Target Object Database data/cmtmtd
Required/Optional Optional Target Object Load week_dstk_sku
Intersection
WEEK Week 1 8
DSTK Destination Stocking Point 9 20
SKU SKU 29 20
VALUE SPQ Commitment Type Exception 49 24
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive). All Weeks should be prefixed with a “W” (case sensitive).
Example of ipcmtmtde.txt Extract File Format:
W25_2005S510 100033002 1
ipfctwkprfd.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name ipfctwkprfd
Source Object Name ipfctwkprfd.txt Target Object Database data/ipfctwkprfd
Required/Optional Optional Target Object Load dow_chn_dept
Intersection
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
None.
Example of ipfctwkprfd.txt Extract File Format:
MON 1 5 0.14
TUE 1 5 0.14
ipfctwkprfe.txt
Data Element Details
Measure Store Week to Day Forecast Contains day, chain, subclass and
Percentage Override (Un- Week to day forecast percentage
Normalized) override value.
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name ipfctwkprfe
Source Object Name ipfctwkprfe.txt Target Object Database data/ipfctwkprfe
Required/Optional Optional Target Object Load day_chn_scls
Intersection
DAY Day 1 9
CHN Chain 10 20
SCLS Subclass 30 20
VALUE Store Week to Day Forecast Percentage 50 8
Override
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
None.
Example of ipfctwkprfe.txt Extract File Format:
D200901011 5 0.14
D200901021 5 0.14
iphldbckqtyi.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name iphldbckqtyi
Source Object Name iphldbckqtyi.txt Target Object Database data/hldbckqty
Required/Optional Optional Target Object Load day_dstk_sku
Intersection
DAY Day 1 9
DSTK Destination Stocking Point 10 20
SKU SKU 30 20
VALUE Hold Back Quantity 50 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive).
Example of iphldbckqtyi.txt Extract File Format:
D20050820W1090 100048001 280
ipldssi.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name ipldssi
Source Object Name ipldssi.txt Target Object Database data/ldss
Required/Optional Optional Target Object Load dstk_sku
Intersection
Source Fields Source Field Description Field Start Position Field Width
Target Data Field Name Target Field Description Target Field Data Type Condition/Format
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive).
Example of ipldssi.txt Extract File Format:
W1090 100048001 520.5000
W3066 100049004 520.5000
ipodcmti.txt
Data Element Details
Measure SPQ Order Commit Contains the 'Fixed' or 'Capped' Purchase Quantity agreed upon
Quantity with the Vendor.
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name ipodcmti
Source Object Name ipodcmti.txt Target Object Database data/odcmt
Required/Optional Optional Target Object Load Intersection week_sstk_skug
Source Fields Source Field Description Field Start Position Field Width
Target Data Field Name Target Field Description Target Field Data Type Condition/Format
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive).
Example of ipodcmti.txt Extract File Format:
W25_2005V1001 100055017A 1200.000
W26_2005V1001 100055017A 1200.000
iprplstcdi.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name iprplstcdi
Source Object Name iprplstcdi.txt Target Object Database data/rplstcd
Required/Optional Optional Target Object Load dstk_sku
Intersection
Target Data Field Name Target Field Description Data Type Condition/Format
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive).
Example of iprplstcdi.txt Extract File Format:
W1090 100046031 H
W3066 100033002 O
iprpltcdi.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name iprpltcdi
Source Object Name iprpltcdi.txt Target Object Database data/rpltcd
Required/Optional Optional Target Object Load dstk_sku
Intersection
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive).
Example of iprpltcdi.txt Extract File Format:
W1090 100046031 A
W3066 100033002 O
ipslsi.txt
Data Element Details
Data Origin System External Systems Target Object Type Online Data Point
Source Object Type Fixed Length Text File Target Object Name ipslsi
Source Object Name ipslsi.txt Target Object Database data/sls
Required/Optional Optional Target Object Load week_dstk_sku
Intersection
WEEK Week 1 8
DSTK Warehouse 9 20
SKU SKU 29 20
Value Historical Weekly Sales 49 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive).
Example of ipslsi.txt Extract File Format:
W31_2005W1090 100076002 105.0000
ipttlhlstki.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name ipttlhlstki
Source Object Name ipttlhlstki.txt Target Object Database data/ttlhlstk
Required/Optional Optional Target Object Load day_dstk_skps
Intersection
Source Fields Source Field Description Field Start Position Field Width
DAY Day 1 9
DSTK Destination Stocking Point 10 20
SKPS Commodity-Pack Size 30 20
VALUE Total Held Stock 50 8
Target Data Field Name Target Field Description Target Field Data Type Condition/Format
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive).
Example of ipttlhlstki.txt Extract File Format:
D20060123W1090 118525_1 2000
ipwhhldcpci.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name ipwhhldcpci
Source Object Name ipwhhldcpci.txt Target Object Database data/whhldcpc
Required/Optional Optional Target Object Load dstknwgp
Intersection
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive).
Example of ipwhhldcpci.txt Extract File Format:
W4110 001 1000
item_attribute.txt
Data Element Details
Data Origin System External Systems Target Object Type Online Data Point
Source Object Type Fixed Length Text File Target Object Name Item Attributes
Source Object Name item_attribute.txt Target Object Database Online Database
Required/Optional Optional Target Object Load N/A
Intersection
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive).
Example of item_attribute.txt Extract File Format:
100048001 1 0 WHSED Y
100049004 1 0 WHSED Y
item_attribute_type.txt
Data Element Details
Measure Item Type Contains SKU, Order Multiple, Pack Quantity, Attribute Type,
Attribute Value.
Data Origin System External Systems Target Object Type Online Data Point
Source Object Type Fixed Length Text File Target Object Name Item Attribute Types
Source Object Name item_attribute_type.txt Target Object Database Online Database
Required/Optional Optional Target Object Load Intersection N/A
Target Data Field Name Target Field Description Data Type Condition/Format
Attribute Type Description Attribute Type Description String "Warehouse Indicator "
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive).
Example of item_attribute_type.txt Extract File Format:
WHSED Warehouse Indicator
VKSTK Viking Stocked Indicator
rmse_order_purge.dat
Data Element Details
N/A Purged Purchase Order Numbers Contains AIP purchase order numbers
This data is not loaded into an that have been purged from the order
RPAS measures. It is loaded into execution system. The PO numbers can
an Oracle table. be assigned to new POs.
Data Origin System External Systems Target Object Type Oracle Table
Source Object Type Fixed Length Text File Target Object Name available_PO_num
Source Object Name rmse_order_purge.dat Target Object Database AIP Online Schema
Required/Optional Optional Target Object Load N/A
Intersection
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
None
Example of rmse_order_purge.dat Extract File Format:
123456
sister_store.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measures &
Online Data Point
Source Object Type Fixed Length Text File Target Object Name dmx_sst &
dmx_stropndt_ &
Sister Store
Source Object Name sister_store.txt Target Object Database data/dmx_sst &
data/dmx_stropndt &
Online Database
Required/Optional Optional Target Object Load str &
Intersection str &
N/A
Source Fields Source Field Description Field Start Position Field Width
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive).
Example of sister_store.txt Extract File Format:
S303 S402 20051201
S348 S309 20051201
Load Notes
AIP RPAS Batch process split this data file into two flat files which are loaded into two
AIP RPAS measures. The original data file is exported to AIP Oracle and loaded by AIP
Oracle Batch processes.
sister_wh.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measures &
Online Data Point
Source Object Type Fixed Length Text File Target Object Name dmx_swh &
dmx_wh_opndt_ &
Sister Warehouse
Source Object Name sister_wh.txt Target Object Database data/dmx_swh &
data/dmx_wh_opndt_ &
Online Database
Required/Optional Optional Target Object Load wh &
Intersection wh &
N/A
Source Fields Source Field Description Field Start Position Field Width
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive).
Example of sister_wh.txt Extract File Format:
W1090 W1091 20051201
W1105 W1170 20051201
Load Notes
AIP RPAS Batch process split this data file into two flat files which are loaded into two
AIP RPAS measures. The original data file is exported to AIP Oracle and loaded by AIP
Oracle Batch processes.
sr0_ad_.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_ad_
Source Object Name sr0_ad_.txt Target Object Database data/sr0_ad_
Required/Optional Optional Target Object Load str_sku_ad
Intersection
STR Store 1 20
SKU SKU 21 20
AD Advertisement 41 20
Value Store Ads 61 1
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_ad_.txt Extract File Format:
S348 100055017 IC0604051 1
sr0_ad_go_.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_ad_go_
Source Object Name sr0_ad_go_.txt Target Object Database data/sr0_ad_go_
Required/Optional Optional Target Object Load day_str_sku
Intersection
DAY Day 1 9
STR Store 10 20
SKU SKU 30 20
VALUE Store Ads Grand Opening 50 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_ad_go_.txt Extract File Format:
D20050801S348 100055017 123.5678
sr0_ad_irt.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_ad_irt
Source Object Name sr0_ad_irt.txt Target Object Database data/sr0_ad_irt
Required/Optional Optional Target Object Load day_str_sku
Intersection
DAY Day 1 9
STR Store 10 20
SKU SKU 30 20
VALUE Store Ads Inserts 50 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_ad_irt.txt Extract File Format:
D20050801S348 100055017 1.000000
sr0_ad_oth.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_ad_oth
Source Object Name sr0_ad_oth.txt Target Object Database data/sr0_ad_oth
Required/Optional Optional Target Object Load day_str_sku
Intersection
DAY Day 1 9
STR Store 10 20
SKU SKU 30 20
VALUE Store Ads Others 50 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_ad_oth.txt Extract File Format:
D20050801S348 100055017 1
sr0_ad_rop.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_ad_rop
Source Object Name sr0_ad_rop.txt Target Object Database data/sr0_ad_rop
Required/Optional Optional Target Object Load day_str_sku
Intersection
DAY Day 1 9
STR Store 10 20
SKU SKU 30 20
Value Store Ads run on press 50 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_ad_rop.txt Extract File Format:
D20050801S348 100055017 1.000000
sr0_adjsls.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_adjsls
DAY Day 1 9
STR Store 10 20
SKU SKU 30 20
Value Store Adjusted Sales 50 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_adjsls.txt Extract File Format:
D20050820S441105 100057004 5
sr0_avgrosld_.txt
Data Element Details
Measure Store Average Weekly Rate of Contains Store, SKU and Store
Sale Loaded average week rate of sale loaded.
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_avgrosld_
Source Object Name sr0_avgrosld_.txt Target Object Database data/sr0_avgrosld_
Required/Optional Optional Target Object Load str_sku
Intersection
STR Store 1 20
SKU SKU 21 20
VALUE Store Average Weekly Rate of Sale 41 8
Loaded
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_avgrosld_.txt Extract File Format:
S441090 100076002 200.0000
sr0_co_.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_co_
Source Object Name sr0_co_.txt Target Object Database data/sr0_co_
Required/Optional Optional Target Object Load day_str_sku
Intersection
DAY Day 1 9
STR Store 10 20
SKU SKU 30 20
VALUE Store Customer Orders 50 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_co_.txt Extract File Format:
D20050820S441105 100057004 1
sr0_dyscsls.txt
Data Element Details
Measure Daily Short Code Sales Contains Day, Store, SKU, and
Daily Short Code Sales quantity.
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_dyscsls
Source Object Name sr0_dyscsls.txt Target Object Database data/sr0_dyscsls
Required/Optional Optional Target Object Load day_str_sku
Intersection
DAY Day 1 9
STR Store 10 20
SKU SKU 30 20
Value Daily Short Code Sales 50 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_dyscsls.txt Extract File Format:
D20060125S303 118525 123.4500
sr0_expwrtoff.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_expwrtoff
Source Object Name sr0_expwrtoff.txt Target Object Database data/sr0_expwrtoff
Required/Optional Optional Target Object Load day_str_sku
Intersection
DAY Day 1 9
STR Store 10 20
SKU SKU 30 20
VALUE Store Expected Write-Off 50 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_expwrtoff.txt Extract File Format:
D20050801S303 100055009 5
sr0_hstls_.txt
Data Element Details
Measure Store Historical Lost Sales Contains Day, Store, SKU and
Store historical lost sales value.
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_hstls_
Source Object Name sr0_hstls_.txt Target Object Database data/sr0_hstls_
Required/Optional Required Target Object Load day_str_sku
Intersection
DAY Day 1 9
STR Store 10 20
SKU SKU 30 20
VALUE Store Historical Lost Sales 50 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_hstls_.txt Extract File Format:
D20050801S303 100055009 1000.500
sr0_invadj.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_invadj
Source Object Name sr0_invadj.txt Target Object Database data/sr0_invadj
Required/Optional Optional Target Object Load day_str_sku
Intersection
DAY Day 1 9
STR Store 10 20
SKU SKU 30 20
Value Inventory Adjustments 50 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_invadj.txt Extract File Format:
D20060124S303 163460 123.4500
sr0_knowndemand.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_knowndemand
Source Object Name sr0_knowndemand.txt Target Object Database data/sr0_knowndemand
Required/Optional Optional Target Object Load day_str_sku
Intersection
DAY Day 1 9
STR Store 10 20
SKU SKU 30 20
VALUE Store Known Demand 50 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_knowndemand.txt Extract File Format:
D20050801S303 100055009 1000.500
sr0_rplcde.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_rplcde
Source Object Name sr0_rplcde.txt Target Object Database data/sr0_rplcde
Required/Optional Optional Target Object Load str_sku
Intersection
Source Fields Source Field Description Field Start Position Field Width
STR Store 1 20
SKU SKU 21 20
Value Store Replenishment Type Code 41 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_rplcde.txt Extract File Format:
S303 100046031 A
S348 100033002 M
sr0_rplsubcde.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_rplsubcde
Source Object Name sr0_rplsubcde.txt Target Object Database data/sr0_rplsubcde
Required/Optional Optional Target Object Load str_sku
Intersection
STR Store 1 20
SKU SKU 21 20
Value Store Replenishment Subtype Code 41 8
Target Data Field Name Target Field Description Data Type Condition/Format
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_rplsubcde.txt Extract File Format:
S303 100046031 A
S348 100033002 J
sr0_ss_ld_.txt
Data Element Details
Measure Store Loaded Safety Stock Contains Store, SKU and Loaded
Safety Stock value.
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_ss_ld_
Source Object Name sr0_ss_ld_.txt Target Object Database data/sr0_ss_ld_
Required/Optional Optional Target Object Load str_sku
Intersection
Source Fields Source Field Description Field Start Position Field Width
STR Store 1 20
SKU SKU 21 20
VALUE Store Loaded Safety Stock Value 41 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_ss_ld_.txt Extract File Format:
S441090 100048001 155.0000
S348 100049004 155.0000
sr0_tdgday.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_tdgday
Source Object Name sr0_tdgday.txt Target Object Database data/ssldat
Required/Optional Optional Target Object Load STR_day_
Intersection
Source Fields Source Field Description Field Start Position Field Width
DAY Day 1 9
STR Store 10 20
Value Store Trading Days 30 1
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive).
Example of sr0_tdgday.txt Extract File Format:
D20050620S303 1
D20050621S303 1
sr0_wkbsf_ld.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_wkbsf_ld
Source Object Name sr0_wkbsf_ld.txt Target Object Database data/sr0_wkbsf_ld
Required/Optional Optional Target Object Load week_str_sku
Intersection
WEEK Week 1 8
STR Store 9 20
SKU SKU 29 20
Value Loaded Weekly Base Sales Forecast 49 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_wkbsf_ld.txt Extract File Format:
W05_2006S303 118525 1.00000
sr0_wstadj.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name sr0_wstadj
Source Object Name sr0_wstadj.txt Target Object Database data/sr0_wstadj
Required/Optional Optional Target Object Load day_str_sku
Intersection
DAY Day 1 9
STR Store 10 20
SKU SKU 30 20
Value Waste Adjustments 50 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
All Stores should be prefixed with an “S” (case sensitive).
Example of sr0_wstadj.txt Extract File Format:
D20060126S303 168941 123.4500
srx_poidst.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name srx_poidst
Source Object Name srx_poidst.txt Target Object Database data/srx_poidst
Required/Optional Optional Target Object Load seq_int_
Intersection
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
None.
Example of srx_poidst.txt Extract File Format:
0016 121000 33.3
srx_prdrpr.txt
Data Element Details
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name srx_prdrpr
Source Object Name srx_prdrpr.txt Target Object Database data/srx_prdrpr
Required/Optional Optional Target Object Load week_cmpn_sku
Intersection
WEEK Week 1 8
COMPANY Company 9 20
SKU SKU 29 20
Value SKU Retail Price 49 8
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
None.
Example of srx_prdrpr.txt Extract File Format:
W32_20051 100048001 6.460000
W32_20051 100048001 6.460000
store_format_pack_size.txt
Data Element Details
Measure Store Format Pack Size Contains Store Format, AIP SKU,
pack size, Warehouse, start date
& end date.
Data Origin System External Systems Target Object Type RPAS Measure
Source Object Type Fixed Length Text File Target Object Name Store Format Pack Size
Source Object Name store_format_pack_size.txt Target Object Database Online Database
Required/Optional Optional Target Object Load N/A
Intersection
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Filtering Conditions
The SKU-pack size should have an AIP ranging status of ‘Profile Ranged,’ ‘Exception
Ranged,’ or ‘Pending De-ranged’ at the warehouse before it is loaded into AIP as the
store ordering pack size.
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive).
Example of store_format_pack_size.txt Extract File Format:
1 100052001 36 W3066 2005010120051201
store_pack_size.txt
Data Element Details
Data Origin System External Systems Target Object Type Online Data Point
Source Object Type Fixed Length Text File Target Object Name Store Pack Size
Source Object Name store_pack_size.txt Target Object Database Online Database
Required/Optional Optional Target Object Load N/A
Intersection
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Filtering Conditions
The SKU-pack size should have an AIP ranging status of ‘Profile Ranged,’ ‘Exception
Ranged,’ or ‘Pending De-ranged’ at the warehouse before it is loaded into AIP as the
store ordering pack size.
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), all Warehouses should
be prefixed with a “W” (case sensitive) and all Stores should be prefixed with an “S”
(case sensitive).
Example of store_pack_size.txt Extract File Format:
S303 100052001 1 W3066 2005010120051201
sku_cost.dat
Data Origin System External Systems Target Object Type Oracle Database
Source Object Type Fixed Length Text File Target Object Name commodity_cost
Source Object Name sku_cost.dat Target Object Database N/A
Required/Optional Optional Target Object Load N/A
Intersection
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Filtering Conditions
None.
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive), and all Warehouses
should be prefixed with a “W” (case sensitive).
Example of sku_cost.dat Extract File Format:
“100052001 V11111 W36 15.9900 “
sku_weight_volume.dat
Data Element Details
Measure SKU Weight and Volume Contains the unit weight and/or
volume of a SKU from a supplier.
Data Origin System External Systems Target Object Type Oracle Database
Source Object Type Fixed Length Text File Target Object Name commodity_weight_volume
Source Object Name sku_weight_volume.dat Target Object Database N/A
Required/Optional Optional Target Object Load N/A
Intersection
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Filtering Conditions
None.
Formatting Conditions
All Supplier values should be prefixed with a “V” (case sensitive).
Example of commodity_weight_volume.dat Extract File Format:
“100052001 V11111 3.0000 0.9560 “
ONL_INBOUND_DIR/ ONL_SCHEMA_DIR/
sku_weight_volume.dat commodity_weight_volume.xml
temp.v
AIP Oracle
Schema
commodity_weight_volume
STR_MINMAX
Data Element Details
RO Integration 203
Store Measure Data
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
STR_DYNAMIC
Data Element Details
Measure Store Service Measure at the SKU/Store/Day level; Used in Dynamic and Poisson Repl
Level Method. Specifies the target percentage level for customer service of a given
item at a store. For example, if the goal is to carry enough safety stock to
maintain a 90% customer service level, .90 should be entered.
Measure Store Inventory Measure at the SKU/Store/Day level; Used to specify number of DAYS of
Selling Days forecasted quantity to be used when calculating the Receive Up To Level
(RUTL). Used in Hybrid, Dynamic, Poisson and Loaded SS Dynamic
Replenishment Methods. For example, to ensure an order will contain at least
14 days of supply, 14 would be entered. NOTE: The GREATER of Inventory
Selling Days and Review Time will be used in the RUTL calculation.
Measure Store Repl Measure at the SKU/Store/Day level; The Replenishment Method determines
Method the type of calculations that will be used in generating a store replenishment
plan. The default is No Replenishment.
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
STR_TIMESUPPLY
Data Element Details
Measure Store Min Time Measure at the SKU/Store/Day level; Used in Time Supply
Supply Days Replenishment Method. It represents minimum stock level in
DAYS that are desired on hand to satisfy demand. Min Time
Supply Days is used in both safety stock and receipt point
calculations. For example, to ensure a minimum inventory level is
at least 14 DAYS of supply, 14 would be entered.
Measure Store Max Time Measure at the SKU/Store/Day level; Used in the Time Supply
Supply Days Replenishment Method. It represents maximum stock level in
DAYS that are desired on hand to satisfy demand. The receipt plan
quantity is calculated to bring Net Inventory up to Maximum Time
Supply Days. For example, to limit an order to bring the inventory
level to no more than to 14 DAYS of supply, 14 would be entered.
Measure Store Time Supply Measure at the SKU/Store/Day level; The number of DAYS of
Horizon forecast used to calculate an average forecast (rate of sale). The
Rate of Sale (ROS) is then multiplied by the minimum time supply
days to generate the safety stock. The Time Supply Horizon can be
used to smooth spiky forecasts over a longer time period or extend
forecasts if the forecasts are not generated throughout the desired
days of supply. Used in Time Supply Replenishment Method.
NOTE: When time supply horizon is specified, ROS is used instead
of the actual forecast.
Measure Store Repl Method Measure at the SKU/Store/Day level; The Replenishment Method
determines the type of calculations that will be used in generating
a store replenishment plan. The default is No Replenishment.
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
STR_HYBRID
Data Element Details
Measure Store Min Time Supply Days Measure at the SKU/Store/Day level; Used in Time Supply
Replenishment Method. It represents minimum stock level in
DAYS that are desired on hand to satisfy demand. Min Time
Supply Days is used in both safety stock and receipt point
calculations. For example, to ensure a minimum inventory level is
at least 14 DAYS of supply, 14 would be entered.
Measure Store Inventory Selling Days Measure at the SKU/Store/Day level; Used to specify number of
DAYS of forecasted quantity to be used when calculating the
Receive Up To Level (RUTL). Used in Hybrid, Dynamic, Poisson
and Loaded SS Dynamic Replenishment Methods. For example, to
ensure an order will contain at least 14 days of supply, 14 would
be entered. NOTE: The GREATER of Inventory Selling Days and
Review Time will be used in the RUTL calculation.
Measure Store Repl Method Measure at the SKU/Store/Day level; The Replenishment Method
determines the type of calculations that will be used in generating
a store replenishment plan. The default is No Replenishment.
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
STR_POISSON
Data Element Details
Measure Store Service Level Measure at the SKU/Store/Day level; Used in Dynamic and Poisson Repl
Method. Specifies the target percentage level for customer service of a given
item at a store. For example, if the goal is to carry enough safety stock to
maintain a 90% customer service level, .90 should be entered.
Measure Store Inventory Measure at the SKU/Store/Day level; Used to specify number of DAYS of
Selling Days forecasted quantity to be used when calculating the Receive Up To Level
(RUTL). Used in Hybrid, Dynamic, Poisson and Loaded SS Dynamic
Replenishment Methods. For example, to ensure an order will contain at least
14 days of supply, 14 would be entered. NOTE: The GREATER of Inventory
Selling Days and Review Time will be used in the RUTL calculation.
Measure Store Repl Method Measure at the SKU/Store/Day level; The Replenishment Method determines
the type of calculations that will be used in generating a store replenishment
plan. The default is No Replenishment.
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
STR_MINSS
Data Element Details
Measure Store Min Safety Stock Units Measure at the SKU/Store/Day level; Used in
Minimum Safety Stock Boundaries calculation
to specify the minimum number of UNITS to be
kept on hand as safety stock. Used in Hybrid,
Poisson and Dynamic Replenishment Methods.
For example, to ensure the number of UNITS of
safety stock is at least 10 UNITS, 10 would be
entered.
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
STR_ROUpdate
Data Element Details
STR_ Store 1 20
ITEM SKU 21 20
aipintxupd_ AIP Intersection Update 41 10
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
WH_MINMAX
Data Element Details
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
WH_DYNAMIC
Data Element Details
Measure Service Level Exception Measure at the SKU/Dstk/Day level; Used in Dynamic and Poisson Repl
Method. Specifies the target percentage level for customer service of a
given item at a warehouse. For example, if the goal is to carry enough
safety stock to maintain a 90% customer service level, .90 should be
entered.
Measure Inventory Selling Days Measure at the SKU/Dstk/Day level; Used to specify number of DAYS
Exception of forecasted quantity to be used when calculating the Receive Up To
Level (RUTL). Used in Hybrid, Dynamic, Poisson and Loaded SS
Dynamic Replenishment Methods. For example, to ensure an order will
contain at least 14 days of supply, 14 would be entered. NOTE: The
GREATER of Inventory Selling Days and Review Time will be used in
the RUTL calculation.
Measure Replenishment Method Measure at the SKU/Dstk/Day level; The Replenishment Method
Exception determines the type of calculations that will be used in generating a
warehouse replenishment plan. The default is No Replenishment.
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
WH_TIMESUPPLY
Data Element Details
Measure Minimum Time Measure at the SKU/Dstk/Day level; Used in Time Supply
Supply Days Replenishment Method. It represents minimum stock level in DAYS that
Exception are desired on hand to satisfy demand. Min Time Supply Days is used in
both safety stock and receipt point calculations. For example, to ensure a
minimum inventory level is at least 14 DAYS of supply, 14 would be
entered.
Measure Maximum Time Measure at the SKU/Dstk/Day level; Used in the Time Supply
Supply Days Replenishment Method. It represents maximum stock level in DAYS that
Exception are desired on hand to satisfy demand. The receipt plan quantity is
calculated to bring Net Inventory up to Maximum Time Supply Days. For
example, to limit an order to bring the inventory level to no more than to
14 DAYS of supply, 14 would be entered.
Measure Time Supply Horizon Measure at the SKU/Dstk/Day level; The number of DAYS of forecast
Exception used to calculate an average forecast (rate of sale). The Rate of Sale (ROS)
is then multiplied by the minimum time supply days to generate the
safety stock. The Time Supply Horizon can be used to smooth spiky
forecasts over a longer time period or extend forecasts if the forecasts are
not generated throughout the desired days of supply. Used in Time
Supply Replenishment Method. NOTE: When time supply horizon is
specified, ROS is used instead of the actual forecast.
Measure Replenishment Measure at the SKU/Dstk/Day level; The Replenishment Method
Method Exception determines the type of calculations that will be used in generating a
warehouse replenishment plan. The default is No Replenishment.
Source Object Type Fixed Length Text File or Target Object Names ipmindaytse,
Comma Separated Values ipmaxdaytse, iptshzne
File and iprplmtde
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
WH_HYBRID
Data Element Details
Measure Minimum Time Supply Measure at the SKU/Dstk/Day level; Used in Time Supply
Days Exception Replenishment Method. It represents minimum stock level in
DAYS that are desired on hand to satisfy demand. Min Time
Supply Days is used in both safety stock and receipt point
calculations. For example, to ensure a minimum inventory
level is at least 14 DAYS of supply, 14 would be entered.
Measure Inventory Selling Days Measure at the SKU/Dstk/Day level; Used to specify number
Exception of DAYS of forecasted quantity to be used when calculating
the Receive Up To Level (RUTL). Used in Hybrid, Dynamic,
Poisson and Loaded SS Dynamic Replenishment Methods. For
example, to ensure an order will contain at least 14 days of
supply, 14 would be entered. NOTE: The GREATER of
Inventory Selling Days and Review Time will be used in the
RUTL calculation.
Measure Replenishment Method Measure at the SKU/Dstk/Day level; The Replenishment
Exception Method determines the type of calculations that will be used
in generating a warehouse replenishment plan. The default is
No Replenishment.
Source Object Type Fixed Length Text File or Target Object Names ipmindaytse, ipisde and
Comma Separated Values File iprplmtde
Source Object Name WH_HYBRID Target Object Databases data/MinDayTs, data/Isd
and data/RplMtd
Required/Optional Optional Target Object Load day_dstksku_
Intersection
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
WH_MINSS
Data Element Details
Measure Minimum Safety Measure at the SKU/Dstk/Day level; Used in Minimum Safety Stock
Stock Units Boundaries calculation to specify the minimum number of UNITS to be
Exception kept on hand as safety stock. Used in Hybrid, Poisson and Dynamic
Replenishment Methods. For example, to ensure the number of UNITS
of safety stock is at least 10 UNITS, 10 would be entered. NOTE: If both
Min SS DAYS and Min SS UNITS are entered, the larger of min SS units
and demand over min SS days is used.
Source Object Type Fixed Length Text File or Target Object Name ipssminunte
Comma Separated Values
File
Source Object Name WH_MINSS Target Object Database data/SsMinUnt
Target Data Field Target Field Description Target Field Data Condition/Format
Name Type
WH_ROUpdate
Data Element Details
Unknown Warehouse 1 20
ITEM SKU 21 20
aipintxupd_ AIP Intersection Update 41 10
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
XORDERCRE
This message type indicates that a brand new purchase order is being sent to RMS. The
orders are sent to RMS in an ‘A’pproved status. This message type is inserted into
PO_MFQUEUE in three different circumstances:
1. The purchase order was released by the batch, or you have chosen to release the
purchase order in the OM Order Maintenance screen.
2. You have created a new purchase order in the OM Order Create screen.
3. In the OM Order Maintenance screen, you have chosen to move a purchase order
delivery date and/or destination and generated a new order number.
XORDERDTLCRE
This message type indicates a new line item is being added to the purchase order after
the order was externally communicated. This message type is inserted into
PO_MFQUEUE when you have moved the purchase order destination and chosen to
retain the existing order number, and the destination does not already exist on the order
for that item.
XORDERMOD
This message type indicates that a modification was made to the overall purchase order
details (header level information). This message type is inserted into PO_MFQUEUE in
the following circumstances:
1. You have moved the purchase order delivery date and chosen to retain the existing
order number.
2. You have canceled all ordered quantity of all items on the purchase order. The total
order quantity for the entire purchase order is zero. The purchase order is sent to
RMS with a ‘C’anceled status.
XORDERDTLMOD
This message type indicates that a modification was made to the purchase order line
items after the order was externally communicated. This message type is inserted into
PO_MFQUEUE when you perform various actions in the OM Order Maintenance screen.
1. You have modified the order quantity of a purchase order that is not “Closed.”
2. You have chosen to move a purchase order line item to a new destination and retain
the order number. If the “move to” destination already exists on the order, a message
will be written to the staging table to increase the quantity at the “move to” location.
Note: Only one message can be inserted for the “move to”
destination. This will either be an XORDERDTLCRE if the
destination is new or XORDERDTLMOD if the SKU is
already being delivered to the “move to” destination.
The order quantity of the “move from” destination must be decremented to equal the
received quantity. A message will be staged for the “move from” destination.
Transfer Messages
The transfer publication messages are in the XTsf message family. In AIP, this message
family processes the staged orders on the TSF_MFQUEUE table.
There is one transfer message type used by AIP, XTSFCRE, and it uses the XTsfDesc.xsd.
XTSFCRE
This message type indicates that a brand new transfer is being sent to RMS. The transfers
are sent to RMS in an ‘A’pproved status. This message type is inserted into
TSF_MFQUEUE when the transfer is released by the batch.
Messages Layout
Purchase Order Header Message Layout
RMS SKU string XOrderDtl.item Uses the RMS SKU mapping table to
convert AIP commodity pack size into
RMS SKU.
Location integer XOrderDtl.location Globally unique scheduling location
identifier
Unit Cost decimal xOrderDtl.unit_cost Not Available
Reference item string xOrderDtl.ref_item
Origin Country string xOrderDtl.origin_conunty_id
Indicator
Supplier Pack Size decimal XOrderDtl.supp_pack_size
Order Quantity decimal XOrderDtl.qty_ordered
Location Type string XorderDtl.location_type Order Destination Type: Store or
Warehouse
Cancel Indicator string xOrderDtl.cancel_ind
Reinstate Indicator string xOrderDtl.reinstate_ind
Data Origin System AIP Online Target Object Type RIB Message - Xorder
Family
Source Table(s)/File(s) STORE_ORDER, STORE, Target Object Name XORDERCRE Message
SUPPLIER, PO_MFQUEUE,
COMMODITY_MAPPING,
NON_CONTENTS_ORDER,
STOCKING_POINT
Target Load Type N/A
# Source Table Source Table Column Source Field Data Type Field
Description Length
# Target Data Field Target Field Description Field Data Field Condition/Format
Name Type Length
# Target Data Field Target Field Description Field Data Field Condition/Format
Name Type Length
# Target Data Field Target Field Description Field Data Field Condition/Format
Name Type Length
14 origin_ind Indicates where the order Varchar2 1 6 is a unique RMS identifier that
originated. Valid values indicates the PO was created in
include: 2 - Manual, 6 - AIP and is hardcoded
AIP generated order, 7 , 8.
15 edi_po_ind Indicates whether or not Varchar2 1 Hardcoded as NULL
the order will be
transmitted to the supplier
via an Electronic Data
Exchange transaction.
Valid values are: Y =
Submit via EDI, N = Do
not use EDI.
16 pre_mark_ind This field indicated Varchar2 1 Hardcoded as NULL
whether or not a supplier
has agreed to break an
order into separate boxes
so that the boxes can be
sent directly to stores.
17 user_id Indicates where the order Varchar2 30 Hardcoded as NULL
was approved. It will be
the user ID of the person
approving the order.
18 comment_desc Any comments pertaining Varchar2 2000 Hardcoded as NULL
to the order.
Filtering Conditions
Store Orders
poQ.file_interface_ind = 'N' AND so.order_number = poQ.order_number AND
so.future_release_ind = 'N' AND so.supplier_id = supp.supplier_id AND
so.commodity_id=cm.commodity_id AND so.pack_size=cm.pack_size AND
s.store_id=so.store_id AND (poQ.store_order_id=so.store_order_id OR
poQ.store_order_id IS NULL)
Warehouse Orders
poQ.file_interface_ind = 'N' AND nco.order_number = poQ.order_number AND
nco.source_type='V' AND nco.source_id=s.supplier_id AND
nco.commodity_id=cm.commodity_id AND nco.pack_size=cm.pack_size AND
nco.stocking_point_id = chamber.stocking_point_id AND
(poQ.non_contents_order_id=nco.non_contents_order_id OR poQ.non_contents_order_id
IS NULL) AND wh.stocking_point_id(+) = chamber.parent_stocking_point_id
RIB Publication Message Create Order Detail Contains Purchase Order Header
and new detail information.
Data Origin System AIP Online Target Object Type RIB Message - Xorder
Family
Source Table(s)/File(s) STORE_ORDER, STORE, Target Object Name XORDERDTL Detail
SUPPLIER, PO_MFQUEUE, Message
COMMODITY_MAPPING,
NON_CONTENTS_ORDER,
STOCKING_POINT
Target Load Type N/A
Filtering Conditions
Store Orders
so.order_number=pm.order_number AND so.supplier_id = supp.supplier_id AND
so.commodity_id=cm.commodity_id AND so.pack_size=cm.pack_size AND
s.store_id=so.store_id AND (pm.store_order_id=so.store_order_id OR
pm.store_order_id IS NULL)
Warehouse Orders
nco.source_type=“V” AND nco.order_number=pm.order_number AND
nco.source_id=s.supplier_id AND nco.commodity_id=cm.commodity_id AND
nco.pack_size=cm.pack_size AND nco.stocking_point_id = sp1.stocking_point_id AND
(pm.non_contents_order_id=nco.non_contents_order_id OR pm.non_contents_order_id IS
NULL) AND sp2.stocking_point_id(+) = sp1.parent_stocking_point_id
RIB Publication Message Modify Order Header Contains Purchase Order header details.
Data Origin System AIP Online Target Object Type RIB Message - Xorder
Family
Source Table(s)/File(s) STORE_ORDER, STORE, Target Object Name XORDERMOD Header
SUPPLIER, PO_MFQUEUE, Message
COMMODITY_MAPPING,
NON_CONTENTS_ORDER,
STOCKING_POINT
Target Load Type N/A
# Target Data Field Target Field Description Target Field Field Length Condition/Format
Name Data Type
# Target Data Field Target Field Description Target Field Field Length Condition/Format
Name Data Type
Filtering Conditions
Store Orders
so.order_number=pm.order_number AND so.supplier_id = supp.supplier_id AND
so.commodity_id=cm.commodity_id AND so.pack_size=cm.pack_size AND
s.store_id=so.store_id AND (pm.store_order_id=so.store_order_id OR
pm.store_order_id IS NULL)
Warehouse Orders
nco.source_type=“V” AND nco.order_number=pm.order_number AND
nco.source_id=s.supplier_id AND nco.commodity_id=cm.commodity_id AND
nco.pack_size=cm.pack_size AND nco.stocking_point_id = sp1.stocking_point_id AND
(pm.non_contents_order_id=nco.non_contents_order_id OR pm.non_contents_order_id IS
NULL) AND sp2.stocking_point_id(+) = sp1.parent_stocking_point_id
RIB Publication Message Modify Order Detail Contains Purchase Order header
and detail information.
Data Origin System AIP Online Target Object Type RIB Message - Xorder
Family
Source Table(s)/File(s) STORE_ORDER, STORE, Target Object Name XORDERDTLMOD
SUPPLIER, PO_MFQUEUE, Message
COMMODITY_MAPPING,
NON_CONTENTS_ORDER,
STOCKING_POINT
Target Load Type N/A
# Source Table Source Table Column Source Field Data Type Field
Description Length
# Source Table Source Table Column Source Field Data Type Field
Description Length
Filtering Conditions
Store Orders
so.order_number=pm.order_number AND so.supplier_id = supp.supplier_id AND
so.commodity_id=cm.commodity_id AND so.pack_size=cm.pack_size AND
s.store_id=so.store_id AND (pm.store_order_id=so.store_order_id OR
pm.store_order_id IS NULL)
Warehouse Orders
nco.source_type=“V” AND nco.order_number=pm.order_number AND
nco.source_id=s.supplier_id AND nco.commodity_id=cm.commodity_id AND
nco.pack_size=cm.pack_size AND nco.stocking_point_id = sp1.stocking_point_id AND
(pm.non_contents_order_id=nco.non_contents_order_id OR pm.non_contents_order_id IS
NULL) AND sp2.stocking_point_id(+) = sp1.parent_stocking_point_id
Data Origin System AIP Online Target Object Type RIB Message XTsf
Family
Source Table(s)/File(s) STORE_ORDER, STORE, Target Object Name XTSFCRE Message
TSF_MFQUEUE,
COMMODITY_MAPPING,
NON_CONTENTS_ORDER,
STOCKING_POINT
Target Load Type N/A
# Target Data Field Name Target Field Field Data Field Condition/Format
Description Type Length
# Target Data Field Name Target Field Field Data Field Condition/Format
Description Type Length
Filtering Conditions
None.
RMS Subscriber Mapping Create/Modify Order Header Contains Purchase Order header
details.
Data Origin System AIP Online Target Object Type RMS Database
Source Table(s)/File(s) STORE_ORDER, STORE, Target Object Name ORDHEAD Table
SUPPLIER, PO_MFQUEUE,
COMMODITY_MAPPING,
NON_CONTENTS_ORDER,
STOCKING_POINT
Target Load Type N/A
# Target Data Field Name Target Field Description Field Data Field Condition/Format
Type Length
# Target Data Field Name Target Field Description Field Data Field Condition/Format
Type Length
# Target Data Field Name Target Field Description Field Data Field Condition/Format
Type Length
# Target Data Field Name Target Field Description Field Data Field Condition/Format
Type Length
Filtering Conditions
None.
RMS Subscriber Mapping Create/Modify Order Detail Contains Purchase Order Line
Item details
Data Origin System AIP Online Target Object Type RMS Database
Source Table(s)/File(s) STORE_ORDER, STORE, Target Object Name ORDSKU & ORDLOC
SUPPLIER, PO_MFQUEUE, Tables
COMMODITY_MAPPING,
NON_CONTENTS_ORDER,
STOCKING_POINT
Target Load Type N/A
# Source Table Source Table Column Source Field Description Data Type Field
Length
# Source Table Source Table Column Source Field Description Data Type Field
Length
# Target Data Field Target Field Description Field Data Field Condition/Format
Name Type Length
# Source Table Source Table Column Source Field Data Type Field
Description Length
Filtering Conditions
None.
RMS Subscriber Mapping Create Transfer Header Contains Transfer header details.
Data Origin System AIP Online Target Object Type RMS Database
Source Table(s)/File(s) STORE_ORDER, STORE, Target Object Name TSFHEAD Table
TSF_MFQUEUE,
COMMODITY_MAPPING,
NON_CONTENTS_ORDER,
STOCKING_POINT
Target Load Type N/A
# Source Table Source Table Column Source Field Data Type Field
Description Length
Filtering Conditions
None.
RMS Subscriber Mapping Create Transfer Detail Contains Transfer detail line of items.
Data Origin System AIP Online Target Object Type RMS Database
Source Table(s)/File(s) STORE_ORDER, STORE, Target Object Name TSFDETAIL Table
TSF_MFQUEUE,
COMMODITY_MAPPING,
NON_CONTENTS_ORDER,
STOCKING_POINT
Target Load Type N/A
1 TSF_NO Number that uniquely Varchar2 (10,0) The transfer number from
identifies the transfer header row
2 TSF_SEQ_NO Transfer Line Item Number (8,0) Transfer line item number
Number under the current header row
3 ITEM The unique identifier of Number 25 N/A
the item being
transferred.
4 INV_STATUS A code indicating the Number (2,0) Hardcoded as NULL
inventory status for
this transfer detail;
valid values are found
on the inv_status_types
table
Filtering Conditions
None.
This is the recommended method of integration when large volumes of Purchase Orders
and Transfers are expected to be executed each night.
purchase_order.dat.1
Data Element Details
Data Origin System AIP Target Object Type Delimited Text File
Source Object Type Delimited Text File Target Object Name purchase_order_.dat.1
Source Object Name PO_MFQUEUE, Target Object Database N/A
STORE_ORDER,
NON_CONTENTS_ORDER,
SUPPLIER,
STOCKING_POINT, STORE,
COMMODITY,
COMMODITY_MAPPING
Required/Optional Optional Target Object Load N/A
Intersection
Field Delimiter |
Final Delimiter 0x0A
Formatting Conditions
All prefixes added by AIP are removed.
transfer_order.dat.1
Data Element Details
Data Origin System AIP Target Object Type Delimited Text File
Source Object Type Delimited Text File Target Object Name transfer_order_.dat.1
Source Object Name PO_MFQUEUE, Target Object Database N/A
STORE_ORDER,
NON_CONTENTS_ORDER,
STOCKING_POINT,
STORE, COMMODITY,
COMMODITY_MAPPING
Required/Optional Optional Target Object Load N/A
Intersection
Field Delimiter | Field Delimiter |
Final Delimiter 0x0A Final Delimiter 0x0A
MIN(NON_CONTENTS
_ORDER.DELIVERY_DATE)
6 N/A Routing Code not available in N/A 1
AIP
Target Data Field Name Target Field Description Field Data Type Condition/Format
Formatting Conditions
All prefixes added by AIP are removed.
Measure Lead Time Contains the number of days the source takes to
deliver the item once the order is released from AIP.
Lead time, is an integer for a SKU/store.
Measure Review Time Review time is the number of days until the next
receipt becomes available. This field contains the
longest review time found within a certain time
period. Review time is an integer for a SKU/store.
Measure Pack Size Contains the preferred ordering pack size when
ordering the SKU to the store.
Data Origin System AIP Target Object Type Fixed Length Text File or
Comma Separated Values
File
Source Object Type RPAS measures Target Object Names STR_AIP_DATA.[txt csv]
Source Object Name sr0_lt, sr0_rt, sr0_ordpkz Target Object Load str_item
Intersection
Required/Optional Optional
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
None.
WH_AIP_DATA
AIP can be configured to export warehouse supply-chain information. However, few
optimization systems can optimize warehouse replenishment. Check the Oracle Retail
Replenishment Optimization guides and the retailer’s specific implementation to determine
if warehouses can be optimized.
Measure Lead Time Contains the number of days the source takes to deliver the item once the
order is released from AIP. Lead time, is an integer for a SKU/warehouse.
Measure Review Time Review time is the number of days until the next receipt becomes
available. This field contains the longest review time found within a
certain time period. Review time is an integer for a SKU/warehouse.
Measure Pack Size Contains the preferred ordering pack size when ordering the SKU to the
warehouse.
Data Origin System AIP Target Object Type Fixed Length Text File or
Comma Separated Values
File
Source Object Type RPAS Measures Target Object Names WH_AIP_DATA.[txt|csv]
Source Object Name IpWhLtO, IpWhRtO, Target Object Load WH__SKU_
IpWhOrdPkzO Intersection
Required/Optional Optional
Target Data Field Name Target Field Description Target Field Condition/Format
Data Type
Formatting Conditions
None.
Overview
The First Day of AIP is little more than the first iteration of the daily AIP batch cycle. It
virtually mirrors the cycle but executes only a subset of the daily processes. This
document will not only outline the actions to execute the First Day of AIP but will also
explain what the process is accomplishing and why. Understanding the goal of the First
Day, the reason it is different and how it executes will provide a deeper understanding of
the flow of data between AIP and external systems as well as between the two AIP
platforms—RPAS and Oracle.
Keeping in mind the goal and purpose of the First Day of AIP will provide the needed
insight to clearly understand how the required actions accomplish the goal.
Load Data
On a day-to-day basis AIP is synchronized with both the external data coming from the
merchandising and forecasting systems and the internal data created on each platform.
This must occur on both AIP platforms—RPAS and Oracle. This occurs first in RPAS
prior to the replenishment planning calculations. All data required for the replenishment
planning calculations are loaded into AIP on the RPAS platform. This means that the
data is first extracted out of AIP on Oracle, the merchandising system, forecasting
system, etc. for loading into AIP on RPAS. In a daily batch run the RPAS database would
be synchronized with
Enterprise Hierarchy
Merchandise Hierarchy
Supply-chain Parameters
Inventory Positions
Forecasts
AIP Supply-chain
Following the data manipulation and replenishment planning on RPAS the plan,
hierarchies, and other modified supply chain data is extracted and/or passed from RPAS
to the Oracle database. The Oracle database is then synchronized with the latest data
passed to, or created by, AIP on RPAS. In a daily batch run the Oracle database would be
synchronized with
Enterprise Hierarchy
Merchandise Hierarchy
Supply Chain Parameters
AIP Supply-chain
Supply-chain Alerts
Replenishment Plan
Order Information (received quantities, closed orders, etc.)
The First Day attempts to follow the same process as the daily batch however only some
of the physical supply-chain elements exist, not the complete supply-chain
representation. Therefore the first day batch processes must be limited to merely loading
the data and setting up the logical connections and replenishment parameters without
doing any replenishment planning.
Supplier
Destination
Warehouse Warehouse
Warehouse
Chamber Chamber
Chamber
Source
Source
Delivery Group Order Group
Destination
Warehouse
Warehouse
Chamber
Chamber
Source
Profile Profile Profile
Store SKU Order Cycle Order Cycle Order Cycle
Source SKU
Store
Source
SKU SKU SKU
The AIP supply chain structure diagram lists the physical as well as logical entities of the
supply chain which must be defined within AIP. If configured correctly, all logical
entities can be created by the Automated Data Maintenance processes with the exception
of those noted in the diagram, and the Supplier SKU pack size links.
The diagram provides an easy-to-discern list of needed supply chain elements. For
example, by examining this diagram from top to bottom, it can be seen that:
A source must be connected to a Delivery Group and Order Group for delivery into
warehouses and a Profile for delivery into the store.
The Order Group must be associated with an Order Cycle.
Demand Groups must be associated with an Order Group and Delivery Group for
deliveries from a source to a warehouse-chamber destination.
Demand Groups must be created for SKU-pack sizes.
etc.
The diagram illustrates what the First Day of AIP needs to accomplish on the Oracle
platform. By fully comprehending each element of the diagram it becomes clear why the
first day process should be different for AIP on Oracle and how to maximize the effect of
automation while minimizing the amount of extra effort required to enable it.
The full analysis of each element of the diagram is out of the scope of this document
however the elements that impact the first day will be examined.
Order Cycles are required to create Order Groups and Profiles. Order Cycles are not
created by Automated Data Maintenance, however default Order Cycles are
provided as seed data loaded before the Fist Day.
Warehouse chambers are required to create Order Groups, Delivery Groups, and
ranged warehouse/SKU-pack sizes. Chambers are not created by Automated Data
Maintenance since there is not a single rule-set that will work for all businesses. It is
maintained as a manual process. Automated Data Maintenance could do very little
setup the first day if the First Day process was not altered to accommodate for this
fact.
Step Execution
Run vdate.sh script to set the Vdate in the AIP Oracle database and export the value to a
flat file.
/aip/oracle> vdate.sh set export 20070101
Copy the flat file vdate.int from ${INTEGRATION_HOME}/vdate to
${AIPDOMAIN}/interface/import/meas.
Step Execution
Log in to the SRP workbook. Refer to the Oracle Retail Store Replenishment Planning User
Guide for details on building and modifying the values in this workbook.
Hierarchy Files
Product hierarchy prod.dat
Profile hierarchy prof.dat
Store hierarchy loc.dat
Supplier hierarchy hspl.dat
Warehouse hierarchy whse.dat
Hierarchy Alerts
New SKU Alert dmx_newprd.dat
New SKU Packsize Alert dmx_newpsz.dat
New Store Alert dm0_new.dat
New Supplier Alert dm0_newspl.dat
New Warehouse Alert dm1_new.dat
Attributes
Default Warehouse info for Stores default_wh.dat
Direct-supply flag dmx_dirspl.dat
SKU Packsize Pack-type dmx_pcktyp.dat
SKU Packsize Attribute item_attribute_type.dat
SKU Packsize Attribute Value item_attribute.dat
Supplier Ship-to info dmx_shpto_.dat
Warehouse Type info wh_type.dat
Warehouse Promotional Start Date dm0_pmsstasrc.dat
Warehouse Promotional End Date dm0_pmsendsrc.dat
RMS to AIP SKU Map dmx_rmsskumap.dat
Step Execution
The aip_batch.sh control script has a –f flag that automatically runs all necessary steps (or
the start and end flags can be used as well):
/aip/rpas> aip_batch.sh –f
- OR -
/aip/rpas> aip_batch.sh –f –s set_implementation_parameters\ –e auto_build_wkbooks_batch
Hierarchy Import
Step Execution
Perform the following procedure.
1. Set the environment variables for the session.
/aip/oracle> . aip_common_online.sh
2. Prepare the flat files in the import directory
/aip/oracle> ${INTEGRATION_HOME}/scripts/prep_files.sh DM_data AIP-ONLINE
3. Verify the success of the operation by checking the log files for errors and checking
the return value of the last operation.
/aip/oracle> echo $?
4. Import the hierarchy values and attributes.
/aip/oracle> ${INTEGRATION_HOME}/scripts/process_aiponline_data.sh -l
"${INTEGRATION_HOME}/config/import_hierarchy.config"
5. Verify the success of the operation by checking the log files for errors and checking
the return value of the last operation.
/aip/oracle> echo $?
6. Import the measure data.
/aip/oracle> ${INTEGRATION_HOME}/scripts/process_aiponline_data.sh -l
"${INTEGRATION_HOME}/config/import_dm.config"
7. Verify the success of the operation by checking the log files for errors and checking
the return value of the last operation.
/aip/oracle> echo $?
Step Execution
Log in to Data Management Online. Follow the steps to create one or more chambers for
each warehouse. Follow the steps to assign one or more SKU types to each chamber.
Step Execution
Perform the following procedure to execute the process.
1. Execute the automation control script.
/aip/oracle> ${INTEGRATION_HOME}/scripts/post_import_wrapper.sh
2. Verify the success of the operation by checking the log files and the return value of
the last operation.
/aip/oracle> echo $?
Step Execution
Perform the following procedure to execute the process.
1. Prepare the flat files in the import directory.
/aip/oracle> ${INTEGRATION_HOME}/scripts/prep_files.sh DM_alerts AIP-ONLINE
2. Verify the success of the operation by checking the log files for errors and checking
the return value of the last operation.
/aip/oracle> echo $?
3. Import the hierarchy values and attributes.
/aip/oracle> ${INTEGRATION_HOME}/scripts/process_aiponline_data.sh -l
"${INTEGRATION_HOME}/config/import_dm_alerts.config"
4. Verify the success of the operation by checking the log files for errors and checking
the return value of the last operation. Note that you will likely see warning messages
indicating that some files do not exist. This is expected on the first day.
/aip/oracle> echo $?
Step Execution
Log in to the Data Management Online application. Refer to the Oracle Retail Advanced
Inventory Planning Data Management User Guide for a detailed description of how to
perform each action.
Log in to the SRP and WRP workbooks. Refer to the Oracle Retail Advanced Inventory
Planning Store Replenishment Planning User Guide and Oracle Retail Advanced Inventory
Planning Warehouse Replenishment Planning User Guide for details on building workbooks
and modifying the Administration Workbooks.