Xi3 Bip Data Source Migration Wizard en

Data Source Migration Wizard
Administrator's Guide
Data Source Migration Wizard Administrator's Guide

Copyright © 2007 Business Objects. All rights reserved. Business Objects owns the following
U.S. patents, which may cover products that are offered and licensed by Business
Objects: 5,555,403; 6,247,008; 6,289,352; 6,490,593; 6,578,027; 6,768,986;
6,772,409; 6,831,668; 6,882,998 and 7,139,766. Business Objects and the Business
Objects logo, BusinessObjects, Crystal Reports, Crystal Xcelsius, Crystal Decisions,
Intelligent Question, Desktop Intelligence, Crystal Enterprise, Crystal Analysis,
Web Intelligence, RapidMarts, and BusinessQuery are trademarks or registered
trademarks of Business Objects in the United States and/or other countries. All
other names mentioned herein may be trademarks of their respective owners.
Third-party Business Objects products in this release may contain redistributions of software
Contributors licensed from third-party contributors. Some of these individual components may
also be available under alternative licenses. A partial listing of third-party
contributors that have requested or permitted acknowledgments, as well as required
notices, can be found at: http://www.businessobjects.com/thirdparty
Contents
Chapter 1 Welcome to the Data Source Migration Wizard 7
About this guide...........................................................................................8
What is the Data Source Migration Wizard?..........................................8
Chapter 2 Architecture and Requirements 9

Overview....................................................................................................10
Component architecture............................................................................10
Source files...........................................................................................11
Reports...........................................................................................11
Data sources...................................................................................12
Source file requirements.................................................................12
Migration wizard...................................................................................12
Target files............................................................................................12
Reports...........................................................................................12
Data sources...................................................................................13
Target file requirements..................................................................13
Migration workflow.....................................................................................13
Chapter 3 Installation and Deployment Planning 15

Overview....................................................................................................16
Choosing the migration path......................................................................16
Migrate then move................................................................................16
Move then migrate................................................................................17
Deploying the migration wizard.................................................................17
For migrating the files first....................................................................18
On the target report location...........................................................18
Data Source Migration Wizard Administrator's Guide 3

Contents
On a computer within a network.....................................................18

On the BusinessObjects Enterprise server.....................................19
On the BusinessObjects Enterpriseserver and target report
location............................................................................................19
For moving the files first.......................................................................20
Installation procedures...............................................................................20
Chapter 4 Report and Data Source Migration 25

Overview....................................................................................................26
Migrating reports and data sources...........................................................26
Modifying the migration settings................................................................31
Migration options..................................................................................31
Copy all reports, including reports that are not based on queries,
dictionaries, or infoviews.................................................................31
Force report migration even when the infoview file is not found.....32
Force report migration even when the query does not have SQL
text..................................................................................................32
Keep saved data of dictionary/infoview reports..............................33
Locating your migrated files.......................................................................33
Migrated reports...................................................................................34
Migrated data sources..........................................................................35
Commands folder............................................................................35
Business Views folder.....................................................................35
Chapter 5 Post-Migration Practices 37

Overview....................................................................................................38
Checking the log file..................................................................................38
Testing the reports.....................................................................................38
Working with the migrated data sources....................................................39
Queries.................................................................................................39
Dictionaries and InfoViews...................................................................43
4 Data Source Migration Wizard Administrator's Guide

Contents
Publishing to BusinessObjects Enterprise.................................................44
Chapter 6 Troubleshooting 47
Understanding the log file..........................................................................48
INFO messages...................................................................................49
ERROR messages...............................................................................50
WARNING messages...........................................................................54
Appendix A Get More Help 57
Index 59

Contents

Welcome to the Data
Source Migration Wizard
1
1 Welcome to the Data Source Migration Wizard
About this guide
About this guide

This guide provides information about the administrative tasks that are
involved when you use the Data Source Migration Wizard. Procedures are
listed for common tasks, while conceptual information and technical details
are given for all advanced topics. A section is included at the end of this
guide for specific troubleshooting information.
What is the Data Source Migration Wizard?
The Data Source Migration Wizard allows you to migrate reports that are
based on Crystal queries, dictionaries, and InfoViews to a BusinessObjects
Enterprise deployment. By migrating your reports, you can take advantage
of the new features that are offered by BusinessObjects Enterprise while
maintaining the functionality of the reports and data sources from your Info
installation.

Architecture and
Requirements
2
2 Architecture and Requirements
Overview
This section provides information about the components that are involved
when you use the Data Source Migration Wizard to migrate your files. It lists
the requirements of each component, and then describes the interaction that
occurs between the components during the migration process.
Overview
The Data Source Migration Wizard allows you to migrate reports that are
based on Crystal queries, dictionaries, or InfoViews, to a BusinessObjects
Enterprise deployment.
You migrate two types of objects: reports and data sources. The wizard
converts the data source of each report into an object that is usable in
BusinessObjects Enterprise, and then resets the data source location of the
report to point to the new object. The result is that you are able to make use
of the new features of BusinessObjects Enterprise, while keeping the
functionality of the reports and data sources from your Info installation.
Component architecture
The process of migrating your reports and your report data sources to
BusinessObjects Enterprise involves three component groups: the source
files, the migration wizard, and the target files.

Architecture and Requirements
Component architecture 2
Source files
Source files are the reports and the report data sources that you want to
migrate to BusinessObjects Enterprise. They are objects that exist within
your current system and are used in your Info deployment.
Typically, each report has a corresponding data source object. When you
choose to migrate a report, you select its data source for migration as well.
The wizard migrates both files concurrently.
Reports
The reports are standard .rpt files that are based on Crystal queries,
dictionaries, or InfoViews. By default, the wizard migrates only those reports
that are based on these data sources; it bypasses any reports that are based
on other sources.

Component architecture
Data sources
Three types of data sources act as source files for the migration wizard:
queries, dictionaries, and InfoViews. The wizard converts these objects into
data source types that can be used in BusinessObjects Enterprise.
Source file requirements
To migrate your source files, you need access to the reports and data sources
that you want to migrate. Before you run the wizard, make sure that you have
the necessary rights to access the locations where all of these objects are
stored.
Migration wizard
Use the Data Source Migration Wizard to migrate your source files to
BusinessObjects Enterprise. Note that the wizard overwrite your files; it
creates copies of the original files, converts the copies, and saves the
migrated copies in a new location.
Target files
Target files exist only after the migration is complete.
Reports
The migrated reports are copies of the reports that you selected as source
files. They are essentially the same reports, but with one significant difference:
their data source locations are now set to the converted data source objects
in BusinessObjects Enterprise.

Architecture and Requirements
Migration workflow 2
Data sources
After the migration, the data sources that were included in your source files
are transformed into objects that are usable in BusinessObjects Enterprise.
Depending on the type of data source, the wizard creates one of two objects
in the BusinessObjects Enterprise Repository: Crystal queries are converted
into SQL Command objects, and dictionaries and InfoViews are converted
into Business Views.
Target file requirements
To create the target reports, you must have write permissions for the location
where you want to save the files. To create the target data source files, you
must have write permissions for the BusinessObjects Enterprise Repository
where the converted objects will be stored.
Migration workflow
You begin the migration by selecting the source files that you want to migrate.
These typically consist of pairings between a Crystal report and the query,
dictionary, or InfoView that acts as the report's data source.
After prompting you to specify the reports that you want to migrate, the wizard
analyzes each file and determines the type of data source that is associated
with each report. Depending on the type of data source, the migration wizard
creates one of two objects in the BusinessObjects Enterprise Repository:
Crystal queries become SQL Command objects, and dictionaries and
InfoViews are converted into Business Views.

Migration workflow
Note: New objects are created in the repository; that is, the wizard does not
overwrite the original data sources during the migration.
After the new data sources are created in the repository, the migration wizard
makes copies of the reports and saves them to a specified location. The
wizard then resets the data source locations of the report copies to point to
the corresponding data source objects in the BusinessObjects Enterprise
Repository.
For example, if you choose to migrate a report that is based on a query, the
migration wizard first creates an SQL Command object in the BusinessObjects
Enterprise Repository. Then, it makes a copy of the report and saves it in a
location that you specify. Afterwards, the wizard resets the data source
location of that report to point to the SQL Command object in the repository.

Installation and Deployment
Planning
3
3 Installation and Deployment Planning
Overview
This section describes the two paths that you can follow to migrate your files.
It offers deployment suggestions on how to optimize the migration process,
and then provides instructions for installing the migration wizard on your
system.
Overview
The Data Source Migration Wizard runs on any computer that has either
Crystal Reports or BusinessObjects Enterprise installed. This arrangement
allows a number of possible environments in which you can perform a
migration. (For example, you can run the wizard directly on the
BusinessObjects Enterprise server, or you can migrate your files from a
computer on your network.) However, each deployment has its advantages,
and an installation setup for one system may not necessarily facilitate the
most efficient migration for another.
Choosing the migration path

When you migrate your files, two migration paths are available:
• You can use the wizard to migrate your reports and data sources first,
and then publish the reports to BusinessObjects Enterprise.
• You can move your reports and data sources to BusinessObjects
Enterprise first, and then use the wizard to migrate the files.
Each migration path has a different application and set of advantages, which
are described in the sections below. From the information that is provided,
you can determine which path is most suited to your situation and your
migration needs.
Migrate then move
Use the Data Source Migration Wizard to migrate your files moving the reports
to BusinessObjects Enterprise if you want to do the following:
• Migrate and test only a subset of reports and data sources at a time.
• Change your security model or authentication provider.
• Move to a new folder structure in BusinessObjects Enterprise.

Installation and Deployment Planning
Deploying the migration wizard 3
• Add previously unmanaged reports.
If you choose this migration path, you may install the migration wizard on
any computer that has Crystal Reports or BusinessObjects Enterprise
installed locally. For information about the possible deployments to use in
this migration path, see For migrating the files first on page 18.
Move then migrate
Use the Data Source Migration Wizard to migrate your files moving the reports
and data sources to BusinessObjects Enterprise if you want to do the
following:
• Include report instances in the migration.
• Retain the folder settings and/or custom settings that were set on the
reports from your Info system.
If you choose this migration path, you must install the migration wizard on
the BusinessObjects Enterprise server. As well, you must use the Import
Wizard to move your reports and data sources to BusinessObjects Enterprise
before you begin the migration.
For more information about this deployment, see For moving the files first
on page 20. For information about using the Import Wizard, see "Importing
with the Import Wizard" in the BusinessObjects Enterprise Administrator's
Guide.
Deploying the migration wizard

After you determine which migration path to follow, you must install the
migration wizard. You may install the Data Source Migration Wizard on any
computer that has either Crystal Reports or BusinessObjects Enterprise
installed locally; depending on the migration path that you choose, a number
of deployments may be available for you to use.

Deploying the migration wizard
For migrating the files first
This section outlines the four deployments that you can use if you choose
to migrate your files before publishing the reports to BusinessObjects
Enterprise.
On the target report location
You can install and run the migration wizard on the computer where you plan
to save the migrated reports. This deployment has these advantages:
• The migration is fast, because the reports are processed and stored on
the same computer that performs the migration.
• The transfer of substantial amounts of data less demanding on your
system (when compared to migrating your files through a separate
computer in a network.)
For the migration to work, the target report location must have Crystal Reports
installed and have access to the BusinessObjects Enterprise server where
you want to save the migrated data sources.
On a computer within a network
You can also install the migration wizard on a separate computer that has
access to both the Crystal Enterprise server and your target report location.
This deployment offers a different set of benefits:
• Because the files are processed on a separate computer, resources on
the Crystal Enterprise server and the target report location are not used.
• The migration can be done on any computer, provided it has Crystal
Reports installed.
Among the four deployments, this arrangement is the most flexible; however,
it has a disadvantage. Because the files need to be transferred through a
network, the migration may be slow, and it can substantially increase the
traffic in your system.

Deploying the migration wizard 3
On the BusinessObjects Enterprise server
You can also install and run the migration wizard on the BusinessObjects
Enterprise server having to import your files first.
Because the BusinessObjects Enterprise repository is the target location of

the migrated data sources, installing and running the migration wizard on
the BusinessObjects Enterprise server provides a number of benefits:
• The migration is fast because the data sources are converted and stored
on the same computer that is performing the migration.
• The transfer of substantial amounts of data has less impact on your system
(when compared to migrating your files through a separate computer
within a network).
However, the migration wizard makes use of local memory. As a result, any
other BusinessObjects Enterprise processes that are running may slow down
during the migration.
On the BusinessObjects Enterpriseserver and target report

location
Installing the migration wizard on the BusinessObjects Enterprise server and

specifying the server to be the location where the target reports are saved
is the optimal way to deploy this migration path. This setup offers the following
benefits:
• The migration is faster because both the reports and data sources are
processed and stored on the same system that performs the migration.
• The transfer of substantial amounts of data has little impact on your overall
system (when compared to other deployments).
This deployment requires you to have full access to the BusinessObjects

Enterprise server.

Installation procedures
For moving the files first
Because you need to install and run the migration wizard on the
BusinessObjects Enterprise server, the deployment for this migration path
has all of the advantages that are described in On the BusinessObjects
Enterprise server on page 19 and On the BusinessObjects Enterpriseserver
and target report location on page 19. As a result, in terms of migration speed
and efficiency, moving your reports and data sources to BusinessObjects
Enterprise before migrating them offers the best deployment. However,
because the files are processed on the BusinessObjects Enterprise server,
other server processes may slow down during the migration.
The Data Source Migration Wizard is distributed as a standard .zip file. Extract
all of the contents of the file before you begin the installation.
Note: The migration wizard needs to be installed on a computer that has

the following programs installed:
• Crystal Reports or BusinessObjects Enterprise.
• The Java 2 Platform, Standard Edition (J2SE) version 1.4.2.
You may download the platform from the Sun Microsystems developer's
web site:
http://java.sun.com/j2se/1.4.2/download.html
To install the Data Source Migration Wizard

1. Double click setup.exe to launch the install application.
2. On the "Welcome" dialog box, click Next.
The "Installation" dialog box appears.

Installation procedures 3
This dialog box displays the path to the directory where the migration
wizard will be installed. You cannot modify this location; the Data Source
Migration Wizard needs to be installed within the specified directory.
3. Click Next.
The "Ready to Install the Application" dialog box appears.

This dialog box confirms that the program is ready to be installed on your
computer.
4. Click Install.
The program installs the Data Source Migration Wizard on your computer.

Installation procedures 3
5. Click Finish.
Note: If you are installing the migration wizard for the first time, you may
be prompted to restart your computer before the new settings take effect.
The Data Source Migration Wizard is now successfully installed on your

computer. To launch the migration wizard, on your desktop, click Start >
Programs > BusinessObjects Enterprise XI Release 2 > BusinessObjects
Enterprise > Data Source Migration Wizard.


Report and Data Source
Migration
4
4 Report and Data Source Migration
Overview
This section lists step-by-step instructions for migrating your reports and
data sources through the Data Source Migration Wizard. It gives information
about how to modify the migration settings, and then describes how to locate
the migrated files.
Overview
By migrating your reports and data sources, you can take advantage of the
new features and extended functionality offered by BusinessObjects
Enterprise. As an integrated suite for reporting, analysis, and information
delivery, BusinessObjects Enterprise provides a solution for increasing
end-user productivity while reducing administrative costs.
Migrating reports and data sources

Before you migrate your files, you must make sure that you have fulfilled all
of the requirements for the components that are involved in the migration.
For more information about the migration components and their requirements,
see Architecture and Requirements on page 9.
Note: If you want to migrate query files that were created with the native
driver for DB2, you have the latest version of the DB2 Unicode driver installed
on your system. If you attempt to migrate the files without the driver installed,
the migration will fail.
To obtain the driver, visit the Business Objects Download Center:
http://www.businessobjects.com/products/downloadcenter/
Note: For additional information about special cases and particular issues
that are involved when using the Data Source Migration Wizard, see the
Release Notes, which are included in your product distribution.
To migrate your reports and your report data sources

1. Launch the Data Source Migration Wizard.
2. On the "Welcome" dialog box, click Next.
The "Log on to BusinessObjects Enterprise" dialog box appears.

Report and Data Source Migration
Migrating reports and data sources 4
3. Log on to your BusinessObjects Enterprise system by providing the

following information:
• System: the name of the BusinessObjects Enterprise system where
you want your migrated data sources to appear.
• User Name: your user name.
• Password: your password.
• Authentication: your authentication type.
You need to have the appropriate rights to be able to migrate the data
source files to the repository of your BusinessObjects Enterprise system.
For more information about system rights, see the BusinessObjects
Enterprise Administrator's Guide.
4. Click Next.
The "Select a File" dialog box appears.

5. Choose the report files that you want to migrate:

a. Click Add Files to select individual reports.
b. Click Add Folder to select all of the reports that are contained within
a specific folder.
Tip:
• Use the CTRL key or SHIFT key to select multiple files within a folder.
• Select the Include Subfolders check box to include all of the reports
that are contained in any of the subfolders within the specified folder.
6. Click Next.
The "Specify the Target Location for the report files" dialog box appears.

Migrating reports and data sources 4
7. Click the ... button to specify the location where you want the report files
to appear after the migration.
Note: The location that you specify must be able to access your
BusinessObjects Enterprise system. Otherwise, the migration wizard will
be unable to reset the data source location of the reports to point to the
migrated data sources in BusinessObjects Enterprise.
Tip: Select any of the check boxes to modify your migration settings. For
more information about these options, see Modifying the migration settings
on page 31.
8. Click Next.
The "Specify the Target Location for the Business Views" dialog box
appears.

9. Select the location in the BusinessObjects Enterprise repository where

you want your migrated data sources to appear.
Tip: The Repository Explorer's toolbar provides buttons with tool tips.
Use these buttons to manage your folders and sort your items.
•
Change view settings
Click this button to open the View Settings dialog box, which allows
you to limit the type of repository items that are displayed in the
repository. You may also select options to sort multiple items by name
or by type.
•
Delete the item/folder
Click this button to remove the selected item or folder from the
repository. Note that the button is disabled when you select a repository
folder that contains objects.
•
Insert a new folder
Click this button to add a new folder to the repository.
10. Click Next.

Modifying the migration settings 4
The "Confirm migration" dialog box appears.
11. Check to make sure that you have selected all of the files that you want
to migrate, then click Next.
The "Migrating Objects" dialog box appears.
The Data Source Migration Wizard migrates your files.
12. Click Next.

The "Finish" dialog box appears.
13. Click Migrate Another to migrate more files, or click Finish to close the
wizard.
Tip: Select the "Show migration log" check box to view the log file of your
migration. This .txt file contains information that is useful for
troubleshooting potential errors in the migration process.
Modifying the migration settings

By default, the Data Source Migration Wizard migrates queries, dictionaries,
and InfoViews, and only those reports that are based on these data sources.
However, while migrating your files, the wizard offers a number of options
that allow you to customize the migration.
Migration options
These options are enabled by selecting the check boxes in the migration
wizard's "Specify the target location for the report files" dialog box. For more
information, see To migrate your reports and your report data sources on
page 26.
Copy all reports, including reports that are not based on queries,
dictionaries, or infoviews
By selecting this option, you enable the wizard to migrate other kinds of
Crystal reports. As a result, the migration wizard also saves copies of reports
that are not based on queries, dictionaries, or InfoViews to the new location.
However, because the data sources of these reports are not migrated, you

Modifying the migration settings
may need to reset their data source locations to point to different data sources
manually.
Examples of other Crystal report types include reports that are based on
direct database connections and reports that are based on Microsoft Excel
spreadsheets.
Force report migration even when the infoview file is not found
Select this option when you want to migrate an InfoView-based report that
does not have its corresponding InfoView available. The migration wizard
saves a copy of the report on the target location, and attempts to use the
cached version of the InfoView to create a Business View in the
BusinessObjects Enterprise Repository. Note, however, that even if the
wizard is successful in creating the Business View, all of the row restriction
formulas that were defined in the original InfoView are lost.
If this option is not selected, then reports with missing InfoView files are not
migrated.
Force report migration even when the query does not have SQL
text
This option allows you to migrate reports that are based on queries that do
not contain SQL text. (Queries that were created in Query Builder do not
contain SQL text.) If this option is selected, the migration wizard will create
an SQL Command object in the BusinessObjects Enterprise Repository
repository; however, like the original query, the Command will not contain
SQL text. A report that is based on this Command will still work, but because
the Command does not have SQL text, you will be unable to modify it in the
future.
To add the appropriate SQL text to the Command object, see Working with
the migrated data sources on page 39. For more information about SQL text,
see SQL text on page 32.
SQL text
Command objects typically consist of three parts: a data connection, a set
of parameters, and SQL text.

Locating your migrated files 4
SQL text refers to the written SQL instructions that are submitted to the
database server when you run a report that is based on a Command. The
purpose of the SQL text is to optimize the data processing that is pushed
down to the server by limiting the data set that the server returns.
Below is an example of SQL text that can be found in a typical Command

object:
SELECT
Customer.`Customer ID`,
Customer.`Customer Name`,
Customer.`Last Year's Sales`,
Customer.`Country`,
Orders.`Order Amount`,
Orders.`Customer ID`,
Orders.`Order Date`
FROM
Customer Customer INNER JOIN Orders Orders ON
Customer.`Customer ID` = Orders.`Customer ID`
WHERE
(Customer.`Country` = 'USA' OR
Customer.`Country` = 'Canada') AND
Customer.`Last Year's Sales` < 10000.
ORDER BY
Customer.`Country` ASC
When you migrate query files, the wizard attempts to create Command
objects with the same SQL text as the corresponding queries.
Keep saved data of dictionary/infoview reports
Some reports may contain saved information from dictionaries or InfoViews

that have been changed over time. If you want to migrate a report with its
associated dictionary or InfoView and keep the information that is in the
report, then you need to select this option. When you enable this feature,
the migration wizard attempts to preserve the information that is in the report.
As a result, when you view the migrated report, you will see the same
information that was in the report before the migration.
Locating your migrated files

When you run the Data Source Migration Wizard, you are prompted to specify
two locations: a location for the migrated reports and a location for the
migrated data sources.

Migrated reports
After the migration, you can find the migrated reports in the folder that you
selected in the "Specify the target location for the report files" dialog box.
Note: For more information, see To migrate your reports and your report
data sources on page 26.
In this folder, the migration wizard creates directory paths, which are identical
to the directory paths of the source reports, and saves the migrated reports
correspondingly.
For example, if you chose to migrate five reports from their original locations:
• c:\Source_Directory\Report1.prt
• c:\Source_Directory\Folder1\Report2.prt
• c:\Source_Directory\Folder2\Report3.prt
• c:\Source_Directory\Folder2\Folder_2A\Report4.prt
• c:\Source_Directory\Folder2\Folder_2A\Report5.prt
The migrated reports can be found in their new locations:

• c:\Target_Directory\Report1.prt
• c:\Target_Directory\Folder1\Report2.prt
• c:\Target_Directory\Folder2\Report3.prt
• c:\Target_Directory\Folder2\Folder_2A\Report4.prt
• c:\Target_Directory\Folder2\Folder_2A\Report5.prt

Locating your migrated files 4
Migrated data sources
After the migration, you can find the migrated data sources in the
BusinessObjects Enterprise Repository folder that you selected in the "Specify
the Target Location for the Business Views" dialog box.
Note: For more information, see To migrate your reports and your report
data sources on page 26.
In this folder, the migration wizard creates two subfolders: Commands and
Business Views.
Commands folder
The Commands folder contains the SQL Command objects that were created
from the original Crystal query files. Within this folder, the migration wizard
creates directory paths, which are identical to the directory paths of the
original query files, and saves the Command objects correspondingly.
Note: The filename of the migrated data source object in the repository is
the of the original data source from which it was converted.
Business Views folder
The Business Views folder contains the Business Views that were created
from the original dictionary/InfoView files. In this folder, the migration wizard
creates directory paths which are identical to the directory paths of the original
dictionary/InfoView files, and saves the Business Views correspondingly.
Note:
• The filename of the migrated data source object in the repository is the
of the original data source from which it was converted.
• The migration wizard also creates a separate folder called Connections,
which contains the data connections that are used by all of the Business
Views.


Post-Migration Practices
5
5 Post-Migration Practices
Overview
This section describes the tasks that administrators must do after they have
finished migrating their files. It gives instructions for checking the migration
log and for verifying the functionality of the migrated reports. The section
also details some considerations about the migrated data sources, and briefly
discusses report publication to BusinessObjects Enterprise.
Overview
After the migration, you can find the migrated files in their new locations: the
reports are in the target folder that you specified, and the data sources are
in their respective folders within the BusinessObjects Enterprise Repository.
As the administrator, you need to perform a few tasks to ensure that the
migration was successful.
Checking the log file

After migrating your reports and data sources, the wizard generates a log
file, which contains information about the migration. You must check this file
to determine whether or not all of the source files were migrated successfully.
The wizard saves the log as a .txt file in the root of the folder that you specified
for your target reports.
For more information about using the log file to troubleshoot your migration,
see Troubleshooting on page 47.
Testing the reports

As a best practice, you should also test the migrated reports. By testing the
functionality of a few reports, you can further verify the overall success of a
migration.
To test the functionality of your migrated reports

1. In Crystal Reports, open one of the migrated reports.
2. When the report is open, click Refresh.
Note: If you are prompted, log on to the data source.

Working with the migrated data sources 5
The report should display the most up-to-date information from the data
source in the BusinessObjects Enterprise Repository.
3. Save the report and publish it to BusinessObjects Enterprise.

Note:
• You can do this step only if you chose to migrate your files before
publishing the reports to BusinessObjects Enterprise. If you imported
the reports to BusinessObjects Enterprise and then performed the
migration, the reports are already published.
• For information about publishing reports to BusinessObjects Enterprise,
see Publishing to BusinessObjects Enterprise on page 44.
4. In BusinessObjects Enterprise, schedule the report.
If the migration of both the report and its associated data source was
successful, the scheduled report will run and display the correct information
when you view it.
Working with the migrated data sources

While the Data Source Migration Wizard is designed to facilitate the migration
of your files to BusinessObjects Enterprise, a few considerations need to be
made for the migrated data sources. Because their formats are converted
during the migration, you may be required to make adjustments to the objects
to match or even augment some of the capabilities that they had before the
migration.
Queries
The migration wizard creates SQL Command objects directly from the Crystal
queries that you selected. As a result, the Command objects will have
configurations that are identical to those of the original queries. (For example,
the objects will have the same parameter values, the same prompting text,
the same SQL text, and so on.)
If the original query does not contain SQL text (Queries that were created in
Query builder do not contain SQL text), then the resulting Command object
will also not have SQL text, and you will be unable to modify it in the future.
However, if you successfully migrated the report that was based on the query,

you can use Crystal Reports to find and add the appropriate SQL text to the
Command object.
Note: For more information about SQL text, see SQL text on page 32.
To fix migrated queries (SQL Command objects) that do not have

SQL text
1. Find the report that is based on the SQL Command object, and open it
in Crystal Reports.
2. On the Database menu, click Show SQL Query.
The "Connection Information" dialog box appears.
3. Type your User ID and your Password, and select the Database that
you want to access.
4. Click Finish to log on to your data source.

The "Show SQL Query" dialog box appears.
Note that the dialog box is empty.
5. Click OK.
The main window in Crystal Reports appears.
6. On the Database menu, click Database Expert.

The "Database Expert" dialog box appears.

7. In the Selected Tables area, right-click the query, and, from the shortcut
menu that appears, select View Command.
The "View Command" dialog box appears.
8. In the Enter SQL query in the box below area, select and copy the SQL
text.
9. Click OK.
You are returned to the "Database Expert" dialog box.
menu that appears, select Disconnect from Repository.
The "Connection Information" dialog box reappears.
11. Log on to the data source once again. When you click Finish, you return
to the "Database Expert" dialog box.
menu that appears, select Edit Command.

The "Modify Command" dialog box appears.
13. In the Enter SQL query in the box below area, paste the SQL text, and
click OK.
The SQL Command on which the report is based now contains SQL text.
Dictionaries and InfoViews
The Data Source Migration Wizard migrates the formulas and filters from
the original dictionaries/InfoViews to the new Business Views. However, the
wizard does not migrate the column-level security definitions that were set
in the original data sources. As a result, you may need to reset the security
definitions in each of the Business Views to ensure that they have the same
security capabilities as the data sources from which they were migrated.
To set column-level security on a migrated data source object
1. On your desktop, click Start > Programs > BusinessObjectsXI Release

2 > BusinessObjects Enterprise > Business View Manager.

Publishing to BusinessObjects Enterprise
Note: When you are prompted, log on to BusinessObjects Enterprise.
2. From the toolbar, click View > Repository Explorer.

The "Repository Explorer" window appears.
3. Find the object for which you want to set security and right-click the object.
On the shortcut menu that appears, click Edit Rights.
The "Edit Rights" dialog box appears.
4. Set your security rights.

For more information about setting rights for objects in the BusinessObjects
Enterprise Repository, see the Business Views Administrator's Guide, which
is included with your BusinessObjects Enterprise product distribution.

If you choose to migrate your files before you publish the reports, only the
data sources are effectively saved to the BusinessObjects Enterprise system.
To make use of the report-viewing and distribution capabilities of
BusinessObjects Enterprise, you need to publish your reports.
There are three ways to publish reports to BusinessObjects Enterprise. As

the administrator, you need to determine which method best suits your
situation and operating needs.
Use the Publishing Wizard when you:

• Have access to the locally installed application.
• Are adding multiple objects or an entire directory.
Use the Central Management Console (CMC) when you are:

• Publishing a single object.
• Taking care of other administrative tasks.
• Performing tasks remotely.
Save directly to your Enterprise folders when you are:

• Designing reports with Crystal Reports.
• Using the OLAP Intelligence Application Designer.

Publishing to BusinessObjects Enterprise 5
Note: BusinessObjects Enterprise supports reports that are created in
versions 6 through XI of Crystal Reports. However, once they are published
to BusinessObjects Enterprise, the reports are saved, processed, and
displayed in version XI format.
For more information about publishing objects to BusinessObjects Enterprise,
see the BusinessObjects Enterprise Administrator's Guide, which is included
with your BusinessObjects Enterprise product distribution.


Troubleshooting
6
6 Troubleshooting
Understanding the log file
This section provides information about issues that may occur during the
migration. In particular, it focuses on specific situations that may result in
failed migrations and gives tips for using the log file to resolve common
problems.

To determine whether or not your source files migrated successfully, you
must check the log file that is generated by the wizard after the migration.
The log file contains information that is useful for identifying any errors that
may have occurred in the course of the migration. It includes a list of every
report and data source that was processed by the wizard, and a record of
the actions that the wizard performed on each object.
The messages in the log file typically follow this structure:

[Message type] Message text
Depending on the type of file that is processed, multiple messages may

appear in the log file for each object.

Troubleshooting
Understanding the log file 6
The wizard saves the log as a standard .txt file in the root of the folder that
you specified for the target reports.
INFO messages
Log file messages that are preceded by the [INFO] tag indicate that the
migration wizard is able to process the files successfully. Depending on the
report file, the data source type, and the migration settings enabled, different
messages may appear in the log.
Message Explanation
This message states that the original

[INFO] " " converted to " "
report and its associated dictionary/In-
based on Crystal Dictionary/In
foView were successfully migrated to
foview " " now " "
their new locations.

[INFO] " " converted to " "
report and its associated Crystal query
based on Crystal Query " " now
were successfully migrated to their new
" "
locations.
This message states that the report

[INFO] " " already exists in was already migrated and can now be
the target location as " ". It found in its new location.
will not be re-migrated.
It will not be migrated again.
This message states that the report is

being processed by the migration wiz-
[INFO] Processing report " " ard.
()
If the report has a title, it will be shown
inside the parentheses.
This message states that the dictio-

[INFO] Migrating Crystal Dic
nary/InfoView file is being migrated by
tionary/Infoview " "
the wizard.
This message states that the Crystal

[INFO] Migrating Crystal Query
query file is being migrated by the wiz-
" "
ard.

6 Troubleshooting
Message Explanation
This message states that the cached

copy of the dictionary/InfoView is being
[INFO] Migrating cached Crys migrated.
tal Dictionary/Infoview " " (This occurs if the original dictionary/In-
foView file is missing, and the option
to migrate the cached copy is enabled.)
This message states that the cached

copy of the Crystal query is being mi-
[INFO] Migrating cached Crys grated.
tal Query " " (This occurs if the original query file is
missing, and the option to migrate the
cached copy is enabled.)
ERROR messages
Log file messages that are preceded by the [ERROR] tag indicate that the
migration wizard encountered a problem. When this happens, the wizard
does not stop the migration process; it logs the error, bypasses the file, and
continues to migrate the rest of your files. You must always check the log
file to troubleshoot any errors that may have occurred during the migration.
Message Explanation
This message states that the migration

wizard encountered a problem when it
[ERROR] Error when converting tried to create a data connection for the
connection " " Business View.
The connection in the original dictio-
nary/InfoView may contain an error.

Troubleshooting
Message Explanation

[ERROR] Error when converting tried to create a table in the Business
table " " View's data foundation.
The table in the original dictionary/In-
foView may contain an error.

tried to recreate the links between the
[ERROR] Error when converting tables in the Business View's data
table link " " foundation.
The table links in the original dictio-
nary/InfoView may contain errors.

[ERROR] Error when converting tried to recreate a formula in the Busi-
formula " ". The formula text ness View.
is replaced. The error is " "
The formula in the original dictionary/In-
foView may contain an error.

[ERROR] Error when converting tried to create a Business Element in
logical table "" the Business View.
The logical table in the original dictio-
nary/InfoView may contain an error.

tried to save the Business View in the
BusinessObjects Enterprise Reposito-
[ERROR] Error when saving ry.
Business View " "
The cause of the error may be in the
original dictionary/InfoView or in the
ry.

6 Troubleshooting
Message Explanation

[ERROR] Error when saving the tried to save the Business View's data
data foundation " " foundation.
The original dictionary/InfoView may
contain an error.

tried to create a folder in the Busines-
[ERROR] Unable to create sObjects Enterprise Repository for the
repository folder for " " Business View.
The cause of the error is likely in the
ry.

tried to repair a partially migrated dictio-
[ERROR] Unable to remove nary/InfoView.
repository folder for " " The repair process occurs if the dictio-
nary/InfoView is not successfully con-
verted to a Business View in a previous
migration.

tried to create formulas and filters in
the Business View to match the row
[ERROR] Error when converting restriction formulas in the original dictio-
row restriction " " nary/InfoView.
The row restriction formulas in the
original dictionary/InfoView may contain
errors.

Troubleshooting
Message Explanation

[ERROR] Unable to load dictio tried to open the dictionary/InfoView
nary/infoview " " data source.
The original dictionary/InfoView may
contain an error.

[ERROR] Cannot convert " " tried to migrate a report that is based
based on Crystal Dictionary/In on a dictionary/InfoView.
foview " "
The original report may contain an er-
ror.

[ERROR] Cannot convert " " tried to migrate a report that is based
based on Crystal Query " " on a Crystal query.
The original report may contain an er-
ror.

[ERROR] Error when retrieving tried to convert an SQL text string
string. handle to a standard string.
The original Crystal query may contain
an error.

tried to create the SQL Command in
[ERROR] Fail to create report the BusinessObjects Enterprise
command. Repository.
The cause of the error may be in the
original query or in the BusinessOb-
jects Enterprise Repository.

6 Troubleshooting
Message Explanation

tried to retrieve the SQL text from a
query.
[ERROR] Fail to get SQL query The original Crystal query may contain
from report. an error, or perhaps it did not contain
SQL text. For information on migrating
queries without SQL text, see Force
report migration even when the query
does not have SQL text on page 32.

tried to reset the data source location
[ERROR] Fail to set location of the migrated report to its correspond-
to migrated Business View or ing migrated data source.
Command.
This error occurs if the target report lo-
cation cannot access the BusinessOb-
jects Enterprise Repository.
WARNING messages
Log file messages that are preceded by the [WARNING] tag indicate that
the migration wizard encountered situations that require the administrator's
attention.
Explanation
This message states that the dictio-

[WARNING] This dictionary/in
nary/InfoView that is being migrated
foview file contains formula
contains formula fields with links. The
field links. These links are
migration wizard does not create these
not migrated to the generated
links in the Business View, so you may
Business View. Please recreate
have to recreate them manually after
them if necessary.
the migration.

Troubleshooting
Explanation
This message states that the text in the

formula is no longer be valid. This oc-
curs if the logical fields names in the
[WARNING] The formula " " is
dictionary/InfoView are not the same
broken in the converted data
as the physical field names. During the
foundation. The formula text
migration, the wizard replaces the in-
is replaced.
valid text with a dummy value, and
comments out the original text in the
formula.

[WARNING] Report Command may query may have contained date-time
contain date-time field that strings that are mistakenly recognized
may be interpreted as a string by the migrated report as string fields
field in the report. Please in the new SQL Command object. To
verify if the report is work solve this inconsistency, you must open
ing. the report in Crystal Reports and verify
the report's database.
This message states that the query

does not contain any SQL text. As a
result, both the query and any reports
that are based on the query will not be
[WARNING] Query file " " not migrated.
migrated because it does not
contain SQL text. This occurs when you try to migrate a
query that does not contain SQL text,
and the "Force report migration even
when the query does not have SQL
text" option is not enabled.
[WARNING] The row restrictions This message states any row restric-
defined in the original Crys tions that were defined in the InfoView
tal Infoview are not applied are not present in the Business View.
to any user. Please re-apply The administrator must review the
the corresponding Data Founda Business View's Data Foundation filters
tion filters if necessary. to re-apply the appropriate restrictions.

6 Troubleshooting
Explanation
This message warns that the query that

is being migrated does not contain any
SQL text. As a result, both the report
[WARNING] The Crystal Query
and the query will be migrated, but if
does not contain any SQL text.
you try to edit the resulting SQL com-
The migrated report command
mand object, you will not see any SQL
will not have any SQL text but
text. For information about manually
the reports will still run.
adding SQL text to a Command, see
on page 39.

Get More Help
A
A Get More Help
Additional developer resources

http://diamond.businessobjects.com
Online customer support

The Business Objects Customer Support web site contains information about
Customer Support programs and services. It also has links to a wide range
of technical information including knowledgebase articles, downloads, and
support forums.
http://www.businessobjects.com/support/
Looking for the best deployment solution for your company?

Business Objects consultants can accompany you from the initial analysis
stage to the delivery of your deployment project. Expertise is available in
relational and multidimensional databases, in connectivities, database design
tools, customized embedding technology, and more.
For more information, contact your local sales office, or contact us at:
http://www.businessobjects.com/services/consulting/
Looking for training options?

From traditional classroom learning to targeted e-learning seminars, we can
offer a training package to suit your learning needs and preferred learning
style. Find more information on the Business Objects Education web site:
http://www.businessobjects.com/services/training
Send us your feedback

Do you have a suggestion on how we can improve our documentation? Is
there something you particularly like or have found useful? Drop us a line,
and we will do our best to ensure that your suggestion is included in the next
release of our documentation:
documentation@businessobjects.com
Note: If your issue concerns a Business Objects product and not the
documentation, please contact our Customer Support experts. For information
about Customer Support visit: http://www.businessobjects.com/support/.

Index
A data sources (continued)
source files 12
architecture, components 10 target files 13
date-time strings 44
definitions, security 43
B deployment 17
Business Element 44 on a computer within a network 18
Business Views 13 on the Crystal Enterprise server 19
Business Views folder 35 on the target report location 18, 19
dialog box 20
Confirm migration 26
C Connection Information 40
Database Expert 40
CMC 44 Edit Rights 43
column-level security 43 Finish 26
Command 13 Installation 20
object 13 Log on to Crystal Enterprise 26
without SQL text 39 Migrating Objects 26
Commands folder 35 Modify Command 40
component architecture 10 Ready to Install the Application 20
Crystal Analysis 44 Select a File 26
Crystal Data Source Migration Wizard 8 Show SQL Query 40
Crystal Enterprise Specify the Target Location for the Business
publishing 44 Views 26
repository 13 Specify the Target Location for the report files
server 19 26
solution 26 View Command 40
Crystal Management Console 44 Welcome 20, 26
Crystal Publishing Wizard 44 dictionary 8
cached copy 44
D object 8
data connection 44
data foundation 44
E
data sources 8 ERROR messages 50
migrated 35

Index
errors 50 log file (continued)

understanding the 48
F
M
files 10
locating 33 messages 48
log 38 ERROR 50
source 11 INFO 49
target 12 log file 48
folder 33 WARNING 54
Business Views 35 migrated data sources 35
Commands 35 location 35
target 26 working with 39
formula 44 migrated reports 34
migration 26
data sources 26
I options 31
Info 8 other Crystal report types 31
INFO messages 49 reports 26
InfoView 8 requirements 10
cached copy 32, 44 saved data 33
missing 32 settings, modifying the 31
object 8 when the infoview file is not found 32
installation 16 when the query does not have SQL text 32
procedures 20 wizard 8, 12
workflow 13
missing InfoViews 32
L
links 44 P
formula fields 44
table 44 post-migration practices 38
location 10 publishing 44
access 12
data source, resetting the 10 Q
migrated files 33
target report 18 query 8
write permissions 13 cached copy 44
log file 38 object 8
checking the 38 without SQL text 39
messages
structure 48

Index
R security, column-level 43
source files 11
reports 8 definition 11
format 44 requirements 12
migrated 34 SQL Commands 13
other kinds 31 strings, date-time 44
publishing 44
source files 11
target files 12
T
testing 38 table 44
title 44 target files 12
version 44 definition 12
requirements 10 requirements 13
migration 10 testing reports 38
source files 12 troubleshooting 48
target files 13
W
S
WARNING messages 54
saved data 33 wizard, migration 8, 12
security definitions 43 workflow, migration 13

Index

Xi3 Bip Data Source Migration Wizard en

Încărcat de

Informații document

Descriere originală:

Titlu original

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Xi3 Bip Data Source Migration Wizard en

Încărcat de

Drepturi de autor:

Formate disponibile

Data Source Migration Wizard

Data Source Migration Wizard Administrator's Guide

Chapter 2 Architecture and Requirements 9

Chapter 3 Installation and Deployment Planning 15

Data Source Migration Wizard Administrator's Guide 3

On a computer within a network.....................................................18

Chapter 4 Report and Data Source Migration 25

Chapter 5 Post-Migration Practices 37

4 Data Source Migration Wizard Administrator's Guide

Publishing to BusinessObjects Enterprise.................................................44

Appendix A Get More Help 57

Data Source Migration Wizard Administrator's Guide 5

6 Data Source Migration Wizard Administrator's Guide

About this guide

What is the Data Source Migration Wizard?

8 Data Source Migration Wizard Administrator's Guide

10 Data Source Migration Wizard Administrator's Guide

Data Source Migration Wizard Administrator's Guide 11

Source file requirements

Target files exist only after the migration is complete.

12 Data Source Migration Wizard Administrator's Guide

Target file requirements

Data Source Migration Wizard Administrator's Guide 13

14 Data Source Migration Wizard Administrator's Guide

Choosing the migration path

Migrate then move

16 Data Source Migration Wizard Administrator's Guide

Move then migrate

Deploying the migration wizard

Data Source Migration Wizard Administrator's Guide 17

For migrating the files first

On the target report location

On a computer within a network

18 Data Source Migration Wizard Administrator's Guide

On the BusinessObjects Enterprise server

Because the BusinessObjects Enterprise repository is the target location of

On the BusinessObjects Enterpriseserver and target report

Installing the migration wizard on the BusinessObjects Enterprise server and

This deployment requires you to have full access to the BusinessObjects

Data Source Migration Wizard Administrator's Guide 19

For moving the files first

Note: The migration wizard needs to be installed on a computer that has

To install the Data Source Migration Wizard

20 Data Source Migration Wizard Administrator's Guide

Data Source Migration Wizard Administrator's Guide 21

22 Data Source Migration Wizard Administrator's Guide

The Data Source Migration Wizard is now successfully installed on your

Data Source Migration Wizard Administrator's Guide 23

24 Data Source Migration Wizard Administrator's Guide

Migrating reports and data sources

To migrate your reports and your report data sources

26 Data Source Migration Wizard Administrator's Guide

3. Log on to your BusinessObjects Enterprise system by providing the

Data Source Migration Wizard Administrator's Guide 27

5. Choose the report files that you want to migrate:

28 Data Source Migration Wizard Administrator's Guide

Data Source Migration Wizard Administrator's Guide 29

9. Select the location in the BusinessObjects Enterprise repository where

10. Click Next.

30 Data Source Migration Wizard Administrator's Guide

The Data Source Migration Wizard migrates your files.

12. Click Next.