Sandbox-tools
u wordt vereist om de volgende twee op rol-gebaseerde toegangsbeheertoestemmingen te hebben om de zandbaktooling eigenschap te gebruiken:
-
manage-sandbox
of view-sandbox
-
manage-package
Verbeter de configuratienauwkeurigheid over sandboxen en voer naadloos sandboxconfiguraties tussen sandboxen in met de functie voor het bewerken van sandboxen. Gebruik de gereedheid van de sandbox om de tijd die nodig is voor het implementatieproces te verkorten en geslaagde configuraties over de sandboxen te verplaatsen.
U kunt de functie voor gereedschappen in de sandbox gebruiken om verschillende objecten te selecteren en deze te exporteren naar een pakket. Een pakket kan uit één object of uit meerdere objecten bestaan. om het even welke voorwerpen die in een pakket inbegrepen zijn moeten van de zelfde zandbak zijn.
Objecten ondersteund voor gereedmaken van sandbox supported-objects
Met de functie voor het gereedmaken van de sandbox kunt u Adobe Real-Time Customer Data Platform - en Adobe Journey Optimizer -objecten exporteren naar een pakket.
Real-time Customer Data Platform-objecten real-time-cdp-objects
De onderstaande tabel bevat een lijst met Adobe Real-Time Customer Data Platform -objecten die momenteel worden ondersteund voor gereedschappen in sandboxen:
De volgende objecten worden geïmporteerd, maar hebben een concept- of een uitgeschakelde status:
Adobe Journey Optimizer-objecten abobe-journey-optimizer-objects
De onderstaande tabel bevat een lijst met Adobe Journey Optimizer -objecten die momenteel worden ondersteund voor het gebruik van sandboxgereedschappen en beperkingen:
De volgende objecten die tijdens de rit worden gebruikt, worden als afhankelijke objecten gekopieerd. Tijdens de importworkflow kunt u Create new of Use existing selecteren voor elke optie:
- Doelgroepen
- Schema's
- Aangepaste acties
- Gebeurtenissen
- Fragmenten
- Contentsjablonen
- Canvasdetails
- Custom actions: Wanneer het selecteren Use existing tijdens het de invoerproces wanneer het kopiëren van een reis aan een andere zandbak, de bestaande douaneacties u selecteert moet het zelfde zijn als de brondouaneactie. Als ze niet hetzelfde zijn, zal de nieuwe reis onoplosbare fouten bevatten.
- De gebeurtenissen en gebeurtenisdetails die in de reis worden gebruikt worden gekopieerd. Er wordt altijd een nieuwe versie gemaakt in de doelsandbox.
de actie van het updateprofiel die in de reis wordt gebruikt kan worden gekopieerd. Aangepaste acties kunnen onafhankelijk van elkaar aan een pakket worden toegevoegd. De details van de actie die tijdens de reis worden gebruikt, worden ook gekopieerd. Er wordt altijd een nieuwe versie gemaakt in de doelsandbox.
Aangepaste acties kunnen onafhankelijk van elkaar aan een pakket worden toegevoegd. Wanneer een aangepaste handeling aan een reis is toegewezen, kan deze niet meer worden bewerkt. Als u aangepaste handelingen wilt bijwerken, moet u:
- aangepaste handelingen verplaatsen voordat u een reis maakt
- updateconfiguraties (zoals aanvraagheaders, queryparameters en verificatie) voor aangepaste acties na migratie
- Reisobjecten migreren met de aangepaste handelingen die u tijdens de eerste stap hebt toegevoegd
De volgende objecten die in de campagne worden gebruikt, worden als afhankelijke objecten gekopieerd:
- Campagnes
- Doelgroepen
- Schema's
- Contentsjablonen
- Fragmenten
- Bericht/inhoud
- Kanaalconfiguratie
- Verenigde beslissingsobjecten
- Instellingen/varianten van experimenten
- Campagnes kunnen samen met alle punten worden gekopieerd met betrekking tot het profiel, het publiek, het schema, de gealigneerde berichten, en afhankelijke voorwerpen. Sommige items worden niet gekopieerd, zoals labels voor gegevensgebruik en taalinstellingen. Voor een volledige lijst van voorwerpen die niet kunnen worden gekopieerd, verwijs naar de exporterende voorwerpen aan een andere zandbakgids.
- Het systeem zal automatisch een bestaand kanaalconfiguratievoorwerp in de doelzandbak ontdekken en opnieuw gebruiken als een identieke configuratie bestaat. Als er geen overeenkomende configuratie wordt gevonden, wordt de kanaalconfiguratie overgeslagen tijdens het importeren en moeten gebruikers de kanaalinstellingen in de doelsandbox voor deze reis handmatig bijwerken.
- Gebruikers kunnen bestaande experimenten en doelgroepen in de doelsandbox opnieuw gebruiken als afhankelijke objecten van geselecteerde campagnes.
Oppervlakken (bijvoorbeeld voorinstellingen) worden niet overschreven. Het systeem selecteert automatisch de dichtstbijzijnde mogelijke overeenkomst op de bestemmingszandbak die op het berichttype en oppervlaknaam wordt gebaseerd. Als er geen oppervlakten op de doelzandbak worden gevonden, dan zal het oppervlakexemplaar ontbreken, veroorzakend het berichtexemplaar om te ontbreken omdat een bericht vereist een oppervlakte om voor opstelling beschikbaar te zijn. In dit geval moet ten minste één oppervlak worden gemaakt voor het rechterkanaal van het bericht, zodat de kopie kan werken.
Aangepaste identiteitstypen worden niet ondersteund als afhankelijke objecten wanneer u een reis exporteert.
Objecten exporteren naar een pakket export-objects
In dit voorbeeld wordt het exporteren van een schema en het toevoegen aan een pakket gedocumenteerd. U kunt het zelfde proces gebruiken om andere voorwerpen, bijvoorbeeld, datasets, reizen, en vele anderen uit te voeren.
Object toevoegen aan een nieuw pakket add-object-to-new-package
Selecteer Schemas in de linkernavigatie en selecteer vervolgens het tabblad Browse , waarin de beschikbare schema's worden vermeld. Selecteer vervolgens de ellips (...
) naast het geselecteerde schema en een vervolgkeuzelijst met besturingselementen. Selecteer Add to package in de vervolgkeuzelijst.
Selecteer de optie Create new package in het dialoogvenster Add to package . Geef een Name voor het pakket op en een optioneel Description en selecteer vervolgens Add .
U wordt teruggestuurd naar de Schemas -omgeving. U kunt nu extra objecten toevoegen aan het pakket dat u hebt gemaakt door de volgende stappen hieronder uit te voeren.
Een object toevoegen aan een bestaand pakket en publiceren add-object-to-existing-package
Als u een lijst met beschikbare schema's wilt weergeven, selecteert u Schemas in de linkernavigatie en selecteert u vervolgens de tab Browse . Selecteer vervolgens de ellips (...
) naast het geselecteerde schema om de besturingsopties in een vervolgkeuzemenu weer te geven. Selecteer Add to package in de vervolgkeuzelijst.
Het dialoogvenster Add to package wordt weergegeven. Selecteer de optie Existing package , selecteer vervolgens het vervolgkeuzemenu Package name en selecteer het vereiste pakket. Selecteer ten slotte Add om uw keuzes te bevestigen.
De lijst met objecten die aan het pakket zijn toegevoegd, wordt weergegeven. Selecteer Publish als u het pakket wilt publiceren en het beschikbaar wilt maken voor import in sandboxen.
Selecteer Publish om de publicatie van het pakket te bevestigen.
U keert terug naar het tabblad Packages in de Sandboxes -omgeving, waar u het nieuwe gepubliceerde pakket kunt zien.
Een pakket importeren naar een doelsandbox import-package-to-target-sandbox
Als u het pakket in een doelsandbox wilt importeren, navigeert u naar het tabblad Sandboxen Browse en selecteert u de plusoptie (+) naast de naam van de sandbox.
Selecteer in het vervolgkeuzemenu de Package name die u wilt importeren in de doelsandbox. Voeg een Job name toe die wordt gebruikt voor toekomstige controle. Standaard wordt het uniforme profiel uitgeschakeld wanneer de schema's van het pakket worden geïmporteerd. Wissel toe laat schema's voor profiel om dit toe te laten, dan selecteren Next.
De pagina Package object and dependencies bevat een lijst met alle elementen in dit pakket. Het systeem detecteert automatisch afhankelijke objecten die nodig zijn om geselecteerde bovenliggende objecten te kunnen importeren. Alle ontbrekende kenmerken worden boven aan de pagina weergegeven. Selecteer View details voor een meer gedetailleerde uitsplitsing.
Als u een bestaand object wilt gebruiken, selecteert u het potloodpictogram naast het afhankelijke object.
De opties voor het maken van nieuwe of het gebruik van bestaande bestanden worden weergegeven. Selecteer Use existing.
Het dialoogvenster Field group bevat een lijst met veldgroepen die beschikbaar zijn voor het object. Selecteer de gewenste veldgroepen en selecteer vervolgens Save .
U wordt teruggestuurd naar de pagina Package object and dependencies . Selecteer van hieruit Finish om het importeren van het pakket te voltooien.
Een volledige sandbox exporteren en importeren
U kunt alle ondersteunde objecttypen exporteren naar een volledig sandboxpakket en het pakket vervolgens in verschillende sandboxen importeren om objectconfiguraties te repliceren. Met deze functionaliteit kunt u bijvoorbeeld:
- Importeer een sandbox opnieuw om alle objectconfiguraties te reproduceren als u de sandbox opnieuw moet instellen
- Importeer het pakket in andere sandboxen en gebruik het als een blauwdruksandbox om het ontwikkelingsproces te versnellen.
Een volledige sandbox exporteren export-entire-sandbox
Als u een volledige sandbox wilt exporteren, navigeert u naar de tab Sandboxes Packages en selecteert u Create package .
Selecteer Entire sandbox voor Type of package in het dialoogvenster Create package . Geef een Package name op voor het nieuwe pakket en selecteer de Sandbox in het vervolgkeuzemenu. Selecteer ten slotte Create om uw gegevens te bevestigen.
Het pakket is gemaakt en selecteer Publish om het pakket te publiceren.
U keert terug naar het tabblad Packages in de Sandboxes -omgeving, waar u het nieuwe gepubliceerde pakket kunt zien.
Het volledige sandboxpakket importeren import-entire-sandbox-package
Als u het pakket in een doelsandbox wilt importeren, navigeert u naar het tabblad Sandboxes Browse en selecteert u de optie met het plusteken (+) naast de naam van de sandbox.
Selecteer de volledige sandbox met behulp van het vervolgkeuzemenu Package name . Voeg een Job name toe, die wordt gebruikt voor toekomstige controle en een optioneel Job description , en selecteer vervolgens Next .
U gaat naar de pagina Package object and dependencies waar u het aantal objecten en afhankelijkheden kunt zien die zijn geïmporteerd en uitgesloten. Selecteer van hieruit Import om het importeren van het pakket te voltooien.
Zorg ervoor dat de importbewerking enige tijd duurt. De tijd die nodig is om te voltooien, is afhankelijk van het aantal objecten in het pakket. U kunt de importtaak controleren vanaf het tabblad Sandboxes Jobs .
Importdetails controleren view-import-details
Als u de geïmporteerde details wilt weergeven, navigeert u naar het tabblad Sandboxes Jobs en selecteert u het pakket in de lijst. U kunt ook de zoekbalk gebruiken om naar het pakket te zoeken.
Selecteer View import summary in het rechterdetailvenster op het tabblad Jobs in de Sandboxomgeving.
In het dialoogvenster Import summary wordt een percentage weergegeven van de importbewerkingen.
Wanneer het importeren is voltooid, ontvangt u een melding in de gebruikersinterface van Experience Platform. U kunt deze meldingen openen via het waarschuwingspictogram. U kunt hier naar probleemoplossing navigeren als een taak mislukt.
Updates van iteratieve objectconfiguraties overbrengen naar andere sandboxen via sandboxgereedschappen move-configs
U kunt sandboxgereedschappen gebruiken om objectconfiguraties tussen verschillende sandboxen over te brengen. Eerder moesten configuratieupdates voor uw objecten (zoals schema's, veldgroepen en gegevenstypen) handmatig opnieuw worden gemaakt of geïmporteerd om te kunnen worden overgebracht naar andere sandboxen. Met deze functie kunt u sandboxgereedschappen gebruiken om uw workflows te versnellen en potentiële fouten te beperken door uw configuratie-updates naadloos over te brengen naar verschillende sandboxen.
- De juiste machtigingen voor toegang tot gereedschappen in sandboxen.
- Een nieuw gemaakt of bijgewerkt object (zoals een schema) in uw bronsandbox.
Ondersteunde objecttypen voor updatebewerking
Hieronder vindt u ondersteunde objecttypen voor bijwerken:
- Schema's
- Veldgroepen
- Datatypen
- Nieuwe velden/veldgroepen toevoegen aan de bron.
- Een vereist veld optioneel maken.
- Nieuwe vereiste velden introduceren.
- Inleiding tot een nieuw relatieveld.
- Introductie van een nieuw identiteitsveld.
- De weergavenaam en beschrijving van de bron wijzigen.
- Eerder gedefinieerde velden verwijderen.
- Bestaande velden opnieuw definiëren wanneer het schema is ingeschakeld voor Real-Time Klantprofiel.
- Eerder ondersteunde veldwaarden verwijderen of beperken.
- Bestaande velden naar een andere locatie in de schemastructuur verplaatsen - hierdoor wordt een nieuw veld in de doelsandbox gemaakt, maar het vorige veld wordt niet verwijderd.
- Het in- of uitschakelen van het schema om deel te nemen aan Profiel - deze bewerking wordt overgeslagen bij een diff-vergelijking.
- Toegangsbeheerlabels.
Volg de onderstaande stappen om te leren hoe u sandboxgereedschappen kunt gebruiken om objectconfiguraties over verschillende sandboxen te verplaatsen.
Eerder geïmporteerde objecten
Voer de volgende stappen uit als uw gebruiksscenario bestaande objecten in uw bronsandbox betreft waarvoor configuratieupdates nodig zijn, nadat deze al zijn verpakt en geïmporteerd naar andere sandboxen.
Werk eerst het object in de bronsandbox bij. Navigeer bijvoorbeeld naar de werkruimte van Schemas , selecteer het schema en voeg een nieuwe veldgroep toe.
Nadat u het schema hebt bijgewerkt, navigeert u naar Sandboxes, selecteert u Packages en zoekt u het bestaande pakket.
Gebruik de interface van pakketten om uw veranderingen te verifiëren. Selecteer Check for updates om eventuele wijzigingen in de artefacten in het pakket weer te geven. Selecteer vervolgens View diff om een gedetailleerd overzicht te ontvangen van alle wijzigingen die zijn uitgevoerd op basis van uw artefacten.
De interface View diff wordt weergegeven. Zie deze tol voor informatie over uw bron en doelartefacten, evenals de veranderingen die op hen moeten worden toegepast.
Tijdens deze stap kunt u ook Summarize with AI selecteren voor een stapsgewijze samenvatting van alle wijzigingen.
Als u klaar bent, selecteert u Update package en vervolgens Confirm in het pop-upvenster dat wordt weergegeven. Nadat de taak is voltooid, kunt u de pagina vernieuwen en View history selecteren om de versie van het pakket te verifiëren.
Als u uw wijzigingen wilt importeren, navigeert u terug naar de map Packages en selecteert u de ovalen (...
) naast het pakket en selecteert u vervolgens Import package . Experience Platform selecteert automatisch Update existing objects . Controleer de wijzigingen en selecteer vervolgens Finish .
Navigeer naar de doelsandbox en bekijk het bijgewerkte object handmatig vanuit die sandbox om het importproces verder te valideren.
Handmatig in doelsandbox gemaakte objecten
Voer de volgende stappen uit als uw gebruiksscenario configuratiewijzigingen toepast op objecten die handmatig in afzonderlijke sandboxen zijn gemaakt.
Maak en publiceer eerst een nieuw pakket met het bijgewerkte object.
Importeer vervolgens het pakket naar de doelsandbox met de objecten die u ook wilt bijwerken. Selecteer tijdens het importproces Update existing objects en gebruik vervolgens de objectnavigator om handmatig de doelobjecten te selecteren waarop de updates moeten worden toegepast.
- Het is optioneel om een doeltoewijzing in een andere sandbox te selecteren voor afhankelijke objecten. Als er geen is geselecteerd, wordt er een nieuwe gemaakt.
- Voor naamruimte voor identiteit detecteert het systeem automatisch of een nieuwe identiteit moet worden gemaakt als een bestaande identiteit opnieuw moet worden gebruikt in de doelsandbox.
Selecteer Finish als u de doelobjecten hebt geïdentificeerd die u wilt bijwerken.
Videotutorial
De volgende video is bedoeld ter ondersteuning van uw begrip van gereedschappen voor sandboxen en beschrijft hoe u een nieuw pakket kunt maken, een pakket kunt publiceren en importeren.
Volgende stappen
In dit document wordt getoond hoe u de functie voor het gereedmaken van de sandbox in de gebruikersinterface van Experience Platform kunt gebruiken. Voor informatie over zandbakken, zie de gids van de zandbakgebruiker.
Voor stappen bij het uitvoeren van verschillende verrichtingen die Sandbox API gebruiken, zie de gids van de zandbakontwikkelaar. Voor een overzicht op hoog niveau van zandbakken in Experience Platform, verwijs naar de overzichtsdocumentatie.