Importing BMC Remedyforce configuration data from another Salesforce organization
You can import data from one Salesforce organization to another. The Salesforce organization can be a sandbox or a production organization. For example, say that you added some real configuration data to a sandbox while testing BMC Remedyforce. You can import this data to your production organization by using Pentaho packages.
The following topics are provided:
Overview of Pentaho packages
Pentaho packages, provided on the BMC Communities website, enable you to import the following data:
- Categories
- Templates
- Request definitions
- Service Level Agreements (SLAs)
- QuickViews
Basic configurations that include status, impact, urgency, priority
Note
If you have different default status in your Salesforce organization and migrated organization, after migration, the default status of the migrated organization is retained. If you do not want the default status of the migrated organization, perform one of the following actions:
- Before migrating the data, remove the mapping of the BMCServiceDesk__defaultStatus__c field.
- After migrating the data, open the default status of the migrated organization (Remedyforce Administration > Configure Application > Status) and clear the Default Status check box.
The following table lists folders included in the zip file on the BMC Communities website, the KJB file available in each folder, and the objects that are imported during data import.
Folder name | KJB file name | Objects imported |
---|---|---|
Category | CategoryMigrationJob |
|
Template | TemplateModuleMigration |
|
Service Request Definition | ServiceRequestMigration |
|
SLA | SLAMigration |
|
QuickView | QuickViewMigration |
|
BMC recommends that you import individual KJB files in a specified order. Another KJB file, CombinedJobs.kjb (not listed in the preceding table), is provided to import data in the correct order for all possible configurations. This file is at the same level as the folders. For information about the order in which to import KJB files, see To import data from another Salesforce organization.
Before you begin
Before importing data, perform the following actions:
Action | Description |
---|---|
Configure the object-level differences | In the destination organization, configure the object-level differences of the source organization fields. For example, in the source organization, you have added a custom field to the |
Tag the records of the objects that you want to import | You must select the Tag for Export check box. For example, say that you created 20 new categories in your sandbox (the source organization). To import these categories to your production organization (the destination organization), tag them to be imported by using the Tag for Export check box. If you tag records of an object for importing, data of the related objects is also imported. For example, if you have marked Service Level Agreements (SLAs) for importing, data of the related objects, such as Service Target, SLA Milestone, and so on, is also imported. The Tag for Export check box is not available on the UI. To tag a record for export:
|
Add or import linked data that is required in the destination organization | Before you import data, ensure that all the required linked data is present in the destination organization. For example, before importing request definitions, ensure that the services and service offerings are present in the destination organization. |
Mark related records for importing | To import related records, ensure that you mark the related records for importing; otherwise, they are not imported. For example, if you have marked an agreement for importing, but did not similarly mark related agreements, the related agreements are not imported. |
Import data of the custom objects | If you have used a custom object field in templates, import the data of the custom object by using Data Loader. |
Import data of the Base Elements and Base Relationships objects | Use the Data Loader to import the data of these objects. This data ensures that you have all the services and service offerings required to create request definitions. |
Register at the BMC Communities website | For more information, see Prerequisites for importing data to BMC Remedyforce. |
Installing the JRE | For more information, see Prerequisites for importing data to BMC Remedyforce. |
Download the Pentaho Data Integration tool. | For more information, see Prerequisites for importing data to BMC Remedyforce. |
To import data from another Salesforce organization
Before importing data from another Salesforce organization, perform all of the actions in Before you begin.
Best practices
- Import data in the following order:
- Any custom status, urgency, priority, or impact, objects.
- Category
- Templates
- Request Definitions
- Service Level Agreements
- QuickViews
- If you need to reimport data, delete the imported data, and then import it again. If you do not delete the imported data before reimporting it, the next import job will fail.
- Download the Pentaho job files from the BMC Communities page: https://communities.bmc.com/docs/DOC-33778 .
- To launch the Pentaho Data Integration tool, in the \pdi-ce-5.0.1.A-stable\data-integration folder, double-click the Spoon.bat file.
Open the KJB file for the package that you want to import.
For example, to import categories, open the CategoryMigrationJob.kjb file from the Category folder.Note
In the Job properties window of the QuickViews KJB file (QuickViewMigration.kjb), do not change the API versions in the values of the SF_DESTINATION_ORG_APIURL and SF_SOURCE_ORG_APIURL parameters. The package does not work for other API versions.
- In the KJB file, select Edit > Settings.
In the Job Properties window, enter the username and password for the source and destination Salesforce organizations.
Note
If your source or destination Salesforce organization is a sandbox, in the API URL of the Salesforce organization, replace www with test. For example, in the https://www.salesforce.com/services/Soap/u/25.0 URL, replace www with test. The updated URL is https://test.salesforce.com/services/Soap/u/25.0.
Click .
The following XLS files are created in the folder where you have unzipped the Pentaho packages downloaded from the BMC Communities website:
- <Object name>Collision: Lists the records that already exist in the destination Salesforce organization.
- <Object name>Success: Lists the records that were successfully imported.
- <Object name>Error: Lists the records that were not imported successfully.
Note
If you had mapped templates to profiles, the mapping is not imported. After importing data to the new Salesforce organization, you must map the templates and profiles again.
When you run the Pentaho package again, already imported records are not imported (even if the imported records are updated in the source organization). However, if you update the Name field of an already imported record, the record is imported again when you run the Pentaho package.
Comments
Log in or register to comment.