# Desktop-App und Geräte (https://docs.akollo.com/de/product-guide/desktop-app)



Die Akollo-Desktop-App läuft auf dem Computer der Mitarbeitenden. Sie folgt der Erfassungsrichtlinie der Organisation: Sie erfasst die Anwendung im Vordergrund, Aktivität und Leerlaufzeit sowie Screenshots, sofern aktiviert, und sendet diese Daten an Akollo. Die App befindet sich im Infobereich der Taskleiste und hat kein weiteres Fenster.

Eine optionale Browser-Erweiterung für Chrome und Edge teilt der Desktop-App mit, welcher Tab im Vordergrund ist. Sie kommuniziert nur mit der Desktop-App auf demselben Computer, nie mit dem Server.

## So fließen die Daten [#so-fließen-die-daten]

<Mermaid
  title="Vom Gerät in Ihre Tagesansicht"
  chart="`flowchart LR
X[Browser-Erweiterung] -.->|Vorderster Tab, nur derselbe Computer| A
P[Erfassungsrichtlinie] --> A[Desktop-App misst Aktivität]
A --> B[Sendet Daten an Akollo]
B --> C[Zeit wird der gewählten Aufgabe angerechnet]
C --> D[My day und Tagesansicht]
C --> E[Zeitberichte]`"
/>

Die Zeit wird der Aufgabe angerechnet, die auf **My tasks** (Meine Aufgaben) für das Gerät ausgewählt ist (siehe [Zeit und Aufgaben](/de/product-guide/time)).

## Anmeldung in der Desktop-App [#anmeldung-in-der-desktop-app]

Wenn die Desktop-App Sie zur Anmeldung auffordert, öffnet sie im Browser die Seite **Desktop sign-in** (Desktop-Anmeldung). Dort bestätigen Sie die Anfrage und kehren zur App zurück. Eine Anmeldeanfrage ist 10 Minuten gültig und kann auch abgelehnt werden. Ihre Rolle muss die Registrierung eines Geräts erlauben; eine Support-Sitzung kann keine Anmeldung bestätigen.

<Steps>
  <Step>
    ### Anmeldung in der Desktop-App starten [#anmeldung-in-der-desktop-app-starten]

    Öffnen Sie die Desktop-App über den Infobereich und starten Sie die Anmeldung. Im Browser öffnet sich die Seite **Desktop sign-in**.
  </Step>

  <Step>
    ### Anfrage prüfen [#anfrage-prüfen]

    Die Seite zeigt Konto, Organisation und Anwendung. Bestätigen Sie nur, wenn Sie diese Anmeldung gerade eben in der Desktop-App auf diesem Computer gestartet haben.
  </Step>

  <Step>
    ### Bestätigen und zurückkehren [#bestätigen-und-zurückkehren]

    Wählen Sie **Approve and return to the agent**. Die Desktop-App schließt die Anmeldung ab, und Sie können den Browser-Tab schließen. Zum Ablehnen wählen Sie **Cancel sign-in**.
  </Step>
</Steps>

<Callout type="warn" title="Achtung">
  Ist die Anfrage älter als 10 Minuten, meldet die Seite, dass keine Anmeldung aussteht. Starten Sie den Vorgang dann erneut in der Desktop-App.
</Callout>

## Geräte [#geräte]

**Settings → Devices** (Einstellungen → Geräte) listet Desktop-Apps: Ihre eigenen oder, für Administratoren, alle Geräte der Organisation. Zu jedem Gerät sehen Sie die Person, die App-Version, das Registrierungsdatum, den letzten Kontakt und den Status (zum Beispiel angemeldet, abgemeldet oder widerrufen). Ein Gerät kann widerrufen werden; ein widerrufenes Gerät sendet keine Daten mehr.

<Screenshot src="/screens/en/settings-devices.webp" alt="Seite Devices mit einer Tabelle registrierter Desktop-Agents, Person, Agent-Version, Registrierungsdatum, letztem Kontakt, Status und der Aktion Revoke" caption="Devices: alle registrierten Desktop-Apps mit Status und Aktionen." />

<Steps>
  <Step>
    ### Geräteliste öffnen [#geräteliste-öffnen]

    Wählen Sie **Settings → Devices**.
  </Step>

  <Step>
    ### Gerät widerrufen [#gerät-widerrufen]

    Suchen Sie das Gerät in der Liste und wählen Sie **Revoke**.
  </Step>

  <Step>
    ### Bestätigen [#bestätigen]

    Bestätigen Sie mit **Revoke device**. Das Gerät wird abgemeldet und kann sich nie wieder anmelden. Die Person kann den Computer als neues Gerät erneut registrieren.
  </Step>
</Steps>

<Callout type="info" title="Hinweis">
  Ein Widerruf erreicht das Gerät, sobald es sich verbindet. Eine widerrufene oder abgemeldete Desktop-App wird beim nächsten Kontakt mit dem Server abgewiesen. Solange sie offline ist, erfährt sie davon nichts; was sie in dieser Zeit erfasst, wird bei der erneuten Verbindung abgewiesen.
</Callout>

## Gerätezustand [#gerätezustand]

**Device health** (Gerätezustand, `/tracking/health`) richtet sich an Personen, die den Erfassungsdienst betreiben. Jedes Gerät hat einen Status: in Ordnung, braucht Aufmerksamkeit, still, lange still oder widerrufen. Die Gründe werden angezeigt, etwa eine veraltete Richtlinie, fehlende Ereignisse, ein Upload-Rückstau, ein fehlender Monitor oder eine fehlende Browser-Erweiterung oder eine Uhrabweichung. Die Geräteseite zeigt letztes Lebenszeichen, Version, Plattform, Richtlinienrevision, Synchronisierungslücke, Speicherplatz und Monitore. Außerdem zeigt die Seite den Zustand des Dienstes selbst (Anwendung, Bildanalyse, Medienspeicher und Hintergrund-Warteschlangen) und die verwendeten Schwellenwerte.

Personen mit Betriebsberechtigung können ein Gerät widerrufen oder fehlgeschlagene Hintergrundaufträge erneut senden, jeweils mit Begründung.

<Screenshot src="/screens/en/device-health.webp" alt="Device health mit Statuskarten für Anwendungsserver, Bildanalyse, Medienspeicher und Aufnahmen, die auf eine Entscheidung warten, einer Tabelle der Warteschlangen und nach Status gefilterten Gerätekarten" caption="Device health: Zustand des Dienstes, seiner Warteschlangen und jedes Geräts." />

<Callout type="info" title="Hinweis">
  Stille, eine Lücke oder ein fehlendes Signal beschreiben ein Gerät oder eine Verbindung. Nichts davon besagt, dass die Person untätig, abwesend oder unproduktiv war.
</Callout>

## Erfassungsrichtlinie [#erfassungsrichtlinie]

Administratoren (Organisationsinhaber oder Administratoren mit der Berechtigung für Personaleinsatz) legen die Erfassungsrichtlinie unter **Settings → Workforce & recording** fest. Jede Änderung veröffentlicht eine neue Revision mit Startdatum und optional einem Enddatum; der Revisionsverlauf bleibt erhalten.

| Einstellung                                      | Was sie steuert                                                                                                                                                                                                                                                                                              |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Schedule** (Arbeitszeitplan)                   | Zeitzone, Arbeitstage, Beginn und Ende sowie ob ein regulärer, ein Feiertags- oder ein Überstundenplan gilt.                                                                                                                                                                                                 |
| **Idle** (Leerlauf)                              | Nach wie vielen Sekunden ohne Eingabe Zeit als Leerlauf gilt, ob die Person die Erfassung pausieren darf und für höchstens wie viele Minuten.                                                                                                                                                                |
| **Categories** (Kategorien)                      | Regeln, die eine Anwendung oder Website als produktiv, neutral, unproduktiv oder nicht klassifiziert einstufen, mit Priorität und der Angabe, ob eine Aufgabe ausgewählt sein muss. Regeln gelten für die Organisation, eine Abteilung oder ein Team; für unbekannte Anwendungen gibt es eine Standardregel. |
| **Screenshots** und **Retention** (Aufbewahrung) | Siehe [Bildschirmnachweise und Datenschutz](/de/product-guide/screen-evidence).                                                                                                                                                                                                                              |

## Häufige Fragen [#häufige-fragen]

<Accordions type="single">
  <Accordion title="Sendet die Browser-Erweiterung Daten an Akollo?">
    Nein. Sie teilt nur der Desktop-App auf demselben Computer mit, welcher Tab im Vordergrund ist. Mit dem Server kommuniziert sie nie.
  </Accordion>

  <Accordion title="Wie lange ist eine Anmeldeanfrage gültig?">
    10 Minuten. Danach starten Sie die Anmeldung erneut in der Desktop-App.
  </Accordion>

  <Accordion title="Was passiert mit einem Laptop, der beim Widerruf offline ist?">
    Er erfährt vom Widerruf erst bei der nächsten Verbindung. Dann wird er abgewiesen, und auch die zwischenzeitlich erfassten Daten werden abgewiesen.
  </Accordion>

  <Accordion title="Kann ein widerrufener Computer wieder genutzt werden?">
    Das widerrufene Gerät kann sich nie wieder anmelden. Die Person kann denselben Computer jedoch als neues Gerät registrieren.
  </Accordion>

  <Accordion title="Bedeutet ein stilles Gerät, dass die Person nicht gearbeitet hat?">
    Nein. Der Gerätezustand beschreibt nur Geräte und Verbindungen. Ein stilles Gerät sagt nichts darüber aus, ob die Person untätig, abwesend oder unproduktiv war.
  </Accordion>
</Accordions>