Professional Documents
Culture Documents
The documentation may have changed since you downloaded the PDF. You can always find the latest information on SAP Help Portal.
Note
This PDF document contains the selected topic and its subtopics (max. 150) in the selected structure. Subtopics from other structures are not included.
2014 SAP SE or an SAP affiliate company. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose
without the express permission of SAP SE. The information contained herein may be changed without prior notice. Some software products marketed by SAP SE
and its distributors contain proprietary software components of other software vendors. National product specifications may vary. These materials are provided by
SAP SE and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be
liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express
warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty. SAP and other
SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE in Germany and other
countries. Please see www.sap.com/corporate-en/legal/copyright/index.epx#trademark for additional trademark information and notices.
Table of content
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 1 of 14
Table of content
1 DataSource
1.1 Functions for DataSources
1.2 DataSource Maintenance in BI
1.2.1 Editing DataSources from SAP Source Systems in BI
1.2.2 Creating DataSources for File Source Systems
1.2.3 Creating DataSources for UD Connect
1.2.4 Creating DataSources for DB Connect
1.2.5 Creating DataSources for Web Services
1.3 Emulation, Migration, and Restoring DataSources
1.3.1 Using Emulated 3.x DataSources
1.3.2 Migrating 3.x DataSources
1.3.3 Migrating 3.x DataSources (UD Connect, Web Service)
1.3.4 Restoring 3.x DataSources
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 2 of 14
1 DataSource
Definition
A DataSource is a set of fields that provide the data for a business unit for data transfer into BI. From a technical viewpoint, the DataSource is a set of logicallyrelated fields that are provided to transfer data into BI in a flat structure (the extraction structure), or in multiple flat structures (for hierarchies).
There are four types of DataSource:
DataSource for transaction data
DataSource for master data
DataSource for attributes
DataSource for texts
DataSource for hierarchies
Use
DataSources supply the metadata description of source data. They are used to extract data from a source system and to transfer the data to the BI system. They
are also used for direct access to the source data from the BI system.
The following image illustrates the role of the DataSource in the BI data flow:
The data can be loaded into the BI system from any source in the DataSource structure using an InfoPackage. You determine the target into which data from the
DataSource is to be updated during the transformation. You also assign DataSource fields to target object InfoObjects in BI.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 3 of 14
DataSource Type
BI:
Object Type of A or M Version
BI:
SAP Source System:
Object Type of Shadow Version Object Type of A Version
(Source System Independent)
DataSource
R3TR RSDS
R3TR SHDS
(Shadow object delivered in its
own table with release and
version)
R3TR OSOA
R3TR OSOD
3.x DataSource
R3TR ISFS
R3TR OSOD
Restriction
The new DataSource concept cannot be used for transferring data from external systems (metadata and data transfer using staging BAPIs), for transferring
hierarchies, or when using the IDoc transfer method.
Recommendation
We recommend that you adjust the data flow for the DataSource as well as the process design to the new concepts if you want to take advantage of these
concepts If you want to migrate an existing data flow, first use the emulation of DataSource 3.x to convert other objects in the data flow or to define new ones. You
can then migrate the 3.x DataSource to a DataSource and benefit from the new concepts in your scenario.
More information: Data Flow in the Data Warehouse and
Features
The following table provides an overview of the functions available in the Data Warehousing Workbench and DataSource repository for
DataSources and DataSources 3.x:
Function
Description
Create
More Information
Display
DataSource Maintenance in BI
Emulation, Migration and Restoring DataSources
Change
DataSource Maintenance in BI
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 4 of 14
You can use a DataSource as a template for creating a new DataSource. This function is not available if you want to
use an SAP source system as the target. For SAP source
systems, you can create DataSources in the source
system in generic DataSource maintenance (RS02).
Delete
Manage
Here you can select the requests that contain the data you
want to call in PSA maintenance.
For SAP source systems: Display DataSource in source
system
Replication of DataSources
Creating Transformations
DataSource Maintenance in BI
In DataSource maintenance in BI you can display DataSources and 3.x DataSources.
You can create or change DataSources for file source systems, UD Connect, DB Connect and Web services on this BI interface.
In DataSource maintenance, you can edit DataSources from SAP source systems. In particular, you can specify which fields you want to transfer into BI. In
addition, you can determine properties for extracting data from the DataSource and properties for the DataSource fields. You can also change these properties.
You call DataSource maintenance from the context menu of a DataSource ( Display , Change ) or, if you are in the Data Warehousing Workbench, from the
context menu of an application component in an object tree ( Create DataSource ). Alternatively you can call DataSource maintenance from the DataSource
repository. In the Data Warehousing Workbench toolbar, choose
Prerequisites
You have replicated the DataSource in BI.
Procedure
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 5 of 14
Result
When you activate the DataSource, BI generates a PSA table and a transfer program.
You can now create an InfoPackage. You define the selections for the data request in the InfoPackage. The data can be loaded into the entry layer of the BI
system, the PSA. Alternatively, you can access the data directly if the DataSource supports direct access and you have defined a VirtualProvider in the data flow.
Prerequisites
Note the following with regard to CSV files:
Fields that are not filled in a CSV file are filled with a blank space if they are character fields and with a zero (0) if they are numerical fields.
If separators are used inconsistently in a CSV file, the incorrect separator (which is not defined in the DataSource) is read as a character and both fields are
merged into one field and may be shortened. Subsequent fields are then no longer in the correct order.
A line break cannot be used as part of a value, even if the value if enclosed with an escape character.
Note the following with regard to CSV files and ASCII files:
The conversion routines that are used determine whether you have to specify leading zeros. More information: Conversion Routines in the BI-System.
For dates, you usually use the format YYYYMMDD, without internal separators. Depending on the conversion routine being used, you can also use other
formats.
Notes on Loading
When loading external data, you can load the data into BI from any workstation. For performance reasons however, you should store the data on an application
server and load it into BI from there. This means that you can also load the data in the background.
If you want to load a large amount of transaction data into BI from a flat file and you can specify the file type of the flat file, you should create the flat file as an ASCII
file. From a performance point of view, loading data from an ASCII file is the most cost-effective method. Loading from a CSV file takes longer because the
separator characters and escape characters then have to be sent and interpreted. In some circumstances, generating an ASCII file may involve more effort.
Procedure
You are in the DataSource tree in Data Warehousing Workbench.
1. Select the application component where you want to create the DataSource and choose Create DataSource .
2. On the next screen, enter a technical name for the DataSource, select the type of DataSource and choose Copy .
The DataSource maintenance screen appears.
3. Select the General tab.
a. Enter descriptions for the DataSource (short, medium, long).
b. If required, specify whether the DataSource is initial non-cumulative and might produce duplicate data records in one request.
c. Specify whether you want to generate the PSA for the DataSource in the character format. If the PSA is not typed it is not generated in a typed structure
but is generated with character-like fields of type CHAR only.
Use this option if conversion during loading causes problems, for example because there is no appropriate conversion routine, or if the source cannot
guarantee that data is loaded with the correct data type.
In this case, you can load data into the PSA and correct it there once you have activated the DataSource.
4. Go to the Extraction tab page.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 6 of 14
a.
b.
c.
d.
You chose the ; character as the data separator. Your file contains the value 12;45 for a field however. If you set as the escape character, the
value in the file must be 12;45 so that 12;45 is loaded into BI. The complete value that you want to transfer has to be enclosed by the escape
characters.
If the escape characters do not enclose the value but are used within the value, the system interprets the escape characters as a normal part of the
value. If you have specified as the escape character, the value 1245 is transferred as 1245 and 1245 is transferred as 1245.
In a text editor (for example, Notepad) check the data separator and the escape character currently being used in the file. These depend on the
country version of the file you are using.
Note that if you do not specify an escape character, the space character is interpreted as the escape character. We recommend using a different
character as the escape character.
If you select the Hex indicator, you can specify the data separator and the escape character in hexadecimal format. When you enter a character
for the data separator and the escape character, these are displayed as hexadecimal code after the entries have been checked. A two character
entry for a data separator or an escape sign is always interpreted as a hexadecimal entry.
g. Make the settings for the number format (thousand separator and character used to represent a decimal point), as required.
h. Make the settings for currency conversion, as required.
i. Make any further settings, as required by your selection.
5. Go to the Proposal tab page.
This tab page is only relevant for CSVfiles. For files in different formats, define the field list on the Fields tab page.
Here you create a proposal for the field list of the DataSource based on the sample data from your CSV file.
a. Specify the number of data records that you want to load and choose Upload Sample Data .
The data is displayed in the upper area of the tab page in the format of your file.
The system displays the proposal for the field list in the lower area of the tab page.
b. In the table of proposed fields, use Copy to Field List to select the fields you want to copy to the field list of the DataSource. All fields are selected by
default.
6. Go to the Fields tab page.
Here, you can edit the fields that you transferred to the field list of the DataSource from the Proposal tab. If you did not transfer the field list from a proposal,
you can define the fields of the DataSource here.
a. To define a field, choose Insert Row and specify a field name.
b. Under Transfer , specify the decision-relevant DataSource fields that you want to be available for extraction and transferred to BI.
c. Instead of generating a proposal for the field list, you can enter InfoObjects to define the fields of the DataSource. Under Template
InfoObject , specify
InfoObjects for the fields in BI. This allows you to transfer the technical properties of the InfoObjects to the DataSource field.
Entering InfoObjects here does not equate to assigning them to DataSource fields. Assignments are made in the transformation. When you define the
transformation, the system proposes the InfoObjects you entered here as InfoObjects that you might want to assign to a field.
d. Change the data type of the field if required.
e. Specify the key fields of the DataSource.
These fields are generated as a secondary index in the PSA. This is important in ensuring good performance for data transfer process selections, in
particular with semantic grouping.
f. Specify whether lowercase is supported.
g. Specify whether the source provides the data in the internal or external format.
h. If you choose the external format, ensure that the output length of the field (external length) is correct. Change the entries if required.
i. If required, specify a conversion routine that converts data from an external format to an internal format.
j. Select the fields that you want to be able to set selection criteria for when scheduling a data request using an InfoPackage. Data for this type of field is
transferred in accordance with the selection criteria specified in the InfoPackage.
k. Choose the selection options (such as EQ, BT) that you want to be available for selection in the InfoPackage.
l. Under Field Type , specify whether the data to be selected is language-dependent or time-dependent, as required.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 7 of 14
Result
The DataSource is created and is visible in the Data Warehousing Workbench in the DataSource overview for the file source system in the application
component. When the DataSource is activated, the system generates a PSA table and a transfer program.
You can now create an InfoPackage where you can define the selections for the data request. The data can be loaded into the BI systems entry layer, the PSA.
Alternatively, you can access the data directly if the DataSource supports direct access and you have defined a VirtualProvider in the data flow.
Prerequisites
You have connected a UD Connect source system.
Note the following background information:
Using InfoObjects with UD Connect
Data Types and Their Conversion
Using SAP Namespace for Generated Objects
Procedure
You are in the DataSource tree in the Data Warehousing Workbench.
1. Select the application components in which the DataSource is to be created and choose Create DataSource .
2. In the next screen, enter a technical name for the DataSource, select the type of the DataSource and choose Copy .
The DataSource maintenance screen appears.
3. Go to the General tab page.
a. Enter descriptions for the DataSource (short, medium, long).
b. If necessary, specify if the DataSource builds an initial non-cumulative and supplies potentially duplicate data records within a request.
4. Go to the Extraction tab page.
a. Define the delta method for the DataSource.
b. Specify whether you want the DataSource to support direct access to data.
c. UD Connect does not support real-time data acquisition.
d. The system displays Universal Data Connect (Binary Transfer) as the adapter for the DataSource.
Choose Properties if you want to display the general adapter properties.
e. Select the UD Connect source object.
The connection to the UD Connect source is established. All source objects that are available in the selected UD Connect source can be selected using
input help. Source objects can be multi-dimensional storage or relational objects.
5. Go to the Proposal tab page.
The system displays the elements of the source object (for JDBC for example fields, or for XMLA and ODBO characteristics and key figures) and creates a
mapping proposal for DataSource fields. The mapping proposal is based on the similarity of the names of the source object element and DataSource field
and the compatibility of the respective data types.
Note that source object elements can have a maximum of 90 characters. Both upper and lower case are supported.
a. Check the mapping and change the proposed mapping as required. Assign the non-assigned source object elements to free DataSource fields.
You cannot map elements to fields if the types are incompatible. The system produces an error message in this case.
b. Under Copy to Field List , select the fields that you want to transfer to the field list for the DataSource. All fields are selected by default.
6. Maintain the Fields tab page.
Here you edit the fields that you transferred to the field list of the DataSource from the Proposal tab page.
a. Under Transfer , specify the decision-relevant DataSource fields that should be available for extraction and transferred to BI.
b. If required, change the values for the key fields of the source.
These fields are generated as a secondary index in the PSA. This is important in ensuring good performance for data transfer process selections, in
particular with semantic grouping.
c. If required, change the data type for a field.
d. Specify whether the source provides the data in the internal or external format.
e. If you choose an External Format , ensure that the output length of the field (external length) is correct. Change the entries, as required.
f. If required, specify a conversion routine that converts data from an external format into an internal format.
g. Select the fields for which you want to be able to set selection criteria when you schedule a data request using an InfoPackage. Data for this type of field
is transferred in accordance with the selection criteria specified in the InfoPackage.
h. Choose the selection options (such as EQ, BT) that you want to be available for selection in the InfoPackage.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 8 of 14
i. Under Field Type , specify whether the data to be selected is language-dependent or time-dependent, as required.
If you did not transfer the field list from a proposal, you can define the fields of the DataSource directly. Choose Insert Row and enter a field name. You can
specify InfoObjects in order to define the DataSource fields. Under Template InfoObject , specify InfoObjects for the fields of the DataSource. This allows you
to transfer the technical properties of the InfoObjects into the DataSource field.
Entering InfoObjects here does not equate to assigning them to DataSource fields. Assignments are made in the transformation. When you define the
transformation, the system proposes the InfoObjects you entered here as InfoObjects that you might want to assign to a field.
7. Check, save and activate the DataSource.
8. Go to the Preview tab page.
If you select Read Preview Data , the number of data records you specified in your field selection is displayed in a preview.
This function allows you to check whether the data formats and data are correct.
Result
The DataSource is created and added to the DataSource overview for the UD Connect source system in the application component in the Data Warehousing
Workbench. When you activate the DataSource, the system generates a PSA table and a transfer program.
You can now create an InfoPackage. You define the selections for the data request in the InfoPackage. The data can be loaded into the entry layer of the BI
system, the PSA. Alternatively you can access the data directly if the DataSource allows direct access and you have a VirtualProvider in the definition of the data
flow.
Prerequisites
See Requirements for Database Tables or Views
You have connected a DB Connect source system.
Procedure
You are in the Data Warehousing Workbench in the DataSource tree.
1. Select the application components in which you want to create the DataSource and choose Create DataSource .
2. On the next screen, enter a technical name for the DataSource, select the type of DataSource and choose Copy .
The DataSource maintenance screen appears.
3. Go to the General tab page.
a. Enter descriptions for the DataSource (short, medium, long).
b. As required, specify whether the DataSource builds an initial non-cumulative and can return duplicate data records within a request.
4. Go to the Extraction tab page.
a. Define the delta process for the DataSource.
b. Specify whether you want the DataSource to support direct access to data.
c. The system displays Database Table as the adapter for the DataSource.
Choose Properties if you want to display the general adapter properties.
d. Select the source from which you want to transfer data.
Application data is assigned to a database user in the Database Management System (DBMS). You can specify a database user here. In this way
you can select a table or view that is in the schema of this database user. To perform an extraction, the database user used for the connection to BI
(also called BI user) needs read permission in the schema of the database user.
If you do not specify the database user, the tables and views of the BI user are offered for selection.
Call the value help for field Table/View .
In the next screen, select whether tables and/or views should be displayed for selection and enter the necessary data for the selection under
Table/View . Choose Execute .
The database connection is established and the database tables are read. The Select DB Object Names screen appears. The tables and views
belonging to the specified database user that correspond to your selections are displayed on this screen. The technical name, type and database
schema for a table or view are displayed.
Only use tables and views in the extraction whose technical names consist solely of upper case letters, numbers, and underscores (_). Problems
may arise if you use other characters.
Extraction and preview are only possible if the database user used in the connection (BI user) has read permission for the selected table or view.
Some of the tables and views belonging to a database user might not lie in the schema of the user. If the responsible database user for the selected
table or view does not match the schema, you cannot extract any data or call up a preview. In this case, make sure that the extraction is possible
by using a suitable view. For more information, see Database Users and Database Schemas.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 9 of 14
When you use data types, be aware of database-specific features. For more information, see Requirements for Database Tables and Views.
6. Choose Copy to Field List to select the fields that you want to transfer to the field list for the DataSource. All fields are selected by default.
7. Go to the Fields tab page.
Here you edit the fields that you transferred to the field list of the DataSource from the Proposal tab page.
a. Under Transfer , specify the decision-relevant DataSource fields that should be available for extraction and transferred to BI.
b. If required, change the values for the key fields of the source.
These fields are generated as a secondary index in the PSA. This is important in ensuring good performance for data transfer process selections, in
particular with semantic grouping.
c. Specify whether the source provides the data in the internal or external format.
d. If you choose an External Format , ensure that the output length of the field (external length) is correct. Change the entries, as required.
e. If required, specify a conversion routine that converts data from an external format into an internal format.
f. Select the fields for which you want to be able to set selection criteria when you schedule a data request using an InfoPackage. Data for this type of field
is transferred in accordance with the selection criteria specified in the InfoPackage.
g. Choose the selection options (such as EQ, BT) that you want to be available for selection in the InfoPackage.
h. Under Field Type , specify whether the data to be selected is language-dependent or time-dependent, as required.
8. Check the DataSource.
The field names are checked for upper and lower case letters, special characters, and field length. The system also checks whether an assignment to an
ABAP data type is available for the fields.
9. Save and activate the DataSource.
10. Go to the Preview tab page.
If you choose Read Preview Data , the specified number of data records, corresponding to your field selection, is displayed in a preview.
This function allows you to check whether the data formats and data are correct. If you can see in the preview that the data is incorrect, try to localize the error.
See also: Localizing Errors
Result
The DataSource is created and is visible in the Data Warehousing Workbench in the DataSource overview for the database source system under the application
component. When you activate the DataSource, the system generates a PSA table and a transfer program.
You can now create an InfoPackage. You define the selections for the data request in the InfoPackage. The data can be loaded into the entry layer of the BI
system, the PSA. Alternatively you can access the data directly if the DataSource supports direct access and you have a VirtualProvider in the definition of the
data flow.
Procedure
You are in the DataSource tree in the Data Warehousing Workbench.
1. Select the application components in which the DataSource is to be created and choose Create DataSource .
2. In the next screen, enter a technical name for the DataSource, select the type of the DataSource and choose Copy .
The DataSource maintenance screen appears.
3. Go to the General tab page.
a. Enter descriptions for the DataSource (short, medium, long).
b. If necessary, specify whether the DataSource may potentially deliver duplicate data records within a request.
4. Go to the Extraction tab page.
Define the delta method for the DataSource.
DataSources for Web services support real-time data acquisition. Direct access to data is not supported.
5. Go to the Fields tab page.
Here you determine the structure of the DataSource either by defining the fields and field properties directly, or by selecting an InfoObject as a Template
InfoObject and transferring its technical properties for the field in the DataSource. You can modify the properties that you have transferred from the InfoObject
further to suit your requirements by changing the entries in the field list.
Entering InfoObjects here does not equate to assigning them to DataSource fields. Assignments are made in the transformation. When you define the
transformation, the system proposes the InfoObjects you entered here as InfoObjects that you might want to assign to a field.
6. Save and activate the DataSource.
7. Go to the Extraction tab page.
The system has generated a function module and a Web service with the DataSource. They are displayed on the Extraction tab page. The Web service is
released for the SOAP runtime.
8. Copy the technical name of the Web service and choose Web Service Administration .
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 10 of 14
8. Copy the technical name of the Web service and choose Web Service Administration .
The administration screen for SOAP runtime appears. You can use the search function to find the Web service. The Web service is displayed in the tree of
the SOAP Application for RFC-Compliant FMs . Select the Web service and choose Web Service WSDL (Web Service Description Language) to
display the WSDL description.
Result
The DataSource is created and is visible in the Data Warehousing Workbench in the application component in the DataSource overview for the Web service
source system. When you activate the DataSource, the system generates a PSA table and a transfer program.
Before you can use a Web service to transfer data into BI for the DataSource, create a corresponding InfoPackage (push package). If an InfoPackage is already
available for the DataSource, you can test the Web service push in Web service administration.
See also:
Web Services
If you use an emulated DataSource 3.x, note that the InfoPackage does not use all of the settings defined in the 3.x data flow because in the new
data flow it only loads the data into the PSA. To prevent problems arising from misunderstandings about using the InfoPackage, we recommend
that you only use the emulation in development and test systems.
More Information:
Using Emulated 3.x DataSources
Migration
You can migrate a 3.x DataSource that transfers data into BI from an SAP source system or a file or uses DB Connect to transfer data into a DataSource. 3.x XML
DataSources and 3.x DataSources that use UD Connect to transfer data cannot be migrated directly. However, you can use the 3.x versions as a copy template
for a Web service or UD Connect DataSource.
You cannot migrate hierarchy DataSources, DataSources that use the IDoc transfer method, export DataSources (namespace 8* or /*/8*) or
DataSources from BAPI source systems.
Migration (SAP Source Systems, File, DB Connect)
If the 3.x DataSource already exists in a data flow based on the old concept, you use emulation first to model the data flow with transformations and data transfer
processes and then test it. During migration you can delete the data flow you were using before, along with the metadata objects.
If you are using real-time data acquisition or want to access data directly using the data transfer process, we recommend migration. Emulation does not support
this.
When you migrate a 3.x DataSource (R3TR ISFS) in an original system, the system generates a DataSource (R3TR RSDS) with a transport connection. The 3.x
DataSource is deleted, along with the 3.x metadata object mapping (R3TR ISMP) and transfer structure (R3TR ISTS), which are dependent on it. If a PSA and
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 11 of 14
InfoPackages (R3TR ISIP) already exist for the 3.x DataSource, they are transferred to the migrated DataSource, along with the requests that have already been
loaded. After migration, only the specifications about how data is loaded into the PSA are used in the InfoPackage.
You can export the 3.x objects, 3.x DataSource, mapping and transfer structure during the migration so that these objects can be restored. The collected and
serialized objects are stored in a local table (RSDSEXPORT).
You can now transport the migration into the target system.
When you import the transport into the target system in the after-import, the system migrates the 3.x DataSource (R3TR ISFS) (as long as it is available in the
target system) to a local DataSource (R3TR RSDS), without exporting the objects that are to be deleted. The 3.x DataSource, mapping (R3TR ISMP) and transfer
structure (R3TR ISTS) objects are deleted and the related InfoPackages are migrated. The data in the DataSource (R3TR RSDS) is transferred to the PSA.
More Information:
Migrating 3.x DataSources
Migrating by Copying
You cannot migrate in the way described above
If you are transferring data into BI using a Web service and have previously used XML DataSources that were created on the basis of a file DataSource.
If you are transferring data into BI using UD Connect and have previously used a UD Connect DataSource that was generated using an InfoSource.
3.x XML DataSource Web Service DataSource
You can make a copy of a generated 3.x XML DataSource in a source system of type Web Service . When you activate the DataSource, the system generates
a function module and a Web service. On your interface, these are different to the 3.x objects. The 3.x objects (3.x DataSource, mapping, transfer rules and
generated function module and Web service) are therefore obsolete and can be deleted manually.
3.x UD Connect DataSource UD Connect DataSource
For a 3.x UD Connect DataSource, you can make a copy in a source system of type UD Connect . The 3.x objects (3.x DataSources, mapping, transfer rules
and the generated function module) are obsolete after they have been copied and can be deleted manually.
More Information:
Migrating 3.x DataSources (UD Connect, Web Service)
Restoring
You can restore a DataSource 3.x from the DataSource (R3TR RSDS) for SAP source systems, files, and DB Connect. The 3.x metadata objects must also be
exported and archived with the migration of the DataSource 3.x into the original system for files and DB Connect. The system reproduces the 3.x DataSource
(R3TR ISFS), mapping (R3TR ISMP), and transfer structure (R3TR ISTS) objects with their pre-migration status.
Only use this function if unexpected problems occur with the new data flow after migration and these problems can only be solved by restoring
the data flow used previously.
When you restore, the 3.x DataSource (R3TR ISFS), mapping (R3TR ISMP) and transfer structure (R3TR ISTS) objects that were exported are generated with a
transport connection in the original system. The DataSource (R3TR RSDS) is deleted. The system tries to retain the PSA. This is only possible if a PSA existed
for the 3.x DataSource before migration. This may not be the case if an active transfer structure did not exist for the 3.x DataSource or if the data for the
DataSource was loaded using an IDoc. The InfoPackage (R3TR ISIP) for the DataSource is retained in the system. Available targets are displayed in the
InfoPackage (this also applies to InfoPackages that were created after migration). However, in InfoPackage maintenance, you have to reselect the targets into
which you want to update data.
The transformation (R3TR TRFN) and data transfer process (R3TR DTPA) objects that are dependent on the DataSource (R3TR RSDS) are retained and can be
deleted manually, as required. You can no longer use data transfer processes for direct access or real-time data acquisition.
You can now transport the restored 3.x DataSource and the dependent transfer structure and mapping objects into the target system.
When you transport the restored 3.x DataSource into the target system, the DataSource (R3TR RSDS) is deleted in the after-import. The PSA and InfoPackages
are retained. If a transfer structure (R3TR ISTS) is transported with the restore process, the system tries to transfer the PSA for this transfer structure. This is not
possible if no transfer structure exists when you restore the 3.x DataSource or if IDoc is specified as the transfer method for the 3.x DataSource. The PSA is
retained in the target system but is not assigned to a DataSource/3.x DataSource or to a transfer structure.
You can also use the restoration function to correct replication errors. If a DataSource was inadvertently replicated in the object type R3TR RSDS,
you can change the object type of the DataSource in R3TR ISFS by restoring it.
Page 12 of 14
You can display an emulated 3.x DataSource in DataSource maintenance in BI. Changes are not possible in this display. In addition, you can use emulation to
create the (new) data flow for a 3.x DataSource with transformations, without having to migrate the existing data flow that is based on the 3.x DataSource.
We recommend that you use emulation before migrating the DataSource in order to model and test the functionality of the data flow with
transformations, without changing or deleting the objects of the existing data flow. Note that use of the emulated Data Source in a data flow with
transformations has an effect on the evaluation of the settings in the InfoPackage. We therefore recommend that you only use the emulation in a
development or test system.
Constraints
An emulated 3.x DataSource does not support real-time data acquisition, using the data transfer process to access data directly, or loading data directly (without
using the PSA).
Prerequisites
If you want to use transformations in the modeling of the data flow for the 3.x DataSource, the transfer rules and therefore the transfer structure must be activated for
the 3.x DataSource. The PSA table to which the data is written is created when the transfer structure is activated.
Procedure
To display the emulated 3.x DataSource in DataSource maintenance, highlight the 3.x DataSource in the DataSource tree and choose Display from the context
menu.
To create a data flow using transformations, highlight the 3.x DataSource in the DataSource tree and choose Create Transformation from the context menu. You
also use the transformation to set the target of the data transferred from the PSA.
To permit a data transfer to the PSA and further updating of the data from the PSA to the InfoProvider, select the DataSource 3.x in the DataSource tree and
choose Create InfoPackage or Create Data Transfer Process in the context menu. We recommend that you use the processes for data transfer to prepare for the
migration of a data flow and not in the production system.
Result
If you defined and tested the data flow with transformations using the emulation, you can migrate the DataSource 3.x after a successful test.
Procedure
1.
2.
3.
4.
5.
In the original system (development system), in the Data Warehousing Workbench, choose Migrate in the context menu of the 3.x DataSource.
If you want to restore the 3.x DataSource at a later time, choose With Export on the next screen.
Specify a transport request.
Transport the migrated DataSource to the target system (quality system, productive system).
Activate the DataSource in the target system.
Prerequisites
The UD Connect source system and the Web service source system are available.
The UD Connect source system uses the same RFC destination, and therefore the same BI Java Connector, as the 3.x DataSource.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 13 of 14
Procedure
1.
2.
3.
4.
5.
6.
In the original system (development system), in the Data Warehousing Workbench, choose Copy in the context menu of the 3.x DataSource.
On the next screen, enter the name of the DataSource under DataSource .
Under Source System , specify the Web service or UD Connect source system to which you want to migrate the DataSource.
Delete the dependent 3.x objects (3.x DataSource, mapping, transfer rules and any generated function modules and the Web service).
Transport the DataSource and the deletion of 3.x objects into the target system.
Activate the DataSource.
Result
When you activate the Web service DataSource, the system generates a Web service and an rfc-compliant function module for the data transfer.
When you activate the UD Connect DataSource, the system generates a function module for extraction and data transfer.
Only use this function if unexpected problems occur with the new data flow after migration and these problems can only be solved by restoring
the data flow used previously.
Furthermore, you can use this function to undo a replication to the incorrect object type (R3TR RSDS).
Prerequisites
For file source system and DB Connect: You exported and archived the relevant 3.x objects when you migrated the 3.x DataSource.
Procedure
1. In the maintenance screen of the DataSource (transaction RSDS) in the original system (development system), choose DataSource Restore 3.x
DataSource .
2. Enter a transport request.
3. If required, delete the dependent transformation (R3TR TRFN) and data transfer process (R3TR DTPA) objects.
4. Transport the restored 3.x DataSource (R3TR ISFS), along with its dependent objects, into the target system.
PUBLIC
2014 SAP SE or an SAP affiliate company. All rights reserved.
Page 14 of 14