Product Evaluator's Guide: Pervasive Data Integration Platform
Product Evaluator's Guide: Pervasive Data Integration Platform
Table of ConTenTs
PurPose of This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Pervasive: a ComPrehensive daTa inTeGraTion PlaTform . . . . . . . . . . . . . . . . adaPTers daTa and aPPliCaTions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Pervasive daTa inTeGraTion and soluTion delivery modes . . . . . . . . . . . . . .
4 4 6 7
IT and EnTErprIsE applIcaTIon dEvElopmEnT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 EmbEddEd daTa InTEgraTIon for on-prEmIsE applIcaTIons or saas soluTIons . . . . . . . . . . . . 7 sErvIcEs dElIvErEd by sysTEms InTEgraTors and soluTIon provIdErs . . . . . . . . . . . . . . . . . . 8
map dEsIgnEr TuTorIal crEaTIon of a basIc TransformaTIon map . . . . . . . . . . . . . . . . . 28 basIc pErvasIvE procEss dEsIgnEr TuTorIal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
overview oF Process Designer user interFace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
addiTional samPles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 TraininG and serviCes oPTions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 suPPorT for QuesTions While revieWinG The ProduCTs . . . . . . . . . . . . . . . 38
conTacT InformaTIon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
For internal systems accessed by many business users, or applications that will be expanded over time to encompass more data sources, it makes sense to use a data integration platform to create solutions. For ISVs that need data integration solutions for their applications or hosted / SaaS solutions, embedding components created by a comprehensive data integration platform is remarkably cost effective. While there is quantitative ROI for many solutions created with data integration software, there are significant qualitative cost benefits as well. The soft benefits, particularly regarding reusability and transparency of design, are often compelling enough to encourage inclusion of data integration platforms for both internal IT systems and for applications of all sorts. Data integration solutions include: Integration and synchronization of backend systems ETL for data warehouses B2B exchanges particularly for supply chain and for processing transactions for backend systems Migrations from legacy applications Extraction of data from unstructured content sources and integration with other data sources Data integration services for Service-Oriented Architecture infrastructures Profiling data sources to identify dirty data and reduce risk of inclusion in production systems Industry specific solutions for healthcare and financial services mbedded components for all of the above for on-premise applications and hosted E services/SaaS
Data Integration
Migrate
OLD Flat Files Excel Outlook Legacy Other NEW Hosted apps Packaged apps Custom apps New database Other
Business Integration
Extract
SaaS On Premise ETL ESB
Interface
CRM
Exchange
B2Bi Hub
Partners
Data Files
SAP
SaaS
SAP
SaaS
Portal Reports
Data Warehouse
EAI Intra-Company
Inter-company
Profiling
Data Integration scenarios that are addressed with Pervasives data integration platform
Access Access 97 Access 2000 Access XP Alpha Four ASCII (Delimited) ASCII (Delimited) Join ASCII (Fixed)
Clarion Clipper CLF Webserver DataEase DataFlex DJ Document Schemas DJ Log File Data dBASE II, III (III+)
dBASE IV dBASE V (IDAPI) Dialog DIF Enable Excel 95, 97 Excel 2000 Excel XP
Folio Flat File Foxbase FoxPro LDIF Lotus 1-2-3 Lotus Notes Lotus Notes 5 Lotus Notes Structured Text
Lotus Works Mac ASCII Delimited Magic PC MAILERS+4 (dBASE) Microsoft Word (Mail Merge) Paradox v5 (IDAPI) Quattro Pro Windows v5 Rich Text Format (RTF)
Unicode (Delimited) Unicode (Fixed) WordPerfect 6.0 (Mail Merge) Wordstar (Mail Merge) WordPerfect 4.2/5.0 Visual FoxPro Visual dBASE 5.5
Oracle 7.x Oracle 8.x Oracle 8.x Multimode Oracle 9i Oracle 9i Multimode Oracle 10g Oracle Direct Path Oracle SQL Loader Pervasive.SQL Pervasive.SQL v8 Pervasive.SQL v8 Multimode Pervasive PSQL v9 Pervasive PSQL v10 PostgreSQL PostgreSQL (ODBC 3.x)
Btrieve v5 Btrieve v6 Btrieve v7 Btrieve v8 CA dB-Fast C-ISAM Cloudscape CWM DB2 7.2 Univ. DB DB2 7.2 Univ. DB Multimode DB2 Loader DB2 UDB Mass Insert DB2 (ODBC) DB2 Univ. DB DB2 Univ. DB Multimode
eXcelon eXcelon XIS 3.0 Hitachi Hi-RDB IDAPI Informix DB Loader Informix (ODBC) Informix Online DS Informix/SE Ingres (ODBC 3.x) Interbase(IDAPI) JDBC MUMPS (ODBC) MySQL NonStop SQL/MX ODBC 3.x
ODBC 3.x Mass Insert ODBC 3.x Multimode ODBC 3.5 ODBC 3.5 Multimode RBase 4.5 (ODBC) Red Brick Scalable SQL SQLBase SQL Script SQL Server 6.x SQL Server 7 Mass Insert SQL Server 7 (OLEDB) Multimode SQL Server 7 (OLEDB) SQL Server 2000
SQL Server 2000 Mass Insert SQL Server 2000 Multimode SQL Server 2005 SQL Server 2005 Mass Insert SQL Server 2005 Multimode SQL Server BCP SQL Server Mass Insert SQL Server (ODBC) Sybase 11.x Sybase 11.x Mass Insert Sybase 11.x Multimode Sybase 12.x Sybase 12.x Mass Insert Sybase 12.x Multimode Sybase BCP
Sybase (ODBC) Sybase SQL Anywhere Sybase SQL Anywhere 6 Sybase SQL Mass Insert Sybase SQL 11 Sybase SQL 11 Multimode Teradata (Fastload) Velocis (ODBC 3.x) Watcom SQL v5 Watcom SQL (ODBC)
AccountMate ACT! for Windows ADABAS (NatQuery) Apache CLF Champion Acct. CYMA Acct. GoldMine
Great Plains DOS Great Plains UNIX/Mac Navision Financials Macola Acct. Market Force Microsoft Dynamics CRM Microsoft Dynamics GP
Microsoft IIS ELF NetSuite Oracle Applications Oracle Siebel CRM On Demand PayChex DJF Peachtree Acct.
Personal Librarian Pivotal CRM Platinum Acct. RealWorld Acct. Remedy ARS Sage CRM SalesLogix Sage MAS 90/200
Sales Ally Salesforce SAP IDoc SAP BAPI SAS SBT Acct. Solomon Acct.
BizTalk XML Email Email Attachments Erwin FF Queue File Transfer Builder
LDAP MSMQ (Extractor) MSMQ (Fixed ASCII) MSMQ (XML) MQSeries (Extractor) MQSeries (Fixed ASCII)
MQSeries (XML) Oracle AQ Oracle BPEL Progress Sonic ESB SGML SOAP
UB92-NSF
embedded daTa inTeGraTion for isvs WiTh on-Premise aPPliCaTions or saas soluTions
Vendors offering software solutions have many delivery mode options available to them, from traditional licensed on-premise applications to hosted and SaaS (software as a service) subscription offerings. Frequently vendor software applications and services also have serious data integration needs to deliver a complete solution to their customers, whether to migrate from legacy applications or to synchronize data with other backend systems. The customers of application vendors always consider how easily new applications will integrate into their current infrastructure, when deciding which technology solutions to buy. The solution provider who offers the best methodology will likely win the business. As Robert Anderson of Gartner Group noted, A new market is emerging that can deliver cost-effective and easy-to-use integration solutions rather than the older complex and high-priced ones that have traditionally reigned. ISVs, ASPs and integrators can deliver competitive advantage by taking advantage of embedding these solutions in their offerings.
Pervasive Data Integration provides a comprehensive solution development platform to meet the many needs for data integration within applications and services: easing migration from legacy applications, helping customers integrate applications within the enterprise, trading data in B2B exchanges, providing integration services in SOA implementations. An embedded data integration capability must be lightweight enough to fit neatly within an application, both technically and economically. Agile customer solutions demand a single embeddable and customizable integration component that addresses size, scope and the strategic nature of the integration task at hand. It must be flexible, able to respond quickly to the changes that inevitably happen. Pervasive Data Integration fulfills those requirements for application vendors of all sorts.
Suited to both large-scale production systems and smaller, project-oriented data movement tasks, Pervasive Data Integrator Professional Edition enables access to virtually any data including unstructured data. With Pervasive Data Integrator, transform data sources, then load the output into operational data stores, data warehouses, data marts or other target systems. Pervasive Data Integrator is designed to deliver a flexible solution that can automate any data movement task on an event-driven or scheduled basis.
environment allows developers to increase their productivity while solving complex integration challenges within business processes and data flows. Whether designing integration processes that tie internal business applications together or automate electronic data exchanges between trading partners, Pervasive Data Integrator Universal Edition includes numerous foundation features that simplify creating and managing flexible integration solutions. Key capabilities include: Real-time, event-driven and message-based integration Continuous integration Native connectivity Point-to-point application integration Legacy conversion Business process design Email queue for auto-notifications
10
11
Pervasive Data Profiler is available as a complementary and essential enhancement to Pervasive Data Integrator for constant monitoring of data in any size enterprise to identify data quality risks. Pervasive Data Profiler also functions as a stand-alone application that may be used with any other data management tools and development initiatives. Pervasive Data Profiler works to unlock the secrets of content to identify data that is inaccurate, incomplete or missing. The right time to find dirty data for any data-intensive projects is during project design phase. Data Profiler can be utilized continuously during project design time, and then incorporated into production processes to test data quality. Data problems identified during project design phases cost considerably less to remediate than if found later in project testing. And, of course, when bad data is carried through production processes, the cost can be tremendous: both in direct remediation costs and in loss of business due to decisions made against faulty data. Versatile and easy to use, Pervasive Data Profiler enables you to proactively audit all types of data and automate testing against ever-changing business needs and compliance regulations. It eliminates the complexity, risk, and expense associated with traditional, and usually manual, means of assessing and validating data. Assess data across multiple data platforms (150+ adapters) Quarantine questionable data until it can be cleansed, reducing rework later on. udit data formats and application sources in place without the need for intermediate A data storage. High-performance parallel processing engine allows full audits of large transactional datasets Pervasive Data Profiler enables organizations to improve internal controls, increase IT productivity, avoid costly rework, and increase ROI around applications and business processes that are only as good as the data upon which they are based.
12
Process Designer
Process Flow Logic
Data Profiler
Repository Explorer
Manage workspaces and design repositories
Map Designer
Mapping Extraction Rules Transformation
Join Designer
MANAGE
Schema Designer
Structured Schema Designer Extract Schema Designer Document Schema Designer
DJAR Files
Command Line APIs COM / JAVA / C
Integration Manager
RUNTIME
Deploy Scheduling Reporting Monitoring
Integration Engine
Scalable Embeddable Multi-Threaded Processing Scriptable Batch and transaction oriented Total coss-platform compatibility Small footprint High throughput Accepts streaming data
Integration Services
SOA Enable
Engine isolation J2EE, SOAP integration Security and authentication
Clients
SOAP JCA, RMI, MDB
Comprehensive Design Tools The Pervasive Integrated Development Environment (IDE) supplies developers with the design tools they need to build effective multi-step integration processes and data transformations accessing hundreds of data sources and targets. Design Repository for Management and Deployment The repository is an open, XML-based file system that a developer uses to track and store work across multiple projects. A variety of user interfaces assist developers with access to the design repository. Data Analysis Pervasive Data Profiler is essential for auditing all data sources to identify dirty data in order to effect recommendations for remediation and risk management before those data sources enter production systems in the enterprise. Runtime Engines for Production and Testing Runtime engines provide the processing power to execute maps and processes created by devRuntime engines provide the processing power to execute maps and processes created by developers, independent of the design environment for automated production purposes. Engines may be run locally for quick access to view data and test designs. In production, engines may be deployed to support configurations for scaling, distributed architectures and embedding. Integration Services for Service-Oriented Architectures and Web services
13
Process Designer Message Component Framework Message Component Framework (MCF) provides a uniform runtime environment for message components. This environment provides some basic services for components to use during execution. The environment is also responsible for the management of the component lifecycle and for the invocation of component actions.
14
Ultimately, the framework simplifies the job of the component writer by eliminating some of the component and message object management issues. Components are invaluable to developers, systems integrators and solution providers as a quick method to create reusable services for data integration projects. Component Types: Component
Aggregator Invoker Iterator Queue Transformer Validator
DesCription
Builds a complex message object from a collection of simpler message objects. Provides an adaptor for external application interfaces. Iterate over a logical collection of messages. Provides connectivity to a message channel. Transform a message object. Validate a message object.
Pervasive Map Designer Pervasive Map Designer is a powerful data transformation designer, providing a visually appealing user interface and Wizards for increased simplicity. The XML-based underpinnings that define an integration process allow substantially more re-use by separating Map objects, such as sources and targets, into discrete objects promoting greatly enhanced reusability in medium to large-scale production environments. Visually control data flow within any transformation regardless of complexity Define rules for mapping complex hierarchical structures such as EDI and XML data Debug transformations on the fly Utilize popular transport protocols such as HTTP, FTP/SFTP and TCP ntegrate with message queues (IBM WebSphere, MSMQ and any JMS compliant message queue) I
Pervasive Map Designers tools put the power of transformation at a developers fingertips.
Product Evaluators Guide
15
The GUI-based Expression Builder is used to quickly build Real-Time Integration Flow Language (RiFL)
16
Metadata Designers: Pervasives Structured Schema Designer, Document Schema Designer, and Extract Schema Designer Metadata plays a key role in data integration projects. Applying the correct metadata is every bit as important as the connecting to the data itself. How well a data integration platform handles metadata challenges should be given strong consideration when selecting a solution. Multiple metadata designers are provided with the Pervasive Data Integration design environment, including the Pervasive Structured Schema Designer for parsing legacy data and flat files, the Pervasive Document Schema Designer for standardized business-to-business data message formats such as EDI, and the Pervasive Extract Schema Designer for accessing data in unstructured content. All metadata designs may be saved and reused. Pervasive Structured Schema Designer The Structured Schema Designer provides a visual interface for creating, saving and manipulating metadata schema definitions for structured data sources, such as legacy data and flat files. The resulting metadata schemas are stored as XML-based structured schema documents that include schema, record recognition rules and record validation rule information. With the Structured Schema Designer you can arrange field order, assign field names and type, and specify data size. Visually define and adjust all record and field properties Parse binary data record structures and define field length, data type, offsets, and more Create an external metadata definition from any data format
Pervasive Structured Schema Designer provides the flexible structure to visually interpret and manipulate standard and proprietary message formats.
17
Pervasive Document Schema Designer The Document Schema Designer gives you a graphical interface for the definition of metadata for data exchange formats, in support of trading partner agreements and industry standards. Standard data exchange formats involve information traded between two or more enterprises (B2B) for purposes such as Supply Chain transactions or insurance claims. Industry standards include commerce-based EDI, industry-specific XML formats, HIPAA EDI, HL7, and ACORD XML. The modification and creation of metadata schemas in the Document Schema Designer gives tight control over data transformations involving B2B data exchanges. ignificantly reduces time and effort to define and modify complex hierarchical document structures S llows the creation of document structures for many standards, including EDI, EDIFACT, SWIFT, A FIXML, TRADACOMS, HIPAA, HCFA 1500, UB92, HL7 nables selection of specific segments and elements to adjust all properties, references and E code tables to define the precise document structure needed for a trading partner enerates a validation rule set for ensuring that messages received in the format are structurally G correct to prevent data quality and non-compliance problems between B2B trading partners
Pervasive Document Schema Designer provides the flexible structure to visually interpret and manipulate standard and proprietary message formats.
18
Pervasive Extract Schema Designer Content management has become an important initiative in many enterprises, with the explosion of data and information across the enterprise on a daily basis. It is critical that enterprises are enabled to access, manage, and control all data, whether in structured or unstructured sources. The Extract Schema Designer is a unique tool exclusive to the Pervasive Data Integration Platform for gaining access to unstructured content as part of data integration and content management solutions. The Extract Schema Designer works with content-oriented sources such as email, report data, HTML, print data or any other raw text. Visual interface for rapid creation of extraction routines that are reusable Integrates with Pervasive Map Designer for inclusion in more complex data integration projects ateway to incorporation of valuable data such as email and Internet content into the data G integration projects to include all relevant data sources ccessible to business users to create extraction routines, eliminating expense and reliance on A skilled IT staff and outside consultants to manually write coded routines elf-documenting visual designer ensures that extraction routines are maintainable and S adjustable through future maintenance cycles
19
Pervasive Join Designer allows users to join two or more single-record data sources prior to running a Map Designer transformation on them.
20
Design Tools
Metadata Interfaces
OPEN METADATA ACCESS & MANAGEMENT
Process Designer
ip.xml .rifl
Map Designer
map.xml Field mapping spec Transformation spec tf.xml sc.xml tc.xml Source spec Target spec Unstructured text extraction schema Structured schema Document schema Document schema codeset Document segment library Document field library Document code library
3rd Party Designers, UIs, Programs, Web Services JAVA, VB, C++, PERL Import/Upgrade from Competitors Metadata Exchange XML, XMI, XIF, CWMI etc.
Schema Designers
Extract Schema Designer Visual Parser Structured Schema Designer Document Schema Designer (EDI, HIPAA, SWIFT etc.)
21
22
HR
BUSINESS INTEGRATION
Message Integration Message Bus/SOA
CRM (SaaS)
ERP (SaaS)
B2Bi Hub
Pricing
File Transfer FTPq21
ETL
REMOTE OFFICES
WWW
Supplier Portal
Data Mart
Web Content
Data Warehouse
BI Tools
Old Acctg
Migration
New Acctg
COBOL
Conversion
Data Replication
Oracle Database
DATA MIGRATION
= Pervasive Integration Engine
Potential deployment options with Pervasives Integration Engine distributed or centralized, supporting incremental adoption of a complete platform
23
24
inTeGraTion serviCes
Pervasive Data Integration solutions may be deployed via services in a variety of ways depending on customer requirements (see diagram below) from a single, lightweight embedded engine to a distributed, fully managed set of Service Oriented Architecture (SOA) adapters. When deploying in SOA environments there are several communication mechanisms that work in conjunction with J2EE application servers. Collectively, the capabilities below are called the Integration Services SDK: purpose-built Message Driven Bean (MDB) that is configured to listen on a JMS queue for A the input message, then invoke a specific integration specification via the Integration Server. The Integration Server, in turn, will find an available Integration Engine on the local server and invoke the desired integration specification and return the results JCA RA for synchronous invocation of integration specs via the Integration Server (as above) A A Java API for synchronous invocation of integration specs via the Integration Server (as above) n HTTP WS-I compliant services interface to the Integration Server to accept SOAP A invocations from any application (not only J2EE)
Synchronous
Integration Server
Synchronous COARSE-GRAINED
Input Message
BUS
Lossely-Coupled Asynchronous
OutputMessage
(Message Documents)
MCB
Integration Manager
Integration Engines
SOAP INVOCATION
FINE-GRAINED
Tightly Coupled Synchronous
BUSINESS FILES T1
(API - Methods/Calls)
INTERFACE
APPLICATION LAYER
PutMsg
Database Connections (SQL, ODBC 2.x, 3.x, IDAPU, Pervasive SQL, etc.) File Format Connectors (ASCII, Binary, Unicode, XML, etc.) Native API Connectors (COBOL, iSAMs, etc.) DBMB Bulk Lead Connectors
T2 T2
T4
DATA LAYER
25
Adapters For runtime, the Integration Engines support more than 150 factory-supplied adapters. Most of the Pervasive data adapters have been written to take advantage of native APIs and industry standards. Many of the adapters are available for multiple platforms. Database adapters support a range of modes from client/server access, local database access, multimode where a single data stream can be rapidly spread across multiple tables in a target database, and mass-insert for high-speed bulk loading of data.
Access Access 97 Access 2000 Access XP Alpha Four ASCII (Delimited) ASCII (Delimited) Join ASCII (Fixed)
Clarion Clipper CLF Webserver DataEase DataFlex DJ Document Schemas DJ Log File Data dBASE II, III III+, IV, V, (IDAPI)
Dialog DIF Enable Excel 95, 97 Excel 2000 Excel XP Folio Flat File Foxbase
FoxPro LDIF Lotus 1-2-3 Lotus Notes Lotus Notes 5 Lotus Notes Structured Text Lotus Works Mac ASCII Delimited
Magic PC MAILERS+4 (dBASE) Microsoft Word (Mail Merge) Paradox v5 (IDAPI) Quattro Pro Windows v5 Rich Text Format (RTF) Unicode (Delimited) Unicode (Fixed)
WordPerfect 6.0 (Mail Merge) Wordstar (Mail Merge) WordPerfect 4.2/5.0 Visual FoxPro Visual dBASE 5.5
Oracle 7, 8, 9i, 10g, 11g Oracle 7, 8, 9i, 10g, 11g Multimode Oracle Direct Path Oracle SQL Loader Pervasive.SQL 8, 9, 10 Pervasive.SQL 8, 9, 10 Multimode PostgreSQL PostgreSQL (ODBC 3.x) Btrieve 5, 6, 7, 8
CA dB-Fast C-ISAM Cloudscape CWM DB2 7.2, 9.5 UDB DB2 7.2, 9.5 UDB Multimode DB2 Loader DB2 UDB Mass Insert DB2 (ODBC) eXcelon, eXcelon XIS 3 Hitachi Hi-RDB
IDAPI Informix DB Loader Informix (ODBC) Informix Online DS Informix/SE Ingres (ODBC 3.x) Interbase (IDAPI) JDBC MUMPS (ODBC) MySQL NonStop SQL/MX
ODBC 3.5 ODBC 3.5 Mass Insert ODBC 3.5 Multimode RBase 4.5 (ODBC) Red Brick Scalable SQL SQLBase SQL Script SQL Server 6, 7, 2000, 2005 SQL Server 6, 7, 2000, 2005 Mass Insert
SQL Server BCP SQL Server Mass Insert SQL Server (ODBC) Sybase 11, 12 Sybase 11, 12 Mass Insert Sybase 11, 12 Multimode Sybase BCP Sybase (ODBC) Sybase SQL Anywhere Sybase SQL Anywhere 6 Sybase SQL Mass Insert
Sybase SQL 11 Sybase SQL 11 Multimode Teradata (Fastload) Velocis (ODBC 3.x) Watcom SQL v5 Watcom SQL (ODBC)
AccountMate ACT! for Windows ADABAS (NatQuery) Apache CLF Champion Acct. CYMA Acct. GoldMine
Great Plains DOS Great Plains UNIX/Mac Navision Financials Macola Acct. Market Force Microsoft Dynamics CRM 4 Microsoft Dynamics GP 9, 10
Microsoft IIS ELF NetSuite Oracle Applications Oracle Siebel CRM On Demand PayChex DJF Peachtree Acct.
Personal Librarian Pivotal CRM Platinum Acct. RealWorld Acct. RightNow Sage CRM SalesLogix Sage MAS 90/200
Sales Ally Salesforce SAP BAPI, IDoc, EAA SAS SBT Acct. Solomon Acct. SPLUS
TRADACOM UB92-NSF
10
26
(1) Connect to a Source Pervasive Map Designer comes with three main tabs, the first of which is used to handle all connectivity options to the data source for the transformation design. Depending on the Integration product you are evaluating, you have a choice between numerous native connectors to legacy and modern databases, flat files, and directly to many applications. Once connected, you can freely browse the source data at any time to assist with the transformation process. (2) Connect to a Target The second tab is used to handle all connectivity to the target destination. Again, numerous connectors are available for writing the transformed data to your target database, file, message format, etc. Depending on the options selected in this tab, the
Product Evaluators Guide
27
transformation can replace data in a target, append data, delete all data and reload. Also, for database targets, parent-child relationships can be maintained by using Pervasive multi-mode connectors that load data in more than one table in a database. (3) Create the Map Once the Source and Target are defined and connected, the Map tab is where the data transformation is designed. Field structures are displayed for source and target data and a simple drag and drop of source fields to the target is all that is needed for a simple pass through transformation. From there, the Map tab includes a rich set of event actions and transformation scripting options to handle everything from error trapping to validation to complex transformation and flow logic using the Real-Time Integration Flow Language (RiFL) built into the product for scripting. The screen image below shows the map tab with the source data fields at the top and the target fields at the bottom
NOTE: The usual default file extensions for ASCII delimited are .asc, .csv and .txt. 4. lick on Tutor1.asc and then click the Open button. You will be taken back to the Source C Connection tab and the drive, directory and filename will be visible in the Source File box. If a dialog box displays with a File Sample Size message, click OK to close it.
28
5. lick on the Source Data Browser icon C to display the source file. You will see that it contains field names in the first row of data. This is the file header. Close the Source Data Browser by clicking on the X button in the top right. 6. he Source Properties options box is on the right side of the Source tab. This is where specific T properties of the Source file can be set. Click on the word False next to the word Header in the Source Property options box, and then double-click to change it to True.
7. lick the Apply button below the list of Property Options. C 8. lick on the Target Connection tab. C 9. lick the down arrow next to the Target Connection box to open the Select Connection window. C 10. ou will have a choice of three tabs in the Select Connection window: Most Recently Used, Y Factory Connections and User Defined Connections. Select the Factory Connections tab. 11. elect dBASE IV from the list. Click the OK button to return to the Map Designer window. S 12. lick the down arrow to the right of the Target File/URI box. This opens the standard C Windows navigation dialog box. The default file extension will appear in the File Name box (in this case, .dbf). Replace the asterisk (*) with Tutor1 and click Open. 13. he Connect button should be grayed out at this point indicating a connection to the target T has been made. If the Connect button is not grayed out, then click on the Connect button to connect to the target. The Output Mode will default to Replace File/Table when you are creating a new Target file. This output mode will create a new file or replace any existing file of this name in this directory. 14. lick the Map tab. C 15. he Map tab displays three main panes on the upper half of the window. The upper left pane T shows the fields associated with each Source Record type. The tree opens already expanded and the fields for record type R1 are highlighted. The upper middle pane contains a grid showing the fields associated with each Target Record type. And the upper right pane shows the Events / Actions for mapping from Source to Target Drag-and-Drop functionality: 16. n the upper left grid, locate the box that contains an asterisk (*) next to the cell that says I <all fields>. This asterisk represents the layout of all fields in the Source File and acts as a shortcut to duplicate the entire Source Schema in the Target file. Click on this cell and hold down on the mouse button. 17. rag the cursor to the middle grid for the Target. The cursor will change to a black rectangle D when it is over a cell in which the selected file information can be inserted. Release the mouse button when the cursor is in the first cell of the middle grid. 18. ince dBASE does not allow lowercase letters or spaces in field names, an Invalid Field Name S dialog box will appear. Map Designer will offer to fix the problem in various ways. The default
Product Evaluators Guide
29
is to automatically create valid field names based on the Source field name for all invalid fields. 19. Click the OK button on the Invalid Field Names dialog box. 20. fter you click the OK button, all the lowercase letters will change to uppercase and spaces A will change to underscores for the Target field names. The Target Field Expression column will be filled with the Source field names in appropriate notation for mapping expressions to a dBase file. 21. or transformations that have only one record type, after you map your fields, a ClearMapPut F Record action is automatically added to the AfterEveryRecord event in the Source Events / Actions grid, so your transformation is ready to run. For most other transformations, you will set up the necessary event actions as appropriate for each transformation definition. 22. ClearMapPut Record is the most commonly used action in a transformation. The ClearMapPut Record combines the actions of: 1clearing the memory buffer of previous contents (usually previously read record), 2mapping the Source data to the Target data structure, and 3writing the record to the Target file or table specified. You have now completed the three basic transformation steps. 23. lick the Save Map icon in the toolbar. C 24. his will open the Save As dialog box in which you are prompted for a Save Location. This T will default to your Workspace, but you should verify the location prior to saving the map and change it if needed. Maps default to the document type .map.xml. 25. ype a document name to replace map1 in the text box and click Save. Your T transformation is saved. 26. lick on the Validate Map C icon in the toolbar. The Map should validate correctly. 27. Click the Run Map icon in the toolbar. 28. ap Designer will load all the information it needs to run this transformation and then execute M it. You will see a gauge quickly flash on the screen as the transformation progresses. A counter will estimate the number of records converted. When the transformation is finished, the total number of records read and the number converted will be displayed in the status bar at the lower left of screen display. 29. lick the Target Data Browser icon C in the tool bar to view the new dBASE IV file. This will open a new window in which you can view and browse the dBASE IV file just created. 30. fter viewing the dBASE file, close the browser by clicking the X button in the upper right A corner. 31. Close Map Designer by clicking the X button in the upper right corner. You will be back in the Repository Explorer, where you will see the Map you just created in the Repository Documents list in the right panel. If you do not see the new map, click on your workspace repository in the left panel tree structure. Congratulations, you have just created, validated, saved and run your first Map using Pervasive Map Designer!
30
(1) Process Design Canvas This area is blank (except for Start and Stop steps) when designing a new process, but later contains all the process elements in a saved process design. The above example shows a completed process design that includes queues set up to collect data exchange messages (EDI or HIPAA, for example), a looping structure to continue monitoring the queue and a transformation set up to utilize newly received messages. It also contains branching logic nodes that can route a process down one or more paths depending on logic parameters. (2) Process Design Icon Palette All the items on this palette may be dropped onto the canvas and then built out to create a simple or complex integration process or workflow. Once on the canvas, the process design icons will be customized by adjusting their properties to enact the specifics needed for each step in the process flow. Process Designer Tutorial Creation of a Basic Process This step-by-step tutorial is available to assist learning how to use the Process Designer and will introduce the graphical interface and the drag-and-drop method of creating processes. The best way to use this tutorial is to print a hard copy so the sequential steps can be easily followed. It is assumed that the evaluator or user has familiarity with the Map Designer and has worked through the basic Map Designer Tutorial in this document before taking on Process Designer, and that the introduction to the Process Designer has been reviewed.
31
Task Create a process that will run once a day, including a transformation, but if it is a Sunday additional routines will also be run. For this tutorial, the transformation and the Sunday routines are not actually included. Instead, comment boxes are used to enable the running of the process as part of this tutorial. As an additional exercise, a transformation may be created using the sample data in the Map Designer Tutorial and added to the process for this tutorial. Procedure 1. rom the Repository Explorer, click on the down arrow beside the New icon in the toolbar and F select Process to open the Process Designer window. A Process Canvas is displayed showing Start and Stop steps. Every process must have one start and one stop step. 2. Per previous presentations, move after Scripting step icon. Click once on the Scripting step icon on the Process Step Bar and move the cursor over the canvas. Position the cursor below the Start step and click the left mouse button. A Script step will be displayed in this position. You can drag a step around the canvas by left-clicking the cursor on it, holding the button down and moving the step around. 3. ouble-click on this step on the canvas to open the Scripting step Properties window. D 4. Rename the step Run Daily Transformation in the Name property. 5. Click on the Expression field and type: MsgBox(Run Daily Transformation)
Note: See the help topics for the MsgBox() function if you are not familiar with its use.
6. Click on the OK button to close the Scripting Properties window. 7. Click on the Decision step icon on the Process Step Bar, position the cursor beneath the Script step and click the left mouse button again. A Conditional Decision step will be displayed.
8. Double-click on the icon on the canvas to open the Decision step Properties window. 9. Rename the step Is it Sunday? in the Name property. You now need to create a condition that will be TRUE if this procedure is run on a Sunday and FALSE on any other day. The condition will be built in the Expression property box using a VB-like scripting language called RiFL (Realtime Integration Flow Language) implemented by Pervasive for data integration tasks. 10. lick on the Expression property and type: C DatePart(w,Now())=1
Note: See the help topics for the DatePart() and Now() functions if you are not familiar with these.
11. Click OK button to close the Decision step Properties Window. 12. Create another Scripting step, this time to the right of the Decision step. 13. Double-click on this step to open the Scripting step Properties window. 14. Rename the step Sunday Only Routines in the Name property. 15. Click on the Expression property and type: MsgBox(Sunday Only Routines)
Note: See the help topics for the MsgBox() function if you are not familiar with its use.
32
00. Now link the steps to show the sequence in which they must be run. 17. lick on the Link icon and move the cursor over the Start step. The cursor will appear as C when it is over the canvas and when it is over a step. 18. lick on the Start step. Now move the cursor to the Run Daily Transformation function C step. Again the cursor will appear as until it is over a step, when it will appear as . 19. lick on the Run Daily Transformation step. An arrow will now appear linking these steps C in the order they are to be performed. Note that the cursor is still showing as . This is so that you can link all your steps without having to repeatedly return to the Process icon bar. 20. Create a link from Run Daily Transformation to Is it Sunday? in the same way. 21. reate a link from Is it Sunday? to the Sunday Only Routines function step. In this case C the following dialog box will be displayed:
22. elect True. This shows that this is the path to follow if the condition specified in the Is it S Sunday? evaluates as TRUE. 23. reate a link from Is it Sunday? to the Sunday Only Routines function step to the Stop C step. Again the Decision dialog box is displayed. Select False.
33
24. inally create a link from Sunday Only Routines to Stop. F Your diagram should now look something like this:
25. Validate the process click on 26. o run the process, click on the T following will appear:
in the tool bar. The process should validate correctly. button. If everything has been set up correctly the
27. his shows the Run Process dialog that displays details of the Process as it goes through T each step. In this case the RiFL Script MsgBox shows that it has reached the Run Daily Transformation step. (In a real-world example a transformation would be carried out at this point and the process would not be stopped.)
34
28. lick OK button to continue. C The following shows the completed process if run during the week:
28. The following shows the completed process when run on a Sunday:
Congratulations, you now have mastered the fundamental process and map design skills needed to evaluate the product.
35
Map Designer To find additional information, tutorials and samples, go to the in-product Help Menu. Then select one of the following: Contents, Tutorials, Samples. Map Designer Tutorials List utorial 1 shows you the basics of how to transform predefined source data to a new target file T utorial 2 shows you how to define fields in a fixed ASCII source file and transform the data to a T new target file Tutorial 3 shows you how to append source data to an existing target file utorial 5 shows you how to transform data where the source is a single-record type and the T target is a multi-record type XML file. This tutorial is particularly useful for learning how to use the event handlers Note For all of the above Map Designer tutorials, see Transformation and Schema Tutorials on page 1-1 in the Tutorials Reference.
Process Designer To find additional information, tutorials and samples, go to the in-product Help Menu. Then select one of the following: Help Topics, Tutorials, Samples. Process Designer Tutorials List tep-by-Step Tutorial for Learning Process Designer: Process Designer Tutorial - The Basics S
Extract Schema Designer When this designer is first opened, a dialog displays to invite evaluators and new users to learn more about Extract Schema Designer. Click on the button for Learn More About Extract Schema Designer to begin the tutorials. You may also access the tutorials through the in-product Help Menu, Contents, then Getting Started with Extract Schema Designer. Extract Schema Designer Tutorials List Step-by-Step Tutorials for Learning Extract Schema Designer Extract Schema Tutorial 1 - The Basics Extract Schema Tutorial 2 - Tagged Data and Automatic Features Extract Schema Tutorial 3 - Columnar Data Extract Schema Tutorial 4 - Floating Tags Extract Schema Tutorial 5 - Columnar Data with a Footer Extract Schema Tutorial 6 - Variable Length Multi Line Data Fields Extract Schema Tutorial 7 - Multiple Accept Records
36
addiTional samPles
Data integration project scenario samples are provided with the products to illustrate real-world uses. Pervasive Data Integrator must be installed to work with the samples. To find the samples, open Map Designer or Process Designer, go to the Help Menu in the Toolbar and select Samples then follow instructions. Basic Samples 1. Using Conditional Put Actions with Event Handlers 2. Filtering Source Data 3. Sorting Source Data 4. Standardizing Multiple Date Formats 5. Writing Reject Records to a File 6. Using DJX to Pass Variables to a SQL Stored Procedure Intermediate Samples 7. Using Global Variables in Transformations 8. Using the FileList Function in a Process 9. Mapping from One Record Type to Many 10. Mapping Database Records to EDI 11. Setting OnDataChange Events 12. Using Buffered Put Tree to Create Hierarchical Records 13. Handling Errors in a File Folder Queue Process Advanced Samples 14 Aggregating Records 15 Manipulating Binary Dates at the Bit Level 16 Complex Date Filtering 17 Working with DJRowSet and Arrays 18 Dynamic SQL Lookup 19 Dynamic SQL Lookup with Error Handling 20 Dynamic SQL Lookup with Reject Records Handling 21 Using EDI X12 Batch Transaction Iterator to Read Messages 22 Mapping Two Joined Source Types to a Target 23 Listening for Messages with File Folder Queue (FFQ) 24 eb Service Invoker W Web Service Invoker Message Component Framework - for Process Designer (see Process Designer Help Contents: Sessions Types, Invoker Sessions and the Message Component Framework (MCF) Users Guide.)
37
38
Contact Information Pervasive Software Inc. 12365-B Riata Trace Parkway Austin, Texas 78727 United States 800.287.4383 512.231.6000 Fax: 512.231.6010 [email protected] EMEAA +800.1212.3434 [email protected] http://www.pervasiveintegration.com
2009 Pervasive Software Inc. All rights reserved. All Pervasive brand and product names are trademarks or registered trademarks of Pervasive Software Inc. in the United States and other countries. Windows Vista is either a registered trademark or trademark of Microsoft Corporation in the United States and/or other countries. All other marks are the property of their respective owners.
39
PN0607H10