[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 importassistent kunt u een importbewerking configureren, opties ervan definiëren (zoals gegevenstransformatie) 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 vertoningen van de invoerassistent na het creëren van een nieuwe de invoerbaan (zie invoer en de uitvoerbanencreëren.
Source-bestand 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 importassistent 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 map Profiles and Targets > Job > Generic imports and exports .
-
Klik Nieuw en klik dan Invoer om het de invoermalplaatje tot stand te brengen.
-
Klik op de pijl rechts van het veld Import template om de sjabloon te selecteren of klik op Select link om door de structuur 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. Importeersjablonen worden standaard opgeslagen in het knooppunt Profiles and targets > Templates > Job templates .
-
Voer in het veld Label een naam in voor deze importbewerking. U kunt een beschrijving toevoegen.
-
Selecteer het type import in het desbetreffende veld. Er zijn twee mogelijke typen importeren: Simple import als u slechts één bestand wilt importeren, en Multiple import als u meerdere bestanden tegelijk wilt importeren.
Selecteer voor een meervoudige importbewerking Multiple import in de vervolgkeuzelijst Import type in het eerste scherm van de importassistent.
-
Geef de velden op die u wilt importeren door op Add te klikken.
Telkens wanneer een bestand wordt toegevoegd, wordt het scherm van de File to import assistent weergegeven. Zie sectie Stap 2 - het dossierselectie van Sourceen volg de stappen in de medewerker om de invoeropties zoals voor een eenvoudige invoer te bepalen.
note note NOTE Meerdere importen moeten alleen aan specifieke behoeften voldoen en worden niet aanbevolen.
Geavanceerde parameters advanced-parameters
Met de koppeling Advanced parameters 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. Als u een variabele wilt maken, klikt u op Add en gebruikt u de variabele-editor.
note important IMPORTANT Het tabblad Variables is alleen bedoeld voor gebruik bij workflowprogrammering en moet alleen door deskundige gebruikers worden geconfigureerd.
Stap 2 - Source-bestandsselectie step-2---source-file-selection
Het bronbestand kan de tekstindeling (txt, csv, tab, vaste kolommen) of xml hebben.
Standaard is Upload file on the server geselecteerd. Klik op de map rechts van het veld Local file om naar de lokale schijf te bladeren en selecteer het bestand dat u wilt importeren. 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 ervan weergeven in de onderste sectie van het venster door op Auto-detect format te klikken. 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:
- Met Click here to change the file format… kunt u de bestandsindeling controleren en de configuratie perfectioneren.
- Met Update on server… 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 de indeling van de gegevensbron opnieuw te initialiseren. Met deze optie kunt u de oorspronkelijke indelingen opnieuw toepassen op gegevens die zijn opgemaakt via de optie Click here to change the file format… .
- Met de koppeling Advanced parameters 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
Met de optie Click here to change the file format… 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.
Klik op OK om de opmaak op te slaan en klik vervolgens op Next om de volgende stap weer te geven.
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.
-
In het veld Destination schema kunt u het schema selecteren waarin de gegevens worden geïmporteerd. Deze informatie is verplicht. Klik op het pictogram Select link om een van de bestaande schema's te selecteren. Klik op 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 vervolgens op het pictogram 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 het pictogram 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 de kolom Transformation die betrekking heeft op het desbetreffende veld en selecteer de transformatie die u wilt toepassen.
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 op basis van een waarde in het bronbestand. De redacteur laat u de bronkolom specificeren en de lijst van opsommingswaarden ingaan, zoals in het volgende voorbeeld:
Op het tabblad Preview kunt u het resultaat van de gedefinieerde configuratie weergeven. Hier is de kolom Subscription toegevoegd. De waarde wordt berekend van het gebied van de Status.
Stap 4 - Verzoening step-4---reconciliation
Met de afstemmingsstap van de importassistent 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 de 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 alleen als 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
In het veld Management of doubles kunt u de deduplicatie van gegevens configureren. De deduplicatie heeft betrekking op verslagen die verscheidene tijden in het brondossier (of brondossiers in het geval van een veelvoudig-dossierinvoer) verschijnen, d.w.z. lijnen waarvoor de gebieden van de verzoeningssleutel identiek zijn.
- Duplicaatbeheer in de modus Update (de standaardmodus) voert geen deduplicatie uit. 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.
- Bij gedupliceerd beheer in de modus Ignore of Reject entity worden duplicaten van het importeren uitgesloten. In dit geval wordt geen record geïmporteerd.
- In de modus Reject entity wordt het element niet geïmporteerd en wordt een fout gegenereerd in de importlogboeken.
- In de modus Ignore 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 update (d.w.z. Update and insertion of Update ). Met de optie Duplicate management kunt u de record bijwerken of negeren als deze zich in zowel het bronbestand als de database bevindt. De optie Update or insert based on origin 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.
De details van deze afwijzing's kunnen worden weergegeven via het tabblad Rejects .
Er zijn twee typen afwijzing (het type wordt weergegeven in de kolom Connector ):
- 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 volledige regel van de record wordt geweigerd, niet alleen het veld dat een fout heeft veroorzaakt.
-
Reject all elements : het importeren wordt gestopt 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 pictogram Export rejects :
Stap 5 - Extra stap bij het importeren van ontvangers step-5---additional-step-when-importing-recipients
In de volgende stap van de importassistent kunt u de map selecteren of maken waarin gegevens worden geïmporteerd, kunt u geïmporteerde ontvangers automatisch toewijzen aan een (nieuwe of bestaande) lijst en kunt u ontvangers aan een service toewijzen.
-
Klik op de koppelingen in Edit 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
Met de koppeling Edit… in de sectie 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. Leer meer in toegangsbeheer van de Omslag. Als u de importmap wilt selecteren, klikt u op de pijl rechts van het veld Folder en selecteert u de desbetreffende map. U kunt het pictogram Select link ook gebruiken om de structuur in een nieuw venster weer te geven 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 op OK .
-
Koppelen aan een lijst
Met de koppeling Edit… in de sectie 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 en vervolgens op Create te klikken. De verwezenlijking en het beheer van lijsten worden voorgesteld 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 informatieservice, klikt u op de koppeling Edit… in de sectie Subscribe recipients to a service om de informatieservice te selecteren of te maken waarop de ontvangers zich moeten abonneren. U kunt de optie Send a confirmation message selecteren: de inhoud van dit bericht wordt gedefinieerd in de leveringssjabloon die is gekoppeld aan de abonnementenservice.
U kunt een nieuwe service voor deze ontvangers maken door op Select link en vervolgens op het pictogram Create te klikken. Het beheer van de informatiediensten wordt voorgesteld in deze sectie.
-
-
Gebruik het veld Origin om informatie over de oorsprong van ontvangers toe te voegen aan hun profielen. Deze informatie is met name nuttig in het kader van een meervoudige import.
Klik op 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 assistent kunt u gegevensimport starten. Klik hiertoe op de knop Start .
U kunt de uitvoering van de de invoerbaan dan controleren (zie de baanuitvoering van de Monitor.