1. Scheduled Processes for SCM
  2. Import Meter Readings

Import Meter Readings

Oracle Fusion Cloud Maintenance enables you to create and update new meter readings in bulk using a File-Based Data Import(FBDI). This includes both asset meter readings and meter readings used in contracts and subscriptions.

The Import Meter Readings scheduled process is used to:

  • Create new sequential readings by value and date/time for an asset-based meter.
  • Create new sequential readings by value and date/time for a subscription-based meter.
Note: For more details, refer to the File-Based Data Import for Oracle SCM guide.

When to Use

The process is used to create and update meter readings in bulk using the File-Based Data Import. Therefore, the process is only run after you have uploaded the file using the Load Interface File for Import scheduled process.

The following are the major steps involved in a Meter Reading import process:

  • Download and update the latest spreadsheet for your update.
  • Transfer data to the interface tables.
  • Run the import meter readings scheduled process.
  • Verify the process output logs.

Download and Update the Spreadsheet

Download the spreadsheet template that's available in the File-Based Data Import for Oracle SCM guide. Update the spreadsheet with the import data.

The spreadsheet template organizes the meter readings information in these tabs:

  • Instructions and CSV Generation: Contains a brief overview, reference to the procedure for importing meter readings using the spreadsheet, and the revision history. It also contains the Generate CSV File button to generate the CSV files from the spreadsheet with import data.
  • Import Batch: Here, you create the unique import batch in which the meter reading records are grouped for processing.
  • Meter Readings: Here, you capture details of each meter reading by asset, subscription PUID, meter code, reading value, and date/time.

Transfer Data to the Interface Tables

On the General Instructions tab, click the Generate CSV File button to transfer the data into a .ZIP file with one or more .csv files. Use the Load Interface File for Import scheduled process to upload the .ZIP file to the server for transferring the data to the interface tables. The scheduled process is also accessible from the Tasks pane on the Maintenance Management landing page.

Run the Import Meter Readings Scheduled Process

The next step is to run the Import Meter Readings scheduled process to transfer the data from interface tables to the production tables. The process will reference the import batch number defined in the uploaded spreadsheet. The scheduled process is also accessible from the Tasks pane on the Maintenance Management landing page.

Review the output logs from the import process. If any errors where encountered, they will be contained in a separate log file.

Privileges Required

Verify that you have the following privileges to upload the FBDI files using the Load Interface File for Import scheduled process:

  • Privileges:
    • FUN_FSCM_FILE_TO_INTERFACE_PRIV
    • FUN_FSCM_LOAD_INTERFACES_PRIV
    • FND_MANAGE_FILE_IMPORT_AND_EXPORT_PRIV
    • FUN_FSCM_TRANSFER_FILE_PRIV

Verify that you have the following privileges for the Import Meter Readings scheduled process:

  • Privileges:
    • MNT_MANAGE_METER_READING_HISTORY_PRIV
    • MNT_EXPORT_ASSET_METER_READING_DETAILS_PRIV

Specifications

Use these specifications when you run the scheduled process.

Specification Description
Job Type Adhoc, you only run after importing an FBDI file for a unique import batch number.
Frequency As needed after importing the FBDI file.
Time of Day Any time.
Duration Typically, less than a few minutes, depending on the volume of data being created or updated.
Compatibility There should be only one instance of the job running at any one time for a unique import batch number. A new job should only be submitted for another unique batch number after the previous one has completed, and the output logs have been reviewed.

Parameters

The process will typically be run adhoc by selecting the batch number.

Parameter Optional or Required Description Parameter Value Special Combinations Required
Batch (number) Required The unique import batch number in which the meter readings records are grouped for processing in the Interface tables. A list of values will display all batch numbers that are ready for import. None

Troubleshooting Information

Try this:

  • Import file creation:
    • You must create the file directly from the source Excel template by following the instructions on the first tab of the file. This will create a .ZIP file that is used for import.
  • File import using the Load Interface File for Import scheduled process:
    • Schedule a new adhoc process to select and load the file into the interface tables.
    • View the status of the Load Interface File for Import job on the Scheduled Processes UI.
    • The process will spawn multiple child processes to transfer the .ZIP file and load data from each of the .CSV files contained in the .ZIP file.
    • If any of the processes end in Warning or Error status, review their output logs. You may need to correct the data in the import file, define a new unique batch number, and start the process again by uploading the new .ZIP file.
  • File processing using the Import Meter Reading schedule process:
    • You will schedule a new adhoc process to select and load the file into the interface tables.
    • You can view the status of the Import Meter Readings job on the Scheduled Processes UI.
    • The process will spawn a child process to import the data and process it from the interface tables.

Related Topics