Importing and exporting content packages
To export a content package
On a dedicated or shared tailoring system, create a deployable export or content package that gets downloaded as a ZIP file. The ZIP file is named in the <developer ID>.<application name>-<application version>-content.zip> format. For example, com.example.ticketingservice-1.0.0-content.zip. If an application's export or content package was created earlier, BMC Helix Innovation Suite overwrites the earlier export or package with the latest package.
To move data from your tailoring environment to your production or QA environment, create the content packages for following data:
After you create a content package, you can import it to the target system, where you want to move this data.
To create a content package for a line of business
If you are setting up a line of business for the first time, you must create a content package for a line of business. To create a content package for a line of business, perform the following steps:
- Log in BMC Helix Innovation Suite as an administrator.
- In Workspace, click Business Workflows.
- Click Actions and select Create Content Package.
- In the Create Content Package window, on the Select Definitions tab, do not select any definition, and click Next.
- On the Add Data tab, select Line of Business, and click Click to build an expression.
- On the Edit Expression page, enter an expression to specify the Line of Business ID, such as ID = AGGADGG8ECDC0.
- On the Package tab, click Create Package.
After you create the content package, you can import it to the target system, where you want to move this data. To import the content package, see.
To create a content package for the out-of-the-box data
After you move the content package for a line of business to your production or QA environment, you must move the content package for out-of-the-box data such as notification templates and acknowledgement templates for the line of business. To create a content package for the out-of-the-box data, perform the following steps:
- Log in BMC Helix Innovation Suite as an administrator.
- In Workspace, click Business Workflows.
- Click Actions and select Create Content Package.
- In the Create Content Package window, on the Select Definitions tab, do not select any definition, and click Next.
- On the Add Data tab, select Email Acknowledgement Templates and Notification Templates.
- In the Duplicates column, for Email Acknowledgement Templates and Notification Templates, select the Merge option.
- Click Click to build an expression, on the Edit Expression page, enter the following expression:
'450000420' = "<Name of the Line of business>"
For example, 450000420 = "Facilities" - To export to-do task templates with questionnaires, export the service actions from BMC Helix Digital Workplace Catalog.
- On the Package tab, click Create Package.
After you create the content package, you can import it to the target system, where you want to move this data. To import the content package, see.
After importing the to-do task templates and service actions, deactivate and then activate the service actions from the BMC Helix Digital Workplace Catalog console to sync the questionnaire details with the to-do templates.
To create a content package for custom data
After you move the content package for out-of-the-box data to your production or QA environment, you must move the content package for custom data such as templates, Flowsets, documents, processes, and rules for the line of business. To create a content package for custom data, perform the following steps:
Log in BMC Helix Innovation Suite as an administrator.
- In Workspace, click Business Workflows.
- Click Actions and select Create Content Package.
In the Create Content Package window on the tabs displayed, perform the actions described in the following table:
Tab Name
Action
Notes
Select Definitions
Select the customized definitions you created for BMC Helix Innovation Suite, for example, documents (dynamic fields), processes, and so on.
This tab lists all the customized definitions you have created for BMC Helix Innovation Suite.
Add Data
Select the data you want to export and click Next.
- Do not remove any predefined qualifications. To add additional qualifications, add brackets to the current qualification, and use the AND operator to specify the qualifications.
- You can create content packages only for specific BMC Helix Innovation Suite data, if required.
- When exporting knowledge articles, you must select the knowledge article and the knowledge sets for which the articles have been created. To search for a particular ID, you must use the Article ID Internal field and not the Content ID field.
- When exporting service targets that use notification templates for milestones, you must also export those notification templates.
To filter the data to be exported, click Click to build a global data filter expression to enter selection criteria. For example, if you only want to export case templates defined for the Facilities line of business, enter the following expression: $450000420$ = <Domain ID of the Facilities line of business>
Ignore Rules—Do not select this option.
When importing data, the utility checks for duplicate records. Selecting this option bypasses all validations during data import.
Duplicates—Select one of these actions for duplicate data
- Ignore—Does not import the record if it exists in the system.
- Create New—Creates a new record with a different GUID even if the record exists in the system.
- Overwrite—Overwrites the existing record only if the fields Created Date and Owner are updated in the new record.
- Merge—Update the delta part on the existing record Field exists and is populated - overwrite will replace the value and merge will append the data to the existing data.
To avoid errors, the recommended option is Merge.
Include configuration data in the package — Do not select this option.
Order Data
Do not change the order displayed.
For BMC Helix Business Workflows, the order is predefined to the order in which the records need to be imported without errors.
Approval Configuration
Select the group for which you want to export the approval configurations.
You have to export all approval flows created for a group and cannot select individual approval configurations.
- Assignment Configuration
- Select Definitions To Delete
- Options
Skip these steps when exporting data for BMC Helix Business Workflows.
These fields are not applicable for BMC Helix Business Workflowsexport.
For details about these fields, see
.
Package
Review the data items included and excluded and click Create Package.
Download
To download the content package, click Download.
After you create the content package, you can import it to the target system, where you want to move this data.
- To import the content package, see
.
To export a content use case
As an administrator, you can export an out-of-the-box content use case or a custom content use case from one environment to another. You can export one content use case at a time.
- Log in to BMC Helix Business Workflows as an administrator.
- Click Settings
.
- Select Content Use Cases Management > Content Use Cases.
- Select a content use case from the list of use cases.
- Click Export.
- Save the file that is generated.
You can now import the content use case to your target environment.
Where to go from here
After you move data from your tailoring environment to your production or QA environment, you must update the outgoing email profile for your line of business. Learn more about email profiles in Configuring-email-profiles.
If you want to copy the out-of-the-box content use cases from one line of business to another, see Creating-and-reusing-out-of-the-box-content-use-cases-for-lines-of-business.