# Synchronisierung im Detail (https://docs.akollo.com/de/connections/sync-details)



Diese Seite erklärt, wie eine Verbindung Datensätze auf dem gleichen Stand hält: Connector-Gruppen und Verantwortliche, die Zuordnung von Datensätzen und was mit Datensätzen geschieht, die nicht synchronisiert werden konnten oder an der Quelle gelöscht wurden.

<Mermaid
  title="Der Weg eines Datensatzes durch eine Synchronisierung"
  chart="`flowchart LR
A[Datensatz an der Quelle] --> B[Sync-Stream liest ihn]
B --> C[Veröffentlichte Feldzuordnung]
C --> D{Verarbeitbar?}
D -->|Ja| E[Akollo-Datensatz angelegt oder aktualisiert]
D -->|Nein| F[In Issues zurückgestellt]
F -->|Erneut versuchen| B`"
/>

## Connector-Gruppen [#connector-gruppen]

Jede Organisation stuft einen Connector als **Business**, **Non-business** oder **Blocked** ein (geschäftlich, nicht geschäftlich, gesperrt). Ein Connector ohne Einstufung ist gesperrt. Ein Ablauf darf geschäftliche und nicht geschäftliche Connectors nicht mischen. Verzeichnis-Connectors erlauben nur Lesen und Auflisten. Der Activepieces-Plattform-Connector und der PostgreSQL-Connector bleiben gesperrt.

## Verantwortliche [#verantwortliche]

Jede Verbindung hat einen Verantwortlichen und eine davon verschiedene Vertretung. Beide sind Mitglieder der Organisation.

* Verlässt der Verantwortliche die Organisation und ist die Vertretung noch Mitglied, wird die Vertretung verantwortlich.
* Ist keiner von beiden mehr da, wird die Verbindung ausgesetzt, bis jemand einen neuen Verantwortlichen bestimmt.
* Eine Verbindung, deren Zugangsdaten entzogen wurden, kann nicht genutzt werden.

## Identität von Datensätzen [#identität-von-datensätzen]

Eine Synchronisierung merkt sich, welcher externe Datensatz zu welchem Akollo-Datensatz gehört, einschließlich Quellsystem und Datensatzversion. Eine spätere Synchronisierung aktualisiert denselben Datensatz. Eine ältere Version ersetzt nie eine neuere. Eine Support-Sitzung kann eine Synchronisierung ansehen, aber nicht ändern.

## Nicht synchronisierte Datensätze [#nicht-synchronisierte-datensätze]

Ein Datensatz, der nicht synchronisiert werden kann, wird zurückgestellt; der Rest der Synchronisierung läuft weiter. Datensätze mit derselben Fehlerursache werden gruppiert, mit der Anzahl der Fehler sowie dem ersten und letzten Auftreten.

Die gespeicherte Kopie eines Datensatzes ist verschlüsselt. Angezeigt werden nur Feldnamen, Werttypen und Längen; die Kopie wird nach 30 Tagen gelöscht.

Ein Administrator kann einen oder mehrere Datensätze auf einmal erneut versuchen, etwa nach der Korrektur einer Zuordnung. Ein erneuter Versuch liest den Datensatz wieder aus der Quelle und nutzt die zu diesem Zeitpunkt gültige Zuordnung. Die gespeicherte Kopie wird nur verwendet, solange die Quelle nicht erreichbar ist. Ist sie älter als die bereits synchronisierte Version, wird sie nie verwendet; der Datensatz bleibt dann in der Liste. Ein Datensatz, der später erfolgreich synchronisiert wird, verschwindet von selbst aus der Liste.

Ein Administrator kann außerdem einen Datensatz mit Begründung überspringen, einen Konflikt lösen oder die Liste als CSV-Datei ohne Datensatzinhalt herunterladen.

## Sync-Streams [#sync-streams]

Jeder Sync-Stream einer Verbindung steht im Reiter **Syncs** der Verbindung, mit Zustand, letztem Lauf und veröffentlichter Version der Zuordnung. Die Stream-Seite zeigt:

* die jüngsten Läufe: Art, gelesene, geschriebene und zurückgestellte Datensätze, Dauer und Ergebnis;
* die Stelle, an der der Stream zuletzt gelesen hat;
* die Version der Zuordnung.

Ein Stream, der noch nie gelaufen ist, weist darauf hin. Ein teilweise synchronisierter Stream zeigt, wie viele Datensätze in Issues warten, mit einem Link dorthin. Eine berechtigte Person stellt mit **Run now** (Jetzt ausführen) einen neuen Lauf in die Warteschlange; solange einer wartet, wird kein zweiter hinzugefügt. Ein Stream lässt sich mit Begründung pausieren und fortsetzen. Ein pausierter Stream zeigt das Datum der Pause und kann nicht ausgeführt werden.

| Stream-Zustand | Bedeutung                                                                                                |
| -------------- | -------------------------------------------------------------------------------------------------------- |
| **Draft**      | Der Stream läuft noch nicht.                                                                             |
| **Running**    | Der Stream läuft nach Zeitplan oder über **Run now**.                                                    |
| **Paused**     | Mit Begründung pausiert. Zeigt das Datum der Pause und kann bis zur Fortsetzung nicht ausgeführt werden. |
| **Off**        | Der Stream ist ausgeschaltet.                                                                            |

## Feldzuordnung [#feldzuordnung]

Die Zuordnungsseite zeigt für jedes Akollo-Feld:

* das entsprechende Feld im externen System;
* die maßgebliche Quelle: **Akollo**, **External system** oder **Both ways** (beide Richtungen);
* die Umwandlung;
* das Verhalten bei einem Konflikt und beim Löschen.

<Steps>
  <Step>
    ### Entwurf ändern [#entwurf-ändern]

    Nehmen Sie Ihre Änderungen in einem Entwurf vor. Die veröffentlichte Version bleibt so lange gültig.
  </Step>

  <Step>
    ### Änderungen prüfen [#änderungen-prüfen]

    Wählen Sie **Review changes** (Änderungen prüfen). Die Ansicht zeigt den Unterschied zwischen veröffentlichter Version und Entwurf.
  </Step>

  <Step>
    ### Veröffentlichen [#veröffentlichen]

    Veröffentlicht wird genau der geprüfte Unterschied. Hat sich der Entwurf nach der Prüfung geändert, wird das Veröffentlichen abgelehnt, und Sie prüfen den Unterschied erneut.
  </Step>
</Steps>

Ein Entwurf, der ein geschütztes Feld für das externe System öffnet, wartet auf die Freigabe durch einen anderen Administrator als den ersten Veröffentlichenden. Währenddessen zeigt die Seite, wer auf die Freigabe wartet. Auf dem Smartphone ist die Zuordnung schreibgeschützt; zum Bearbeiten brauchen Sie einen größeren Bildschirm.

## Ansicht „Issues“ [#ansicht-issues]

Der Reiter **Issues** (Probleme) gruppiert die zurückgestellten Datensätze nach Ursache. Jede Gruppe zeigt Ursache, Anzahl der Datensätze und Vorkommen, erstes und letztes Auftreten sowie die betroffenen Streams. Wenn Sie eine Gruppe öffnen, werden ihre Datensätze aufgelistet.

Die Felder eines Datensatzes zeigen nur Namen, Typen und bei ungeschützten Feldern die Länge. Werte werden nie angezeigt. Ist die gespeicherte Kopie eines Datensatzes abgelaufen, weist die Ansicht darauf hin, dass ein erneuter Versuch ihn wieder aus der Quelle liest.

Auf einem größeren Bildschirm können Sie Datensätze auswählen und gemeinsam erneut versuchen oder mit Begründung überspringen. Ein Konfliktfeld lösen Sie mit Akollo-Wert und externem Wert nebeneinander: **Take Akollo** (Akollo-Wert übernehmen), **Take external** (externen Wert übernehmen) oder **Enter value** (Wert eingeben). Auch hier werden die Werte geschützter Felder nicht angezeigt. Die Liste lässt sich als CSV-Datei ohne Datensatzinhalt herunterladen. Gibt es kein offenes Problem, zeigt die Ansicht das mit dem Zeitpunkt der letzten Prüfung an.

| Datensatz-Zustand | Bedeutung                                                                             |
| ----------------- | ------------------------------------------------------------------------------------- |
| **Open**          | Zurückgestellt, wartet auf eine Entscheidung.                                         |
| **Retrying**      | Für einen erneuten Versuch eingereiht, der den Datensatz wieder aus der Quelle liest. |
| **Skipped**       | Von einem Administrator mit Begründung übersprungen.                                  |
| **Resolved**      | Das Problem ist erledigt, etwa weil ein Konflikt gelöst wurde.                        |

## An der Quelle gelöschte Datensätze [#an-der-quelle-gelöschte-datensätze]

Einmal pro Woche vergleicht die Verbindung die vollständige Liste der Datensätze an der Quelle mit den verknüpften Datensätzen. Ein Datensatz gilt erst als gelöscht, wenn ihn zwei vollständige Vergleiche hintereinander nicht gefunden haben. Ein unvollständiger oder abgebrochener Vergleich löscht nie etwas.

Was mit dem Akollo-Datensatz geschieht (archivieren, trennen, ignorieren oder deaktivieren), wird an der Synchronisierung festgelegt. Lehnt der zuständige Teil von Akollo die Löschung ab, erscheint der Datensatz unter den nicht synchronisierten Datensätzen.

<Callout type="idea" title="Tipp">
  Die Regel der zwei vollständigen Vergleiche hintereinander schützt vor versehentlichen Löschungen, wenn eine Quelle eine unvollständige Liste liefert.
</Callout>

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

<Accordions type="single">
  <Accordion title="Stoppt ein fehlerhafter Datensatz die ganze Synchronisierung?">
    Nein. Ein Datensatz, der nicht synchronisiert werden kann, wird zurückgestellt, und der Rest läuft weiter.
  </Accordion>

  <Accordion title="Welche Zuordnung nutzt ein erneuter Versuch?">
    Ein erneuter Versuch liest den Datensatz wieder aus der Quelle und nutzt die zu diesem Zeitpunkt gültige Zuordnung. Sie können also erst die Zuordnung korrigieren und dann erneut versuchen.
  </Accordion>

  <Accordion title="Kann eine ältere Datensatzversion eine neuere überschreiben?">
    Nein. Die Synchronisierung merkt sich die Datensatzversion, und eine ältere Version ersetzt nie eine neuere.
  </Accordion>

  <Accordion title="Wann gilt ein Datensatz an der Quelle als gelöscht?">
    Erst wenn ihn zwei vollständige wöchentliche Vergleiche hintereinander nicht gefunden haben. Ein unvollständiger oder abgebrochener Vergleich löscht nie etwas.
  </Accordion>

  <Accordion title="Was passiert, wenn der Verantwortliche einer Verbindung geht?">
    Ist die Vertretung noch Mitglied, wird sie verantwortlich. Ist keiner von beiden mehr da, wird die Verbindung ausgesetzt, bis jemand einen neuen Verantwortlichen bestimmt.
  </Accordion>
</Accordions>

## Verwandte Seiten [#verwandte-seiten]

* [Verbundene Systeme](/de/connections)
* [API und Schlüssel](/de/connections/api)