octobercms/october · error · SystemException

The database column name cannot be empty.

Error message

The database column name cannot be empty.

What it means

Error "The database column name cannot be empty." thrown in octobercms/october.

Source

Thrown at modules/dashboard/classes/ReportDimension.php:116

     * @param string $databaseColumnName Specifies the column name in the data source table.
     * Dimension columns typically match the primary key in the dimension table.
     * @param string $displayName Specifies the dimension name used in reports, e.g., "Product".
     * @param ?string $labelColumnName Specifies the name of the column for the dimension label.
     * Use this column to provide a user-friendly label for the dimension, e.g., "product_name".
     * If this argument is not provided, the value of $databaseColumnName is used as the dimension label.
     */
    public function __construct(
        string $code,
        string $databaseColumnName,
        string $displayName,
        ?string $labelColumnName = null
    ) {
        if (!strlen($code)) {
            throw new SystemException('The dimension code cannot be empty.');
        }

        if (!strlen($databaseColumnName)) {
            throw new SystemException('The database column name cannot be empty.');
        }

        if (!strlen($displayName)) {
            throw new SystemException('The display name cannot be empty.');
        }

        $knownTypes = [
            ReportDimension::TYPE_INDICATOR
        ];

        $dimensionType = null;
        $codeParts = explode('@', $code);
        if (count($codeParts) === 2) {
            $dimensionType = $codeParts[0];
        }

        if ($dimensionType !== null && !in_array($dimensionType, $knownTypes)) {
            throw new SystemException('Unknown dimension type: ' . $dimensionType);

View on GitHub (pinned to b608633a7e)

When it happens

Trigger: Thrown at modules/dashboard/classes/ReportDimension.php:116 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of octobercms/october@b608633a7e (2026-08-21). Data as JSON: /api/errors/7e2fb501737eaf50. Report an issue: GitHub.