Operations

Kind: Class

Source: Pams/Web/Pams.Web/Client/app/components/dashboard/dashboard-operations.ts (line 15)

Part of: Pams

Operations contains dashboard data helpers for converting enums, grouping and sorting records, preparing grouped data, and calculating derived values. It also includes display-oriented helpers for remaining-day values, sparkline data, and random colors.

Methods

Properties

Where it refuses work

• Operations stops the work with an early return when !groupField || !actual || !target.
• Operations stops the work with an early return when !groups || !groups.length.
• Operations stops the work with an early return when !actual.
• Operations stops the work with an early return when !labels.
• Operations stops the work with an early return when type == dash.DateGroupEnum.Month.
• Operations stops the work with an early return when FilterString.length > 3.

Diagram

mermaid
graph LR
  Operations --> EnumToArray
  Operations --> GroupBy_v1
  Operations --> GroupBy_Single
  Operations --> ConstructGroups_WithFields
  Operations --> SortGroups
  Operations --> SortGroupedObjectKeys
  Operations --> CalculateExpression
  Operations --> getRemainingDays
  Operations --> SparkLine
  Operations --> getRandomColor

  GroupBy_v1 --> ConstructGroups_WithFields
  GroupBy_Single --> ConstructGroups_WithFields
  ConstructGroups_WithFields --> SortGroups
  SortGroups --> SortGroupedObjectKeys

Usage

ts
import { Operations } from "./components/dashboard/dashboard-operations";

const operations = new Operations();

const enumItems = operations.EnumToArray();
const groupedRecords = operations.GroupBy_v1();
const preparedGroups = operations.ConstructGroups_WithFields();

operations.SortGroups();
operations.SortGroupedObjectKeys();

const remainingDays = operations.getRemainingDays();
const sparkLineData = operations.SparkLine();
const color = operations.getRandomColor();
const calculatedValue = operations.CalculateExpression();

console.log({
  enumItems,
  groupedRecords,
  preparedGroups,
  remainingDays,
  sparkLineData,
  color,
  calculatedValue,
});

AI Coding Instructions

• Keep grouping logic inside Operations so dashboard components consume prepared group data rather than duplicate grouping behavior.
• Call sorting methods after building grouped data when the dashboard depends on ordered group output.
• Preserve the return shapes of EnumToArray, grouping methods, and ConstructGroups_WithFields when changing dashboard data handling.
• Treat SparkLine, getRandomColor, and CalculateExpression as display and derived-value helpers; keep their output compatible with current dashboard bindings.

Relationships

• IMPORTS → DashboardDataFields
• IMPORTS → OperationTypeEnum
• IMPORTS → DateGroupEnum
• IMPORTS → FilterOptions
• IMPORTS → DataTypeEnum
• IMPORTS → Measure
• IMPORTS → data
• IMPORTS → EnumItem
• IMPORTS → DimensionField
• IMPORTS → PreparedDataGroups
• IMPORTS → DashboardWidgetTypeEnum
• IMPORTS → DateGroupEnum
• IMPORTS → DashboardWidget
• IMPORTS → widgetData
• IMPORTS → AppSettings

Used by

1 reference from 1 file. Each is a place in this repository where the symbol is actually used — go read one rather than trusting an example.

Imported by (1)

• DashboardWidgetOperationsService — Pams/Web/Pams.Web/Client/app/services/dashboard/dashboard-widget-operations.service.ts:1