numbering/index
Overview
Module
- package:
org.eclipse.dirigible.sdk.numbering - source: numbering/
The numbering module allocates the next gap-free number from a declared document-number series - rendered as the series' literal prefix plus the sequence zero-padded to its total width. It is backed by the platform's per-tenant counter store - the same store the application shell's Document Numbering settings manage - so hand-written custom/ code and the intent-generated stamping share one engine and one sequence per series.
Numbering is a first-class concern in business software (invoices, orders, receipts, credit and debit notes), so the platform owns the sequence: allocation is gap-free, the counter lives in the tenant's schema, and the shape (prefix + width) is declared by the module's .numbers artefact and configured per tenant - never baked into code. Most applications never call this SDK directly - they declare a number: { ... } field in the intent model and the generator wires the stamping. Use the SDK when you need a number from bespoke logic that the declarative form does not cover.
The main components of this module are:
- DocumentNumbers: Static
next(series[, partition])- allocate the next number of a series (optionally within a partition, e.g. per company).