You are here: Integration > About data mapping > How to complete mapping details in SOAP and dotNet services

How to complete data mapping for SOAP and dotNet services

Data mapping defines the relationship between parameter-value pairs in external systems and property-value pairs in the Pega 7 Platform. SOAP and dotNET services forms have two tabs for data mapping:

For SOAP and dotNet services, the Pega 7 Platform supports a subset of the primitive data types supported by the World Wide Web Consortium standard at
WWW linkhttp://www.w3.org/TR/xmlschema-2.

Simple data types

Because XML is text-based, you can map any XSD data type into a Single Value property of type Text. However, when possible, a more restrictive mapping is better — for example, the XSD type float corresponds to the Pega 7 Platform type of Double. In specific situations, you may be aware of values and format that allow even more restrictive mappings than listed below.

When an incoming or outgoing message contains scalar arguments (or arrays of scalar arguments) that match Pega 7 Platform properties or activity parameters and the data is to be treated as a single value, you create simple argument-property mappings. The following table lists the XSD data types that appear in the Data Type selection list and the typical Pega 7 Platform property type to map it to or from.

XSD Data Type

Type

Notes and XSD examples

string

Text

Also used for User Name and Password.

Boolean

True or False

True

double

Double

 
float

Double

XSD represents single-precision values (originally 32 bits) only.

-1E4, 12687.433E12, 12, INF (infinity)

int

Integer

Same as Java

long Integer

Same as Java

short Integer

Same as Java

byte Integer

Same as Java

base64Binary Text

Encoded binary value as characters

dateTime

DateTime

 
date

Date

1999-10-26
decimal Decimal 3.14159
integer Integer -7, 43
time

DateTime

UTC zone (Zulu) only.

2004-03-04T21:15:00Z

For the array counterparts of these XSD types — string(n), short(n), for example — map them to or from properties of mode Value List that have the types specified above.

Complex data types

To map complex data types, assess the data that is to be transmitted in the SOAP messages. Determine whether the message contains a string parameter with XML code embedded in the value. or contains an XML object:

For information about using Parse XML rules, XML Stream rules, and data transforms (previously known as model rules) for data mapping, see Data Mapping XML, a document in the Integration area of the PDN.

Related topics About Service SOAP rules
About Service dotNet rules
Data type conversions in expressions

Integration-Services category