Add-On: Automatischer Personalisierungsdaten-Import

Owned by t.weiss@bebeyond.de
Last updated: März 04, 2021 by Stefan Bleilevens
3 min read

Das Add-On lautet: Auto-Import von Pers.-Daten

Der automatische Personalisierungsdaten-Import ruft jede Nacht gegen 2 Uhr eine Datei ab und importiert diese in eine definierte Personalisierungsdatenbank. Die Daten können per HTTP, FTP oder SFTP bereitgestellt werden. Als Dateitypen werden CSV und XML sowie von SAP bereitgestellte XML-Exporte unterstützt.

Einstellungen

Legen Sie sofern nicht vorhanden eine Personalisierungsdatenbank an. Ist das Modul "Auto-Import von Pers.-Daten" aktiviert, finden Sie die Einstellung unter Add-ons → Auto-Import Pers.-Daten. Geben Sie hier zwingend die Zugangsdaten ein, unter der die Datei abrufbar ist und wählen die Pers.-Datenbank, in der die Daten importiert werden sollen. 

Wenn Sie eine Verbindung testen, wird ebenfalls geprüft, ob die angegebene Datei abgerufen und gelesen werden kann.  

Hinweis

Bitte beachten Sie, dass bei jedem Import die Struktur geprüft wird. Nicht vorhandene Felder werden erstellt, nicht benötigte Felder gelöscht. 

Unterstütze Verbindungstypen

HTTP

Geben Sie bei der URL die vollständige URL ein unter der die Daten abrufbar sind. Ist die Datei Standard zugriffsgeschützt, können Sie optional Benutzername und Passwort angeben. Bei jeder nachträglichen Änderung ist es zwingend erforderlich das Passwort erneut einzugeben.

FTP

Geben Sie hier vollständige FTP-Daten an. Host, Benutzername und Password werden zwingend benötigt, sowie der Dateiname, der importiert werden soll. Standardmäßig wird versucht eine Verbindung über Port 21 aufzubauen. Wir empfehlen die Option Passiv immer zu aktivieren. 

SFTP

Geben Sie hier vollständige SFTP-Daten an. Host und Benutzername werden zwingend benötigt, sowie der Dateiname, der importiert werden soll. Zur Authentifizierung können Sie ein Passwort hinterlegen oder alternativ einen privaten Key. Standardmäßig wird versucht eine Verbindung über Port 22 aufzubauen. 

Um die CSV korrekt lesen zu können, geben Sie das korrekte Trennzeichen sowie die Zeichenkodierung an. Anschließend können Sie die Verbindung testen. Ist die Verbindung erfolgreich, können Sie zudem noch eine E-Mail-Adresse definieren, die im Fehlerfall unterrichtet wird. 

Unterstütze Dateiformate

CSV

Als Trennzeichen werden Komma, Semikolon und Tabulator unterstützt. Es ist zwingend erforderlich, dass die CSV eine Kopfzeile mit den gewünschten Feldern enthält. 

Sample.csv
Firma;Vorname;Name;Color
Firma 1;Max;Mustermann;green
Firma 2;Erika;Mustermann;yellow

XML

Eine XML muss aus <data> und <element> Nodes bestehen. Es werden zudem Attribute unterstützt und diese mit "_" zum Node-Namen verknüpft. Beispiel "<field_1 attr1="de">" wird als "field_1_de" in der Pers.-Datenbank abgelegt.

<data>
    <element>
        <field_1>Field 1 DE</field_1>
        <field_2>Field 2</field_2>
    </element>
    <element>
        <field_1>Field 1</field_1>
        <field_3>Field 3</field_3>
    </element>
    <element>
        <field_1 attr1="de">Field 1 DE</field_1>
        <field_1 attr1="en">Field 1 EN</field_1>
        <field_2>Field 2</field_2>
    </element>
</data>

SAP XML

<?xml version="1.0" encoding="utf-8"?>
<ns1:MT_BUSINESSCARDS_XML xmlns:ns1="http://intra.net/BUSINESSCARDS/IB">
<user>
    <personnel_number>0000123445678</personnel_number>
    <name>SAP User 1</name>
    <hierarchie_of_user lang="de">Hierarchie of User German</hierarchie_of_user>
    <hierarchie_of_user lang="en">Hierarchie of User English</hierarchie_of_user>
    <function_of_user lang="de">Function of User German</function_of_user>
    <function_of_user lang="en">Function of User English</function_of_user>
    <function2_of_user lang="de">Function 2 of User German</function2_of_user>
    <function2_of_user lang="en">Function 2 of User English</function2_of_user>
    <signing_authority lang="de">Signing Authority German</signing_authority>
    <signing_authority lang="en">Signing Authority Engish</signing_authority>
    <title lang="de">Der Titel</title>
    <title lang="en">The Title</title>
    <phone type="main">tel main</phone>
    <fax type="main">fax main</fax>
    <mobile type="main">mobile main</mobile>
    <phone type="sub">tel sub</phone>
    <fax type="sub">fax sub</fax>
    <mobile type="sub">mobile sub</mobile>
    <email>mail@mail.com</email>
    <website>www.web.com</website>
    <addresses>
        <address type="main">
            <name>SAP User 1's Address</name>
            <department>Marketing</department>
            <street>Marketingstreet</street>
            <zip>123456</zip>
            <place>Tettnang</place>
        </address>
        <address type="sub">
            <street>Sample 1</street>
            <zip>12345</zip>
            <place>Tettnang</place>
        </address>
    </addresses>
</user>
</ns1:MT_BUSINESSCARDS_XML>