Skip to content

Commit

Permalink
Merge pull request #1083 from metasfresh/gh19301-me03
Browse files Browse the repository at this point in the history
Translate highest PP doc
  • Loading branch information
metas-Kay authored Jun 10, 2024
2 parents ec494be + d1f6a84 commit 3c41edb
Show file tree
Hide file tree
Showing 3 changed files with 64 additions and 12 deletions.
51 changes: 51 additions & 0 deletions _webui_collection/DE/Material-Cockpit-hoechster-einkaufspreis.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
---
title: Wie kann ich die höchsten Einkaufspreise für einen bestimmten Zeitraum einsehen? (Systemadministrator)
layout: default
tags:
- Stammdaten
- Lagerverwaltung
- Material Cockpit / Handelsbord
lang: de
sequence: 20
ref: material-cockpit-highest-purchase-price
---

## Überblick
metasfresh bietet über das [Material Cockpit](Material-Cockpit) die Möglichkeit, u.a. den höchsten Einkaufspreis für einen bestimmten Zeitraum in der Vergangenheit, ausgehend vom aktuellen Tag, zu ermitteln. Um diese Funktion nutzen zu können, sind **Administratorrechte** notwendig, um die erforderlichen Systemkonfigurationen zur Berechnung und Anzeige der gewünschten Daten zu aktivieren. Zu diesen Systemkonfigurationen zählen die folgenden:
- `de.metas.ui.web.material.cockpit.rowfactory.HighPriceProvider.isActive`
- Durch Aktivierung dieser Konfiguration wird der [Listenansicht](Ansichten#listenansicht) des Material Cockpits eine Spalte mit dem Namen "Höchster EP" (EP=Einkaufspreis) hinzugefügt.
- `de.metas.ui.web.material.cockpit.field.HighestPurchasePrice_AtDate.LastDays`
- Mittels dieser Konfiguration kann die Zeitspanne, d.h. die Anzahl der vergangenen Tage, festgelegt werden, die zur Ermittlung des letzten höchsten Einkaufspreises ausgehend vom aktuellen Tag herangezogen wird.
- `de.metas.ui.web.material.cockpit.field.HighestPurchasePrice_AtDate.CurrencyCode`
- Mittels dieser Konfiguration kann die Währung festgelegt werden, in der der höchste Einkaufspreis angezeigt werden soll unter Berücksichtigung des Umrechnungskurses im Falle unterschiedlicher Währungen.

Damit diese Funktion zuverlässig und effizient arbeitet, werden die **Daten zwischengespeichert** und jede Nacht automatisch inkrementell aktualisiert, d.h. nur Produkte und Termindaten werden aktualisiert. Die zwischengespeicherten Daten enthalten den höchsten Preis für jedes Produkt an jedem Tag in der festgelegten Währung. Der Cache kann auch [manuell aktualisiert oder komplett neu aufgebaut](#cache-aktualisieren-neu-aufbauen) werden, z.B. nach einer Anpassung des Umrechnungskurses.

## Schritte

### Systemkonfigurationen aktivieren
1. [Melde Dich bei metasfresh an](Anmeldung) mit der [Benutzerrolle](NeueBenutzerrolle) "Systemadministrator".
1. [Gehe ins Menü](Menu) und öffne das Fenster "Systemkonfigurator".
1. [Verwende die Filterfunktion](Filterfunktion) und suche über das Feld **Name** nach der Systemkonfiguration (siehe Überblick oben).
1. Öffne den Systemkonfigurationseintrag.
>**Hinweis:** Stelle sicher, dass der Eintrag, den du einschalten möchtest (siehe folgenden Schritt), auch [aktiviert ist](Datensatz_aktivieren).
1. Trage in das Feld **Suchschlüssel** je nach Systemkonfigurationseintrag folgende Werte ein:
- zum **Einschalten** der Systemkonfiguration trage `Y` ein und bestätige mit `↵ Enter`. Um sie auszuschalten, trage `N` ein.
- um die **Anzahl der Tage** für die Ermittlung des letzten höchsten Einkaufspreises festzulegen, trage eine Zahl ein (z.B. `7`) und bestätige mit `↵ Enter`.
1. [metasfresh speichert automatisch](Speicheranzeige).

### <a name="cache-aktualisieren-neu-aufbauen">Cache manuell aktualisieren oder neu aufbauen</a>

| **Wichtiger Hinweis:** |
| :--- |
| Wenn die Umrechnungskurse der Einkaufspreise angepasst wurden, muss der **gesamte Cache neu aufgebaut** werden, damit das Material Cockpit die korrekten Einkaufspreise anzeigen kann. |

1. [Gehe ins Menü](Menu) und öffne das Fenster "Material Cockpit".
1. [Starte die Aktion](AktionStarten#aktionsmenue) "Update purchase order highest price cache" (*Cache für höchste Einkaufspreise aktualisieren*). Es öffnet sich ein Overlay-Fenster.
1. Es gibt zwei Optionen:<br>
**a)** Setze ein Häkchen bei **Rebuild**, wenn der ***bestehende Cache gelöscht*** und auf Grundlage der aktuellsten Daten ***neu erstellt werden*** soll (z.B. bei geänderten Umrechnungskursen).<br>
**b)** Sollen nur ***Produkte und Termindaten*** auf Grundlage der vorhandenen Währungsdaten aktualisiert werden, **deaktiviere das Kontrollkästchen**.
>**Hinweis:** Der Cache wird automatisch jede Nacht ohne Neuaufbau aktualisiert (Option b), um tagesgenaue Daten zu erhalten.
1. Klicke auf "Start", um den Cache zu aktualisieren/neu aufzubauen und das Overlay-Fenster zu schließen.
3 changes: 2 additions & 1 deletion _webui_collection/DE/Material-Cockpit.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ ref: material-cockpit
---

## Überblick
In metasfresh kannst du über das sogenannte **Material Cockpit** (oder Handelsbord) die Bestände deiner Produkte auf Lager sowie weitere Bestands- und Belegdetails einsehen und verwalten.
In metasfresh kannst du über das sogenannte **Material Cockpit** (oder Handelsbord) die Bestände deiner Produkte auf Lager sowie weitere Bestands- und Belegdetails einsehen und verwalten wie z.B. die [höchsten Einkaufspreise](Material-Cockpit-hoechster-einkaufspreis).

## Schritte
1. [Gehe ins Menü](Menu) und öffne das Fenster "Material Cockpit".
Expand All @@ -20,6 +20,7 @@ In metasfresh kannst du über das sogenannte **Material Cockpit** (oder Handelsb

## Nächste Schritte (optional)
- [Erfasse Bestandsmengen mittels einer Inventur](Inventur_HUs_erstellen) oder füge neue [Handling Units](Handling_Unit_System) dem Bestand hinzu.
- [Füge der Listenansicht eine Spalte für den höchsten Einkaufspreis hinzu. (Systemadministrator)](Material-Cockpit-hoechster-einkaufspreis)

## Beispiel
<kbd><img src="assets/Material-Cockpit.png" alt="Screenshot: Material Cockpit"></kbd>
22 changes: 11 additions & 11 deletions _webui_collection/EN/Material-Cockpit-highest-purchase-price.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: How can I check the highest purchase prices for a specific period? (System Administrator)
title: How do I check the highest purchase prices for a specific period? (System Administrator)
layout: default
tags:
- Master Data
Expand All @@ -17,14 +17,14 @@ see also: https://github.com/metasfresh/mf15/issues/2942
## Overview
Via the [material cockpit](Material-Cockpit), metasfresh offers the possibility to determine, among other data, the highest purchase price for a defined period in the past, based on the current day. In order to use this feature, you need **administrator permissions** to activate the system configurations required to calculate and display the requested data accordingly. These system configurations are the following:
- `de.metas.ui.web.material.cockpit.rowfactory.HighPriceProvider.isActive`
- By enabling this configuration, a column called "Highest PP" (PP=Purchase Price) is added to the material cockpit [list view](ViewModes).
- By enabling this configuration, a column called "Highest PP" (PP=Purchase Price) is added to the material cockpit [list view](ViewModes#list-view).
- `de.metas.ui.web.material.cockpit.field.HighestPurchasePrice_AtDate.LastDays`
- Via this configuration, you can set the timespan, i.e. days in the past to be used for determining the last highest purchase price based on the current day.
- Via this configuration, you can set the timespan, i.e. the number of past days, that is used to determine the last highest purchase price based on the current day.
- `de.metas.ui.web.material.cockpit.field.HighestPurchasePrice_AtDate.CurrencyCode`
- Via this configuration, you can define the currency that the highest price shall be displayed in, also considering the conversion rate in case of different currencies.
- Via this configuration, you can define the currency in which the highest purchase price shall be displayed, taking into account the conversion rate in case of different currencies.

In order to be performant, the **data is cached** and updated automatically in increments each night, meaning that only products and dates are updated. The cached data contains the highest price of each product on each day in the defined currency.
You can also [manually update the cache or rebuild it](#update-rebuild-cache) entirely, e.g., after changing the currency rate.
For this feature to perform reliably and efficiently, the **data is cached** and automatically refreshed incrementally each night, meaning that only products and dates are updated. The cached data contains the highest price of each product on each day in the specified currency.
You can also [manually update the cache or rebuild it](#update-rebuild-cache) entirely, e.g., after adjusting the currency rate.

## Steps

Expand All @@ -35,17 +35,17 @@ You can also [manually update the cache or rebuild it](#update-rebuild-cache) en
1. Open the system configuration entry.
>**Note:** Make sure the entry you want to enable (see next step) is [activated](Activate_record).
1. In the field **Search Key**,
- to **enable** a system configuration enter `Y` and hit `↵ Enter` to apply. To disable it, enter `N`.
- to set the **number of days** for determining the last highest purchase price enter a number (e.g. `7`) and hit `↵ Enter` to apply.
1. In the field **Search Key**, enter the following values depending on the system configuration entry:
- to **enable** a system configuration, enter `Y` and hit `↵ Enter` to apply. To disable it, enter `N`.
- to set the **number of days** for determining the last highest purchase price, enter a number (e.g. `7`) and hit `↵ Enter` to apply.

1. [metasfresh saves the progress automatically](Saveindicator).

### <a name="update-rebuild-cache">Manually Update or Rebuild Cache</a>

| **Important note:** |
| :--- |
| If the currency rates of purchase prices are changed, the entire **cache must be rebuilt** in order for the material cockpit to display the correct purchase prices. |
| If the currency rates of purchase prices have changed, the entire **cache must be rebuilt** in order for the material cockpit to display the correct purchase prices. |

1. Open "Material Cockpit" from the [menu](Menu).
1. [Start the action](StartAction#actions-menu) "Update purchase order highest price cache". An overlay window opens up.
Expand All @@ -54,4 +54,4 @@ You can also [manually update the cache or rebuild it](#update-rebuild-cache) en
**b)** If you only want to ***update products and dates*** based on the existing currency data, **deactivate the checkbox**.
>**Note:** The cache is automatically updated each night without rebuilding (option b) for daily accurate data.
1. Click "Start" to update/rebuild the cache.
1. Click "Start" to update/rebuild the cache and close the overlay window.

0 comments on commit 3c41edb

Please sign in to comment.