Administrators can define packages to exchange resources between different Adobe Campaign instances through structured XML files. These can be configuration parameters or data.
This may be useful for transferring data from one server to another or for replicating the configuration of an instance.
Packages are available under the
Package importsmenus. The two menus function similarly.
The elements of each list are displayed by default according to their modification or installation date, from the most recent to the least recent.
Administrationare two built-in packages, each containing a predefined list of resources to be exported. They can be opened in read-only mode and they are only suitable for exporting.
Exporting packages is not authorized if the resources exported have default IDs. Therefore, the IDs of exportable resources must be changed by using a name that is different from the templates provided as standard by Adobe Campaign Standard. For example, to export test profiles, an ID containing the value "SDM" or "sdm" must not be used. When trying to export packages containing default IDs, you can see errors such as: "The 'Brands (branding)' entity type uses a default ID ('BRD1') that may cause a conflict when importing the package. Change this name and repeat the operation."
The package export steps are described in the Exporting a package section.
- ThePlatformpackage regroups all the resources added during technical configuration: custom resources, custom resource sets, triggers, and application options with theSystemtype.
- TheAdministrationpackage regroups all the objects added during business configuration such as: campaign templates, content templates, delivery templates, landing page templates, program templates and workflow templates.It also includes the following objects: content blocks, target mappings, external accounts, organizational units, application options with theUsertype, roles, typologies, typology rules and users.
Creating a package
You need to create a package if you need to export specific sets of data.
To create a package, you need the administration rights.
- FromAdministration>Deployment>Package exports, click theCreatebutton in the list of package contents.The element is created immediately. To cancel creating it, go back to the list and check the corresponding box to delete it.
- In the package content screen, specify a name and an ID.
- Click theEdit propertiesbutton if you would like to add a description and restrict access to certain users.
- Use theCreate elementbutton in theExport contenttab to select the resources you wish to export.
- Resources are shown in alphabetical order and can be filtered by name. Their technical name is displayed in brackets. Select an element from the list and confirm.
- The resource name is displayed in theExport contenttab. To modify a resource, check the corresponding box and use theShow detail of the element selectedbutton.
- Using the query editor allows you to filter the elements to be exported. For more on this, refer to the Editing queries section.You can export up to 5000 objects per resource.
- Once you have specified all the resources to be exported, save your selection.
Your package is now created and is ready to be exported.
Exporting a package
Exporting a package allows you to save a specific state of a resource that you will be able to reimport on another instance or later on the same instance.
Exporting packages is not authorized if the resources exported have out-of-the-box IDs. Therefore, the IDs of exportable resources must be changed by using a name that is different from the templates provided as standard by Adobe Campaign Standard. For example, to export test profiles, an ID containing the value "SDM" or "sdm" must not be used.
- FromAdministration>Deployment>Package exports, select a package to access its detail.
- Check that the package contains the data you need.
- Click theStart exportbutton.
The exported file is stored in the download folder of the browser in use. It is automatically named "package_xxx.xml", whereby "xxx" corresponds to the package ID.
When the operation has finished, several sections appear:
- Export status: this section shows whether the operation has been carried out correctly.
- You can consult the different steps of the export via theLogtab. This contains the statuses of all the former exports.
When selecting an element from the package content list that has already been exported, the
Last exporttabs are still available.
The package import list above anything contains the automatic imports linked to updates performed by Adobe.
Execution logstab stores all of the import steps. A side panel displays the general information.
These elements are accessible in read-only mode.
Importing a package
An administrator can manually import a package originating from an export executed earlier from an Adobe Campaign instance. For more on this, refer to the Package exports section.
The manual package import consists of two steps: first, you have to upload a file, then you can import its content.
- FromAdministration>Deployment>Package imports, click theCreatebutton in the package import list.The element is created immediately. To cancel creating it, go back to the list and check the corresponding box to delete it.
- Specify a name and an ID for the new import.
- Select the file you wish to upload by dragging and dropping it, or by clicking theSelect from folderlink.Imported files must be either XML or ZIP (containing an XML file) format.To replace the uploaded document, start by deleting the file via the X icon to the right of its name, then repeat the operation.
- Once the file is uploaded, import its content into the database by using theStart importbutton.
When the operation has finished, several sections appear:
- Import status: this section shows whether the operation has been carried out correctly.
- You can consult the different steps of the import via theExecution logstab. This is particularly important to view errors.
Once a package has been imported, you cannot re-import it from the same element. You can only modify its label and ID.
To re-import the same package, you have to go back to the package import list, create an element, and then upload the selected file again.