Incremental Imports History

Purpose: Use Incremental Imports History screen to review the incremental inventory imports that have taken place or are currently running.

Used for the Routing Engine module.

For more information: See Incremental Inventory Import for an overview on the incremental inventory import process and background information.

How to display this screen: Click the history icon (Illustrates the history icon.) next to an Incremental Inventory Import entry for a system at the View Active Schedules screen.

Note:

  • Available if Use Routing Engine is selected at the Tenant screen. Only users with View Active Schedules authority can display this screen. See the Role Wizard for more information.
  • Available only if the Incremental Inventory Import is currently enabled, or if there are any incremental inventory import records that have not been purged.
  • If the Incremental Imports History screen was already open in another tab when you clicked the history icon, you advance to this screen with the incremental imports history of the previously-selected organization and system displayed.
  • History is retained for the number of days specified in the Job History retention setting at the Tenant-Admin screen.

Options at this screen

Option Procedure
Search for an import process

Use the Job Number, Start Date, or Status fields to restrict the displayed imports to those that match your entries and click Search:

  • Job Number = Optionally, enter an job ID number to display this import process only.
  • Start Date = Optionally, enter a date to display imports that took place on that date.
  • Status = Optionally, select a status of:
    • Error to display an import process that ended in error.
    • Running to display an import process that is currently running for the system.
    • Failed to display import processes that included any records in error.
    • Rejected to display import processes that were rejected because another import process, or a conflicting job, was running. See Schedule Imports for a listing of jobs that can conflict.

    • Success to display import processes that completed without any errors.

      Note:

      You cannot select a status of Paused; however, a job stays in this status only briefly when it switches to another server to complete running.
Understand general errors

If an error occurred for an import process itself, it is displayed in the Error field.

Fields on this screen

Field Description
Organization

The code identifying the organization associated with the import you selected at the View Active Schedules screen is displayed. The description of the organization is to the right.

System

The code identifying the system associated with the import you selected at the View Active Schedules screen is displayed. The description of the system is to the right.

Search fields
Job Number

A unique ID number assigned by Order Broker to identify an import process.

Note: An import is associated with a single job number, regardless of whether Order Broker breaks it out into multiple batches for processing.

Start Date

The date and time when the import process started.

Status

Optionally, select an import status from the drop down list and click Search to display incremental imports that are currently in that status. Possible statuses are:

  • Error (Illustrates the red X icon.): The entire import failed.
  • Rejected (Illustrates the rejected icon.): The import was rejected because another import, or a conflicting job, was in process. See Schedule Imports for a listing of jobs that can conflict.
  • Running (Illustrates the running man icon.): The import is currently running.
  • Success (Illustrates the green check icon.): The import ran successfully, even if one or more individual records failed.

    Note:

    You cannot select a status of Paused; however, a job stays in this status only briefly when it switches to another server to complete running, and then Order Broker restarts it automatically.
Results fields:
Job Number

A unique ID number assigned by Order Broker to identify an import process.

Note: An import is associated with a single job number, regardless of whether Order Broker breaks it out into multiple batches for processing.

Start Date

The date and time when the import process started.

End Date

The date and time when the import process ended.

Duration

The amount of time it took for the incremental import to run. HH:MM:SS format, but displayed in MM:SS format if the import took less than an hour.

Submitted By

Indicates how the import was submitted. This could be the ID of the user who submitted or scheduled the process, or the client ID used to authenticate the run job API request message.

SYSTEM is displayed here if the job ran successfully through a schedule; however, if a scheduled job was rejected, the ID of the user who scheduled the job is displayed.

Status

Indicates the result of the incremental import process:

  • A green check(Illustrates the green check icon.) indicates that the import was successful, even if one or more individual records failed.

    Note:

    The green check is also displayed if there were no records to import.
  • A red X (Illustrates the red X icon.) indicates that an error occurred and the import failed.
  • A yellow triangle (Illustrates the rejected icon.) indicates that the import was rejected because another import, or a conflicting job, was already running. See Schedule Imports for a listing of jobs that can conflict.
  • A running man (Illustrates the running man icon.) indicates that the import is currently running.
  • A pause icon (Illustrates the pause icon.) indicates that the job has paused briefly while it switches to another server to finish running. This status might be displayed only briefly.
Error

Error message, if any. For example, a message is written when the job status is reset, for example: Running job status was reset by user SYSTEM on 11/28/2021 04:29 PM. Up to 255 positions.

See Incremental Inventory Import for background and troubleshooting information.

Inventory Records

The total number of inventory records in the import.

Inventory Errors

The total number of inventory records that failed to import. See Incremental Inventory Import for background and troubleshooting information.