Conversion AgentLocate this document in the navigation structure

Purpose

SAP Conversion Agent by Informatica is a data conversion system that enables you to create interfaces between any data formats and XML-based systems. The Conversion Agent can convert unstructured, semi-structured, and structured formats to XML, and the other way around.

The Conversion Agent comprises the Conversion Agent Studio and the Conversion Agent Engine. In the Conversion Agent Studio you can develop and configure data conversions. The Conversion Agent Engine executes the data conversions.

Conversion Agent in Process Integration

In Process Integration you can call the Conversion Agent by using an adapter module. For this purpose, you must integrate this module in the module processor of your adapter. Only use Conversion Agent with the SAP adapters of the Adapter-Engine.

The module in the sender adapter uses a data conversion statement to call the Conversion Agent Engine and it then receives the converted XML document. In a receiver adapter the source format is XML.

Note

For current information and FAQs for the Conversion Agent, see SAP Note 894815.

Features

For information about installing the Conversion Agent, see Deploying and Using Conversion Agent and Getting Started with Conversion Agent.

If you want to use data transformations in Process Integration, you must perform the following steps once you have installed the Conversion Agent:

  1. Define your data transformation in the Conversion Agent Studio.

    More information: Getting Started with Conversion Agent

  2. Configure a communication channel within your integration scenario.

    For more information, see the documentation about the Integration Directory in the chapter Defining Communication Channels.

  3. In the adapter configuration under Modules, integrate the adapter module CMTransformModule in the adapter type for your communication channel.
    • Under Parameter Name in the Module Configuration, enter the name TransformationName, and under Parameter Value, enter the name of the data transformation you defined.
    • The document to be converted must be in the main payload of the message.
    • If the document to be converted is in an attachment, you can use the PayloadSwapBean module to exchange the payloads.

      For more information, see the documentation about the Advanced Adapter Engine in chapter Inserting PayloadSwapBean in Module Processor

    • The adapter module can be integrated in all adapters that can be enhanced with additional modules (for example, the SOAP adapter or mail adapter).

    For more information about integrating an adapter module, see Deploying and Using Conversion Agent

    For more information on integrating modules in an adapter, see the documentation on the Advanced Adapter Engine in the chapter Inserting Modules in the Module Processor.

    For more information on enhancing the module processor, see the documentation on the Advanced Adapter Engine in the chapter Enhancing the Module Chain for SAP Adapter in the Module Processor.

Getting Started with the Conversion Agent

To quickly get up to speed with the SAP NetWeaver Conversion Agent, read the following documentation:

Document Name Content

Conversion Agent bereitstellen und verwenden (German)

Deploying and Using Conversion Agent (English)

Contains detailed information about how you can use the Conversion Agent in SAP NetWeaver. It also includes a description of how to deploy the adapter module for calling the Conversion Agent Engine.

Erste Schritte mit Conversion Agent (German)

Getting Started with Conversion Agent (English)

Uses exercises to introduce you to Conversion Agent Studio.

Also contains short installation instructions.

Conversion Agent Guides

The following guides are available:

Document Name Content

Conversion Agent Handbuch für Administratoren (German)

Conversion Agent Administrator Guide (English)

Contains information on the following topics:

  • Installing the Conversion Agent Studio
  • Updating Conversion Agent projects
  • Configuration Editor
  • Administration and Deployment - Guidelines, Security, Troubleshooting

This editor enables you to configure the parameters of an existing Conversion Agent installation.

Conversion Agent Studio Benutzerhandbuch (German)

Conversion Agent Studio User Guide (English)

Contains a description of all functions of the Conversion Agent Studio.

Conversion Agent Engine Entwicklerhandbuch (German)

Conversion Agent Engine Developer Guide (English)

Contains information about how you enable transformations defined in the Conversion Agent Studio to be executed by the Conversion Agent Engine.

More Information

Document Name Content

Conversion Agent-Bibliotheken (German)

Conversion Agent Libraries (English)

Contains information about the libraries shipped by the industry standards AL3 (insurance sector), EDI (Electronic Data Interchange), HIPAA (United States Health Insurance Portability and Accountability Act), HL7 (Health Level 7), and SWIFT (Society for Worldwide Interbank Financial Telecommunication).

Verwenden von Conversion Agent Studio für Eclipse (German)

Using Conversion Agent Studio in Eclipse (English)

Contains information about using the Conversion Agent in the Eclipse environment.

Conversion Agent COM-API-Referenz (German)

Conversion Agent COM API Reference (English)

Contains information about how you can execute a Conversion Agent service by using a Conversion Agent COM API.

Verarbeiten von COBOLDaten in Conversion Agent (German)

Processing COBOL Data in Conversion Agent (English)

Contains information about converting COBOL data to XML and the other way around.

Neuerungen in Conversion Agent (German)

What’s New in Conversion Agent (English)