BUSINESS OBJECTS DATA INTEGRATOR

Transcription

1 You can read the recommendations in the user guide, the technical guide or the installation guide for BUSINESS OBJECTS DATA INTEGRATOR You'll find the answers to all your questions on the BUSINESS OBJECTS DATA INTEGRATOR in the user manual (information, specifications, safety advice, size, accessories, etc.). Detailed instructions for use are in the User's Guide. User manual BUSINESS OBJECTS DATA INTEGRATOR User guide BUSINESS OBJECTS DATA INTEGRATOR Operating instructions BUSINESS OBJECTS DATA INTEGRATOR Instructions for use BUSINESS OBJECTS DATA INTEGRATOR Instruction manual BUSINESS OBJECTS DATA INTEGRATOR You're reading an excerpt. Click here to read official BUSINESS OBJECTS DATA INTEGRATOR user guide

2 Manual abstract: com. Copyright Business Objects S.A 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: Third-party contributors Patents Business Objects owns the following U.S. patents, which may cover products that are offered and sold by Business Objects: 5,555,403, 6,247,008 B1, 6,578,027 B2, 6,490,593 and 6,289,352. February 28, 2006 Date 2 Data Integrator Designer Guide Contents Contents Chapter 1 Introduction 3 17 Welcome 18 Overview of this document.. 18 Audience and assumptions More Data Integrator product documentation.. 19 Chapter 2 Logging in to the Designer 21 About this chapter Creating a Data Integrator repository Associating the repository with a Job Server Entering repository information Version restrictions Oracle login Microsoft SQL Server login.

3 .. 25 Informix login IBM DB2 login Sybase ASE login Resetting users Chapter 3 Designer user interface 29 About this chapter Data Integrator objects Reusable objects Single-use objects Object hierarchy.. 31 Designer window

4 Menu bar Data Integrator Designer Guide 3 Contents Project menu Edit menu.. 35 View menu Tools menu Debug menu Validation menu.. 38 Window menu

5 Help menu.. 39 Toolbar Project area Tool palette Workspace Moving objects in the workspace area Connecting and disconnecting objects Describing objects Scaling the workspace.. 46 Arranging workspace windows....

6 .. 47 Closing workspace windows Local object library Object editors.. 50 Working with objects.. 51 Creating new reusable objects Changing object names Viewing and changing object properties Creating descriptions Creating annotations Saving and deleting objects Searching for objects...

7 63 General and environment options.. 65 Designer -- Environment Designer -- General Designer -- Graphics Designer -- Central Repository Connections Data Integrator Designer Guide Contents Data -- General.. 69 Job Server -- Environment Job Server -- General.. 69 Chapter 4 Projects and Jobs 71 About this chapter Projects. 72 Objects that make up a project

8 72 Creating new projects.. 73 Opening existing projects Saving projects Jobs Creating jobs Naming conventions for objects in jobs Chapter 5 Datastores 79 About this chapter What are datastores?. 80 Database datastores. 81 Mainframe interfaces Defining a database datastore.

9 87 Changing a datastore definition 90 Browsing metadata through a database datastore 91 Importing metadata through a database datastore 97 Memory datastores Adapter datastores Defining an adapter datastore 110 Browsing metadata through an adapter datastore 112 Importing metadata through an adapter datastore 112 Creating and managing multiple datastore configurations Definitions Why use multiple datastore configurations? Creating a new configuration Data Integrator Designer Guide 5 Contents Adding a datastore alias Portability solutions...

10 . 118 Job portability tips Renaming table and function owner Defining a system configuration Chapter 6 File Formats 133 About this chapter What are file formats? File format editor Creating file formats Creating COBOL copybook file formats. 145 Editing file formats. You're reading an excerpt. Click here to read official BUSINESS OBJECTS DATA INTEGRATOR user guide

11 Replicating and renaming file formats File format features Reading multiple files at one time Number formats Ignoring rows with specified markers Date formats at the field level Error handling for flat-file sources File transfers Custom transfer system variables for flat files Custom transfer options for flat files Setting custom transfer options Design tips...

12 Web log support Word_ext function Concat_date_time function WL_GetKeyValue function Chapter 7 Data Flows 167 About this chapter What is nested data? Representing hierarchical data Operations on nested data Overview of nested data and the Query transform FROM clause construction Nesting columns....

13 Using correlated columns in nested data Distinct rows and nested data. 218 Grouping values across nested schemas Unnesting nested data How transforms handle nested data Formatting XML documents Using XML Schemas Using Document Type Definitions (DTDs) Generating DTDs and XML Schemas from an NRDM schema 229 XML extraction and parsing for columns Example Scenarios Chapter 10 Real-time jobs 237 Overview Request-response message processing..

14 What is a real-time job? Real-time versus batch Messages. 240 Real-time job examples Data Integrator Designer Guide Contents Creating real-time jobs Real-time job models Using real-time job models Creating a real-time job Real-time source and target objects Secondary sources and targets Transactional loading of tables Design tips for data flows in real-time jobs

15 253 Testing real-time jobs 254 Executing a real-time job in test mode Using View Data Using an XML file target Building blocks for real-time jobs. 256 Supplementing message data 256 Branching data flow based on a data cache value Calling application functions. 264 Designing real-time applications. 265 Reducing queries requiring back-office application access Messages from real-time jobs to adapter instances Real-time service invoked by an adapter instance Chapter 11 Embedded Data Flows 267 About this chapter Overview..

16 Example of when to use embedded data flows Creating embedded data flows Using the Make Embedded Data Flow option Creating embedded data flows from existing flows Using embedded data flows Testing embedded data flows Troubleshooting embedded data flows Data Integrator Designer Guide 9 Contents Chapter 12 Variables and Parameters 279 About this chapter Overview The Variables and Parameters window Using local variables and parameters Parameters Passing values into data flows Defining local variables.

17 286 Defining parameters Using global variables Creating global variables Viewing global variables Setting global variable values Local and global variable rules Naming Replicating jobs and work flows Importing and exporting Environment variables Setting file names at run-time using variables.

18 . 298 Chapter 13 Executing Jobs 301 About this chapter Overview of Data Integrator job execution Preparing for job execution Validating jobs and job components. 303 Ensuring that the Job Server is running Setting job execution options Executing jobs as immediate tasks Monitor tab Log tab Debugging execution errors Using Data Integrator logs Examining target data

19 Data Integrator Designer Guide Contents Changing Job Server options Chapter 14 Data Quality 317 Chapter overview Using the Data Profiler. You're reading an excerpt. Click here to read official BUSINESS OBJECTS DATA INTEGRATOR user guide

20 Data sources that you can profile Connecting to the profiler server Profiler statistics Executing a profiler task Monitoring profiler tasks using the Designer Viewing the profiler results Using View Data to determine data quality Data tab Profile tab Relationship Profile or Column Profile tab Using the Validation transform Analyze column profile....

21 Define validation rule based on column profile Using Auditing Auditing objects in a data flow Accessing the Audit window. 352 Defining audit points, rules, and action on failure 353 Guidelines to choose audit points Auditing embedded data flows Resolving invalid audit labels Viewing audit results Chapter 15 Design and Debug 365 About this chapter Using View Where Used From the object library. 367 From the workspace

22 Limitations Data Integrator Designer Guide 11 Contents Using View Data Accessing View Data Viewing data in the workspace View Data properties View Data tool bar options View Data tabs Using the interactive debugger Before starting the interactive debugger Starting and stopping the interactive debugger Windows

23 Menu options and tool bar Viewing data passed by transforms Push-down optimizer Limitations. 405 Comparing Objects Overview of the Difference Viewer window Navigating through differences Calculating usage dependencies. 413 Chapter 16 Exchanging metadata 415 About this chapter Metadata exchange Importing metadata files into Data Integrator Exporting metadata files from Data Integrator.

24 Creating Business Objects universes Mappings between repository and universe metadata Attributes that support metadata exchange Chapter 17 Recovery Mechanisms 423 About this chapter Recovering from unsuccessful job execution Automatically recovering jobs Enabling automated recovery Data Integrator Designer Guide Contents Marking recovery units Running in recovery mode Ensuring proper execution path Using try/catch blocks with automatic recovery Ensuring that data is not duplicated in targets Using preload SQL to allow re-executable data flows Manually recovering jobs using status tables Processing data with problems..

25 438 Using overflow files Filtering missing or bad values Handling facts with missing dimensions Chapter 18 Data Cleansing 443 About this chapter Cleansing data in Data Integrator Parse and standardize names Correct and standardize addresses Match and consolidate data Installation and configuration for data cleansing Using data cleansing transforms Data cleansing job templates Business logic in pre-defined templates Template tokens 451 Storing and finding templates

26 452 Creating template files. 453 Support files Migrating Firstlogic jobs 455 Debugging data cleansing jobs Debugging with Address_Enhancement or Name_Parsing Debugging with Match_Merge 455 Data cleansing limitations. 456 Data cleansing transforms and LONG data type Data cleansing transforms and column dependencies Data Integrator Designer Guide 13 Contents Chapter 19 Techniques for Capturing Changed Data 457 About this chapter Understanding changed-data capture Full refresh Capturing only changes.

27 Source-based and target-based CDC Using CDC with Oracle sources Overview of CDC for Oracle databases Setting up Oracle CDC. 465 CDC datastores Importing CDC data from Oracle Viewing an imported CDC table Configuring an Oracle CDC source Creating a data flow with an Oracle CDC source Maintaining CDC tables and subscriptions Limitations. 481 Using CDC with DB2 sources. You're reading an excerpt. Click here to read official BUSINESS OBJECTS DATA INTEGRATOR user guide

28 Guaranteed delivery Setting up DB Setting up Data Integrator CDC Services CDC datastores Importing CDC data from DB Configuring a DB2 CDC source Limitations Using CDC with IBM mainframe sources Guaranteed Delivery Setting up IBM mainframe data sources....

29 Setting up Data Integrator CDC Services IBM Connector CDC Datastores Importing CDC data from IBM Connect Configuring an IBM Connector CDC source Data Integrator Designer Guide Contents Limitations Using CDC with Attunity mainframe sources Setting up Attunity CDC 503 Setting up Data Integrator Importing mainframe CDC data Configuring a mainframe CDC source Using mainframe check-points Using CDC with Microsoft SQL Server databases Overview of CDC for SQL Server databases..

30 Setting up SQL Replication Server for CDC Setting up Data Integrator Importing SQL Server CDC data Configuring an SQL Server CDC source Using CDC with timestamp-based sources Processing timestamps Overlaps Types of timestamps Timestamp-based CDC examples Additional job design tips Using CDC for targets Chapter 20 Monitoring jobs 545 About this chapter Administrator..

31 SNMP support About the Data Integrator SNMP agent Job Server, SNMP agent, and NMS application architecture. 547 About SNMP Agent's Management Information Base (MIB) About an NMS application Configuring Data Integrator to support an NMS application Troubleshooting. 564 Index 567 Data Integrator Designer Guide 15 Contents 16 Data Integrator Designer Guide Data Integrator Designer Guide Introduction chapter 1 Introduction Welcome Welcome Welcome to the Data Integrator Designer Guide. The Data Integrator Designer provides a graphical user interface (GUI) development environment in which you define data application logic to extract, transform, and load data from databases and applications into a data warehouse used for analytic and on-demand queries. You can also use the Designer to define logical paths for processing message-based queries and transactions from Web-based, frontoffice, and back-office applications. This chapter discusses these topics: Overview of this document Audience and assumptions More Data Integrator product documentation Overview of this document The book contains two kinds of information: Conceptual information that helps you understand the Data Integrator Designer and how it works Procedural information that explains in a step-by-step manner how to accomplish a task While you are learning about the product While you are performing tasks in the design and early testing phase of your data-movement projects As a general source of information during any phase of your projects You will find this book most useful: Audience and assumptions This and other Data Integrator product documentation assumes the following: You are an application developer, consultant, or database administrator working on data extraction, data warehousing, or data integration. You understand your source data systems, RDBMS, business intelligence, and messaging concepts. You understand your organization's data needs. You are familiar with SQL (Structured Query Language). 18 Data Integrator Designer Guide Introduction More Data Integrator product documentation 1 If you are interested in using this product to design real-time processing, you should be familiar with: DTD and XML Schema formats for XML files Publishing Web Services (WSDL, HTTP, and SOAP protocols, etc.) You are familiar Data Integrator installation environments--microsoft Windows or UNIX. More Data Integrator product documentation Consult the Data Integrator Getting Started Guide for: An overview of Data Integrator products and architecture Data Integrator installation and configuration information A list of product documentation and a suggested reading path After you install Data Integrator, you can view technical documentation from many locations. To view documentation in PDF format, you can: Select Start > Programs > Data Integrator version > Data Integrator Documentation and choose: Release Notes--Opens this document, which includes known and fixed bugs, migration considerations, and lastminute documentation corrections Release Summary--Opens the Release Summary PDF, which describes the latest Data Integrator features Technical Manuals--Opens a "master" PDF document that has been compiled so you can search across the Data Integrator documentation suite Tutorial--Opens the Data Integrator Tutorial PDF, which you can use for basic stand-alone training purposes Select one of the following from the Designer's Help menu: Release Notes Release Summary Technical Manuals Tutorial Other links from the Designer's Help menu include: DIZone--Opens a browser window to the DI Zone, an online resource for the Data Integrator user community) Data Integrator Designer Guide 19 1 Introduction More Data Integrator product documentation Knowledge Base--Opens a browser window to Business Objects' Technical Support Knowledge Exchange forum (access requires registration) Select Help from the Data Integrator Administrator to open Technical Manuals. You're reading an excerpt. Click here to read official BUSINESS OBJECTS DATA INTEGRATOR user guide

32 You can also view and download PDF documentation, including Data Integrator documentation for previous releases (including Release Summaries and Release Notes), by visiting the Business Objects documentation Web site at documentation/product_guides/%20default. asp. You can also open Help, using one of the following methods: Choose Contents from the Designer's Help menu. Click objects in the object library or workspace and press F1. Online Help opens to the subject you selected. Use Online Help's links and tool bar to navigate. 20 Data Integrator Designer Guide Data Integrator Designer Guide Logging in to the Designer chapter 2 Logging in to the Designer About this chapter About this chapter This chapter describes how to log in to the Data Integrator Designer. When you log in to the Data Integrator Designer, you are actually logging in to the database you defined for the Data Integrator repository. Data Integrator repositories can reside on Oracle, Microsoft SQL Server, Informix, IBM DB2, Sybase ASE. This chapter discusses: Creating a Data Integrator repository Associating the repository with a Job Server Entering repository information Resetting users Creating a Data Integrator repository You must configure a local repository to log in to Data Integrator. Typically, you create a repository during installation. However, you can create a repository at any time using the Data Integrator Repository Manager. To create a local repository Define a database for the local repository using your database management system. From the Start menu, choose Programs > BusinessObjects Data Integrator version > Repository Manager (assuming you installed Data Integrator in the Data Integrator program group). In the Repository Manager window, enter the database connection information for the repository and select Local for repository type. Click Create. This adds the Data Integrator repository schema to the specified database Associating the repository with a Job Server Each repository must be associated with at least one Job Server, which is the process that starts jobs. When running a job from a repository, you select one of the associated repositories. In production environments, you can balance loads appropriately. You can link any number of repositories to a single Job Server. The same Job Server can run jobs stored on multiple repositories. 22 Data Integrator Designer Guide Logging in to the Designer Entering repository information 2 Typically, you define a Job Server and link it to a repository during installation. However, you can define or edit Job Servers or links between repositories and Job Servers at any time using the Data Integrator Server Manager. 1. To create a Job Server for your local repository Open the Data Integrator Server Manager. From the Start menu, choose Programs > BusinessObjects Data Integrator version > Server Manager (assuming you installed Data Integrator in the Data Integrator program group). 2. See "To configure Job Servers" on page 78 of the Data Integrator Getting Started Guide for detailed instructions. Entering repository information To log in, enter the connection information for your Data Integrator repository. The required information varies with the type of database containing the repository. This section discusses: Version restrictions Oracle login Microsoft SQL Server login Informix login IBM DB2 login Sybase ASE login Version restrictions Your repository version must be associated with the same major release as the Designer and must be less than or equal to the version of the Designer. For example, Designer 5.2 can access repositories 5.0, 5.1, and 5.2 (equal to or less than), but not repository 4. 4 (different major release version). So, in this example, repository 5.0 is the earliest repository version that could be used with Designer version 5.2. During login, Data Integrator alerts you if there is a mismatch between your Designer version and your repository version. After you log in, you can view Data Integrator and repository versions by selecting Help > About Data Integrator. Data Integrator Designer Guide 23 2 Logging in to the Designer Entering repository information Some features in the current release of the Designer might not be supported if you are not logged in to the latest version of the repository. Oracle login From the Windows Start menu, select Programs > BusinessObjects Data Integrator version > Data Integrator Designer. In the Repository Login window, complete the following fields: Database type -- Select Oracle. Database connection name -- The TNSnames. ora entry or Net Service Name of the database. User name and Password --The user name and password for a Data Integrator repository defined in an Oracle database. Remember -- Check this box if you want the Designer to store this information for the next time you log in. 24 Data Integrator Designer Guide Logging in to the Designer Entering repository information 2 Microsoft SQL Server login From the Windows Start menu, select Programs > BusinessObjects Data Integrator version > Data Integrator Designer. For a Microsoft SQL Server repository, you must complete the following fields: Database type -- Select Microsoft_SQL_Server. Database server name --The database server name. Database name -- The name of the specific database to which you are connecting. Windows authentication -- Select to have Microsoft SQL Server validate the login account name and password using information from the Windows operating system; clear to authenticate using the existing Microsoft SQL Server login account name and password and complete the User name and Password fields. User name and Password -- The user name and password for a Data Integrator repository defined in a Microsoft SQL Server database. Remember -- Check this box if you want the Designer to store this information for the next time you log in. Informix login From the Windows Start menu, select Programs > BusinessObjects Data Integrator version > Data Integrator Designer. For an Informix repository, you must complete the following fields: Data Integrator Designer Guide 25 2 Logging in to the Designer Entering repository information Database type -- Select Informix. Informix datasource -- The data source name. User name and Password -- The user name and password for a Data Integrator repository defined in an Informix database. Remember -- Check this box if you want the Designer to store this information for the next time you log in. IBM DB2 login From the Windows Start menu, select Programs > BusinessObjects Data Integrator version > Data Integrator Designer. You're reading an excerpt. Click here to read official BUSINESS OBJECTS DATA INTEGRATOR user guide

33 For a DB2 repository, you must complete the following fields: Database type -- Select DB2. DB2 datasource -- The data source name. User name and Password -- The user name and password for a Data Integrator repository defined in a DB2 database. Remember -- Check this box if you want the Designer to store this information for the next time you log in. Sybase ASE login From the Windows Start menu, select Programs > BusinessObjects Data Integrator version > Data Integrator Designer. For a Sybase ASE repository, you must complete the following fields: Database type -- Select Sybase ASE. Database server name -- Enter the database's server name. Note: For UNIX Job Servers, when logging in to a Sybase repository in the Designer, the case you type for the database server name must match the associated case in the SYBASE_Home\interfaces file. If the case does not match, you might receive an error because the Job Server cannot communicate with the repository. Database name -- Enter the name of the specific database to which you are connecting. User name and Password -- Enter the user name and password for this database. Remember -- Check this box if you want the Designer to store this information for the next time you log in. 26 Data Integrator Designer Guide Logging in to the Designer Resetting users 2 Resetting users Occasionally, more than one person may attempt to log in to a single repository. If this happens, the Reset Users window appears, listing the users and the time they logged in to the repository. From this window, you have several options. You can: Reset Users to clear the users in the repository and set yourself as the currently logged in user. Continue to log in to the system regardless of who else might be connected. Exit to terminate the login attempt and close the session. Note: Only use Reset Users or Continue if you know that you are the only user connected to the repository. Subsequent changes could corrupt the repository. Data Integrator Designer Guide 27 2 Logging in to the Designer Resetting users 28 Data Integrator Designer Guide Data Integrator Designer Guide Designer user interface chapter 3 Designer user interface About this chapter About this chapter This chapter provides basic information about the Designer's graphical user interface. It contains the following topics: Data Integrator objects Designer window Menu bar Toolbar Project area Tool palette Workspace Local object library Object editors Working with objects General and environment options Data Integrator objects All "entities" you define, edit, or work with in Data Integrator Designer are called objects. The local object library shows objects such as source and target metadata, system functions, projects, and jobs. Objects are hierarchical and consist of: Options, which control the operation of objects. For example, in a datastore, the name of the database to which you connect is an option for the datastore object. Properties, which document the object. For example, the name of the object and the date it was created are properties. Properties describe an object, but do not affect its operation. Reusable objects Single-use objects Data Integrator has two types of objects: The object type affects how you define and retrieve the object. 30 Data Integrator Designer Guide Designer user interface Data Integrator objects 3 Reusable objects You can reuse and replicate most objects defined in Data Integrator. After you define and save a reusable object, Data Integrator stores the definition in the local repository. You can then reuse the definition as often as necessary by creating calls to the definition. Access reusable objects through the local object library. A reusable object has a single definition; all calls to the object refer to that definition. If you change the definition of the object in one place, you are changing the object in all other places in which it appears. A data flow, for example, is a reusable object. Multiple jobs, like a weekly load job and a daily load job, can call the same data flow. If the data flow changes, both jobs use the new version of the data flow. The object library contains object definitions. When you drag and drop an object from the object library, you are really creating a new reference (or call) to the existing object definition. Single-use objects Some objects are defined only within the context of a single job or data flow, for example scripts and specific transform definitions. Object hierarchy Data Integrator object relationships are hierarchical. The following figure shows the relationships between major Data Integrator object types: Data Integrator Designer Guide 31 3 Designer user interface Designer window Designer window The Data Integrator Designer user interface consists of a single application window and several embedded supporting windows. 32 Data Integrator Designer Guide Designer user interface Menu bar 3 Project area Menu bar Toolbar Workspace Tool palette Local object library The application window contains the Menu bar, Toolbar, Project area, Tool palette, tabbed Workspace, and tabbed Local object library. Menu bar This section contains a brief description of the Designer's menus: Project menu Edit menu View menu Tools menu Debug menu Validation menu Data Integrator Designer Guide 33 3 Designer user interface Menu bar Window menu Help menu Project menu The project menu contains standard Windows as well as Data Integratorspecific options. New -- Define a new project, batch job, real-time job, work flow, data flow, transform, datastore, file format, DTD, XML Schema, or custom function. Open -- Open an existing project. Close -- Close the currently open project. Delete -- Delete the selected object. Save -- Save the object open in the workspace. Save All -- Save all changes to objects in the current Designer session. Print -- Print the active workspace. Print Setup -- Set up default printer information. Compact Repository -- Remove redundant and obsolete objects from the repository tables. Exit -- Exit Data Integrator Designer. 34 Data Integrator Designer Guide Designer user interface Menu bar 3 Edit menu The Edit menu provides standard Windows commands with a few restrictions. Undo -- Undo the last operation (text edits only). Cut -- Cut the selected object or text and place it on the clipboard. Copy -- Copy the selected object or text to the clipboard. You're reading an excerpt. Click here to read official BUSINESS OBJECTS DATA INTEGRATOR user guide

34 Note: You cannot copy reusable objects using the Copy command; instead, use Replicate in the object library to make an independent copy of an object. Paste -- Paste the contents of the clipboard into the active workspace or text box. Note: You can only paste clipboard contents once. To paste again, you must cut or copy the objects again. Delete -- Delete the selected object. Clear All -- Clear all objects in the active workspace (no undo). View menu A check mark indicates that the tool is active. Toolbar -- Display or remove the toolbar in the Designer window. Status Bar -- Display or remove the status bar in the Designer window. Palette -- Display or remove the floating tool palette. Enabled Descriptions -- View descriptions for objects with enabled descriptions. Data Integrator Designer Guide 35 3 Designer user interface Menu bar Refresh -- Redraw the display. Use this command to ensure the content of the workspace represents the most up-to-date information from the repository. Tools menu A check mark indicates that the tool is active. Object Library -- Open or close the object library window. For more information, see "Local object library" on page 47. Project Area -- Display or remove the project area from the Data Integrator window. For more information, see "Project area" on page 41. Variables -- Open or close the Variables and Parameters window. For more information, see "Variables and Parameters" on page 279. Output -- Open or close the Output window. The Output window shows errors that occur such as during job validation or object export. Custom Functions -- Display the Custom Functions window. For more information, see "Custom functions" on page 388 of the Data Integrator Reference Guide. System Configurations -- Display the System Configurations editor. For more information, see "Creating and managing multiple datastore configurations" on page Data Integrator Designer Guide Designer user interface Menu bar 3 Export -- Export individual repository objects to another repository or file. This command opens the Export editor in the workspace. You can drag objects from the object library into the editor for export. To export your whole repository, in the object library right-click and select Repository > Export to file. For more information, see "Exporting/ importing objects in Data Integrator" on page 30 of the Data Integrator Advanced Development and Migration Guide. Import From File -- Import objects into the current repository from a file. For more information, see "Importing from a file" on page 35 of the Data Integrator Advanced Development and Migration Guide. Metadata Exchange -- Import and export metadata to third-party systems via a file. See "Metadata exchange" on page 416. BusinessObjects Universes -- Export (create or update) metadata in Business Objects Universes. See "Creating Business Objects universes" on page 419. Central Repositories -- Create or edit connections to a central repository for managing object versions among multiple users. See Chapter 6, "Multi-user environment setup," in the Data Integrator Advanced Development and Migration Guide. Options -- Display the Options window. See "General and environment options" on page 65. Metadata Reports -- Display the Metadata Reports window. Select the object type, report type, and the objects in the repository that you want to list in the report. See "Metadata reporting tool" on page 427. Debug menu The only options available on this menu at all times are Show Filters/ Breakpoints and Filters/Breakpoints. The Execute and Start Debug options are only active when a job is selected. All other options are available as appropriate when a job is running in the Debug mode. For more information, see "Using the interactive debugger" on page 386. Execute - Opens the Execution Properties window which allows you to execute the selected job. Start Debug - Opens the Debug Properties window which allows you to run a job in the debug mode. Show Filters/Breakpoints - Shows and hides filters and breakpoints in workspace diagrams. Data Integrator Designer Guide 37 3 Designer user interface Menu bar Filters/Breakpoints - Opens a window you can use to manage filters and breakpoints. For more information, see "Filters and Breakpoints window" on page 401. Validation menu The Designer displays options on this menu as appropriate when an object is open in the workspace. Validate -- Validate the objects in the current workspace view or all objects in the job before executing the application. Display Language -- View a read-only version of the language associated with the job. Display Optimized SQL -- Display the SQL that Data Integrator generated for a selected data flow. See "Viewing SQL" on page 36 of the Data Integrator Performance Optimization Guide. Window menu The Window menu provides standard Windows options. Back -- Move back in the list of active workspace windows. Forward -- Move forward in the list of active workspace windows. Cascade -- Display window panels overlapping with titles showing. Tile Horizontally -- Display window panels side by side. Tile Vertically -- Display window panels one above the other. Close All Windows -- Close all open windows. 38 Data Integrator Designer Guide Designer user interface Toolbar 3 A list of objects open in the workspace also appears on the Windows menu. The name of the currently-selected object is indicated by a check mark. Navigate to another open object by selecting its name in the list. Help menu Contents -- Display on-line help. Data Integrator`s on-line help works with Microsoft Internet Explorer version 5.5 and higher. Technical Manuals-- Display a PDF version of Data Integrator documentation. This file contains the same content as on-line help. It is provided for users who prefer to print out their documentation. This format prints graphics clearly and includes a master index and page numbers/references. You can also access the same file from the Help menu in the Administrator or from the <linkdir>\doc\books directory. Release Notes -- Display current release notes. Release Summary -- Display summary of new features in the current release. About Data Integrator -- Display information about Data Integrator including versions of the Designer, Job Server and engine, copyright information, and a link to the Business Objects Web site. Toolbar In addition to many of the standard Windows tools, Data Integrator provides application-specific tools, including: Icon Tool Description Close all windows Closes all open windows in the workspace. You're reading an excerpt. Click here to read official BUSINESS OBJECTS DATA INTEGRATOR user guide

35 Local Object Library Opens and closes the local object library window. Data Integrator Designer Guide 39 3 Designer user interface Toolbar Icon Tool Central Object Library Variables Project Area Output View Enabled Descriptions Validate Current View Validate All Objects in View Audit Objects in Data Flow Description Opens and closes the central object library window. Opens and closes the variables and parameters creation window. Opens and closes the project area. Opens and closes the output window. Enables the system level setting for viewing object descriptions in the workspace. Validates the object definition open in the workspace. Other objects included in the definition are also validated. Validates the object definition open in the workspace. Objects included in the definition are also validated. Opens the Audit window to define audit labels and rules for the data flow. View Where Used Opens the Output window, which lists parent objects (such as jobs) of the object currently open in the workspace (such as a data flow). Use this command to find other jobs that use the same data flow, before you decide to make design changes. To see if an object in a data flow is reused elsewhere, right-click one and select View Where Used. Go Back Go Forward Move back in the list of active workspace windows. Move forward in the list of active workspace windows. Metadata Reports Opens and closes the Metadata Reports window. About Opens the Data Integrator About box, with product component version numbers and a link to the Business Objects Web site. Use the tools to the right of the About tool with the interactive debugger. See "Menu options and tool bar" on page Data Integrator Designer Guide Designer user interface Project area 3 Project area The project area provides a hierarchical view of the objects used in each project. Tabs on the bottom of the project area support different tasks. Tabs include: Create, view and manage projects. Provides a hierarchical view of all objects used in each project. View the status of currently executing jobs. Selecting a specific job execution displays its status, including which steps are complete and which steps are executing. These tasks can also be done using the Data Integrator Administrator. View the history of complete jobs. Logs can also be viewed with the Data Integrator Administrator. To control project area location, right-click its gray border and select/deselect Allow Docking, or select Hide from the menu. When you select Allow Docking, you can click and drag the project area to dock at and undock from any edge within the Designer window. When you drag the project area away from a Designer window edge, it stays undocked. To quickly switch between your last docked and undocked locations, just double-click the gray border. When you deselect Allow Docking, you can click and drag the project area to any location on your screen and it will not dock inside the Designer window. When you select Hide, the project area disappears from the Designer window. To unhide the project area, click its toolbar icon. Here's an example of the Project window's Designer tab, which shows the project hierarchy: Data Integrator Designer Guide 41 3 Designer user interface Tool palette Project Job Work flow Data flow As you drill down into objects in the Designer workspace, the window highlights your location within the project hierarchy. Tool palette The tool palette is a separate window that appears by default on the right edge of the Designer workspace. You can move the tool palette anywhere on your screen or dock it on any edge of the Designer window. The icons in the tool palette allow you to create new objects in the workspace. The icons are disabled when they are not allowed to be added to the diagram open in the workspace. To show the name of each icon, hold the cursor over the icon until the tool tip for the icon appears, as shown. When you create an object from the tool palette, you are creating a new definition of an object. If a new object is reusable, it will be automatically available in the object library after you create it. For example, if you select the data flow icon from the tool palette and define a new data flow, later you can drag that existing data flow from the object library, adding a call to the existing definition. 42 Data Integrator Designer Guide Designer user interface Tool palette 3 The tool palette contains the following icons: Icon Tool Pointer Description (class) Available Returns the tool pointer to a Everywhere selection pointer for selecting and moving objects in a diagram. Creates a new work flow. (reusable) Creates a new data flow. (reusable) Used only with the SAP licensed extension. Creates a template for a query. Data flows Use it to define column mappings and row selections. (single-use) Creates a table for a target. (single-use) Creates an XML template. (single-use) Used only with the SAP Licensed extension. Creates a new script object. (single-use) Jobs and work flows Data flows Data flows Jobs and work flows Jobs and work flows Work flow Data flow R/3 data flow Query transform Template table Template XML Data transport Script Conditional Try Catch Annotation Creates a new conditional object. Jobs and work (single-use) flows Creates a new try object. (single-use) Creates a new catch object. (single-use) Creates an annotation. (single-use) Jobs and work flows Jobs and work flows Jobs, work flows, and data flows Data Integrator Designer Guide 43 3 Designer user interface Workspace Workspace When you open or select a job or any flow within a job hierarchy, the workspace becomes "active" with your selection. The workspace provides a place to manipulate system objects and graphically assemble data movement processes. These processes are represented by icons that you drag and drop into a workspace to create a workspace diagram. This diagram is a visual representation of an entire data movement application or some part of a data movement application. This section describes major workspace area tasks, such as: Moving objects in the workspace area Connecting and disconnecting objects Describing objects Scaling the workspace Arranging workspace windows Closing workspace windows Moving objects in the workspace area Use standard mouse commands to move objects in the workspace. To move an object to a different place in the workspace area Click to select the object Drag the object to where you want to place it in the workspace. 44 Data Integrator Designer Guide Designer user interface Workspace 3 Connecting and disconnecting objects You specify the flow of data through jobs and work flows by connecting objects in the workspace from left to right in the order you want the data to be moved: To connect objects Place the objects you want to connect in the workspace. You're reading an excerpt. Click here to read official BUSINESS OBJECTS DATA INTEGRATOR user guide

36 Powered by TCPDF ( Click and drag from the triangle on the right edge of an object to the triangle on the left edge of the next object in the flow. 1. To disconnect objects Click the connecting line. 2. Press the Delete key. Describing objects You can use descriptions to add comments about objects. You can use annotations to explain a job, work flow, or data flow. You can view object descriptions and annotations in the workspace. Together, descriptions and annotations allow you to document a Data Integrator application. For example, you can describe the incremental behavior of individual jobs with numerous annotations and label each object with a basic description. Data Integrator Designer Guide 45 3 Designer user interface Workspace For more information, see "Creating descriptions" on page 58 and "Creating annotations" on page 60. Scaling the workspace You can control the scale of the workspace. By scaling the workspace, you can change the focus of a job, work flow, or data flow. For example, you might want to increase the scale to examine a particular part of a work flow, or you might want to reduce the scale so that you can examine the entire work flow without scrolling. 1. To change the scale of the workspace In the drop-down list on the tool bar, select a predefined scale or enter a custom value. 2. Alternatively, right-click in the workspace and select a desired scale. 46 Data Integrator Designer Guide Designer user interface Local object library 3 Note: You can also select Scale to Fit and Scale to Whole: Select Scale to Fit and the Designer calculates the scale that fits the entire project in the current view area. Select Scale to Whole to show the entire workspace area in the current view area. Arranging workspace windows The Window menu allows you to arrange multiple open workspace windows in the following ways: cascade, tile horizontally, or tile vertically. Closing workspace windows When you drill into an object in the project area or workspace, a view of the object's definition opens in the workspace area. The view is marked by a tab at the bottom of the workspace area, and as you open more objects in the workspace, more tabs appear. (You can show/hide these tabs from the Tools > Options menu. Go to Designer > General options and select/deselect Show tabs in workspace. For more information, see the "General and environment options" section.) Note: These views use system resources. If you have a large number of open views, you might notice a decline in performance. Close the views individually by clicking the close box in the top right corner of the workspace. Close all open views by selecting Window > Close All Windows or clicking the Close All Windows icon on the toolbar. Local object library The local object library provides access to reusable objects. These objects include built-in system objects, such as transforms, and the objects you build and save, such as datastores, jobs, data flows, and work flows. The local object library is a window into your local Data Integrator repository and eliminates the need to access the repository directly. Updates to the repository occur through normal Data Integrator operation. Saving the objects you create adds them to the repository. Access saved objects through the local object library. To learn more about local as well as central repositories, see "Central versus local repository" on page 40 of the Data Integrator Advanced Development and Migration Guide. Data Integrator Designer Guide 47 3 Designer user interface Local object library To control object library location, right-click its gray border and select/deselect Allow Docking, or select Hide from the menu. When you select Allow Docking, you can click and drag the object library to dock at and undock from any edge within the Designer window. When you drag the object library away from a Designer window edge, it stays undocked. To quickly switch between your last docked and undocked locations, just double-click the gray border. When you deselect Allow Docking, you can click and drag the object library to any location on your screen and it will not dock inside the Designer window. When you select Hide, the object library disappears from the Designer window. To unhide the object library, click its toolbar icon. To open the object library Choose Tools > Object Library, or click the object library icon in the icon bar. Object library window Transform object list Tabs for other object types The object library gives you access to the object types listed in the following table. The table shows the tab on which the object type appears in the object library and describes the Data Integrator context in which you can use each type of object. Tab Description Projects are sets of jobs available at a given time. Jobs are executable work flows. There are two job types: batch jobs and real-time jobs. Work flows order data flows and the operations that support data flows, defining the interdependencies between them. 48 Data Integrator Designer Guide Designer user interface Local object library 3 Tab Description Data flows describe how to process a task. Transforms operate on data, producing output data sets from the sources you specify. The object library lists both built-in and custom transforms. Datastores represent connections to databases and applications used in your project. Under each datastore is a list of the tables, documents, and functions imported into Data Integrator. Formats describe the structure of a flat file, XML file, or XML message. Custom Functions are functions written in the Data Integrator Scripting Language. You can use them in Data Integrator jobs. To display the name of each tab as well as its icon, do one of the following: Make the object library window wider until the names appear. Hold the cursor over the tab until the tool tip for the tab appears, as shown. To sort columns in the object library Click the column heading. For example, you can sort data flows by clicking the Data Flow column heading once. Names are listed in ascending order. To list names in descending order, click the Data Flow column heading again. Data Integrator Designer Guide 49 3 Designer user interface Object editors Object editors To work with the options for an object, in the workspace click the name of the object to open its editor. The editor displays the input and output schemas for the object and a panel below them listing options set for the object. If there are many options, they are grouped in tabs in the editor. A schema is a data structure that can contain columns, other nested schemas, and functions (the contents are called schema elements). A table is a schema containing only columns. A common example of an editor is the editor for the query transform, as shown in the following illustration: Input schema Output schema Parameter tabs Tabs of open windows For specific information about the query editor, see "Query editor" on page 185. You're reading an excerpt. Click here to read official BUSINESS OBJECTS DATA INTEGRATOR user guide