Benutzermenü

Individuelle Einstellungen für jeden Benutzer werden über das Benutzermenü geöffnet. Es befindet sich auf Höhe der Überschrift, rechts oberhalb des jeweiligen Arbeitsbereichs. Die Einstellungen in diesem Bereich betreffen ausschließlich den Benutzer, der sie vornimmt.

Das Menü zeigt Informationen wie Name, E-Mail und die Business Central Instanz zu dem angemeldeten Benutzer. Dieser kann sich hier explizit abmelden, den Mandanten wechseln und die Benutzer Einstellungen öffnen.

Mandanten wechseln

Um einen Mandanten zu wechseln, muss der Benutzer in dem anderen Mandanten angelegt sein. Die Zeiterfassungen, Vorlagen und auch die Benutzer selbst sind mandantenspezifisch. Zeiterfassungen und Vorlagen oder Projekte aus einem Mandanten sind in anderen Mandanten nicht sichtbar.

Einstellungen

Die Benutzer Einstellungen gliedern sich in einen allgemeinen Teil und einen Teil speziell für die Zeiterfassung.

Allgemein

Einrichtungen in der Seite Allgemein steuern die Darstellung der gesamten App für den Benutzer.

• Sprache und Region
  Die Sprache und Region wird bei der ersten Anmeldung aus dem Browser entnommen. Jeder Benutzer kann die Sprache und Region über das Benutzermenü für sich ändern. Die Region steuert die Datums- und Zeitanzeige. Die Sprachen Englisch und Deutsch sind verfügbar.
  Falls eine andere Sprache als Deutsch im Browser hinterlegt ist, wird automatisch Englisch verwendet. Es ist in einigen Browsern möglich, zwar eine Sprache aber keine Region zu hinterlegen. So kann z.B. in Chrome in Sprachen Deutsch oder Deutsch / Deutschland gewählt werden. Ist keine Region hinterlegt oder kann nicht erkannt werden, wird Vereinigte Staaten automatisch ausgewählt.

• Dark Mode
  Mit dem Schalter Design kann die Darstellung von einem hellen Design in augenschonendes dunkles Design geändert werden. Die Standardeinstellung ist immer das helle Design.

• Zustimmung zur Verwendung von Nutzerdaten und Datenbewegung
  Um einen optimalen Support leisten zu können sowie zur stetigen Verbesserung unserer DYCE Connect Plattform zeichnen wir Nutzerdaten und Datenbewegungen auf. Die Zustimmung kann über das Cookie-Banner und in der Einrichtung gegeben werden. Ist keine Zustimmung erteilt, werden keine Daten aufgezeichnet, auch keine Fehler.

Zeiterfassungen

Einstellungen in der Seite Zeiterfassungen beeinflussen ausschließlich die Darstellung des Bereichs Zeiterfassungen.

• Auswahl Zeiterfassungsmasken
  Für die Erstellung von Zeiterfassungen können verschiedene Masken verwendet werden. Die Masken funktionieren generell gleich und unterscheiden sich nur in den angezeigten Feldern. Folgende Zeiterfassungsmasken können ausgewählt werden:
• Alles
  In dieser Maske werden alle Felder angezeigt. Sie wird beim ersten Öffnen der Zeiterfassung als Standard verwendet.
• Kompakt
  In dieser Maske werden die Felder Start, Ende und Pause nicht angezeigt.
• Einfach
  In dieser Maske werden die Felder Start, Ende, Pause und Kunde nicht angezeigt.
• Dynamisch
  Dies Maske ist einer der Masken, die in Azure DevOps verwendet werden. In dieser Maske werden alle Felder angezeigt.

Die Vorschau unter der Auswahl zeigt die ausgewählte Maske an. Die Änderung der Zeiterfassungsmaske ändert die Anzeige in der Seite Zeiterfassung, Unvollständig und Vorlagen.

• Export
  Die Zeiterfassungen werden automatisch in Business Central synchronisiert. Über die Export-Funktion können darüber hinaus Zeiterfassungen exportiert werden. Es werden ausschließlich die Zeiterfassungen des Benutzers exportiert, der den Export ausführt. Die exportierten Zeiterfassungen werden als JSON bereitgestellt.

• Tage ohne Kapazität anzeigen
  Das Kennzeichen Zeige Tage ohne Kapazitäten steuert ob alle oder ausschließlich Arbeitstage angezeigt werden. Arbeitstage werden aus dem Basiskalender und dem Arbeitszeitmodell ermittelt. Als Default werden nur Arbeitstage angezeigt.

• Kalendereinstellung
  Bevor Sie Ihre Outlook-Kalendereinträge sehen können, müssen Sie einmalig eine Leseberechtigung erteilen. Die Leseberechtigung kann in https://myapps.microsoft.com/ widerrufen werden. Suchen Sie nach der DYCE App, klicken Sie auf die drei Punkte, wählen Sie Anwendung verwalten und anschließend auf Zustimmung widerrufen.

Sonstiges

• Aufgabengruppierung
  Hier wird die Gruppierung der Aufgaben festgelegt. Jeder Anwender kann zwischen den Gruppierungen nach Kunde, Projekt (Standard), Startdatum und Enddatum wählen.

• URL
  In der URL können Informationen zu App, Seite, Umgebung, Mandant und Tag kodiert werden.

Bestandteil	Beispiel URL	Bemerkung
Basis URL	https://app.dyce.cloud/	Öffent die Auswahl der Apps. Wenn der Benutzer nur Zugang zur einer App hat, erfolgt eine automatische Weiterleitung zu dieser App.
App	https://app.dyce.cloud/timetracking/	Öffnet die App Time Tracking in der zuletzt verwendeten Umgebung und Mandant.
Seite	https://app.dyce.cloud/timetracking/dailyrecordings	Öffnet die Seite Zeiterfassungen (dailyrecordings) am aktuellem Tag in der zuletzt verwendeten Umgebung und Mandant.
Tag	https://app.dyce.cloud/timetracking/dailyrecordings#2024-04-12	Öffnet die Zeiterfassung am 12.04.2024. Der Filter #2024-04-12 funktioniert ausschließlich in der Seite Zeiterfassungen.
Umgebung	https://app.dyce.cloud/timetracking/dailyrecordings?instance=demo#2024-04-12	Öffnet die Zeiterfassung am 12.04.2024 in der Umgebung Demo (?instance=demo).
Mandant	https://app.dyce.cloud/timetracking/dailyrecordings?instance=demo&company=CRONUS#2024-04-12	Öffnet die Zeiterfassung am 12.04.2024 im Mandanten CRONUS (?instance=demo&company=CRONUS).
Tenant	https://app.dyce.cloud/?tenant=customer.onmicrosoft.com	Meldet einen B2B-Gastbenutzer an einem bestimmten Tenant an. Siehe Gast-Login für externe Tenants.

instance und company legen die Umgebung und den Mandanten fest, in denen die App geöffnet wird. Beide angeben, um gezielt eine bestimmte Umgebung und einen bestimmten Mandanten zu öffnen. Eines von beiden kann entfallen, wenn es eindeutig ist: company allein genügt, wenn der Benutzer nur Zugriff auf eine Umgebung hat, und instance allein genügt, wenn diese Umgebung nur einen Mandanten enthält. Kann die Umgebung oder der Mandant weiterhin nicht aufgelöst werden oder hat der Benutzer keinen Zugriff darauf, greift die App auf ihr übliches Verhalten zurück: die zuletzt verwendete Umgebung und Mandant, andernfalls die Auswahlansicht oder, wenn es nur eine Kombination gibt, diese direkt.

Sonderzeichen, die ungültige Zeichen in einer URL darstellen, müssen kodiert werden. So müssen bspw. Leerzeichen durch %20 ersetzt werden.

Neue Zeiterfassung per URL vorbelegen

Ein externes System, zum Beispiel ein Ticket-Tool, kann DYCE Time Tracking mit einer neuen Zeiterfassung öffnen, die bereits mit den im Quellsystem bekannten Daten vorbelegt ist. Der Benutzer füllt nur die übrigen Felder aus und speichert, wodurch die manuelle Dateneingabe auf ein Minimum reduziert wird.

Um ein vorbelegtes Formular anzufordern, wird die Seite Zeiterfassungen mit newRecord=true und mindestens einem der untenstehenden Parameter geöffnet, zum Beispiel:

https://app.dyce.cloud/timetracking/dailyrecordings?newRecord=true&jobId=<id>&duration=60&description=Kickoff%20call

newRecord=true allein öffnet das normale, leere Formular für eine neue Zeiterfassung.

Parameter	Beschreibung
newRecord=true	Fordert das vorbelegte Formular an. Muss auf true gesetzt sein, zusammen mit mindestens einem der untenstehenden Parameter.
instance	Business Central Umgebung (wie in der URL-Tabelle oben).
company	Mandant innerhalb der Umgebung.
date	Datum der Zeiterfassung als ISO-Datum (YYYY-MM-DD). Hat Vorrang vor einem #YYYY-MM-DD-Hash. Kann entfallen, wenn start (oder end) das Datum bereits enthält.
start	Startzeit als vollständiges ISO-Datum mit Uhrzeit.
end	Endzeit als vollständiges ISO-Datum mit Uhrzeit.
duration	Dauer in Minuten.
durationBillable	Berechenbare Dauer in Minuten.
break	Pause in Minuten.
description	Freitext-Beschreibung.
customerId	Kunden-Id.
jobId	Projekt-Id.
jobTaskId	Projektaufgaben-Id.
jobPlanningLineId	Projektplanzeilen-Id.
tntModelLineId	Time & Travel Model Line-Id; die passende Tätigkeit wird entsprechend ausgewählt.
workOrderId	Work Order-Id; deren Kunde und Projekt werden in die Zeiterfassung übernommen.
nonBillableReason	Grund für Nichtberechnung. Wird nur übernommen, wenn er einem gültigen Wert entspricht.

Jede Id ist die System Id des Datensatzes (eine GUID), also derselbe Bezeichner, den der Datensatz in Business Central hat. Widersprechen sich die Parameter (zum Beispiel ein Kunde und ein Projekt, die nicht zusammengehören), gewinnt das übergeordnete Feld und das untergeordnete Feld bleibt leer. Wie oben müssen Sonderzeichen URL-kodiert werden, zum Beispiel ein Leerzeichen als %20.

Start- und Endzeit

start und end sind ISO 8601-Datum-/Uhrzeitwerte und können auf zwei Arten übergeben werden:

• Ohne Zeitzonen-Offset (am einfachsten): Die Zeit wird in der lokalen Zeitzone des Benutzers interpretiert, zum Beispiel start=2026-09-22T14:00:00.
• Mit explizitem Offset: Das + muss als %2B kodiert werden, da es sonst als Leerzeichen interpretiert wird und der Offset verloren geht, zum Beispiel start=2026-09-22T14:00:00%2B02:00 für UTC+02:00.