Werken met gegevenspakketten data-packages

Aan de slag met pakketten gs-data-packages

Met gegevenspakketten kunt u aangepaste instellingen en gegevens van uw platform exporteren en importeren. Een pakket kan verschillende typen configuraties en componenten bevatten, al dan niet gefilterd.

In de gegevenspakketten van de Campagne, worden de entiteiten van het gegevensbestand van Adobe Campaign getoond in de dossiers van XML. In een pakket wordt elke entiteit vertegenwoordigd met al haar gegevens.

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

Typen pakketten types-of-packages

U kunt in Adobe Campaign met drie typen pakketten werken: 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, zoals in het onderstaande voorbeeld:

<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 worden de folder en company koppelingen zijn vervangen door zogenaamde "toetsen op hoog niveau" in de doeltabellen:

<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 gebouwd. U moet ervoor zorgen dat de structuur van het XML-document voldoet aan de xtk:navtree gegevensschema. De clientconsole heeft een export- en importmodule voor gegevenspakketten.

Pakketten exporteren export-packages

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 export-a-set-of-objects-in-a-package

Ga als volgt te werk om een set objecten in een gegevenspakket te exporteren:

Afhankelijkheden beheren manage-dependencies

Tijdens het exportproces worden de koppelingen tussen de verschillende geëxporteerde elementen bijgehouden. Dit mechanisme wordt gedefinieerd door twee regels:

Een campagne exporteren export-a-campaign

Hieronder ziet u hoe u een campagne kunt exporteren. De uit te voeren marketingcampagne bevat:

De taak en de workflow worden in hetzelfde pakket als de campagne geëxporteerd, aangezien de overeenkomende schema's via koppelingen met een own typedonaliteit.

De inhoud van het pakket is:

<?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 and @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 manage-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.

Een pakketdefinitie maken create-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 add-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.

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 configure-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 export-packages-from-a-package-definition

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

Pakketten importeren import-packages

De importassistent voor het pakket is toegankelijk via het hoofdmenu Tools > Advanced > Import package van de clientconsole.

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

Voer de volgende stappen uit om een bestaand gegevenspakket te importeren:

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 install-a-standard-package

Ingebouwde pakketten (ook bekend als (standaardpakketten) worden geïnstalleerd wanneer de Adobe Campaign wordt geconfigureerd. Afhankelijk van uw machtigingen, uw implementatiemodel en uw productaanbod kunt u nieuwe standaardpakketten importeren.

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

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.

Versies

U moet altijd importeren 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. Het invoeren van een pakket met schema moet door schemageneratie worden gevolgd.

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 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 bijvoorbeeld de volgende conventie gebruiken:

Volgorde van pakketten voor entiteiten entity-packages-order

Om de invoer te helpen, zouden de entiteitpakketten door bevolen moeten worden aangezien zij zouden moeten worden ingevoerd.

Bijvoorbeeld:

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.

U kunt het beste ook de datum van de update invoeren.