MrmTotalSalesComponent

Kind: Class

Source: Pams/Web/Pams.Web/Client/app/components/dashboard/dashboard-libary/widgets/mrm-total-sales/mrm-total-sales.component.ts (line 97)

Part of: Pams

MrmTotalSalesComponent is an Angular dashboard widget that retrieves and saves total-sales dashboard data, then calculates totals by year and month. It participates in Angular lifecycle hooks, handles authorization access, initializes widget state, and translates month names for display.

Methods

Properties

Where it refuses work

• MrmTotalSalesComponent stops the work with an early return when a[propertyName] < b[propertyName], in 2 places.
• MrmTotalSalesComponent stops the work with an early return when a[propertyName] > b[propertyName], in 2 places.
• MrmTotalSalesComponent stops the work with an early return when month.MonthId == 12.
• MrmTotalSalesComponent stops the work with an early return when month[propertyName] < this.data[bIndex].MrmTotalSalesGroups[monthIndex - 1][propertyName].
• MrmTotalSalesComponent stops the work with an early return when month[propertyName] < this.totalBookingMonths[index - 1][propertyName].
• MrmTotalSalesComponent stops the work with an early return when this.allowedtoEnableEdting.

Diagram

mermaid
graph LR
    A[Angular Lifecycle] --> B[ngOnInit]
    A --> C[ngOnChanges]
    A --> D[ngOnDestroy]

    B --> E[GetAuthorizationAccess]
    B --> F[initalizingData]
    F --> G[getDashboardData]

    G --> H[calculateSumByYear]
    G --> I[calculateSumByMonth]
    I --> J[translateMonthName]

    K[Dashboard Configuration] --> L[saveDashboardData]

Usage

ts
import { Component, ViewChild } from '@angular/core';
import { MrmTotalSalesComponent } from './mrm-total-sales.component';

@Component({
  selector: 'app-dashboard-page',
  template: `
    <app-mrm-total-sales #totalSalesWidget></app-mrm-total-sales>
    <button type="button" (click)="refreshSalesData()">
      Refresh sales data
    </button>
  `
})
export class DashboardPageComponent {
  @ViewChild('totalSalesWidget')
  totalSalesWidget!: MrmTotalSalesComponent;

  refreshSalesData(): void {
    this.totalSalesWidget.getDashboardData();
  }

  saveWidgetSettings(): void {
    this.totalSalesWidget.saveDashboardData();
  }
}

AI Coding Instructions

• Keep initialization logic inside ngOnInit() and react to updated bound values through ngOnChanges().
• Preserve the existing GetAuthorizationAccess() flow when adding dashboard data requests or save actions.
• Use initalizingData() for resetting or preparing widget state before processing dashboard results.
• Keep year and month aggregation logic in calculateSumByYear() and calculateSumByMonth() rather than duplicating calculations in templates.
• Clean up subscriptions, timers, or other retained resources in ngOnDestroy().

Used by

3 references from 3 files. Each is a place in this repository where the symbol is actually used — go read one rather than trusting an example.

Imported by (3)

• TranslateHandler — Pams/Web/Pams.Web/Client/app/app.module.ts:1
• DashboardTabComponent — Pams/Web/Pams.Web/Client/app/components/dashboard/dashboard-libary/dashboard-tab/dashboard-tab.component.ts:1
• ReportsTabComponent — Pams/Web/Pams.Web/Client/app/components/dashboard/reports-library/reports-tab/reports-tab.component.ts:1