[Ook van toepassing op v8]{class="badge positive" title="Ook van toepassing op campagne v8"}

Werken met gegevenspakketten working-with-data-packages

Over gegevenspakketten about-data-packages

Met Adobe Campaign kunt u de platformconfiguratie en data via een pakketsysteem exporteren of importeren. Pakketten kunnen verschillende configuraties, elementen bevatten, al dan niet gefilterd.

Met datapakketten kunnen entiteiten van de Adobe Campaign-database worden weergegeven via bestanden in XML-indeling. Elke entiteit in een pakket wordt met al zijn data vertegenwoordigd.

Het beginsel van gegevenspakketten moet een gegevensconfiguratie exporteren en in een ander Adobe Campaign-systeem integreren. Leer hoe u een consistente set gegevenspakketten in deze sectie.

Typen pakketten types-of-packages

Er zijn drie typen exporteerbare pakketten: gebruikerspakketten, platformpakketten en beheerpakketten.

Gegevensstructuur data-structure

De beschrijving van een gegevenspakket is een gestructureerd XML-document dat voldoet aan de grammatica van de xrk:navtree gegevensschema.

Voorbeeld van gegevenspakketten:

<package>
  <entities schema="nms:recipient">
    <recipient email="john.smith@adobe.com" lastName="Smith" firstName="John">
      <folder _operation="none" name="nmsRootFolder"/>
      <company _operation="none" name="Adobe"/>
    </recipient>
  </entities>
  <entities schema="sfa:company">
    <company name="Adobe">
      location city="London" zipCode="W11 2BQ"/>
    </company>
  </entities>
</package>

Het XML-document moet beginnen en eindigen met het <package> element. Alle <entities> elementen die volgen, verdelen de gegevens per documenttype.

An <entities> element bevat de gegevens van het pakket in de indeling van het gegevensschema dat is ingevoerd in het dialoogvenster schema kenmerk.

De gegevens in een pakket mogen geen interne sleutels bevatten die niet compatibel zijn tussen databases, zoals automatisch gegenereerde toetsen (automatische ).

In ons voorbeeld zijn de verbindingen op de "omslag"en "bedrijf"verbindingen vervangen door zogenaamde "high level"sleutels op de bestemmingstabellen:

<recipient>
  <folder _operation="none" name="nmsRootFolder"/>
  <company _operation="none" name="Adobe"/>
</recipient>

De operation kenmerk met de waarde "none" definieert een afstemmingskoppeling.

Een gegevenspakket kan manueel van om het even welke tekstredacteur worden samengesteld. Zorg er gewoon voor dat de structuur van het XML-document voldoet aan het gegevensschema "xtk:navtree". De Adobe Campaign-console heeft een export- en importmodule voor gegevenspakketten.

Pakketten exporteren exporting-packages

Over exporteren van pakket about-package-export

U kunt pakketten op drie verschillende manieren exporteren:

Nadat een pakket is geëxporteerd, kunt u het pakket en alle toegevoegde entiteiten importeren in een andere Campagne-instantie.

Een set objecten in een pakket exporteren exporting-a-set-of-objects-in-a-package

De wizard Pakket exporteren is toegankelijk via de Tools > Advanced > Export package… menu van de Adobe Campaign-clientconsole.

Voor de drie typen pakketten biedt de wizard de volgende stappen:

Afhankelijkheden beheren managing-dependencies

Met het exportmechanisme kan Adobe Campaign de koppelingen tussen de verschillende geëxporteerde elementen bijhouden.

Dit mechanisme wordt gedefinieerd door twee regels:

Een campagne exporteren exporting-a-campaign

Hier volgt een voorbeeld van hoe u een campagne kunt exporteren. De marketingcampagne die geëxporteerd moet worden, bevat een taak (label: "MyTask") en een workflow (label: "CampaignWorkflow") in een map "MyWorkflow" (knooppunt: Beheer / Productie / Technische workflows / Campagne-processen / MyWorkflow).

De taak en de workflow worden geëxporteerd in hetzelfde pakket als de campagne, aangezien de overeenkomende schema's worden verbonden door koppelingen met een integriteit van het type "own".

Inhoud pakket:

<?xml version='1.0'?>
<package author="Administrator (admin)" buildNumber="7974" buildVersion="7.1" img=""
label="" name="" namespace="" vendor="">
 <desc></desc>
 <version buildDate="2013-01-09 10:30:18.954Z"/>
 <entities schema="nms:operation">
  <operation duration="432000" end="2013-01-14" internalName="OP1" label="MyCampaign"
  modelName="opEmpty" start="2013-01-09">
   <controlGroup>
    <where filteringSchema=""/>
   </controlGroup>
   <seedList>
    <where filteringSchema="nms:seedMember"></where>
    <seedMember internalName="SDM1"></seedMember>
   </seedList>
   <parameter useAsset="1" useBudget="1" useControlGroup="1" useDeliveryOutline="1"
   useDocument="1" useFCPValidation="0" useSeedMember="1" useTask="1"
   useValidation="1" useWorkflow="1"></parameter>
   <fcpSeed>
    <where filteringSchema="nms:seedMember"></where>
   </fcpSeed>
   <owner _operation="none" name="admin" type="0"/>
   <program _operation="none" name="nmsOperations"/>
   <task end="2013-01-17 10:07:51.000Z" label="MyTask" name="TSK2" start="2013-01-16 10:07:51.000Z"
   status="1">
    <owner _operation="none" name="admin" type="0"/>
    <operation _operation="none" internalName="OP1"/>
    <folder _operation="none" name="nmsTask"/>
   </task>
   <workflow internalName="WKF12" label="CampaignWorkflow" modelName="newOpEmpty"
   order="8982" scenario-cs="Notification of the workflow supervisor (notifySupervisor)"
   schema="nms:recipient">
    <scenario internalName="notifySupervisor"/>
    <desc></desc>
    <folder _operation="none" name="Folder4"/>
    <operation _operation="none" internalName="OP1"/>
   </workflow>
  </operation>
 </entities>
</package>

De verbinding met een type pakket wordt bepaald in een schema met het @pkgAdmin en @pkgPlatform kenmerk. Beide eigenschappen ontvangen een XTK-expressie die de voorwaarden voor aansluiting bij het pakket definieert.

<element name="offerEnv" img="nms:offerEnv.png"
template="xtk:folder" pkgAdmin="@id != 0">

Tot slot de @pkgStatus kunt u de exportregels voor deze elementen of kenmerken definiëren. Afhankelijk van de waarde van het kenmerk, wordt het element of kenmerk gevonden in het geëxporteerde pakket. De drie mogelijke waarden voor dit kenmerk zijn:

Pakketdefinities beheren managing-package-definitions

Met pakketdefinities kunt u een pakketstructuur maken waarin u entiteiten toevoegt die later in één pakket worden geëxporteerd. Vervolgens kunt u dit pakket en alle toegevoegde entiteiten importeren in een andere Campagne-instantie.

Verwante onderwerpen:

Een pakketdefinitie maken creating-a-package-definition

Pakketdefinities zijn toegankelijk via de Administration > Configuration > Package management > Package definitions -menu.

Als u een pakketdefinitie wilt maken, klikt u op de knop New en vul vervolgens de algemene informatie over de pakketdefinitie in.

Vervolgens kunt u entiteiten toevoegen aan de pakketdefinitie en deze exporteren naar een XML-bestandspakket.

Verwante onderwerpen:

Entiteiten toevoegen aan een pakketdefinitie adding-entities-to-a-package-definition

In de Content klikt u op de knop Add om de entiteiten te selecteren die u met het pakket wilt exporteren. Aanbevolen werkwijzen bij het selecteren van entiteiten in het dialoogvenster deze sectie sectie.

Entiteiten kunnen rechtstreeks vanaf hun locatie in de instantie aan een pakketdefinitie worden toegevoegd. Hiervoor voert u de volgende stappen uit:

Genereren van pakketdefinities configureren configuring-package-definitions-generation

Pakketgeneratie kan worden geconfigureerd via de pakketdefinitie Content tab. Om dit te doen, klik Generation parameters koppeling.

Pakketten uit een pakketdefinitie exporteren exporting-packages-from-a-package-definition

Voer de volgende stappen uit om een pakket uit een pakketdefinitie te exporteren:

Pakketten importeren importing-packages

De wizard voor het importeren van pakketten kan worden geopend via het hoofdmenu Tools > Advanced > Import package van de Adobe Campaign-clientconsole.

U kunt een pakket importeren uit een eerdere exportbewerking, bijvoorbeeld uit een andere Adobe Campaign-instantie of uit een ingebouwd pakket, afhankelijk van de voorwaarden van uw licentie.

Een pakket uit een bestand installeren installing-a-package-from-a-file

Als u een bestaand gegevenspakket wilt importeren, selecteert u het XML-bestand en klikt u op Open.

De inhoud van het te importeren pakket wordt vervolgens in het middelste gedeelte van de editor weergegeven.

Klikken Next en Start om het importeren te starten.

Een ingebouwd pakket installeren installing-a-standard-package

Standaardpakketten zijn ingebouwde pakketten die worden geïnstalleerd wanneer de Adobe Campaign wordt geconfigureerd. Afhankelijk van uw toestemmingen en uw plaatsingsmodel, kunt u nieuwe standaardpakketten invoeren als u nieuwe opties of toe:voegen-ons verwerft, of als u aan een nieuwe aanbieding bevordert.

Raadpleeg de licentieovereenkomst om te controleren welke pakketten u kunt installeren.

Raadpleeg voor meer informatie over ingebouwde pakketten deze pagina.

Aanbevolen werkwijzen voor gegevenspakketten data-package-best-practices

In deze sectie wordt beschreven hoe u gegevenspakketten op consistente wijze kunt ordenen gedurende de levensduur van het project.

Pakketten kunnen verschillende configuraties en elementen bevatten, al dan niet gefilterd. Als u sommige elementen mist of geen elementen/pakketten in de correcte orde invoert, kan de platformconfiguratie breken.

Bovendien kan de map met pakketspecificaties snel complex worden, aangezien meerdere mensen met veel verschillende functies aan hetzelfde platform werken.

Hoewel dit niet verplicht is, biedt deze sectie een oplossing om pakketten in Adobe Campaign te helpen organiseren en gebruiken voor grootschalige projecten.

De belangrijkste beperkingen zijn:

Aanbevelingen data-package-recommendations

Importeer altijd binnen dezelfde versie van het platform. U moet controleren dat u uw pakketten tussen twee instanties opstelt die de zelfde bouwstijl hebben. Dwing nooit de import en werk altijd eerst het platform bij (als de build anders is).

Let op het schema en de databasestructuur. De invoer van pakket met schema moet door schemageneratie worden gevolgd.

Oplossing data-package-solution

Pakkettypen package-types

Begin door verschillende typen pakketten te definiëren. Er worden slechts vier typen gebruikt:

Entiteiten

Als u uw configuratie op een nieuw geval moet opstellen, kunt u al uw entiteitpakketten invoeren.

Functies

Dit type pakket:

Campagnes

Dit pakket is niet verplicht. Het is soms nuttig om een specifiek type voor alle campagnes te creëren, zelfs als een campagne als eigenschap kan worden gezien.

Updates

Zodra gevormd, kan een eigenschap in een ander milieu worden uitgevoerd. Het pakket kan bijvoorbeeld worden geëxporteerd van een ontwikkelomgeving naar een testomgeving. Bij deze test wordt een defect aan het licht gebracht. In de eerste plaats moet het worden aangepast aan de ontwikkelomgeving. Vervolgens moet de pleister op het testplatform worden aangebracht.

De eerste oplossing zou zijn om de hele functie opnieuw te exporteren. Maar om elk risico te vermijden (het bijwerken van ongewenste elementen) is het veiliger om een pakket te hebben dat alleen de correctie bevat.

Daarom raden we u aan een updatepakket te maken dat slechts één eenheidstype van de functie bevat.

Een update kan niet alleen een oplossing zijn, maar ook een nieuw element van uw entiteit/functie/campagnemakket. Als u wilt voorkomen dat het hele pakket wordt geïmplementeerd, kunt u een updatepakket exporteren.

Naamconventies data-package-naming

Nu er typen zijn gedefinieerd, moeten we een naamgevingsconventie opgeven. Adobe Campaign staat het niet toe om subfolders voor pakketspecificaties tot stand te brengen, betekenend dat de aantallen de beste oplossing voor het blijven georganiseerd zijn. Nummervoorvoegselpakketnamen. U kunt de volgende conventie gebruiken:

Pakketten data-packages

Volgorde van pakketten voor entiteiten entity-packages-order

Om het importeren te vergemakkelijken, moeten eenheidspakketten worden geordend op het moment dat ze worden geïmporteerd. Bijvoorbeeld:

Pakket 200 package-200

Pakketnummer "200" mag niet worden gebruikt voor een specifieke campagne: dit nummer wordt gebruikt om iets bij te werken dat betrekking heeft op alle campagnes.

Pakket bijwerken update-package

Het laatste punt betreft de nummering van updatepakketten. Het is uw pakketnummer (entiteit, functie of campagne) met het voorvoegsel "5". Bijvoorbeeld:

Het updatepakket mag slechts één specifieke entiteit bevatten, zodat het gemakkelijk opnieuw kan worden gebruikt. Als u deze wilt splitsen, voegt u een nieuw nummer toe (begin vanaf 1). Er zijn geen specifieke bestelregels voor deze pakketten. Om beter te begrijpen, veronderstel dat wij een 101 eigenschap, een sociale toepassing hebben:

Pakketdocumentatie package-documentation

Wanneer u een pakket bijwerkt, moet u altijd een opmerking in het beschrijvingsveld plaatsen om eventuele wijzigingen en redenen (bijvoorbeeld "voeg een nieuw schema toe" of "repareer een fout") nader toe te lichten.

De opmerking moet u ook op de hoogte brengen. Meld uw opmerking over een updatepakket altijd aan het "bovenliggende item" (pakket zonder het voorvoegsel 5).