Contact output

Dieses Plugin kann in Transformationen verwendet werden, um Kontakte nach ConSol CM zu importieren.

Es sind folgende Einstellungen verfügbar:

• Step name: Geben Sie den Namen des Transformationsschrittes ein. Der Standardname ist der Name des Plugins.

• Customer group: Wählen Sie die Kundengruppe der Kontakte.

• Batch size: Legen Sie fest, wie viele Daten in einem Schritt importiert werden sollen.

• Contact object for CM/Track profile: Wählen Sie das Kontaktobjekt, dem das CM/Track-Benutzerprofil zugewiesen werden soll. Dieser Wert ist optional.

• Input field with CM/Track username: Wählen Sie das Feld, das den Namen des CM/Track-Benutzerprofils enthält.

• Default value for CM/Track username: Geben Sie den Namen des CM/Track-Benutzerprofils ein, das verwendet werden soll, wenn keine CM/Track-Benutzerprofile in den Daten vorhanden sind, oder das Feld Input field with CM/Track username leer ist. Dieser Wert ist optional.

• Do not remove existing CM/Track profile assignment if input field is empty: Wenn diese Option ausgewählt ist, wird das dem Kontakt zugewiesene CM/Track-Benutzerprofil nicht entfernt, wenn das Feld Input field with CM/Track username leer ist.

• Name of the contact ID field: Geben Sie den Namen des neuen Feldes ein, das die Kontakt-ID enthalten soll. Diese ID kann in den nachfolgenden Transformationsschritten für die zusätzliche Verarbeitung verwendet werden. Dieser Wert ist optional.

• Input field: Diese Spalte kann alle Felder aus dem vorhergehenden Transformationsschritt enthalten. Diese Felder werden den Kontaktfeldern in ConSol CM zugeordnet. Klicken Sie auf Get fields, um die aktuellen Eingabefelder zu laden.

• Contact object: Wählen Sie das Kontaktobjekt, zu dem die Felder gehören aus. Das ist entweder die Firma oder die Person aus dem Kontaktdatenmodell.

• Contact field: Wählen Sie das Kontaktfeld, das dem Eingabefeld zugeordnet werden soll. Syntax: <Feldgruppe>:<Feld Im Feld Unit:Deactivated kann angegeben werden, ob der Kontakt deaktiviert ist (true) oder aktiv (false).

• Operation type: Geben Sie an, wie das Feld verarbeitet werden soll. Alle Felder müssen denselben Typ haben. Die verfügbaren Optionen sind:

  • Create or error: Ein Feld dieses Typs kann nur erzeugt, aber nicht aktualisiert werden.

  • Update or error: Ein Feld dieses Typs kann nur aktualisiert, aber nicht erzeugt werden.

  • Fetch or error: Ein Feld dieses Typs kann abgerufen, aber weder erstellt noch aktualisiert werden. Das funktioniert nur für vorhandene Felder. Wenn der Kontakt nicht gefunden wird, gibt es eine Exception. Der ausgewählte Kontakt kann in nachfolgenden Transformationsschritten für die weitere Bearbeitung verwendet werden.

  • Create or update: Ein Feld dieses Typs wird erstellt (wenn der Kontakt nicht gefunden wird) oder aktualisiert (wenn der Kontakt gefunden wird).

  • Create or fetch: Ein Feld dieses Typs kann abgerufen werden (wenn der Kontakt gefunden wird), oder erstellt werden (wenn der Kontakt nicht gefunden wird). Es kann nicht aktualisiert werden. Der ausgewählte Kontakt kann in nachfolgenden Transformationsschritten für die weitere Bearbeitung verwendet werden.

• Search criterion: Mögliche Werte sind true und false. Der Wert true bedeutet, dass das Kontaktfeld zur Suche nach einem vorhandenen Kontakt mit den gleichen Daten verwendet wird. Alle mit true gekennzeichneten Felder werden zusammen für die Suche verwendet. Sie sollten den Kontakt daher eindeutig identifizieren.

• Search case insensitive: Geben Sie an, ob bei der Suche nach Groß- und Kleinbuchstaben unterschieden werden soll (false) oder nicht (true).

info

Wenn die Kontakte, die Sie importieren möchten, Datenfelder der Typen Liste oder Spalten enthalten, müssen Sie diese Felder mit dem Plugin Contact container field output importieren. Verwenden Sie zum Importieren von Kommentaren und Attachments das Plugin Contact content output.

Warnung

Beachten Sie beim Importieren von Kontaktdaten folgendes Verhalten:

• Wenn Sie Kontakte in deinem zweistufigen Kontaktdatenmodell erstellen, in dem die Firma erforderlich ist, muss die Eingabedatei die ID der Firma, zu der die Person gehört enthalten. Die ID muss dem Kontaktfeld des Datentyps Kontaktreferenz. Wenn die Firmen-ID nicht bekannt ist, können Sie sie mit dem Plugin Contact ID lookup abfragen. Die ID muss in die Eingabedatei eingefügt werden.
• Wenn Sie Datenfelder von vorhandenen Kontakten aktualisieren, werden alle Kontaktfelder, die Eingabefeldern zugeordnet sind, überschrieben. Die bedeutet, dass die vorhandenen Feldwerte verloren gehen, wenn das entsprechende Feld in der Eingabedatei einen leeren Wert hat. Wenn Sie diese Werte behalten möchten, müssen Sie sie vorher mit dem Plugin Contact input abrufen und mit den Werten aus der Eingabedatei zusammenführen.
• Wenn die Felder, die das Suchkriterium bilden, nicht eindeutig sind, und zum Beispiel mehr als ein passender Kontakt gefunden wird, wird ein neuer Kontakt erstellt, statt einen vorhandenen Kontakt zu aktualisieren.