Plan – Relationen

Eine HubEngine-Relation, oft einfach als „Relation“ bezeichnet, stellt die Verknüpfung von eindeutigen ID-Paaren zwischen den verbundenen API-Endpunkten dar.

Eine ausführlichere Erklärung: In einem HubEngine-Plan werden Datensätze von zwei verschiedenen API-Endpunkten mithilfe eindeutiger IDs miteinander verknüpft, um Beziehungen zwischen ihnen herzustellen. Eine Relation besteht daher aus einem solchen ID-Paar. Wenn beispielsweise die Integration von 1.000 Kontakten (Datensätzen) zwischen zwei Systemen erfolgt, werden 1.000 Relationen benötigt. Diese Relationen werden im sogenannten Relation Store gespeichert.

Um die Relationen eines Plans zu verwalten, öffne den entsprechenden Plan und klicke auf den Reiter Relationen/Relations. Du hast nun verschiedene Optionen.

• Relationen herunterladen
• Relationen hochladen
• Relationen erstellen
• Alle Relationen löschen
• Relationen einrichten
• Relationen teilen
• Relationen suchen/einzelne Relationen löschen

Du kannst dir jederzeit die Relationen (ID-Pärchen) als csv-Datei herunterladen.

Du kannst ebenfalls Relationen in einer csv-Datei hochladen. Du hast die Optionen, die erste Zeile beim Import zu ignorieren, falls diese die Spalten angeben. Ebenfalls kannst du angeben, ob die Spalten vertauscht werden sollen. Die Spalten der IDs in der csv-Datei entsprechen den angebundenen Systemen. In diesem Beispiel gehört die linke Spalte zu SAP und die rechte zu HubSpot. Ist deine csv-Datei vertauscht, dann wähle einfach die Option „Spalten tauschen/Switch Columns„.

Relationen, die du hochlädst, werden hinzugefügt. Besteht die Relation bereits, wird sie ignoriert und nicht doppelt angelegt. Bevor du Relationen hochlädst, empfehlen wir jedoch dringend, dass du die Relationen vorher herunterlädst zur Sicherheit, falls dir ein Fehler unterlaufen sollte beim Importieren.

Du kannst über den Button Create auch neue Relationen erstellen.

Du kannst die gesamten Relationen auch vollständig löschen. Wichtig: Bevor du das tust, empfehlen wir jedoch dringend, dass du dir die Relationen vorher herunterlädst zur Sicherheit.

Über Einrichten kannst du ID Pendants aus einer freigegebenen Liste auswählen, wenn es einen anderen Plan gibt, bei dem die Teilen-Funktion aktiviert ist.

Du kannst Relationen auch über Pläne hinweg teilen – innerhalb derselben Gruppe allerdings nur. Damit verwenden dann zwei oder mehr Pläne dieselben Relationen. Erfahre mehr über Geteilte Relationen und wann du sie verwendest in unserem Help Center Beitrag.

Du kannst über die Such-Maske nach einzelnen Relationen suchen. Nachdem du eine einzelne Relation über die ID gefunden hast, besteht die Möglichkeit, sie dort über das Mülleimer-Icon im grünen Ergebnisfeld zu löschen.