Importing and exporting content packages


To use the out-of-the-box content packages for your lines of business, as an administrator, you must first import the content packages to your tailoring environment. A case business analyst can customize the templates that are provided and create custom data specific to your business requirements. You can then export the content packages and custom data to your production environment.

The following table lists the tasks that are performed for content packages:

Step

Task

Role

Reference

1

Import content packages on tailoring environment.

Administrator

2

Customize templates and data.

Case business analyst

3

Export content packages and custom data to production environment.

Administrator

To import the out-of-the-box content packages for BMC Helix Business Workflows

Use the following instructions to import the BMC Helix Business Workflows specific content packages on your tailoring environment:

  1. As an administrator, log in to BMC Helix Innovation Studio.
  2. In Workspace, click Business Workflows.
  3. On the Business Workflows page, select Actions > Import Definitions and Data.
  4. Import the following content packages to create the lines of business:
    • BMC Sample HR: Calbro-LOB-HR_21.30.00.zip
    • BMC Sample Finance: Calbro-LOB-Finance_21.30.00.zip
    • BMC Sample Facilities: Calbro-LOB-Facilities_21.30.00.zip

      After importing a package, wait till the line of business is activated, and then import the next package.

  5. Log in to BMC Helix ITSM, and use the steps in Importing and exporting a package to import the Calbro-Config-Data_21.30.00.zip content package.
  6. In BMC Helix Innovation Studio, import the Foundation data for the lines of business by importing the D2P content package: Calbro-Foundation-Data_21.30.00.zip.
  7. To import the BMC Helix Digital Workplace Catalog services, log in to BMC Helix Digital Workplace Catalog, and complete the following steps:
    1. Make sure that the connector configuration is defined with the name Helix Platform.
    2. Import the CalbroServiceCatalog_21.30.00.zip content package.

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.

Important

Use the 7 Zip utility to extract the contents of the ZIP file. You cannot extract the contents of the import ZIP file using the Windows Zip utility or Mac archive utility.

To move data from your tailoring environment to your production or QA environment, create the content packages for following data:

  1. Content package for a line of business
  2. Content package for out-of-the-box data
  1. Content package for custom data

After you create a content package, you can import it to the target system, where you want to move this data.

Best practice
To move large amount of custom data, we recommend that you segregate your data as items such as Flowsets, look up items, case templates, knowledge sets, assignment mappings, and email rules. You then create a separate content package for each item and move them to the target system.

To create a content package for a line of business

If you 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:

  1. Log in BMC Helix Innovation Suite as an administrator.
  2. Navigate to the Workspace tab. 
  3. Select Business Workflows.
  4. Click Actions and select Create Content Package.
  5. In the Create Content Package window, on the Select Definitions tab, do not select any definition, and click Next.
  6. On the Add Data tab, select Line of Business, and click Click to build an expression.
  7. On the Edit Expression page, enter an expression to specify the Line of Business ID, such as ID = AGGADGG8ECDC0.
  8. 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 Deploying application tailoring changes.

To create a content package for 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:

  1. Log in BMC Helix Innovation Suite as an administrator.
  2. Navigate to the Workspace tab. 
  3. Select Business Workflows.
  4. Click Actions and select Create Content Package.
  5. In the Create Content Package window, on the Select Definitions tab, do not select any definition, and click Next.
  6. On the Add Data tab, select Email Acknowledgement Templates and Notification Templates.
  7. In the Duplicates column, for Email Acknowledgement Templates and Notification Templates, select the Merge option.
  1. 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"
  2. 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 Deploying application tailoring changes.

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:

  1. Log in BMC Helix Innovation Suite as an administrator. 

    Note

    If the export package contains any dynamic data that includes an attachment, the administrator must be assigned the Case Business Analyst functional role to so that the dynamic data definition can be successfully imported.

  2. Navigate to the Workspace tab. 
  3. Select Business Workflows.
  4. Click Actions and select Create Content Package.
  5. 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.

    1. 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.
    2. You can create content packages only for specific BMC Helix Innovation Suite data, if required.
    3. When exporting knowledge articles, you must select the knowledge article and the knowledge sets for which the articles have been created.
    4. 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

    1. Ignore—Does not import the record if it exists in the system.
    2. Create New—Creates a new record with a different GUID even if the record exists in the system.
    3. Overwrite—Overwrites the existing record only if the fields Created Date and Owner are updated in the new record. 
    4. 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.

    1. Assignment Configuration
    2. Select Definitions To Delete
    3. 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 Deploying application tailoring changes.

    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. 

  6. To import the content package, see Deploying application tailoring changes.

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 Reusing-out-of-the-box-content-use-cases-for-lines-of-business.

Related topic

Data-in-content-packages-for-lines-of-business

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*