[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 uitvoeren en het in een ander systeem van Adobe Campaign integreren. Leer hoe te om een verenigbare reeks gegevenspakketten in deze sectiete handhaven.

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 document van XML dat met de grammatica van xrk voldoet: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 element <package> . Alle <entities> -elementen die volgen, verdelen de gegevens op documenttype.

Een <entities> element bevat de gegevens van het pakket in het formaat van het gegevensschema ingegaan in het schema attribuut.

De gegevens in een pakket moeten geen interne sleutels bevatten die niet compatibel tussen bases, zoals auto-geproduceerde sleutels (automatische 1} optie) zijn.

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>

Het attribuut operation 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 exportassistent voor pakketten is toegankelijk via het Tools > Advanced > Export package… -menu van de Adobe Campaign-clientconsole.

Voor de drie types van pakketten, biedt de medewerker de volgende stappen aan:

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="AAAA-MM-DD HH:MM:SS.954Z"/>
 <entities schema="nms:operation">
  <operation duration="432000" end="AAAA-MM-DD" internalName="OP1" label="MyCampaign"
  modelName="opEmpty" start="AAAA-MM-DD">
   <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="2023-01-17 10:07:51.000Z" label="MyTask" name="TSK2" start="2023-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 aan een type van pakket wordt bepaald in een schema met @pkgAdmin en @pkgPlatform attributen. 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 laat het @pkgStatus attribuut u toe om de de uitvoerregels voor deze elementen of attributen te bepalen. 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 het menu Administration > Configuration > Package management > Package definitions .

Als u een pakketdefinitie wilt maken, klikt u op de knop New en vult u 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

Klik in het tabblad Content op de knop Add om de entiteiten te selecteren die u met het pakket wilt exporteren. De beste praktijken wanneer het selecteren van entiteiten worden voorgesteld in deze sectiesectie.

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 het tabblad pakketdefinitie Content . Klik hiertoe op de koppeling Generation parameters .

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 importassistent voor pakketten is toegankelijk via het hoofdmenu Tools > Advanced > Import package van de Adobe Campaign-clientconsole.

U kunt een pakket van de uitvoer invoeren vroeger, bijvoorbeeld van een andere instantie van Adobe Campaign, of a ingebouwd pakket, afhankelijk van de termijnen van uw vergunning wordt uitgevoerd.

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.

Klik op 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.

Voor meer informatie over ingebouwde pakketten, verwijs naar 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.

Eigenschappen

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 entiteitstype 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).