BUSINESS OBJECTS DATA INTEGRATOR

You can read the recommendations in the user guide, the technical guide or the installation guide for BUSINESS OBJECTS DATA INTEGRATOR 11.5.1.5. You'll find the answers to all your questions on the BUSINESS OBJECTS DATA INTEGRATOR 11.5.1.5 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 11.5.1.5 User guide BUSINESS OBJECTS DATA INTEGRATOR 11.5.1.5 Operating instructions BUSINESS OBJECTS DATA INTEGRATOR 11.5.1.5 Instructions for use BUSINESS OBJECTS DATA INTEGRATOR 11.5.1.5 Instruction manual BUSINESS OBJECTS DATA INTEGRATOR 11.5.1.5 You're reading an excerpt. Click here to read official BUSINESS OBJECTS DATA INTEGRATOR 11.5.1.5 user guide http://yourpdfguides.com/dref/3757086

Manual abstract: com. Copyright Business Objects S.A. 2005. @@@@@@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 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...... 18 More Data Integrator product documentation.. 19 Chapter 2 Logging in to the Designer 21 About this chapter... 22 Creating a Data Integrator repository...... 22 Associating the repository with a Job Server... 22 Entering repository information... 23 Version restrictions.... 23 Oracle login..... 24 Microsoft SQL Server login.

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

.... 32 Menu bar..... 33 Data Integrator Designer Guide 3 Contents Project menu..... 34 Edit menu.. 35 View menu...... 35 Tools menu...... 36 Debug menu..... 37 Validation menu.. 38 Window menu

.... 38 Help menu.. 39 Toolbar....... 39 Project area... 41 Tool palette.... 42 Workspace.... 44 Moving objects in the workspace area..... 44 Connecting and disconnecting objects..... 45 Describing objects..... 45 Scaling the workspace.. 46 Arranging workspace windows....

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

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

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

87 Changing a datastore definition 90 Browsing metadata through a database datastore 91 Importing metadata through a database datastore 97 Memory datastores... 104 Adapter datastores.. 109 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.. 113 Definitions..... 113 Why use multiple datastore configurations?.... 114 Creating a new configuration...... 115 Data Integrator Designer Guide 5 Contents Adding a datastore alias..... 117 Portability solutions...

. 118 Job portability tips..... 123 Renaming table and function owner...... 125 Defining a system configuration.... 129 Chapter 6 File Formats 133 About this chapter........ 134 What are file formats?..... 134 File format editor.... 135 Creating file formats...... 137 Creating COBOL copybook file formats. 145 Editing file formats. You're reading an excerpt. Click here to read official BUSINESS OBJECTS DATA INTEGRATOR 11.5.1.5 user guide http://yourpdfguides.com/dref/3757086

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

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

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

.... 238 What is a real-time job?.... 239 Real-time versus batch...... 239 Messages. 240 Real-time job examples. 241 8 Data Integrator Designer Guide Contents Creating real-time jobs.... 243 Real-time job models.. 243 Using real-time job models....... 245 Creating a real-time job..... 247 Real-time source and target objects... 250 Secondary sources and targets.... 251 Transactional loading of tables.... 252 Design tips for data flows in real-time jobs

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

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

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

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

.. 313 10 Data Integrator Designer Guide Contents Changing Job Server options.... 313 Chapter 14 Data Quality 317 Chapter overview........ 318 Using the Data Profiler. You're reading an excerpt. Click here to read official BUSINESS OBJECTS DATA INTEGRATOR 11.5.1.5 user guide http://yourpdfguides.com/dref/3757086

... 319 Data sources that you can profile.. 320 Connecting to the profiler server... 320 Profiler statistics...... 323 Executing a profiler task..... 326 Monitoring profiler tasks using the Designer.... 333 Viewing the profiler results... 335 Using View Data to determine data quality........ 341 Data tab.. 342 Profile tab...... 343 Relationship Profile or Column Profile tab...... 343 Using the Validation transform... 343 Analyze column profile....

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

.. 370 Limitations..... 371 Data Integrator Designer Guide 11 Contents Using View Data.... 371 Accessing View Data....... 373 Viewing data in the workspace..... 374 View Data properties... 376 View Data tool bar options........ 380 View Data tabs.. 381 Using the interactive debugger........ 386 Before starting the interactive debugger... 387 Starting and stopping the interactive debugger... 392 Windows

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

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

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

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

.... 458 Source-based and target-based CDC..... 459 Using CDC with Oracle sources.. 461 Overview of CDC for Oracle databases........ 462 Setting up Oracle CDC. 465 CDC datastores.. 466 Importing CDC data from Oracle.... 467 Viewing an imported CDC table.... 473 Configuring an Oracle CDC source.. 474 Creating a data flow with an Oracle CDC source...... 477 Maintaining CDC tables and subscriptions...... 480 Limitations. 481 Using CDC with DB2 sources. You're reading an excerpt. Click here to read official BUSINESS OBJECTS DATA INTEGRATOR 11.5.1.5 user guide http://yourpdfguides.com/dref/3757086

........ 481 Guaranteed delivery... 482 Setting up DB2....... 483 Setting up Data Integrator.... 484 CDC Services... 485 CDC datastores....... 486 Importing CDC data from DB2..... 488 Configuring a DB2 CDC source.... 488 Limitations...... 490 Using CDC with IBM mainframe sources..... 491 Guaranteed Delivery... 492 Setting up IBM mainframe data sources....

.... 492 Setting up Data Integrator.... 495 CDC Services... 496 IBM Connector CDC Datastores.... 497 Importing CDC data from IBM Connect... 499 Configuring an IBM Connector CDC source..... 499 14 Data Integrator Designer Guide Contents Limitations..... 501 Using CDC with Attunity mainframe sources.. 502 Setting up Attunity CDC 503 Setting up Data Integrator... 504 Importing mainframe CDC data.... 506 Configuring a mainframe CDC source.... 507 Using mainframe check-points..... 509 Using CDC with Microsoft SQL Server databases....... 510 Overview of CDC for SQL Server databases..

.. 510 Setting up SQL Replication Server for CDC.... 512 Setting up Data Integrator........ 513 Importing SQL Server CDC data... 516 Configuring an SQL Server CDC source....... 518 Using CDC with timestamp-based sources... 521 Processing timestamps..... 522 Overlaps....... 525 Types of timestamps.. 531 Timestamp-based CDC examples....... 533 Additional job design tips.... 542 Using CDC for targets.... 543 Chapter 20 Monitoring jobs 545 About this chapter....... 546 Administrator..

.... 546 SNMP support..... 546 About the Data Integrator SNMP agent... 546 Job Server, SNMP agent, and NMS application architecture. 547 About SNMP Agent's Management Information Base (MIB).. 548 About an NMS application... 551 Configuring Data Integrator to support an NMS application.. 552 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 11.5.1.5 user guide http://yourpdfguides.com/dref/3757086

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 http://support.businessobjects.com/ 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. 1. 2. 3. 4. 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 11.5.1.5 user guide http://yourpdfguides.com/dref/3757086

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 11.5.1.5 user guide http://yourpdfguides.com/dref/3757086

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 113. 36 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 11.5.1.5 user guide http://yourpdfguides.com/dref/3757086

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 402. 40 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. 1. 2. 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: 1. 2. 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 11.5.1.5 user guide http://yourpdfguides.com/dref/3757086

Powered by TCPDF (www.tcpdf.org) 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 11.5.1.5 user guide http://yourpdfguides.com/dref/3757086