Version 9 Release 2 A Guide to Graphical Data Mapping in IBM Integration Bus
Version 9 Release 2 A Guide to Graphical Data Mapping in IBM Integration Bus Note Before using this information and the product it supports, read the information in “Notices” on page 341. When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. © Copyright IBM Corporation 2014. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Chapter 1. Using message maps . . . . 1 Chapter 2. Graphical Mapping overview 3 Graphical Data Mapping editor . . . . . . . . 5 Message maps . . . . . . . . . . . . . . 7 Submaps . . . . . . . . . . . . . . . 10 Guidelines for developing reusable graphical data mapping assets . . . . . . . . . . . . . 13 Considerations for mapping messages modeled in message sets . . . . . . . . . . . . . . 13 Chapter 3. Designing a message map 15 Input and output messages to a message map . . . 17 Advanced XML schema structures valid in input and output messages . . . . . . . . . . . 18 Substitution groups. . . . . . . . . . . 19 Wildcards (xsd:any) . . . . . . . . . . 19 Derived types . . . . . . . . . . . . 19 List types (xs:list). . . . . . . . . . . 20 Union types (xs:union) . . . . . . . . . 20 Chapter 4. Transforms (Mapping operations) . . . . . . . . . . . . . 21 Choosing a transform to set the value of a simple type output element . . . . . . . . . . . 23 Choosing a transform to set the value of a complex output element . . . . . . . . . . . . . 25 Choosing a transform to map repeating elements. . 27 Selecting the indexes of input array elements . . 28 Choosing a transform to concatenate input data . . 29 Choosing a transform to perform an arithmetic operation . . . . . . . . . . . . . . . 31 Choosing a transform to define a conditional mapping . . . . . . . . . . . . . . . 31 Choosing a transform to map an input message to multiple output messages . . . . . . . . . 32 Chapter 5. Handling nulls in message maps . . . . . . . . . . . . . . . 35 Chapter 6. Using nested maps . . . . 37 Chapter 7. Configuring your workspace mapping preferences . . . . . . . . 39 Setting mapping preferences for your workspace . . 39 Setting mapping keyboard preferences for your workspace. . . . . . . . . . . . . . . 41 Chapter 8. Creating a message map . . 45 Creating a message map . . . . . . . . . . 47 Creating a message map in the Application Development view . . . . . . . . . . . 48 Creating a message map from a Mapping node 49 Creating a submap . . . . . . . . . . . . 50 Creating a submap by using the Graphical Data Mapping editor . . . . . . . . . . . . 51 Creating a submap in the Application Development view . . . . . . . . . . . 52 Creating a submap by using the Submap transform . . . . . . . . . . . . . . 53 Converting a local map into a submap . . . . 54 Creating a message map programmatically . . . . 56 Creating a local map by using the Local map transform . . . . . . . . . . . . . . . 57 Converting a submap into a local map . . . . . 57 Creating a graphical data map in the Eclipse editor 59 Chapter 9. Editing message maps . . . 61 Configuring the general properties of a message map . . . . . . . . . . . . . . . . . 62 Adding input and output messages . . . . . . 63 Mapping xsd:any on an input or output message. . 64 Casting wildcards in a map . . . . . . . . . 65 Casting a wildcard defined as xsd:any into a specific type for a SOAP message . . . . . . 65 Casting a base type to a derived type or extension type . . . . . . . . . . . . 68 Mapping input to output elements manually . . . 70 Adding connections between input and output elements . . . . . . . . . . . . . . 70 Connecting multiple input elements to a transform . . . . . . . . . . . . . . 71 Mapping input to output elements automatically . . 73 Mapping by same name . . . . . . . . . 75 Mapping by similar name . . . . . . . . 76 Examples of similarity values . . . . . . . 77 Format of the synonym file . . . . . . . . 77 Algorithm used to match synonyms . . . . . 80 Creating and using a synonym file . . . . . 81 Selecting matches . . . . . . . . . . . 82 Specifying a transform (mapping operation) . . . 82 Configuring the properties of a transform . . . . 84 Defining an XPath conditional expression for a transform . . . . . . . . . . . . . . . 85 Defining an XPath conditional expression for a structural transform (ForEach) . . . . . . . 89 Choosing an XPath conditional expression that tests for a nil value in a transform. . . . . . 91 Grouping transforms into nested maps . . . . . 92 Using content assist (Mapping syntax) . . . . . 93 Deleting objects and transforms . . . . . . . 94 Chapter 10. Advanced editing in a message map. . . . . . . . . . . . 95 Configuring the message map to include message assembly components . . . . . . . . . . . 95 Choosing message assembly components to include in a message map . . . . . . . . 96 © Copyright IBM Corp. 2014 iii Choosing a mapping action . . . . . . . . 98 Customizing a message map to include a message assembly component . . . . . . . 105 Configuring the properties of the input and the output message assembly to a message map . . . 108 Mapping transport headers. . . . . . . . . 109 Mapping data in the local environment tree . . . 111 Configuring the local environment tree Variables folder by using the Cast function . . 113 Adding database definitions to the IBM Integration Studio . . . . . . . . . . . . . . . . 116 Creating a data design project . . . . . . . 117 Creating a database definition (.dbm file) by using the New Database Definition File wizard . 118 Creating a database definition from scratch . . 120 Accessing integration node properties from a Mapping node . . . . . . . . . . . . . 122 Accessing user-defined properties from a Mapping node . . . . . . . . . . . . . . . . 122 Chapter 11. Setting the value of an output element by using a transform or a function. . . . . . . . . . . . 125 Setting the value of an output element to a simple data type . . . . . . . . . . . . . . . 126 Setting the value of an output element with a explicit data type . . . . . . . . . . . . 128 Setting the value of a simple output element to uploads/Ingenierie_Lourd/ gdm-guide.pdf
Documents similaires










-
25
-
0
-
0
Licence et utilisation
Gratuit pour un usage personnel Attribution requise- Détails
- Publié le Jul 15, 2021
- Catégorie Heavy Engineering/...
- Langue French
- Taille du fichier 7.3357MB