Batches

  • Updated

The Batches tab within Updates History contains a comprehensive history of deliveries made by utilizing Storefront. This article will provide a high level overview of what the user will observe on this tab of Updates History.

Navigating

By default, the user will be in the "Batches" tab:

The user can see that they are in the Batches tab, with the directory guidance below the Module's name or the white tab of the same name.

At the top of the Batches tab, along with the other tabs, are the Columns, Download, and Filter buttons.

  • For information on the Columns available in the Batches tab, scroll further down or click here.
  • For more information on the Columns button and showing or hiding columns, click here.
  • For instructions on exporting updates history results, click here. Navigate to "Exporting Results"
  • For more information on utilizing the filters, click here. Navigate to "Filters"

Batch Data

The Batch tab contains a table that lists various types of batches that contain different batch items, statuses, and associated delivery data.

Below are some of the column headers that can be utilized:

  • Batch name - The name of the updates batch that was pushed through. This tab can be sorted by Batch name,
    • If the user clicks on the name of a batch, they will be taken to a pre-filtered view of the"Batch items" tab, that focuses on items in that batch.
      • For information on the Batch items tab, click here.
    • Each row within the batch will have all their titles' information, line by line, for the metadata being pushed through that specific batch.
      • For information on Update Errors, click here.
  • Providers - The provider of that batch.
  • Creator - The user within the user's organization that created the batch.
  • Sender - The user that pushed the batch through.
  • Status - This will either be sent, pending, or draft.
    • Sent - The batch went through successfully
    • Pending - An item within the batch's delivery is still in progress
    • Draft - The batch has been saved but not sent through yet
      • Items within a drafted batch are only visible to the Creator
    • Error - Indicates an issue with a particular batch item that should be investigated within the batch.
      • There are a number of reasons an update might have failed: the price might not exist at the retailer, the EST end date is before the start date, and more.
      • In Batch Items, the user will be able to see what the error was exactly, since the UI provides that exact information. 
  • Item Count - Total number of batch files being updated
  • Created - When the batch was created.
  • Modified - When the batch was last resent, with modifications.
  • Sent - When the batch initially pushed through.

For more information on how to show or hide columns, please click here.

Actions

Within a batch, a user has the option to perform two actions:

  • Re-update: This action allows the user to take an entire batch and add the same information provided and create a new batch, with or without unchanged metadata.
    • If the user wishes to send specific items from batch items, they can check the boxes next to any of the updates, the box next to "Batch name". 
    • Then, click the "Re-update selected" button to send them through again.
      • Please note the following:
        • If the update has an error status, the user should verify that the error has been resolved before attempting to re-update.
        • Additionally, in certain cases, the update may be resent thanks to automated workflows. Please contact support to clarify these cases.
    • From there, the user will be redirected to the Create Updates module and the data will be pre-filled with the previous batch item's data. 
      • For more information on creating updates, click here.
  • Cancel: This option allows for users to only cancel pending batches in Updates History that don't have the delivering status, yet. Otherwise, it will be grayed out.
    1. Users can select the batch, which will redirect them to Batch Items. In Batch Items, users should check any given items they'd like to cancel, and then they can navigate to the Actions menu.
    2. Within this menu, users will find the Cancel updates function. Upon selecting Cancel updates, a confirmation window will open.
    3. Users can either select 'Cancel' or 'Ok', which would then remove that update's batch item(s).Batches 9.png
      • Any selected batch items should be listed here. Users can either select 'Cancel' or 'Ok', which would then remove that update's batch item(s).
      • Canceling an update in Storefront does not guarantee the update will not be delivered if it wasn't canceled in a timely fashion. Users must validate their data prior to sending the update, or risk unintended changes.

(Return to the top)