[Ook van toepassing op v8]{class="badge positive" title="Ook van toepassing op campagne v8"}
Importtaken configureren executing-import-jobs
Met Adobe Campaign kunt u gegevens uit een of meer bestanden in tekst-, CSV-, TAB- of XML-indeling importeren in de database. Deze bestanden zijn gekoppeld aan een tabel (hoofd of gekoppeld) en elk veld van het bronbestand of de bronbestanden is gekoppeld aan een veld van de database.
Met de wizard Importeren kunt u een importbewerking configureren, de opties ervan (zoals gegevenstransformatie) definiëren en uitvoering starten. Het is een reeks schermen waarvan de inhoud afhankelijk is van het type import (enkelvoudig of meervoudig) en de rechten van de operator.
De wizard Importeren wordt weergegeven nadat een nieuwe importtaak is gemaakt (zie Import- en exporttaken maken.
Bronbestand source-file
In het bronbestand valt elke regel samen met een record. De gegevens in records worden gescheiden door scheidingstekens (spatie, tab, teken, enz.). Dit betekent dat de gegevens in de vorm van kolommen worden teruggewonnen, en elke kolom wordt geassocieerd met een gebied van het gegevensbestand.
Stap 1 - Kies de importsjabloon step-1---choosing-the-import-template
Wanneer u de wizard Importeren start, moet u eerst een sjabloon selecteren. Als voorbeeld, om de invoer van ontvangers te vormen die een nieuwsbrief ontvingen, volg de stappen hieronder:
-
Selecteer de Profiles and Targets > Job > Generic imports and exports map.
-
Klikken Nieuw en klik vervolgens op Importeren om de importsjabloon te maken.
-
Klik op de pijl rechts van de knop Import template te selecteren of klik op Select link om door de boomstructuur te bladeren.
De native sjabloon is New text import. Deze sjabloon moet niet worden gewijzigd, maar u kunt het dupliceren om een nieuwe sjabloon te configureren, afhankelijk van uw vereisten. Importsjablonen worden standaard opgeslagen in de Profiles and targets > Templates > Job templates knooppunt.
-
Voer een naam in voor deze importbewerking in het dialoogvenster Label veld. U kunt een beschrijving toevoegen.
-
Selecteer het type import in het desbetreffende veld. Er zijn twee mogelijke typen importbewerkingen: Simple import om slechts één bestand te importeren, en Multiple import om meerdere bestanden in één uitvoering te importeren.
Selecteer bij een meervoudige importbewerking Multiple import van de Import type vervolgkeuzelijst in het eerste scherm van de importwizard.
-
Geef de velden op die u wilt importeren door op Add.
Telkens wanneer een bestand wordt toegevoegd, wordt het scherm van de File to import wordt weergegeven. Zie sectie Stap 2 - Bronbestandsselectie en voert u de stappen in de wizard uit om de importopties te definiëren als voor een eenvoudige importbewerking.
note note NOTE Meerdere importen moeten alleen aan specifieke behoeften voldoen en worden niet aanbevolen.
Geavanceerde parameters advanced-parameters
De Advanced parameters Via de koppeling hebt u toegang tot de volgende opties:
-
General tab
-
Stop execution if there are too many rejects
Deze optie is standaard ingeschakeld. U kunt de selectie opheffen als u het importeren wilt blijven uitvoeren, ongeacht het aantal afwijzingen. De uitvoering wordt standaard gestopt wanneer de eerste 100 regels worden geweigerd.
-
Trace mode
Selecteer deze optie om de uitvoering van het importeren voor elke regel bij te houden.
-
Start the job in a detached process
Deze optie is standaard ingeschakeld. Hiermee kunt u de uitvoering van het importeren loskoppelen, zodat dit geen invloed heeft op andere taken in de database.
-
Do not update enumerations
Selecteer deze optie om te voorkomen dat de lijst met opgesomde waarden in de database wordt verrijkt. Zie Opsommingen beheren.
-
-
Variables tab
U kunt variabelen definiëren die aan de taak zijn gekoppeld en die toegankelijk zijn in de query-editors en berekende velden. Klik op Add en gebruikt u de variabele editor.
note important IMPORTANT De Variables tab is alleen bedoeld voor workflowtype programmering en moet alleen worden geconfigureerd door deskundige gebruikers.
Stap 2 - Bronbestandsselectie step-2---source-file-selection
Het bronbestand kan de tekstindeling (txt, csv, tab, vaste kolommen) of xml hebben.
Standaard, Upload file on the server is geselecteerd. Klik op de map rechts van het dialoogvenster Local file om op de lokale schijf te bladeren en het te importeren bestand te selecteren. U kunt deze optie deselecteren om het toegangspad en de naam in te voeren van het bestand als dit zich op de server bevindt.
Wanneer het bestand is opgegeven, kunt u de gegevens in het onderste gedeelte van het venster bekijken door op Auto-detect format. In deze voorvertoning worden de eerste 200 regels van het bronbestand weergegeven.
Gebruik de opties boven deze weergave om het importeren te configureren. De parameters die via deze opties worden gedefinieerd, worden overgebracht naar de voorvertoning. De volgende opties zijn beschikbaar:
- Click here to change the file format… Hiermee kunt u de bestandsindeling controleren en de configuratie perfectioneren.
- Update on server… Hiermee kunt u het lokale bestand overbrengen naar de server. Deze optie is alleen beschikbaar als Upload file on the server is geselecteerd.
- Download is alleen beschikbaar als het bestand op de server is geüpload.
- Auto-detect format wordt gebruikt om het formaat van de gegevensbron opnieuw te initialiseren. Met deze optie kunt u de oorspronkelijke indelingen opnieuw toepassen op gegevens die zijn opgemaakt via het dialoogvenster Click here to change the file format… -optie.
- De Advanced parameters Met de koppeling kunt u de brongegevens filteren en geavanceerde opties gebruiken. Vanuit dit scherm kunt u ervoor kiezen om slechts een deel van het bestand te importeren. U kunt ook een filter definiëren, bijvoorbeeld om alleen gebruikers van het type Prospect of Klant te importeren, op basis van de waarde van de corresponderende regel. Deze opties mogen alleen worden gebruikt door deskundige JavaScript-gebruikers.
De bestandsindeling wijzigen changing-the-file-format
De Click here to change the file format… Met deze optie kunt u de gegevens van het bronbestand opmaken, en met name het kolomscheidingsteken en het type gegevens voor elk veld opgeven. Deze configuratie wordt uitgevoerd via het volgende venster:
In deze stap kunt u beschrijven hoe de waarden van de bestandsvelden moeten worden gelezen. In het geval van een datum kunnen de datum- of datum- en tijdgegevens bijvoorbeeld worden gekoppeld aan een notatie (dd/mm/jjjj, mm/dd/jj, enz.). Als de invoergegevens niet overeenkomen met de verwachte indeling, worden deze tijdens het importeren geweigerd.
U kunt het resultaat van de configuratie weergeven in de voorvertoningszone in het onderste gedeelte van het venster.
Klikken OK om de opmaak op te slaan, klikt u vervolgens op Next de volgende stap weergeven.
Stap 3 - Toewijzing van velden step-3---field-mapping
U moet dan het bestemmingsschema selecteren en de gegevens van elke kolom op gebieden in het gegevensbestand in kaart brengen.
-
De Destination schema kunt u het schema selecteren waarin de gegevens worden geïmporteerd. Deze informatie is verplicht. Klik op de knop Select link om een van de bestaande schema's te selecteren. Klikken Edit link om de inhoud van de geselecteerde tabel weer te geven.
-
In de centrale tabel staan alle velden die in het bronbestand zijn gedefinieerd. Selecteer de velden die u wilt importeren om er een doelbestand aan te koppelen. Deze velden kunnen handmatig of automatisch worden toegewezen.
Als u een veld handmatig wilt toewijzen, klikt u op het selectievakje om het bronveld te selecteren en klikt u op de tweede kolom om de cel te activeren die overeenkomt met het geselecteerde veld. Klik op de knop Edit expression om alle velden van de huidige tabel weer te geven. Selecteer het doelveld en klik op OK om de toewijzing te valideren.
Als u de bronvelden en doelvelden automatisch wilt koppelen, klikt u op de knop Guess the destination fields rechts van de lijst met velden. De voorgestelde velden kunnen indien nodig worden gewijzigd.
note important IMPORTANT Het resultaat van deze bewerking moet altijd worden gevalideerd voordat u verdergaat met de volgende stap. -
U kunt een transformatie toepassen op de geïmporteerde velden. Klik hiertoe in de cel van het dialoogvenster Transformation kolom die betrekking heeft op het betrokken veld, en selecteer de toe te passen transformatie.
note important IMPORTANT De transformatie wordt toegepast op het moment van importeren. Als beperkingen op het bestemmingsgebied, echter (in het bovenstaande voorbeeld, op het @lastname gebied) zijn bepaald, nemen deze beperkingen prioriteit. -
U kunt berekende velden toevoegen met het juiste pictogram rechts van de centrale tabel. Met berekende velden kunt u complexe transformaties uitvoeren, virtuele kolommen toevoegen of de gegevens van meerdere kolommen samenvoegen. Raadpleeg de volgende secties voor meer informatie over de verschillende mogelijkheden.
Berekende velden calculated-fields
Berekende velden zijn nieuwe kolommen die aan het bronbestand worden toegevoegd en uit andere kolommen worden berekend. Berekende velden kunnen vervolgens worden gekoppeld aan velden in de Adobe Campaign-database. Afstemmingen zijn echter niet mogelijk op berekende velden.
Er zijn vier typen berekende velden:
-
Fixed string: de waarde van het berekende veld is gelijk voor alle regels van het bronbestand. Hiermee kunt u de waarde instellen van een veld met records die zijn ingevoegd of bijgewerkt. U kunt bijvoorbeeld voor alle geïmporteerde records een markering instellen op "ja".
-
String with JavaScript tags: de waarde van het berekende veld is een tekenreeks met JavaScript-opdrachten.
-
JavaScript expression: de waarde van het berekende veld is het resultaat van de evaluatie van een JavaScript-functie. De geretourneerde waarde kan een getal, een datum enzovoort zijn.
-
Enumeration: de waarde van het veld wordt toegewezen aan de waarde in het bronbestand. De redacteur laat u de bronkolom specificeren en de lijst van opsommingswaarden ingaan, zoals in het volgende voorbeeld:
De Preview kunt u het resultaat van de gedefinieerde configuratie weergeven. Hier, Subscription kolom is toegevoegd. De waarde wordt berekend op basis van de Status veld.
Stap 4 - Verzoening step-4---reconciliation
Met de afstemmingsstap van de importwizard kunt u de modus definiëren waarmee de gegevens uit het bestand worden afgestemd op de bestaande gegevens in de database en kunt u de prioriteitsregels instellen tussen de bestandsgegevens en de databasegegevens. Het configuratievenster ziet er als volgt uit:
Het centrale gedeelte van het scherm bevat een structuur met de velden en tabellen van de Adobe Campaign-database waarnaar de gegevens worden geïmporteerd.
Er zijn speciale opties beschikbaar voor elk knooppunt (tabel of veld). Wanneer u op het betrokken knooppunt klikt in de lijst, worden de parameters en een korte beschrijving ervan hieronder weergegeven. Het gedrag dat voor elk element wordt gedefinieerd, wordt weergegeven in het corresponderende Behavior kolom.
Soorten bewerkingen types-of-operation
Voor elke tabel waarop de invoer betrekking heeft, moet u het type bewerking definiëren. De volgende bewerkingen zijn beschikbaar voor het hoofdelement van de database:
- Update or insertion: werkt de record bij als deze in de database bestaat en maakt deze zo niet.
- Insertion: voegt records in de database in.
- Update: werkt alleen bestaande records bij (negeert andere records).
- Reconciliation only: zoekt naar de record in de database, maar voert geen update uit. Hiermee kunt u bijvoorbeeld de map met ontvangers koppelen om te importeren volgens een kolom van het bestand zonder de gegevens in de mappen bij te werken.
- Deletion: hiermee kunt u records in de database vernietigen.
De volgende opties zijn beschikbaar voor elk veld in de tabel waarop de invoer betrekking heeft:
- Update (empty) if source value is empty: in het geval van een update verwijdert de waarde in het veld de databasewaarde als het veld leeg is in het bronbestand. Anders wordt het databaseveld bewaard.
- Update only if destination is empty: de waarde van het bronbestand overschrijft de waarde in het databaseveld niet, tenzij het databaseveld leeg is. In dat geval wordt de waarde van het bronbestand gebruikt.
- Update the field only when the record is inserted: tijdens een update- of invoegbewerking worden alleen nieuwe bronbestandsrecords geïmporteerd.
Afstemmingssleutels reconciliation-keys
Er moet ten minste één afstemmingssleutel worden ingevuld om deduplicatie te beheren.
Een afstemmingssleutel is een set velden die wordt gebruikt om een record te identificeren. Als u bijvoorbeeld ontvangers wilt importeren, kan de afstemmingssleutel het rekeningnummer, het veld E-mail of de velden Achternaam, Voornaam, Bedrijf zijn, enzovoort.
In dit geval vergelijkt de importengine de waarden van het bestand met die van de database voor alle velden van de sleutel om te zien of een regel van een bestand overeenkomt met een bestaande ontvanger in de database. Wanneer velden specifiek zijn voor een record, kan een nauwkeurige vergelijking tussen de bron- en de doelgegevens worden uitgevoerd, zodat de integriteit van de gegevens na het importeren wordt gegarandeerd. Een tweede afstemmingssleutel kan worden ingevuld voor dezelfde tabel; deze wordt gebruikt voor de regels waarvan de eerste sleutel leeg is.
Kies geen veld dat tijdens het importeren kan worden gewijzigd. Als dit gebeurt, kan de engine aanvullende records maken.
Deduplicatie deduplication
De Management of doubles kunt u de deduplicatie van gegevens configureren. Deduplicatie betreft records die meerdere keren worden weergegeven in het bronbestand (of bronbestanden in geval van een import van meerdere bestanden), d.w.z. regels waarvoor de velden van de afstemmingssleutel identiek zijn.
- Dubbel beheer in Update in de modus (de standaardmodus) wordt geen deduplicatie uitgevoerd. De laatste record heeft daarom prioriteit (omdat deze de gegevens van de voorgaande records bijwerkt). Het tellen van duplicaten wordt niet uitgevoerd in deze modus.
- Dubbel beheer in Ignore modus of Reject entity Hiermee worden duplicaten van de import uitgesloten. In dit geval wordt geen record geïmporteerd.
- In Reject entity in de modus, wordt het element niet geïmporteerd en wordt een fout gegenereerd in de importlogboeken.
- In Ignore in de modus, wordt het element niet geïmporteerd, maar wordt geen spoor van de fout behouden. In deze modus kunt u de prestaties optimaliseren.
Deduplicatie heeft betrekking op een record die zowel in het bronbestand als in de database aanwezig is. Het betreft bewerkingen met alleen updates (d.w.z. Update and insertion of Update). De Duplicate management Met deze optie kunt u de record bijwerken of negeren als deze zich in zowel het bronbestand als de database bevindt. De Update or insert based on origin Deze optie behoort tot de optionele module en kan niet worden gebruikt in een standaardcontext.
De opties Reject en Ignore werken zoals hierboven beschreven.
In geval van fout behavior-in-the-event-of-an-error
De meeste gegevensoverdrachtsbewerkingen genereren verschillende soorten fouten (incoherente regelindeling, ongeldig e-mailadres, enz.). Alle fouten en waarschuwingen die door de importengine worden gegenereerd, worden opgeslagen en gekoppeld aan het importexemplaar.
Details van deze afwijzingen kunnen worden bekeken via de Rejects tab.
Er zijn twee typen afwijzing (het type wordt weergegeven in het dialoogvenster Connector kolom):
- Afwijzingen van de tekstconnector hebben betrekking op fouten die optreden tijdens het verwerken van de bestandsregel (berekend veld, gegevensanalyse, enz.). In dit geval wordt bij een fout de hele regel altijd geweigerd.
- Afkeuringen van databaseverbindingen hebben betrekking op fouten die optreden tijdens het afstemmen van gegevens of het schrijven naar de database. In het geval van een import naar meerdere tabellen kan de afwijzing alleen betrekking hebben op een deel van de record (bijvoorbeeld bij het importeren van ontvangers en bijbehorende gebeurtenissen kan een fout het bijwerken van een gebeurtenis voorkomen zonder de ontvanger te negeren).
Op de pagina voor het afstemmen van gegevens kunt u het gewenste veld voor het type foutbeheer per veld en tabel per tabel definiëren.
-
Ignore and log a warning: alle velden worden geïmporteerd in de database, behalve de velden die een fout hebben gegenereerd.
-
Reject parent element: de gehele regel van de record wordt afgewezen, niet alleen het veld dat een fout heeft veroorzaakt.
-
Reject all elements: de importstop en alle elementen van de record worden geweigerd.
De structuur in het afstotingsscherm van een importinstantie geeft aan welke velden zijn geweigerd en waar de fouten zijn opgetreden.
U kunt een bestand met deze records genereren via het dialoogvenster Export rejects pictogram:
Stap 5 - Extra stap bij het importeren van ontvangers step-5---additional-step-when-importing-recipients
In de volgende stap van de wizard Importeren kunt u de map selecteren of maken waarin gegevens worden geïmporteerd, geïmporteerde ontvangers automatisch toewijzen met een (nieuwe of bestaande) lijst en ontvangers abonneren op een service.
-
Klik op de knop Edit koppelingen maken om de map, de lijst of de service te selecteren waaraan u de ontvangers wilt koppelen of zich erop wilt abonneren.
-
Importeren in een map
De Edit… koppeling van de Import into a folder kunt u de map selecteren of maken waarin de ontvangers worden geïmporteerd. Als standaard geen partitie is gedefinieerd, worden de gegevens geïmporteerd in de standaardmap van de operator.
note note NOTE De standaardmap voor een operator is de eerste map waarvoor de operator schrijftoegang heeft. Meer informatie in Toegangsbeheer voor mappen. Als u de importmap wilt selecteren, klikt u op de pijl rechts van de knop Folder en selecteer de desbetreffende map. U kunt ook de opdracht Select link om de structuur weer te geven in een nieuw venster of een nieuwe map te maken.
Als u een nieuwe map wilt maken, selecteert u het knooppunt waaruit u een map wilt toevoegen en klikt u met de rechtermuisknop. Selecteer Create a new ‘Recipients’ folder.
De map wordt toegevoegd onder het huidige knooppunt. Voer de naam van de nieuwe map in, klik op Enter om te bevestigen en klik vervolgens op OK.
-
Koppelen aan een lijst
De Edit… in de Add recipients to a list kunt u een lijst selecteren of maken waarin de ontvangers worden geïmporteerd.
U kunt een nieuwe lijst voor deze ontvangers maken door op Select link vervolgens Create. De opstelling en het beheer van lijsten worden weergegeven in deze sectie.
U kunt besluiten om de ontvangers aan degenen toe te voegen die reeds in een lijst aanwezig zijn, of de lijst met de nieuwe ontvangers opnieuw te maken. In dit geval worden ontvangers verwijderd en vervangen door de geïmporteerde ontvangers als de lijst al ontvangers bevatte.
-
Abonneren op een service
Als u alle geïmporteerde ontvangers wilt abonneren op een inlichtingenservice, klikt u op de knop Edit… koppeling van de Subscribe recipients to a service om de informatiedienst te selecteren of te creëren waarop de ontvangers zullen worden geabonneerd. U kunt de Send a confirmation message optie: De inhoud van dit bericht wordt bepaald in het leveringsmalplaatje verbonden aan de abonnementsdienst.
U kunt een nieuwe service voor deze ontvangers maken door op Select link en vervolgens de Create pictogram. Het beheer van de informatiediensten is te vinden in deze sectie.
-
-
Gebruik de Origin veld voor het toevoegen van informatie over de oorsprong van ontvangers aan hun profielen. Deze informatie is met name nuttig in het kader van een meervoudige import.
Klikken Next om deze stap te valideren en de volgende stap weer te geven.
Stap 6 - Het importeren starten step-6---launching-the-import
In de laatste stap van de wizard kunt u gegevensimport starten. Om dit te doen, klik Start knop.
U kunt vervolgens de uitvoering van de importtaak controleren (zie Uitvoering van taken controleren.