# MrmCashPositionComponent

**Kind:** Class

**Source:** `Pams/Web/Pams.Web/Client/app/components/dashboard/dashboard-libary/widgets/mrm-cash-position/mrm-cash-position.component.ts` (line 89)

**Part of:** [Pams](subsystem-pams)

`MrmCashPositionComponent` is an Angular dashboard widget that retrieves, initializes, and saves cash-position dashboard data. It checks authorization, obtains currency rates, aggregates monthly values, and calculates a performance percentage for the dashboard view.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `GetAuthorizationAccess` | `GetAuthorizationAccess(url: string)` | `void` |
| `ngOnInit` | `ngOnInit()` | `void` |
| `ngOnChanges` | `ngOnChanges()` | `void` |
| `ngOnDestroy` | `ngOnDestroy()` | `void` |
| `getDashboardData` | `getDashboardData()` | `void` |
| `saveDashboardData` | `saveDashboardData()` | `void` |
| `initalizingData` | `initalizingData(value: BranchData[])` | `void` |
| `calculateSumByMonth` | `calculateSumByMonth(monthIndex: number)` | `void` |
| `getCurrencyRates` | `getCurrencyRates()` | `void` |
| `calculatePerformancePer` | `calculatePerformancePer(month: MonthData)` | `number` |
| `translateMonthName` | `translateMonthName(month: MonthData)` | `string` |
| `getpriceFormatted` | `getpriceFormatted(x: undefined)` | `string` |
| `syncScroll` | `syncScroll(e: undefined)` | `void` |
| `onResize` | `onResize()` | `void` |
| `setChaching` | `setChaching()` | `void` |
| `getChaching` | `getChaching()` | `void` |
| `onValueChanged` | `onValueChanged(e: undefined)` | `void` |
| `onChartInit` | `onChartInit(e: any, index: number)` | `void` |
| `switchChartTypeHandler` | `switchChartTypeHandler()` | `void` |
| `switchBasedOnTendencyHandler` | `switchBasedOnTendencyHandler()` | `void` |
| `isCurrentMonth` | `isCurrentMonth(month: MonthData)` | `boolean` |
| `comparingWithPrevMonth` | `comparingWithPrevMonth(month: MonthData, bIndex: number, index: number, propertyName: string)` | `string` |
| `comparingMonthsWithPrevSumm` | `comparingMonthsWithPrevSumm(month: TotalBookingMonths, index: number, propertyName: string)` | `string` |
| `setValue` | `setValue(value: number)` | `void` |
| `setForecastValue` | `setForecastValue(value: number)` | `void` |
| `setMarginAvarage` | `setMarginAvarage(value: number)` | `void` |
| `isForecast` | `isForecast(month: MonthData)` | `boolean` |
| `isAchievedOrCurrent` | `isAchievedOrCurrent(month: MonthData)` | `boolean` |
| `getpriceForecastAmount` | `getpriceForecastAmount(month: MonthData)` | `number` |
| `expectedCurrencyChange` | `expectedCurrencyChange(e: undefined)` | `void` |
| `selectText` | `selectText(e: undefined)` | `void` |
| `mouseoverRowSpan` | `mouseoverRowSpan(e: undefined, bIndex: number)` | `void` |
| `mouseoutRowSpan` | `mouseoutRowSpan(e: undefined, bIndex: number)` | `void` |
| `editSelectedMonthPrepare` | `editSelectedMonthPrepare(month: MonthData)` | `void` |
| `sorting` | `sorting(propertyName: string, propertyType: string, monthIndex: number)` | `void` |

## Properties

| Property | Type |
|---|---|
| `scrollOne` | `ElementRef` |
| `scrollTwo` | `ElementRef` |
| `scrollThree` | `ElementRef` |
| `_widget` | `Widget` |
| `_widgetType` | `string` |
| `withoutOptionBar` | `boolean` |
| `editMode` | `boolean` |
| `bookingOrSales` | `number` |
| `withNominal` | `boolean` |
| `selectedTeam` | `number` |
| `forecastRuleId` | `number` |
| `allowedtoEdit` | `boolean` |
| `allowedtoEnableEdting` | `boolean` |
| `widgetEditRequest` | `any` |
| `widgetEditEnd` | `any` |
| `selectedData` | `BranchData[]` |
| `forecastRules` | `any[]` |
| `selectedYear` | `number` |
| `numYearsDatasource` | `any[]` |
| `todayWidgetsEnum` | `any` |
| `cachingWidgetData` | `CachingWidgetData` |
| `data` | `BranchData[]` |
| `originalData` | `BranchData[]` |
| `currencyRateData` | `currencyRatesData[]` |
| `singleMonths` | `MonthData` |
| `branchCurrency` | `any` |
| `basedOnTendency` | `boolean` |
| `subscription` | `Subscription` |
| `SeriseRange` | `any[]` |
| `echartsIntance` | `any` |
| `totalBookingMonths` | `TotalBookingMonths[]` |
| `tempTotalMonth` | `TotalBookingMonths` |
| `sortingDirection` | `number` |

## Where it refuses work

- `MrmCashPositionComponent` stops the work with an early return when `a[propertyName] < b[propertyName]`, in 2 places.
- `MrmCashPositionComponent` stops the work with an early return when `a[propertyName] > b[propertyName]`, in 2 places.
- `MrmCashPositionComponent` stops the work with an early return when `month.MonthId == 12`.
- `MrmCashPositionComponent` stops the work with an early return when `this.allowedtoEnableEdting`.
- `MrmCashPositionComponent` stops the work with an early return when `this.allowedtoEdit`.
- `MrmCashPositionComponent` stops the work with an early return when `month[propertyName] < this.data[bIndex].MrmCashPositions[index - 1][propertyName]`.

## Diagram

```mermaid
graph LR
  View[Dashboard View] --> Component[MrmCashPositionComponent]
  Component --> Auth[GetAuthorizationAccess]
  Component --> Init[initalizingData]
  Component --> Load[getDashboardData]
  Component --> Rates[getCurrencyRates]
  Rates --> Monthly[calculateSumByMonth]
  Monthly --> Performance[calculatePerformancePer]
  Component --> Save[saveDashboardData]
  Component --> Destroy[ngOnDestroy]
```

## Usage

```ts
import { TestBed } from '@angular/core/testing';
import { MrmCashPositionComponent } from './mrm-cash-position.component';

const fixture = TestBed.createComponent(MrmCashPositionComponent);
const cashPositionWidget = fixture.componentInstance;

// Runs Angular lifecycle hooks and loads initial widget state.
fixture.detectChanges();

// Refresh dashboard data when required by the host dashboard.
cashPositionWidget.getDashboardData();

fixture.detectChanges();

const performance = cashPositionWidget.calculatePerformancePer();
console.log('Cash position performance:', performance);
```

## AI Coding Instructions

- Keep data loading inside `getDashboardData()` and initialization logic inside `initalizingData()` so lifecycle methods remain focused on orchestration.
- Check authorization through `GetAuthorizationAccess()` before exposing or loading cash-position data.
- Refresh currency-rate-dependent calculations through `getCurrencyRates()` before calling `calculateSumByMonth()` or `calculatePerformancePer()`.
- Preserve the existing `initalizingData()` method name when calling or refactoring it, including its current spelling.
- Release subscriptions, timers, or other resources in `ngOnDestroy()` when adding asynchronous dashboard behavior.

## 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