Operator guideEN

NX / Categories / Reorder

Ordering screen for NX categories.

How to use this guide

Start with the main guide

Follow the explanation and examples first. Extra definitions and formulas are available below when you need them.

What this page does

This page is the dedicated ordering workspace for NX categories. It reads the same category records as the list page, lets the operator stage local row selections, and saves bulk order changes.

Filters

  • Search: filters categories after Enter is pressed.
  • Aggregators: limits rows to selected aggregators.
  • The first Status selector actually filters Scope using External, Casino, or System.
  • The second Status selector filters lifecycle status using Active or Disabled. Archived is configured but hidden from the selector.

The two selectors currently have the same visible Status label. Search applies on Enter; the multi-select filters submit automatically after a short delay. Filtering, pagination, and column sorting do not clear selected rows or the stored target.

Available reorder actions

  • Row selection is local staging only; it does not save an order change.
  • Move To Top submits selected category IDs without a target and moves those rows to the top of the saved category order.
  • To insert after a category, select exactly that row and use Set Target.
  • Deselect the target, select the categories to move, and use Move To The Set.
  • Set a fresh target before each insert. The stored target is not displayed and is not cleared after a successful move.
  • All shows the current server page. Selected locally keeps only selected IDs present on the currently loaded page; selected categories from other pages can remain in the move payload without appearing there.

How to read the grid

  • The grid columns are ID, Category, Aggregator, Order, Scope, and Status.
  • Order is the current persisted category sort value, but the initial grid is ordered by ID ascending unless the operator explicitly sorts a column.
  • Clicking the row body does not open category details; use the checkbox to select a row.

Save behavior

The save flow writes three-decimal temporary values in checkbox selection order, then renumbers every category with ROW_NUMBER() ordered by those values inside one transaction. On success the page clears row selection, resets pagination, switches back to All, refreshes the grid, and shows Order Changed Successfully. The stored target category is not cleared.

Current request handling can return success-shaped page feedback after a failed sort. An empty Move To Top also reaches the sort service, fails validation, changes no saved order, and can still produce the success reset/toast. Refresh and verify Order after every move.

Known caveats

  • Move To Top remains enabled with no selected row. Select at least one category first.
  • Move buttons are not locked while a request is in flight. Wait for the refreshed list before another click.
  • If the target remains selected during Move To The Set, the target ID is also included in the categories being moved.
  • Selection order determines the order assigned to the moved categories.
More details

Definitions and formulas

Open only the section you need. The relevant section opens automatically when you request help for a specific item on screen.

Calculations4 topicsOpen details

Default grid order

Explains why rows can initially appear out of sequence with the visible Order values.

Formula
With no explicit column sort, the category-list read orders by category ID ascending. The Order column still displays the persisted categorySort value.
Caveats
Sort the Order column explicitly when reviewing the persisted category sequence.

Move To Top

Explains how checkbox selection becomes the first saved categories.

Formula
For each `categoryIds` entry at zero-based position i, the service writes `round(0.001 * (i + 1), 3)` as a temporary category sort. It then replaces every category sort with `ROW_NUMBER()` ordered by that temporary value and commits the transaction.
Caveats
Checkbox selection order determines payload position and therefore moved-category order.

Move To The Set

Explains how categories are inserted after the stored target.

Formula
The service reads the target category sort. For each `categoryIds` entry at zero-based position i, it writes `round(targetCategorySort + 0.001 * (i + 1), 3)`, then replaces every category sort with `ROW_NUMBER()` ordered by the temporary value and commits the transaction.
Caveats
If the target category remains in `categoryIds`, the target itself also receives a new temporary sort.

Empty Move To Top

Explains what happens when Move To Top is pressed without selecting a category.

Formula
The page sends an empty `categoryIds` array. The sort service rejects it and rolls back without changing category order, but current response handling can still run the page's success reset and toast.
Caveats
Success feedback in this case is not proof that any category moved.
Fields8 topicsOpen details

ID

Internal identifier of the category row being moved.

Data Type
integer

Category

Category display name shown in the reorder grid.

Data Type
string

Aggregator

Aggregator currently attached to the category row.

Data Type
string

Order

Current persisted sort value used by the reorder flow.

Data Type
number
Caveats
The initial list is ordered by category ID ascending, not by this value, until the operator explicitly changes column sorting.

Scope

Scope indicator for the category row.

Data Type
enum
Allowed Values
0: Label: External | Value: external | 1: Label: Casino | Value: casino | 2: Label: System | Value: system

Status

Current lifecycle state of the category row.

Data Type
enum
Allowed Values
0: Label: Active | Value: active | 1: Label: Disabled | Value: disabled | 2: Label: Archived | Value: archived

Row checkbox

Local page selection used to decide which category IDs are submitted by Move To Top or Move To The Set.

Data Type
selection-state
Caveats
Selection order is preserved in the `categoryIds` move payload., Page, tab, filter, and sort changes do not clear selected categories., Clicking the row body has no navigation action on this page.

Target

Local page target category ID used as the insertion anchor for Move To The Set.

Data Type
local-state
Caveats
A successful move resets row selection and the grid view, but it does not clear the stored target category., The page does not display the stored target after the confirmation toast., Page, tab, filter, and sort changes do not clear or revalidate it.
Filters5 topicsOpen details

Search

Narrows the candidate categories after Enter is pressed.

Type
text

Aggregators

Narrows the candidate categories by aggregator.

Type
multi-select

Status

Narrows candidate categories by scope even though the current visible label says Status.

Type
multi-select
Allowed Values
0: Label: External | Value: external | 1: Label: Casino | Value: casino | 2: Label: System | Value: system
Caveats
This is the first of two visible Status selectors; its values represent scope, not lifecycle status.

Status

Narrows the candidate categories by lifecycle status.

Type
multi-select
Allowed Values
0: Label: Active | Value: active | 1: Label: Disabled | Value: disabled
Caveats
Archived exists in the page configuration but is hidden from this selector., This is the second of two visible Status selectors.

All / Selected tab

All shows the current server page; Selected locally keeps only selected IDs found on that currently loaded page.

Type
tab
Allowed Values
All, Selected
Caveats
Selected does not gather selected categories from other pages into one list., A selected category from another page can remain in the move payload while not being visible in Selected.
More help

Related pages

NX / Categories

Operator guide for NX category list, detail, mapping relations, and ordering flows.

NX / Categories / Category Mapping

Relation page for linking one NX category to other categories.

NX / Categories / Detail

Record-level workspace for one NX category.

NX / Categories / Game Mapping

Relation page for linking one NX category to games.

NX / Categories / List

Main NX category grid with filters, modal-based create flow, and row navigation into detail.

Auto Tags Manager / Order

Manual drag-and-drop ordering screen for valid auto-tag rules, with a single save action that rewrites sort positions.