D Appendix: Application Specific Custom Functions, Procedures, and Expressions
Assortment Planning Cloud Service uses the RPAS Enterprise Edition Batch Framework to set up the batch process. Refer to the Oracle Retail Assortment Planning Cloud Service Implementation Guide for more details about understanding batch_control files and its uses in the batch process. Any application-specific custom functions are packaged in the RPAS Applications Standard Library (RASL) libraries and those are available to use in the batch_exec_list.txt control file with the service name as ra_custom to trigger those functions and parameter as the function name. The following list of predefined custom functions are available RASL libraries installed as part of RPAS that are used by Item Planning.
This appendix also contains details about special procedures/expressions used in the APCS configuration.
Custom Function: ap_set_datr
The Platform UI feature allows product attributes to be assigned during item creation if the attributes are defined as dimension attributes. This application-level function registers all the loaded product attributes as dimension attributes. It needs to be called each time a new set of product attributes is loaded.
Example:
batch_datr | ra_custom | ap_set_datr
Custom Function: ap_exp_rms_item
This custom function is used to export new items to RMFCS in XML format. It merges and formats the exported files into XML format and uploads to Object Storage.
Example:
exp_rms | ra_custom | ap_exp_rms_item
Custom Function: ap_set_rms_dim
This custom function is used to link the dimension in the domain to the RMFCS item dimension. It sets the domain property, rms_im_levels, with dimension mappings passed as a parameter. If the domain is linked with RMFCS and dimensions are mapped with the example call shown below, then any new DPM positions created for those dimensions will use the reserved numbers from RMFCS for that mapped item. More than one dimension can be mapped using following mapping "rpasDimName:rmsDimName,...".
Example:
set_rms_sib | ra_custom | ap_set_rms_dim~sku:ITEM,skup:ITEM
Custom Function: ap_exp_alloc
This custom function formats the Standard Exports to the Allocation’s system into the required format, reads the exported file ap_to_alloc.txt and formats, and converts the file as p0itpt.01 (Style only items) or p1itpt.01 (for Style/Color) and uploads to Object Storage.
Example:
exp_alloc | ra_custom | ap_exp_alloc
Custom Function: ap_sib_color
This custom function is used to rename the Style/Color positions using the Style:<color attribute name> format for newly created DPM positions as needed by RMFCS integration so that if actual positions are integrated, it will be formalized.
It expects the ap_sib_color.dat file containing the DPM style/color position, style position, and color attribute in the temp directory. It creates the required product hierarchy renaming the file from it and calls eebatch_rename_positions.ksh to rename those positions.
No additional inputs required to call this function.
Example:
batch_sib | ra_custom | ap_sib_color