320 likes | 763 Views
Overview: Transformation Maps. Understanding Transformation Maps Mapping Tool Database Connectivity Work with Transformation Maps Transformation Map Details Load IBM i File Definitions Objective: To understand the use of Transformation Maps and the Mapping Tool. Transformation Maps.
E N D
Overview: Transformation Maps • Understanding Transformation Maps • Mapping Tool • Database Connectivity • Work with Transformation Maps • Transformation Map Details • Load IBM i File Definitions Objective: To understand the use of Transformation Maps and the Mapping Tool
Transformation Maps • Enables powerful visual mapping • Defines how to transform or map data between disparate formats: • XML documents • EDI documents • Text files (for example, comma-separated values) • Web service functions • wide range of databases, including IBM DB2 Universal Database for IBM i
Understanding Transformation Maps and Mapping Tool • Altova MapForce included for defining transformations. • For editing, MapForce provides LANSA Composer with the mapping tools to visually define connections between source and target components. • For preparation, LANSA Composer invokes MapForce to generate Java code for the map, and then LANSA Composer compiles the code. • When a Processing Sequence executes the Transformation Maps, it invokes the generated and compiled Java code via a LANSA Integrator service. • No Altova software is required at run-time.
Database Connectivity • Design time (Client): Must establish two types of database connectivity for use with the mapping tool: • ODBC or ADO connection from the LANSA Composer client computer running MapForce • JDBC connection from the LANSA Composer server computer. • Execution time (Server): Generated Java uses JDBC database connectivity - initiated from the server on which the transformation map executes. • Your responsibility to obtain, install and correctly configure database connectivity of components on client and server – usually from database vendor.
Work with Transformation Maps • Filter Transformation Maps • Create or Copy a Transformation Map • Delete a Transformation Map • Review or Change a Transformation Map • Review Transformation Map Parameters • Display where a Transformation Map is used • Transformation Map Details • In addition, as with other such as activities, configurations and processing sequences, you can: • Define or Review Notes • Review Audit Details.
Transformation Map Details • The details consist of basic identification and status information
Edit Transformation Map (1) • Edit transformation map uses the MapForce mapping tool • Windows must be logged into IBM i server to edit maps
Edit Transformation Map (2) • MapForce is not designed exclusively for use with LANSA Composer • Refer to Composer documentation for supported functions
Edit Transformation Map (3) • Insert source and target components • Try to use “universal” paths and connectivity so the map definition can be opened unchanged by other LANSA Composer users
Define Database Connection #1 • DB/2 Example
Define Database Connection #2 • To define a new connection
Define Database Connection #3 • Define ODBC Connection Any unique Name and suitable Description IBM i server name (domain name)
Define Database Connection #4 Connection Options
Define Database Connection #5 • Connect to DB/2 Database
Define Database Connection #6 • Select Tables/Views to Insert Select library from dropdown Select file(s) Preview available
Edit Transformation Map • Connect data items between source and target components:
Edit Transformation Map • Connect data items between source and target components: • Some connections affect when data is output
Prepare Transformation Map • Prepare transformation map for use in LANSA Composer processing sequence
Prepare Transformation Map • What does Prepare do? • Generates Java code • Compiles generated Java code • Jar file placed into map folder in JSM instance. e.g. • /LANSA_k12pgmlib/jsm/instance/composer/LIC/map(where LIC = partition) • Determines parameters required • e.g.: path to XML or text file • e.g.: database configuration to connect to source or target database
Execute Transformation Map • Combine transformation maps with other activities and processing directives in a Processing Sequence
Execute Transformation Map • Add transformationmap to processingsequence • Provide values for transformation map parameters • Variables or literals
Run Transformation Map • Map may be run independently • Useful for testing
Setup Database Configuration • When Transform used with a Processing Sequence: • Executed on server • Uses the generated JAR file • Uses JDBC to connect to database tables • Needs a Database Configuration
Setup Database Configuration Your IBM i server name and library name
Exercise: LIC003 Transformation Map • Create a Transformation Map