pervasive tutorial

Download Pervasive Tutorial

Post on 01-Nov-2014

100 views

Category:

Documents

4 download

Embed Size (px)

DESCRIPTION

Pervasive Tutorial

TRANSCRIPT

Integration Architect

Tutorials ManualTutorials for Map Designer, Structured Schema Designer and Process Designer

Pervasive Software Inc. 12365 Riata Trace Parkway Building B Austin, TX 78727 USA

Telephone: 512 231 6000 or 800 287 4383 Fax: 512 231 6010 Email: info@pervasive.com Web: http://www.pervasive.com

Refer to the license.txt file in the default installation directory for disclaimers and information about trademarks and credits.Tutorials Manual April 2005

Contents

Contents1 Map Designer Tutorials . . . . . . . . . . . . . . . . . . . . . . . .Step-by-Step Tutorials for Learning Map Designer and Structured Schema Designer Introduction to Map Designer/Structured Schema Designer Tutorials . . . . . . . . Map Designer Tutorial 1 - The Basics . . . . . . . . . . . . . . . . . . . . . . . . . . . Goals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Requirement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Map Designer Tutorial 2 - Parsing an ASCII File. . . . . . . . . . . . . . . . . . . . . Goals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Requirement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Map Designer Tutorial 3 - Output to an Existing Target File . . . . . . . . . . . . . . Goals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Requirement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Structured Schema Designer Tutorial 4 - Using the Data Parser . . . . . . . . . . . . Goals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Requirement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Map Designer Tutorial 5 - Single-record Type File to a Multi-record Type XML File Goals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Requirement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2 1-3 1-3 1-3 1-3 1-7 1-8 1-8 1-8 1-8 1-13 1-14 1-14 1-14 1-14 1-17 1-18 1-18 1-18 1-18 1-29 1-30 1-30 1-30 1-30 1-40

1-1

2

Process Designer Tutorials . . . . . . . . . . . . . . . . . . . . . .Step-by-Step Tutorials for Learning Process Designer Introduction to Process Designer Tutorials. . . . Process Designer Tutorial 1 - The Basics . . . . . Goals . . . . . . . . . . . . . . . . . . . . . Requirement . . . . . . . . . . . . . . . . . Procedure . . . . . . . . . . . . . . . . . . . Summary . . . . . . . . . . . . . . . . . . . Process Designer Tutorial 2 - Loops and Queues. Goals . . . . . . . . . . . . . . . . . . . . . Requirement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-12-2 2-3 2-3 2-3 2-3 2-9 2-11 2-11

. . . . . . . . . . . . . . . . 2-11 1

Contents

Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

2-112-19

3

Extract Schema Designer Tutorials . . . . . . . . . . . . . . . . . .Step by Step Tutorials for Learning Extract Schema Designer Introduction to Extract Schema Designer Tutorials. User Driven Tutorials . . . . . . . . . . . . . . Tutorial 1 - The Basics . . . . . . . . . . . . . . . . . Tutorial 2 - Tagged Data and Automatic Features. . Tutorial 3 - Columnar Data . . . . . . . . . . . . . . Tutorial 4 - Floating Tags . . . . . . . . . . . . . . . Tutorial 5 - Columnar Data with a Footer . . . . . . Tutorial 6 - Variable Length Multi Line Data Fields Tutorial 7 - Multiple Accept Records. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3-13-2 3-2 3-4 3-11 3-20 3-29 3-37 3-45 3-51

2

chapter

Map Designer Tutorials

1

Step-by-Step Tutorials for Learning Map Designer and Structured Schema Designer

This chapter includes five tutorials to help you learn Map Designer and Structured Schema Designer. Tutorials 1, 2, 3 and 5 guide you through creating Transformations and Maps in Map Designer. Tutorial 4 walks you through using the Data Parser in Structured Schema Designer. This chapter includes the following sections: Introduction to Map Designer/Structured Schema Designer Tutorials on page 1-2 Map Designer Tutorial 1 - The Basics on page 1-3 Map Designer Tutorial 2 - Parsing an ASCII File on page 1-8 Map Designer Tutorial 3 - Output to an Existing Target File on page 1-14 Structured Schema Designer Tutorial 4 - Using the Data Parser on page 1-18 Map Designer Tutorial 5 - Single-record Type File to a Multirecord Type XML File on page 1-30

1-1

Map Designer Tutorials

Introduction to Map Designer/Structured Schema Designer TutorialsFive step-by-step tutorials are available to help you learn how to use Map Designer and Structured Schema Designer. The tutorials should be completed in order. Each Tutorial builds upon your knowledge as you work through them. Also, you must run Tutorial 1 to create a Target file that will be used in Tutorial 3. Map Designer Tutorial 1 - The Basics on page 1-3 Map Designer Tutorial 2 - Parsing an ASCII File on page 1-8 Map Designer Tutorial 3 - Output to an Existing Target File on page 1-14 Structured Schema Designer Tutorial 4 - Using the Data Parser on page 1-18 Map Designer Tutorial 5 - Single-record Type File to a Multirecord Type XML File on page 1-30

1-2

Map Designer Tutorial 1 - The Basics

Map Designer Tutorial 1 - The BasicsThe purpose of Tutorial 1 is to guide a new user through the basic steps necessary to create, save, and run a basic data Transformation Map in Map Designer. It will help you to become familiar with both the basic process of converting data from one application to another using Map Designer and the terms used throughout the documentation. The best way to use this tutorial is to print a hard copy so you can follow the sequential steps.Note The Target file created in Tutorial 1 will be used as the Target file in Tutorial 3, so you must run this tutorial before running Map Designer Tutorial 3 - Output to an Existing Target File on page 1-14.

Goals

In this tutorial, you will: learn the basic process of data conversion, design a simple data Transformation Map, save and run the Map, and review the Target file, and learn new terms you will encounter throughout the documentation.

Requirement Procedure

Create, save, and run a basic data Transformation Map.1

From Repository Explorer, click the down arrow beside the New icon in the toolbar and select Map to open the Map Designer window. Click the down arrow beside the Source Connection box to open the Select Connection Window. You will have a choice of three tabs in the Select Connection window: Most Recently Used, Factory Connections and User Defined Connections.

2

3 4

Click the Factory Connections tab and click ASCII (Delimited) from the list. Click OK to return to the Map Designer window. Click the down arrow next to the Source File/URI box.

1-3

Map Designer Tutorials

This will open the standard Windows navigation dialog box. The source file you will be using, Tutor1.asc, in the default installation directory \Common800.Note The default file extensions for ASCII delimited are .asc, .csv and .txt. 5

Click Tutor1.asc and then click Open. You will be taken back to the Source Connection tab and the drive, directory and filename will be visible in the Source File box.

6

Click the Source Data Browser icon to display the source file. You will see that it contains field names in the first row of data. This is the file header. You will need to change the default source properties so that Map Designer will recognize this. Close the Source Data Browser by clicking on the X button in the top right. The Source Properties options box is on the right side of the Source tab. This is where specific properties of the Source file can be set.

7 8 9

Click False next to the word Header in the Source Property options box, and then double-click to change it to True. Click Apply below the list of Property options. Click the Target Connection tab. the Select Connection window. You will have a choice of three tabs in the Select Connection window: Most Recently Used, Fa