> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/data-migrator/data-migrator-de/vorlagen/migration/so-funktioniert-die-datensatzzuordnung.md).

# So funktioniert die Datensatzzuordnung

## ![](https://1417117101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FcfMTqg4Brbm9baWutclZ%2FSummary2-Small-Icon.svg?alt=media\&token=d1cf162d-c02d-4184-988e-7f7350e450fc) Überblick

Data Migrator verwendet Datensatz-Mapping, um Datensätze über mehrere Migrationsläufe hinweg korrekt zu halten. Wenn Sie das Datensatz-Mapping für ein Objekt aktivieren, ordnet Data Migrator einzelne Datensätze zwischen der Quell- und der Ziel-Organisation zu, sodass nachfolgende Migrationen nur neue Datensätze hinzufügen und vorhandene aktualisieren. Sie steuern das Datensatz-Mapping für jedes Objekt in einer Vorlage einzeln. Data Migrator bietet zwei Methoden zum Zuordnen von Datensätzen zwischen der Quell- und der Ziel-Organisation: **Automatisch** und **Manuell**. Die folgenden Abschnitte beschreiben, wie jede Methode funktioniert, und enthalten Beispiel-Szenarien, die erfolgreiches und fehlgeschlagenes Datensatz-Mapping veranschaulichen.

* [#automatic-record-mapping](#automatic-record-mapping "mention")
* [#manual-record-mapping](#manual-record-mapping "mention")
* [#record-mapping-scenarios](#record-mapping-scenarios "mention")

{% hint style="info" %}

#### Datensatz-Mapping aktivieren

Standardmäßig ist das Datensatz-Mapping für alle Objekte in einer Vorlage deaktiviert. Wenn das Datensatz-Mapping nicht aktiviert ist, werden bei der Migration immer alle Quelldatensätze in die Ziel-Organisation eingefügt. Dies kann zu Duplikaten führen, wenn derselbe Datensatz an beiden Orten vorhanden ist.

Das Datensatz-Mapping für ein Objekt wird über die Registerkarte „Einstellungen“ aktiviert. Der folgende Artikel beschreibt, wie Sie das Datensatz-Mapping für ein Objekt aktivieren.

* [Objektdatensatzzuordnung festlegen](/data-migrator/data-migrator-de/vorlagen/vorlagen-designer/objektdatensatzzuordnung-festlegen.md)
  {% endhint %}

## Automatisches Datensatz-Mapping

Automatisches Datensatz-Mapping ist eine zustandsbehaftete, mappingbasierte Strategie, die eine interne Zuordnungstabelle verwendet, um Quell- und Zieldatensätze zu verknüpfen. Sie stützt sich eher auf historische Zuordnungen aus früheren Bereitstellungen als auf Echtzeitdaten der Ziel-Org. Sobald eine Zuordnung von Quelle zu Ziel existiert, ist die Beziehung fest, sodass für Datensätze, die bereits mit dem automatischen Mapping migriert wurden, keine Unklarheit besteht.

Das automatische Mapping ist für wiederholte Migrationen gedacht, wenn:

* Data Migrator das einzige verwendete Migrationstool ist
* die Ziel-Org bei der ersten Migration leer ist
* langfristige Konsistenz über mehrere Läufe hinweg erforderlich ist

Das automatische Mapping gewährleistet:

* derselbe Quelldatensatz immer denselben zugeordneten Zieldatensatz aktualisiert
* Änderungen in Geschäftsfeldern die Zuordnung von Datensätzen nicht beeinflussen
* Datensatzaktualisierungen deterministisch sind, sobald eine Zuordnung existiert

Das automatische Mapping wertet jedoch keine Echtzeitdaten der Ziel-Org aus.

### So funktioniert das automatische Mapping

Das automatische Mapping folgt einem deterministischen, auf Zuordnungen basierenden Prozess. Das folgende Diagramm veranschaulicht den gesamten Ablauf.

<figure><img src="https://1417117101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FHQ3R5paTJEYcCDt5ZNZi%2FFlosum%20Data%20Migrator%20VEID%20Flow.png?alt=media&amp;token=e9ff49d1-056a-490d-940a-b979f06cfd64" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

#### Quelldatensatz lesen

Jeder Quelldatensatz wird während des Migrationslaufs einzeln verarbeitet.
{% endstep %}

{% step %}

#### Zuordnung in der Datenbank nachschlagen

Das System prüft, ob bereits eine Zuordnung für die ID des Quelldatensatzes vorhanden ist.
{% endstep %}

{% step %}

#### Zuordnungsergebnis auswerten

<table><thead><tr><th width="180.33331298828125">Zuordnung gefunden</th><th>Aktion</th></tr></thead><tbody><tr><td>Nein</td><td>Neuen Datensatz in der Ziel-Org EINFÜGEN.</td></tr><tr><td>Ja</td><td>Den vorhandenen zugeordneten Zieldatensatz AKTUALISIEREN.</td></tr></tbody></table>
{% endstep %}

{% step %}

#### Zuordnung speichern

Wenn keine Zuordnung vorhanden ist, fügt das System den Datensatz in die Ziel-Org ein und erstellt eine neue Zuordnung. Bei nachfolgenden Migrationen wird dieser Datensatz aktualisiert, anstatt erneut eingefügt zu werden. Dieser Prozess wiederholt sich bei jedem Lauf, sodass neu hinzugefügte Quelldatensätze in der Datenbank nachverfolgt werden.
{% endstep %}
{% endstepper %}

### Einschränkungen

{% hint style="warning" %}

#### Wichtige Einschränkungen der automatischen Zuordnung von Datensätzen

* Automatic kann keine Datensätze zuordnen, die bereits in der Zielorganisation vorhanden sind.
* Wenn ein anderes Tool oder ein manueller Prozess Datensätze in der Zielorganisation erstellt oder ändert, können die Automatic-Zuordnungen veraltet werden, was zu doppelten Datensätzen führt.
* Automatic kann nur Datensätze verfolgen, die über Data Migrator migriert wurden.
  {% endhint %}

#### Veraltete Zuordnung

Das automatische Mapping ist nur so zuverlässig wie seine Datenbank. Zuordnungen werden veraltet, wenn Datensätze in der Ziel-Org erstellt werden, entweder manuell oder über ein anderes Tool. Das folgende Beispiel zeigt, wie dies zu doppelten Datensätzen führt.

**Beispiel:**

1. Ein Benutzer führt eine Migration aller Kontaktdatensätze in eine leere Org aus.
   1. Alle Kontaktdatensätze werden von der Quelle in die Ziel-Org kopiert.
   2. Für jeden Datensatz werden automatische Zuordnungen erstellt.
2. Der Benutzer erstellt manuell Kontaktdatensätze für **Charlie** und **Alice** sowohl in der Quell- als auch in der Ziel-Org.
3. Der Benutzer führt eine weitere Migration aller Kontaktdatensätze von der Quell-Org in die Ziel-Org aus.
   1. **Charlie** und **Alice** haben keine automatische Zuordnung, weil sie zuvor nicht migriert wurden.
   2. Neue Datensätze für **Charlie** und **Alice** werden in der Ziel-Org erstellt.
   3. Die Ziel-Org enthält jetzt doppelte Datensätze für **Charlie** und **Alice**: einen aus der manuellen Erstellung und einen aus der Migration.

## Manuelles Datensatz-Mapping

Beim manuellen Datensatz-Mapping werden ein oder mehrere Datensatzfelder zu einer zusammengesetzten ID kombiniert, die Quell- und Zieldatensätze verknüpft. Im Gegensatz zu standardmäßigen externen IDs von Salesforce kann jedes Feld in der zusammengesetzten ID verwendet werden. Wenn das manuelle Mapping in der Ziel-Org genau einen passenden Datensatz findet, aktualisiert es diesen Datensatz anstatt einen neuen einzufügen.

Es ist dafür ausgelegt, Datensätze in Ziel-Organisationen zu migrieren, die bereits Datensätze enthalten, die zuvor nicht mit automatischem Datensatz-Mapping zugeordnet wurden, oder Datensätze, die in der Ziel-Org von anderen Tools erstellt wurden. Wählen Sie die Felder für das manuelle Datensatz-Mapping sorgfältig aus: Wenn sich der Wert eines ausgewählten Felds ändert, stimmt die Zuordnung nicht mehr mit dem zuvor migrierten Datensatz überein.

### So funktioniert das manuelle Mapping

Bevor Sie manuelles Datensatz-Mapping zum Migrieren von Datensätzen verwenden, müssen Sie für das Objekt ein oder mehrere Felder auswählen, die für das Datensatz-Mapping verwendet werden sollen. Die ausgewählten Felder werden kombiniert, um einen Schlüssel zu erstellen, der sowohl eindeutig als auch stabil ist. Das bedeutet, dass sich der Schlüssel nicht ändert, wenn sich häufig aktualisierte Datensatzfelder ändern, und dass er für jeden Datensatz in der Org eindeutig ist. Sie können ein oder mehrere Felder für den manuellen Schlüssel auswählen. Je mehr Felder Sie auswählen, desto wahrscheinlicher ist es, dass der Schlüssel eindeutig ist. Allerdings erhöht die Auswahl weiterer Felder auch die Wahrscheinlichkeit, dass der Schlüssel instabil wird.

Während des manuellen Datensatz-Mappings sucht der Prozess in der Ziel-Org nach Übereinstimmungen mit dem generierten Schlüssel. Das folgende Diagramm und die Erläuterung veranschaulichen, wie es funktioniert.

<figure><img src="https://1417117101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FSS7vNmCOIbsfbeAEDUTo%2FFlosum%20Data%20Migrator%20CEID%20Flow.png?alt=media&amp;token=2b82cea9-8699-4038-a8ad-e88ed6380754" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Quelldatensatz lesen

Jeder Quelldatensatz wird während des Migrationslaufs einzeln verarbeitet.
{% endstep %}

{% step %}

### Schlüssel generieren

Ein **SCHLÜSSEL** wird aus den für das manuelle Mapping ausgewählten Feldern des Datensatzes generiert.
{% endstep %}

{% step %}

### Ziel-Org abfragen

Führen Sie in der Ziel-Org eine SOQL-Abfrage für den **SCHLÜSSEL**.
{% endstep %}

{% step %}

### Abfrageergebnis auswerten

<table><thead><tr><th width="219.6666259765625">Anzahl der übereinstimmenden Datensätze</th><th>Aktion</th></tr></thead><tbody><tr><td>0</td><td>Neuen Datensatz in der Ziel-Org EINFÜGEN.</td></tr><tr><td>1</td><td>Den vorhandenen übereinstimmenden Zieldatensatz AKTUALISIEREN.</td></tr><tr><td>2 oder mehr</td><td>FEHLER - der Datensatz wird übersprungen. Mehr als ein Datensatz stimmt mit dem <strong>SCHLÜSSEL</strong>überein, sodass der manuelle Schlüssel für diesen Datensatz nicht eindeutig ist und der Datensatz nicht migriert werden kann.</td></tr></tbody></table>
{% endstep %}
{% endstepper %}

### Einschränkungen

{% hint style="warning" %}

#### Wichtige Einschränkungen der manuellen Datensatzzuordnung

Die Auswahl einer Kombination stabiler Felder, die für jeden Datensatz eine eindeutige ID erzeugen, ist entscheidend.

* **Stabil**: Wenn sich ein Wert in einem der für den Schlüssel ausgewählten Felder ändert, stimmt die manuelle Zuordnung nicht mehr mit dem zuvor migrierten Datensatz überein, und ein neuer Datensatz wird eingefügt, was zu einem Duplikat führt.
* **Eindeutig**: Wenn zwei oder mehr Datensätze im Quell-Org denselben Schlüssel haben, kann die Migration sie nicht korrekt den Zieldatensätzen zuordnen, da der Schlüssel nicht eindeutig ist.
  {% endhint %}

#### Ungeeignete manuelle Felder

Manuelles Datensatz-Mapping ist nur zuverlässig, wenn die für das manuelle Mapping ausgewählten Felder einen Schlüssel erstellen, der sowohl stabil als auch eindeutig ist. Unten finden Sie Beispiele für schlechte Feldauswahlen.

Die folgenden Beispiele verwenden das Objekt Kontakt.

<table><thead><tr><th width="220">Für den Schlüssel ausgewählte Felder</th><th>Warum diese Felder eine schlechte Wahl sind</th></tr></thead><tbody><tr><td><code>Name</code> und <code>Stadt</code></td><td>Obwohl <code>Name</code> sich selten ändert, macht die Kombination mit <code>Stadt</code> den Schlüssel instabil, weil sich die Stadt eines Kontakts ändern kann.</td></tr><tr><td><code>Titel</code> und <code>Abteilung</code></td><td>Diese Kombination ist nicht eindeutig: Mehrere Kontakte können denselben Titel und dieselbe Abteilung haben.</td></tr><tr><td><code>Name</code> und <code>Geburtstag</code></td><td>Diese Kombination scheint eindeutig und stabil zu sein, aber <code>Geburtstag</code> ist anfangs oft leer und wird später ausgefüllt, wodurch der Schlüssel instabil wird.</td></tr></tbody></table>

## Szenarien für das Datensatz-Mapping

{% hint style="success" %}

#### Vorlagendesign

Objekt: **Kontakt**

* Feld: **Name**
* Feld: **E-Mail**
* Feld: **Stadt**
  {% endhint %}

Die folgenden Tabellen zeigen die Quell- und Zieldatensätze, wobei die Unterschiede fett hervorgehoben sind.

**Kontaktdatensätze der Quell-Org**

<table><thead><tr><th width="200.3333740234375">ID</th><th>Name</th><th width="210">E-Mail</th><th>Stadt</th></tr></thead><tbody><tr><td>001D000000kL4p1</td><td>Alice</td><td>alice@company.com</td><td><strong>Berlin</strong></td></tr><tr><td>001D000000kL4p2</td><td>Bob</td><td><strong>bobNew@company.com</strong></td><td>London</td></tr><tr><td>001D000000kL4p3</td><td>Charlie</td><td>charlie@company.com</td><td>Paris</td></tr><tr><td>001D000000kL4p4</td><td><strong>Dave</strong></td><td><strong>dave@company.com</strong></td><td><strong>Seattle</strong></td></tr></tbody></table>

**Kontaktdatensätze der Ziel-Org**

<table><thead><tr><th width="200.33331298828125">ID</th><th>Name</th><th width="210">E-Mail</th><th>Stadt</th></tr></thead><tbody><tr><td>002D000000kL5p1</td><td>Alice</td><td>alice@company.com</td><td>New York</td></tr><tr><td>002D000000kL5p2</td><td>Bob</td><td>bob@company.com</td><td>London</td></tr><tr><td>002D000000kL5p3</td><td>Charlie</td><td>charlie@company.com</td><td>Paris</td></tr></tbody></table>

### Datenmigration mit automatischem Datensatz-Mapping

#### Erfolgreiches Szenario

In diesem Szenario hat eine vorherige Migration bereits eine automatische Zuordnung zwischen der Quell- und der Ziel-Org erstellt. Die folgende Tabelle zeigt diese Zuordnung.

| Quellname | Quell-ID        | Ziel-ID         |
| --------- | --------------- | --------------- |
| Alice     | 001D000000kL4p1 | 002D000000kL5p1 |
| Bob       | 001D000000kL4p2 | 002D000000kL5p2 |
| Charlie   | 001D000000kL4p3 | 002D000000kL5p3 |

Wenn die Migration ausgeführt wird, sucht das automatische Datensatz-Mapping in der vorhandenen Zuordnung nach der ID jedes Quelldatensatzes. Datensätze mit gespeicherter Zuordnung werden in der Ziel-Org aktualisiert, und Datensätze ohne Zuordnung werden als neue Datensätze eingefügt. Das folgende Diagramm und die folgende Tabelle veranschaulichen diesen Prozess und die daraus resultierenden Aktionen in der Ziel-Org.

<figure><img src="https://1417117101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FaIMfSu7i6GDBlAQuOiXT%2F3_VEID%20Record%20Mapping%20Example.png?alt=media&amp;token=0db00575-fe39-412d-972b-ad5857d23307" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="179.66668701171875">ID</th><th>Name</th><th width="210">E-Mail</th><th>Stadt</th><th>Vorgang</th></tr></thead><tbody><tr><td>002D000000kL5p1</td><td>Alice</td><td>alice@company.com</td><td><strong>Berlin</strong></td><td>AKTUALISIEREN</td></tr><tr><td>002D000000kL5p2</td><td>Bob</td><td><strong>bobNew@company.com</strong></td><td>London</td><td>AKTUALISIEREN</td></tr><tr><td>002D000000kL5p3</td><td>Charlie</td><td>charlie@company.com</td><td>Paris</td><td>AKTUALISIEREN</td></tr><tr><td>002D000000kL5p4</td><td><strong>Dave</strong></td><td><strong>dave@company.com</strong></td><td><strong>Seattle</strong></td><td>EINFÜGEN</td></tr></tbody></table>

Für den neu eingefügten Datensatz wird dann eine neue automatische Zuordnung hinzugefügt:

| Quellname | Quell-ID        | Ziel-ID         |
| --------- | --------------- | --------------- |
| Dave      | 001D000000kL4p4 | 002D000000kL5p4 |

#### Fehlgeschlagenes Szenario

In diesem Szenario hatte eine vorherige Migration bereits eine automatische Zuordnung zwischen der Quell- und der Ziel-Org erstellt; zu diesem Zeitpunkt waren jedoch nur zwei Datensätze zugeordnet. Die folgende Tabelle zeigt diese Zuordnung.

| Quellname | Quell-ID        | Ziel-ID         |
| --------- | --------------- | --------------- |
| Alice     | 001D000000kL4p1 | 002D000000kL5p1 |
| Bob       | 001D000000kL4p2 | 002D000000kL5p2 |

Vor der nächsten Migration fügt ein externes Tool einen Datensatz für Charlie sowohl in der Quell- als auch in der Ziel-Org hinzu. Wenn die Migration ausgeführt wird, sucht das automatische Mapping in der vorhandenen Zuordnung nach der ID jedes Quelldatensatzes, aktualisiert Zieldatensätze, die bereits eine Zuordnung haben, und fügt für diejenigen, die keine haben, neue Datensätze ein.

Das folgende Diagramm und die folgende Tabelle veranschaulichen diesen Prozess und die daraus resultierenden Aktionen in der Ziel-Org. Da für Charlie keine automatische Zuordnung vorhanden ist, fügt die Migration einen doppelten Datensatz ein, der in der zusätzlichen eingefügten Zeile angezeigt wird.

<figure><img src="https://1417117101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FyGETlsSHDtegUt29M7Lp%2F4_VEID%20Record%20Mapping%20Example%20-%20Failed.png?alt=media&amp;token=b651fbc8-e7d2-4747-be3c-0b9670ce2624" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="180.33331298828125">ID</th><th>Name</th><th width="209.666748046875">E-Mail</th><th>Stadt</th><th>Vorgang</th></tr></thead><tbody><tr><td>002D000000kL5p1</td><td>Alice</td><td>alice@company.com</td><td><strong>Berlin</strong></td><td>AKTUALISIEREN</td></tr><tr><td>002D000000kL5p2</td><td>Bob</td><td><strong>bobNew@company.com</strong></td><td>London</td><td>AKTUALISIEREN</td></tr><tr><td>002D000000kL5p3</td><td>Charlie</td><td>charlie@company.com</td><td>Paris</td><td></td></tr><tr><td><mark style="color:$danger;"><strong>002D000000kL5p4</strong></mark></td><td><mark style="color:$danger;"><strong>Charlie</strong></mark></td><td><mark style="color:$danger;"><strong>charlie@company.com</strong></mark></td><td><mark style="color:$danger;"><strong>Paris</strong></mark></td><td><mark style="color:$danger;"><strong>EINFÜGEN</strong></mark></td></tr><tr><td>002D000000kL5p5</td><td><strong>Dave</strong></td><td><strong>dave@company.com</strong></td><td><strong>Seattle</strong></td><td>EINFÜGEN</td></tr></tbody></table>

Für die neu eingefügten Datensätze werden zwei neue automatische Zuordnungen hinzugefügt:

| Quellname | Quell-ID        | Ziel-ID         |
| --------- | --------------- | --------------- |
| Charlie   | 001D000000kL4p3 | 002D000000kL5p4 |
| Dave      | 001D000000kL4p4 | 002D000000kL5p5 |

{% hint style="warning" %}
Die Migration ist fehlgeschlagen, weil ein externes Tool Charlie sowohl in der Quell- als auch in der Ziel-Org hinzugefügt hat, ohne eine automatische Zuordnung zwischen ihnen zu erstellen. Da für Charlie keine Zuordnung vorhanden ist, hat das automatische Mapping in der Ziel-Org einen neuen Datensatz eingefügt, anstatt den vorhandenen zu aktualisieren, wodurch ein Duplikat entstanden ist.
{% endhint %}

### Datenmigration mit manuellem Datensatz-Mapping

#### Erfolgreiches Szenario

Manueller Feldschlüssel: `Name`

In diesem Szenario gleicht das manuelle Datensatz-Mapping Datensätze mithilfe des konfigurierten Schlüssels ab. Mit `Name` als manuellem Schlüssel generiert das System für jeden Quelldatensatz einen Schlüssel und fragt die Ziel-Org nach einer Übereinstimmung ab. Datensätze, die genau eine Übereinstimmung zurückgeben, werden aktualisiert, und Datensätze ohne Übereinstimmung werden eingefügt. Das folgende Diagramm und die folgende Tabelle veranschaulichen den Prozess des manuellen Datensatz-Mappings und die daraus resultierenden Aktionen in der Ziel-Org.

<figure><img src="https://1417117101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FeN0MzVUkDxLyb4oaEEok%2F1_CEID%20Record%20Mapping%20Example.png?alt=media&amp;token=6a6b92f2-6cde-457c-90cf-bca80edd8701" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="180.3333740234375">ID</th><th>Name</th><th width="209.6666259765625">E-Mail</th><th>Stadt</th><th>Vorgang</th></tr></thead><tbody><tr><td>002D000000kL5p1</td><td>Alice</td><td>alice@company.com</td><td><strong>Berlin</strong></td><td>AKTUALISIEREN</td></tr><tr><td>002D000000kL5p2</td><td>Bob</td><td><strong>bobNew@company.com</strong></td><td>London</td><td>AKTUALISIEREN</td></tr><tr><td>002D000000kL5p3</td><td>Charlie</td><td>charlie@company.com</td><td>Paris</td><td>AKTUALISIEREN</td></tr><tr><td>002D000000kL5p4</td><td><strong>Dave</strong></td><td><strong>dave@company.com</strong></td><td><strong>Seattle</strong></td><td>EINFÜGEN</td></tr></tbody></table>

#### Fehlgeschlagenes Szenario

Manueller Feldschlüssel: `Name` + `E-Mail`

In diesem Szenario verwendet das manuelle Datensatz-Mapping `Name` + `E-Mail` als konfigurierten Schlüssel. Für jeden Quelldatensatz generiert das System diesen Schlüssel und fragt die Ziel-Org nach einer Übereinstimmung ab. Da sich bei Bobs Quelldatensatz einer der Schlüsselwerte geändert hat, stimmt er nicht mehr mit seinem Datensatz in der Ziel-Org überein.

Datensätze, die genau eine Übereinstimmung zurückgeben, werden aktualisiert, und Datensätze ohne Übereinstimmung werden eingefügt. Das folgende Diagramm und die folgende Erläuterung zeigen den Prozess des manuellen Datensatz-Mappings und die daraus resultierenden Aktionen in der Ziel-Org. Da Bobs Quellschlüssel nicht mehr mit seinem vorhandenen Zieldatensatz übereinstimmt, fügt die Migration ein Duplikat ein, das in der zusätzlichen eingefügten Zeile angezeigt wird.

<figure><img src="https://1417117101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvaxzColPOlNbsq4imqpd%2Fuploads%2FOSRDO54tfxS7GfSUJKvq%2F2_CEID%20Record%20Mapping%20Example%20-%20Failed.png?alt=media&amp;token=f1fdb64e-0820-4337-94c4-cdea43f3633b" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="180.33331298828125">ID</th><th>Name</th><th width="210.3333740234375">E-Mail</th><th>Stadt</th><th>Vorgang</th></tr></thead><tbody><tr><td>002D000000kL5p1</td><td>Alice</td><td>alice@company.com</td><td><strong>Berlin</strong></td><td>AKTUALISIEREN</td></tr><tr><td>002D000000kL5p2</td><td>Bob</td><td>bob@company.com</td><td>London</td><td></td></tr><tr><td>002D000000kL5p3</td><td>Charlie</td><td>charlie@company.com</td><td>Paris</td><td>AKTUALISIEREN</td></tr><tr><td><mark style="color:$danger;"><strong>002D000000kL5p4</strong></mark></td><td><mark style="color:$danger;"><strong>Bob</strong></mark></td><td><mark style="color:$danger;"><strong>bobNew@company.com</strong></mark></td><td><mark style="color:$danger;"><strong>London</strong></mark></td><td><mark style="color:$danger;"><strong>EINFÜGEN</strong></mark></td></tr><tr><td>002D000000kL5p5</td><td><strong>Dave</strong></td><td><strong>dave@company.com</strong></td><td><strong>Seattle</strong></td><td>EINFÜGEN</td></tr></tbody></table>

{% hint style="warning" %}
Die Migration ist fehlgeschlagen, weil sich Bobs `E-Mail` Wert in der Quell-Org geändert hat, nachdem der Zieldatensatz erstellt wurde. Da `E-Mail` Teil des manuellen Schlüssels ist, stimmt der vom Quelldatensatz generierte neue Schlüssel (`Bob` + `bobNew@company.com`) nicht mehr mit dem Schlüssel des vorhandenen Zieldatensatzes überein (`Bob` + `bob@company.com`). Da keine Übereinstimmung gefunden wurde, fügte das manuelle Mapping in der Ziel-Org einen neuen Datensatz ein, anstatt den vorhandenen zu aktualisieren, wodurch ein Duplikat entstand.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/data-migrator/data-migrator-de/vorlagen/migration/so-funktioniert-die-datensatzzuordnung.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.