XML Translator User Guide

 

 

BEA WebLogic XML/Non-XML Translator Overview

Understanding XML Translation

What is XML Translator?

The Design-Time Component

The Run-Time Component

Binary to XML Translation

XML to Binary Translation

Run-Time Plug-In to WebLogic Process Integrator

Post Translation Options and Considerations

Performing XML Transformation

Working with BEA WebLogic Process Integrator

Getting Started with the BEA WebLogic XML/Non-XML Translator

 

Building Format Definitions

Understanding the Data Formats Used with XML Translator

About Binary Data (Non-XML Data)

About XML Documents

About MFL Documents

Analyzing the Data to be Translated

Using the Format Builder

Starting Format Builder

Using the Format Builder Main Window

Using the Tree Pane

Using the Menu Bar

Using the Toolbar

Using the Shortcut Menus

Using Drag and Drop

Creating a Message Format

Valid Names

Creating a Group

Creating a Field

Creating a Comment

Creating References

Working with Palettes

Opening the Palette

Using the File Menu

Using the Shortcut Menu

Adding Items to the Palette

Deleting Items From the Palette

Adding Palette Items to a Message Format

Saving a Message Format to a File

Opening an Existing Message Format File

Working With the Repository

Retrieving Repository Documents

Storing Repository Documents

Setting Format Builder Options

Format Builder Menus

File Menu

Edit Menu

Insert Menu

View Menu

Repository Menu

Tools Menu

Help Menu

 

Testing Format Definitions

Starting Format Tester

Using the Format Tester Main Window

Using the Menu Bar

File Menu

Edit Menu

Display Menu

Generate Menu

Translate Menu

Using the Shortcut Menus

Using the Binary Window

Using the Data Offset Feature

Using the Escaped Text Feature

Using the Text Feature

Using the XML Window

Using the Debug Window

Using the Resize Bars

Testing Format Definitions

Debugging Format Definitions

Searching For Values

Positioning to an Offset

Using the Debug Log

 

Importing Meta Data

Importing a COBOL Copybook

COBOL Copybook Sample Files

Importing C Structures

C Struct Importer Sample Files

Starting the C Struct Importer

Understanding Hardware Profiles

Building the Hardware Profile Utility

Running the Hardware Profile Utility

Generating MFL

Generating C Code

Importing an FML Field Table Class

FML Field Table Class Importer Prerequisites

FML Field Table Class Sample Files

Creating XML with the FML Field Table Class Importer

 

Retrieving and Storing Repository Documents

Accessing the Repository

Repository Menu

Retrieving Repository Documents

Storing Repository Documents

Importing Documents into the Repository

Invoking the Batch Import Utility

Using the Repository Document Chooser

Using the Open Document Dialog Box

Using the Store Document Dialog Box

Using the Shortcut Menus

 

Using the Run-Time Component

Binary to XML

Generating XML with a Reference to a DTD

Passing in a Debug Writer

XML to Binary

Converting a Document object to Binary

Passing in a debug writer

Debug Output

XML to XML Transformation

Initialization methods

init() method

Java API Documentation

Run-Time Plug-In to WebLogic Process Integrator

 

Supported Data Types

MFL Data Types

COBOL Copybook Importer Data Types

C Structure Importer From Importing Meta Data

 

Creating Custom Data Types

User Defined Types Sample Files

Registering User Defined Types in Format Builder

Creating User Defined Types for the Stand-Alone XML Translator Engine

Configuration of User Defined Types for the Process Integrator XML Translator Plug-In

Publishing User Defined Types to the Repository from Format Builder

Publishing User Defined Types to the Repository Using the Repository Import Utility

User Defined Type Coding Requirements

Class com.bea.wlxt.bintype.Bintype

Required Interface Routines

Optional Interface Routines

Utility Interface Routines

Class com.bea.wlxt.bintype.BintypeString

Required Interface Routines

Optional Interface Routines

Utility Interface Routines

Class com.bea.wlxt.bintype.BintypeDate

Required Interface Routines

Optional Interface Routines

Utility Interface Routines

Class com.bea.wlxt.mfl.MFLField

 

Running the Purchase Order Sample

What is Included in the Purchase Order Sample

Prerequisite Considerations

Understanding the Data Formats Used with XML Translator

About Binary Data (Non-XML Data)

About XML Documents

About MFL Documents

Performing Binary to XML Translation

Analyzing the Data to be Translated

Using the Format Builder To Test the Translation

Step 1. Starting Format Builder and Creating the Message Format

Step 2. Creating Fields

Step 3. Creating Groups

Step 4. Creating a Group Reference

Step 5. Creating the Remaining Items

Step 6. Saving the Message Format

Step 7. Testing the Message Format

Performing XML to Binary Translation