cdmTicker — Hilfe

Was die App leistet

cdmTicker blendet ein Laufband in das Rollencenter von Business Central ein, das frei konfigurierbare Kennzahlen (KPIs) als fortlaufenden Lauftext zeigt — wie ein Börsenticker. So behalten Benutzer ihre wichtigsten Zahlen im Blick, ohne im Rollencenter zu scrollen oder Kacheln zu suchen.

• Live-Kennzahlen als Laufband — das Band aktualisiert seine Werte alle 60 Sekunden ohne Zutun des Benutzers.
• Drilldown per Klick — ein Klick öffnet die zugehörige Liste, etwa die Verkaufsaufträge oder die Debitorenposten; bei Mauskontakt pausiert das Band.
• Fünf eingebaute Kennzahlen, jede zählbare Standard-Kachel (Cue-Feld) aus 16 unterstützten Cue-Tabellen und die ausstehenden Benutzeraufgaben.
• Je Rollencenter konfiguriert — 15 Standard-Rollencenter werden unterstützt; jede Kennzahl läuft in einem Rollencenter oder global in allen aktivierten.
• Freie Farbwahl — Hintergrund (einfarbig oder Verlauf) und Schriftfarbe per Color Picker oder Hex-Eingabe.
• Erweiterbar — eigene KPI-Typen und alternative Filter über Integrationsereignisse.
• Keine externen Dienste, keine KI — alle Werte werden innerhalb von Business Central mit den Berechtigungen des jeweiligen Benutzers berechnet.

Diese Hilfe folgt dem Key Usage Scenario Guide (PDF, englisch). Beispiel ist durchgängig das Rollencenter Verkaufsauftragsverarbeitung (Sales Order Processor) im Demomandanten CRONUS.

Erste Schritte

Voraussetzungen und Installation

cdmTicker wird wie jede Erweiterung installiert — aus dem AppSource oder, für eine manuelle Bereitstellung, über Erweiterungsverwaltung → Erweiterung hochladen. Die App benötigt Business Central Version 28 (Plattform 28.0) oder neuer und hat keine Abhängigkeiten zu anderen Apps.

1. Installieren Sie die Erweiterung aus dem AppSource oder laden Sie die App-Datei in der Erweiterungsverwaltung hoch.
2. Weisen Sie den Berechtigungssatz cdmTicker jedem Benutzer zu, der das Band sehen soll, und jedem, der es konfiguriert. Der Satz deckt alle Objekte der App ab; weitere app-spezifische Berechtigungen sind nicht nötig.
3. Beachten Sie die normalen Datenberechtigungen der Benutzer: Der Ticker berechnet jede Kennzahl mit den Rechten des Benutzers, der ihn betrachtet. Eine Kennzahl, deren Quelltabelle der Benutzer nicht lesen darf, wird für ihn einfach ausgelassen — der Rest des Bands läuft weiter.

Kennzahlenkatalog initialisieren

Die Seite Ticker Setup ist der einzige Ort, an dem die App konfiguriert wird. Öffnen Sie sie über Wie möchten Sie weiter verfahren (Alt+Q) mit dem Suchbegriff „Ticker Setup"; sie ist in der Kategorie Verwaltung gelistet. Beim ersten Öffnen legt die Seite ihren Setup-Datensatz an und setzt die Standardfarben. Der Kennzahlenkatalog wird dagegen auf Anforderung aufgebaut, damit Sie entscheiden, wann die Rollencenter-Zeilen entstehen.

1. Öffnen Sie Ticker Setup.
2. Wählen Sie die Aktion Initialize Standard KPIs.
3. Die App legt jetzt die 15 Rollencenter-Zeilen an (nur Business Manager ist standardmäßig aktiviert), setzt die Standardfarben, falls alle drei Farbfelder leer sind, und baut den Katalog auf: für jedes unterstützte Rollencenter eine Zeile pro zählbarer Kachel seiner Standard-Cue-Tabellen plus eine Zeile Pending User Tasks. Alle Katalogzeilen werden deaktiviert angelegt — es erscheint also noch nichts im Rollencenter.
4. Lesen Sie die Bestätigungsmeldung — sie nennt die Anzahl der erzeugten KPI-Zeilen.

Benutzereinstellungen

Der Ticker erscheint in dem Rollencenter, das dem Profil (der Rolle) des Benutzers zugewiesen ist. Öffnen Sie Meine Einstellungen, prüfen Sie das Feld Rolle und stellen Sie sicher, dass es auf eines der 15 unterstützten Rollencenter zeigt — im Walkthrough Verkaufsauftragsverarbeitung. Benutzer ohne gewähltes Profil erhalten das Standardprofil des Mandanten.

Ticker konfigurieren

Die Seite Ticker Setup

Die Seite besteht aus drei Bereichen, die von oben nach unten verwendet werden:

• Role Centers — die Liste der 15 unterstützten Rollencenter mit ihren Seiten-IDs. Das Häkchen Enabled schaltet den Ticker für das ganze Rollencenter ein oder aus. Die Auswahl einer Zeile filtert den KPI-Bereich darunter automatisch auf dieses Rollencenter.
• Appearance — die drei Farbfelder Background Color, Background Color 2 (Gradient) und Text Color, gefolgt vom Color Picker mit denselben drei Farben als Browser-Farbsteuerelemente.
• KPIs — die Liste der Ticker-Zeilen: welche Kennzahl in welchem Rollencenter läuft, in welcher Reihenfolge, mit welcher Beschreibung und welchem Drilldown-Ziel.

Ein Rollencenter aktivieren

1. Suchen Sie im Bereich Role Centers das gewünschte Rollencenter — im Walkthrough Sales Order Processor (9006).
2. Setzen Sie Enabled.
3. Bitten Sie die Benutzer dieses Rollencenters, die Browserseite neu zu laden (oder zum Rollencenter zu wechseln). Das Band erscheint beim nächsten Laden.

In einem nicht aktivierten Rollencenter klappt der Ticker seine Zeile vollständig ein und belegt keinen Platz.

Kennzahlen aus dem Katalog aktivieren

1. Wählen Sie das Rollencenter im Bereich Role Centers. Das Feld Role Center Filter im KPI-Bereich zeigt jetzt dessen ID, und die Liste enthält nur noch die Katalogzeilen dieses Rollencenters — für 9006 die neun Kacheln des Sales Cue (von Sales Quotes - Open bis Sales Credit Memos - Pending Document Exchange), die beiden Genehmigungskacheln und Pending User Tasks.
2. Setzen Sie Enabled auf den Zeilen, die im Band laufen sollen.
3. Passen Sie optional Sequence an, um die Reihenfolge zu ändern.

Die Spalte Description zeigt die Beschriftung, die im Ticker erscheint — die Standard-Kachelbeschriftung in der Sprache des Benutzers, sofern kein Override eingetragen ist. Die Spalte Drilldown Page ID enthält bereits die Liste, die bei einem Klick geöffnet wird, zum Beispiel 9305 (Verkaufsauftragsliste) für Sales Orders - Open.

Die eingebauten Kennzahlen als globale Zeilen

Fünf Kennzahlen sind fest in die App eingebaut und brauchen keine Quelltabelle: Open Orders Count, Order Backlog (Amount), Shipments Today, Invoiced Today und Overdue Receivables. Sie sind nicht Teil des automatischen Katalogs und werden manuell ergänzt — typischerweise als globale Zeilen, die in jedem aktivierten Rollencenter laufen:

1. Leeren Sie das Feld Role Center Filter oder setzen Sie es auf 9006|0, damit globale Zeilen sichtbar sind.
2. Legen Sie eine neue Zeile an und tragen Sie Role Center Page ID 0 ein — null bedeutet „alle aktivierten Rollencenter".
3. Vergeben Sie eine Sequence (10, 20, 30, …) und wählen Sie den KPI Type.
4. Belassen Sie Show As auf dem zum KPI passenden Wert (Beträge als Amount, Anzahlen als Quantity) und Drilldown Page ID auf 0 — die eingebauten Kennzahlen öffnen ihre Standardliste automatisch.
5. Manuell angelegte Zeilen sind standardmäßig aktiviert; die Zeile erscheint beim nächsten Refresh im Band.

Globale Zeilen laufen zuerst im Band, danach die Zeilen des aktuellen Rollencenters — jede Gruppe in Sequenzreihenfolge.

Jede Standard-Kachel als Cue-Feld

Jede zählbare Kachel der 16 unterstützten Cue-Tabellen kann zur Ticker-Zeile werden — auch für Rollencenter oder Kacheln, die nicht Teil des automatischen Katalogs sind:

1. Legen Sie eine neue Zeile an und tragen Sie die Role Center Page ID ein (oder 0 für global).
2. Nutzen Sie in Source Table No. das Lookup. Es listet genau die 16 unterstützten Cue-Tabellen. Die Wahl einer Tabelle setzt den KPI Type automatisch auf Cue Field (Standard Cue).
3. Nutzen Sie in Source Field No. das Lookup. Es zeigt nur die zählbaren Felder dieser Tabelle — Flowfields vom Typ Integer oder Decimal, die nicht veraltet sind. Die Auswahl füllt zwei weitere Spalten vor: Show As (Decimal → Amount, Integer → Quantity) und Drilldown Page ID aus dem eingebauten Mapping der App.
4. Setzen Sie Enabled, falls noch nicht gesetzt.

Eine Zeile feinjustieren

Band gestalten

Die Standardfarben stammen aus dem Business-Central-Logo: Hintergrund #09638E (Dunkelblau) mit Verlauf nach #2BDABE (Türkis), Schrift #9FF2E4 (Mint).

1. Wählen Sie im Bereich Appearance eine Farbe im Color Picker. Der Hex-Wert wird in das passende Feld geschrieben und sofort gespeichert.
2. Alternativ geben Sie einen Wert im Format #RRGGBB ein (sieben Zeichen, führendes #, Hexadezimalziffern). Jede andere Eingabe wird mit einer Fehlermeldung abgewiesen; der Color Picker folgt einer gültigen manuellen Eingabe.
3. Lassen Sie Background Color 2 (Gradient) leer für einen einfarbigen Hintergrund, oder füllen Sie es für einen horizontalen Verlauf von Background Color zu Background Color 2.
4. Laden Sie das Rollencenter neu, um das Ergebnis zu sehen.

Um jederzeit zu den Logo-Farben zurückzukehren, wählen Sie die Aktion Restore Default Colors in der Aktionsleiste der Seite Ticker Setup. Nach einer Bestätigung werden die drei Farbfelder und der Color Picker auf #09638E, #2BDABE und #9FF2E4 zurückgesetzt; KPI-Zeilen und Rollencenter-Aktivierungen bleiben unberührt.

Ticker im Rollencenter nutzen

Das laufende Band

Nach der Konfiguration sieht der Benutzer das Band in einer eigenen Zeile über den Aktivitätenkacheln, über die volle Breite des Arbeitsbereichs. Es läuft mit konstanter Geschwindigkeit von 80 Pixeln pro Sekunde und wiederholt sich ohne sichtbare Lücke. Jeder Eintrag besteht aus Beschreibung, Doppelpunkt und dem fett gesetzten Wert, getrennt vom nächsten Eintrag durch einen Punkt. Die Werte entsprechen denen der Kacheln im Aktivitätenbereich darunter.

Automatische Aktualisierung

Das Band fordert alle 60 Sekunden frische Werte aus Business Central an. Hat sich nichts geändert, bleibt die laufende Animation unberührt — das Band startet nicht neu. Hat sich ein Wert geändert, wird das Band mit dem neuen Inhalt neu aufgebaut.

Pausieren und Drilldown

1. Bewegen Sie die Maus über das Band — es pausiert, damit Sie in Ruhe lesen können, und der Wert unter dem Zeiger wird unterstrichen.
2. Klicken Sie auf die Kennzahl. Die konfigurierte oder automatisch ermittelte Seite öffnet sich: für Sales Orders - Open die Verkaufsauftragsliste, für Requests to Approve die Genehmigungsanfragen, für Pending User Tasks die Benutzeraufgabenliste.
3. Bewegen Sie die Maus weg — das Band läuft weiter.

Eine Zeile mit Drilldown Page ID 0 und ohne automatisches Ziel (einige wenige Kacheln haben keine sinnvolle Liste) reagiert auf einen Klick nicht — das Band läuft einfach weiter.

Sprache und Formatierung

• Automatische Beschreibungen — die Feldbeschriftungen der Cue-Felder und die Namen der eingebauten KPI-Typen — erscheinen in der Sprache der Benutzersitzung. Ein Override wird jedem Benutzer wörtlich angezeigt.
• Beträge werden mit zwei Nachkommastellen und dem Währungssymbol der Finanzbuchhaltung-Einrichtung formatiert; Anzahlen als ganze Zahlen.
• Datumsangaben in den Cue-Filtern folgen dem Arbeitsdatum des Benutzers — genau wie die Kacheln.

Wenn eine Kennzahl nicht berechnet werden kann

Jede Kennzahl wird isoliert berechnet. Eine Zeile, die keinen Wert liefern kann — weil dem Benutzer die Berechtigung auf die Quelltabelle fehlt, das Quellfeld nach einem Upgrade veraltet ist oder kein Flowfield mehr ist — wird für diesen Benutzer stillschweigend übersprungen. Die übrigen Kennzahlen sind nicht betroffen; eine defekte Zeile bringt nie das ganze Band zum Stillstand.

KPI-Referenz

KPI-Typen

Eine manuell eingetragene Drilldown Page ID hat bei jedem Typ Vorrang vor dem Standard.

Unterstützte Cue-Tabellen

Das Lookup auf Source Table No. bietet diese 16 Cue-Tabellen. Die rechte Spalte zeigt, welche davon der automatische Katalog zuweist; die übrigen stehen für manuell angelegte Zeilen bereit.

Unterstützte Rollencenter

Der Ticker ist in die folgenden 15 Standard-Rollencenter eingebettet. Die Aktivierung erfolgt ausschließlich über das Häkchen Enabled im Bereich Role Centers der Seite Ticker Setup. Die letzte Spalte nennt die Cue-Tabellen, die Initialize Standard KPIs dem Rollencenter zuweist; jedes Rollencenter erhält zusätzlich eine Zeile Pending User Tasks.

Administration

Setup zurücksetzen

Die Aktion Reset auf der Seite Ticker Setup fragt nach einer Bestätigung, löscht dann alle KPI-Zeilen und Rollencenter-Aktivierungen, stellt die Standardfarben wieder her und führt die Initialisierung erneut aus. Nutzen Sie sie, um zu einem sauberen Katalog zurückzukehren; manuelle Zeilen, Overrides und Aktivierungen gehen dabei verloren. Sollen nur die Farben zurückgesetzt werden, verwenden Sie stattdessen Restore Default Colors — sie ändert nichts außer den drei Farbfeldern.

Generalprobe mit Leistungstestdaten

Für einen Lasttest vor dem Go-live bietet die Seite Ticker Setup zwei Aktionen, die nur für Benutzer mit dem Berechtigungssatz SUPER sichtbar und ausführbar sind:

• Create Performance Test Data — erzeugt nach einer Bestätigung rund 10.000 Datensätze je KPI-Typ in den Quelltabellen des Tickers (Verkaufsaufträge und -zeilen, gebuchte Lieferungen, Debitorenposten, detaillierte Debitorenposten, Benutzeraufgaben, Einkaufsbestellungen). Ein Fortschrittsdialog zeigt den aktuellen KPI-Typ, die eingefügten Datensätze, den Prozentsatz und einen Fortschrittsbalken. Jeder Datensatz trägt die Markierung CDMPERF in seiner Belegnummer oder seinem Titel.
• Delete Performance Test Data — entfernt genau diese Datensätze wieder; andere Daten bleiben unberührt.

Fehlerbehebung

Erweiterbarkeit (für Entwickler)

• Das Enum CDM Ticker KPI Type ist erweiterbar — ergänzen Sie eigene KPI-Typen in einer Erweiterung.
• OnFormatCustomKPI (Codeunit CDM Ticker Data Mgt.) — berechnen Sie den Wert einer Zeile selbst; setzen Sie IsHandled, um die Standardberechnung zu ersetzen.
• OnBeforeApplyFilters (Codeunit CDM Ticker Cue Filters) — überschreiben oder erweitern Sie die Cue-Filter.
• OnCreateTestDataForCustomKPI und OnDeleteCustomTestData (Codeunit CDM Ticker Perf. Test Data) — liefern und entfernen Sie Testdaten für eigene KPI-Typen.

Datenhaltung

• cdmTicker berechnet jeden Wert innerhalb von Business Central. Es verlassen keine Daten die Umgebung, es wird kein externer Dienst aufgerufen und keine KI eingesetzt.
• Jede Kennzahl wird mit den Berechtigungen des Benutzers ausgewertet, der das Band betrachtet. Die App erweitert keine Berechtigungen; ein Wert, den der Benutzer auf einer Kachel oder in einer Liste nicht sehen könnte, wird auch im Ticker nicht angezeigt.
• Die Einrichtungsdaten der App (Rollencenter-Aktivierungen, KPI-Zeilen und Farben) werden in drei Tabellen der Erweiterung in der Datenbank des Mandanten gespeichert und sind als Kundeninhalt klassifiziert.
• Die App registriert eine Herausgeber-Telemetrieverbindung (Azure Application Insights), wie sie die Business-Central-Plattform vorsieht. Die Plattform sendet Betriebssignale zur Erweiterung — etwa Fehler und Leistungsereignisse — an den Herausgeber; Kennzahlenwerte und Geschäftsdaten sind nie Teil dieser Telemetrie.

Details finden Sie im Endbenutzer-Lizenzvertrag und in unserer Datenschutzerklärung.

Support

Bitte geben Sie bei Ihrer Anfrage Ihre Business-Central-Version, die App-Version (Seite Erweiterungsverwaltung), das betroffene Rollencenter und, wenn möglich, einen Screenshot der Seite Ticker Setup an.