Communities
A collaborative platform to connect and grow with like-minded Informaticans across the globe
Product Communities
Connect and collaborate with Informatica experts and champions
Discussions
Have a question? Start a Discussion and get immediate answers you are looking for
User Groups
Customer-organized groups that meet online and in-person. Join today to network, share ideas, and get tips on how to get the most out of Informatica
Get Started
Community Guidelines
Knowledge Center
Troubleshooting documents, product guides, how to videos, best practices, and more
Knowledge Base
One-stop self-service portal for solutions, FAQs, Whitepapers, How Tos, Videos, and more
Support TV
Video channel for step-by-step instructions to use our products, best practices, troubleshooting tips, and much more
Documentation
Information library of the latest product documents
Velocity (Best Practices)
Best practices and use cases from the Implementation team
Learn
Rich resources to help you leverage full capabilities of our products
Trainings
Role-based training programs for the best ROI
Certifications
Get certified on Informatica products. Free, Foundation, or Professional
Product Learning Paths
Free and unlimited modules based on your expertise level and journey
Resources
Library of content to help you leverage the best of Informatica products
Tech Tuesdays Webinars
Most popular webinars on product architecture, best practices, and more
Product Availability Matrix
Product Availability Matrix statements of Informatica products
SupportFlash
Monthly support newsletter
Support Documents
Informatica Support Guide and Statements, Quick Start Guides, and Cloud Product Description Schedule
Product Lifecycle
End of Life statements of Informatica products
Ideas
Events
Change Request Tracking
Marketplace
English
  • Administrator
  • All Products

Table of Contents

Search

  1. Preface
  2. Informatica Intelligent Cloud Services REST API
  3. Platform REST API version 2 resources
  4. Platform REST API version 3 resources
  5. Data Integration REST API
  6. File Ingestion and Replication REST API
  7. Streaming Ingestion and Replication REST API
  8. Model Serve REST API
  9. RunAJob utility
  10. ParamSetCli utility
  11. REST API codes
  12. REST API resource quick references

REST API Reference

REST API Reference

Back Next

Mappings

Mappings

Use this resource to request the details for a mapping or the details of all mappings in the organization.

GET Request

You can request the following information using a mapping GET request:
  • Details of all mappings in the organization.
  • Details for a particular mapping.
  • An image of a mapping.
Details of all mappings in the organization
To request the details of all mappings in the organization, use the following URI: 
/api/v2/mapping
Details for a particular mapping
To request the details of a particular mapping, include the mapping ID or mapping name in the URI. Use one of the following URIs: 
/api/v2/mapping/<id>
/api/v2/mapping/name/<name>
If you use the mapping name in the URI and the mapping name value includes a space, replace the space with %20. For example: 
/api/v2/mapping/name/my%20mapping
You can also request a specific mapping by name with the following URI: 
/api/v2/mapping/search?name=<name>
Image of a mapping
To request an image of a mapping, specify the mapping ID and whether the mapping is deployed or not. Use the following URI: 
/api/v2/mapping
/<id>
/image?deployed=<true|false>
For example: 
/api/v2/mapping/N0A1700000000001J/image?deployed=true

GET Response

If successful, returns the mapping object for the requested mapping.
If you request the details for all mappings, returns the mapping object for every mapping in the organization without parameter details.
Returns the error object if errors occur.
The mapping object includes the following attributes:
Field
Type
Description
id
String
Mapping ID.
orgId
String
Organization ID.
name
String
Mapping name.
description
String
Description of the mapping.
createTime
Date/time
Time the mapping was created.
updateTime
Date/time
Last time the mapping was updated.
createdBy
String
User who created the mapping.
updatedBy
String
User who last updated the mapping.
bundleObjectId
String
ID of the bundle that includes the mapping, if applicable.
bundleVersion
String
Version of the bundle that includes the mapping, if applicable.
templateId
String
ID of the template created internally to represent the mapping.
deployTime
Date/time
Time the mapping was deployed.
hasParameters
Boolean
Indicates if the mapping includes parameters. Returns true or false.
valid
Boolean
Indicates if the mapping is valid. Returns true or false.
fixedConnection
Boolean
Indicates if the mapping has fixed connections. Returns true or false.
hasParametersDeployed
Boolean
Indicates if the mapping has parameters deployed. Returns true or false.
fixedConnectionDeployed
Boolean
Indicates if the mapping has fixed connections deployed. Returns true or false.
deployedTemplateId
String
ID of the template created internally to represent the deployed mapping.
tasks
Int
Number of tasks that use the mapping.
parameters
Parameters used in the mapping. Includes an mtTaskParameter object for each parameter.
id
Long
Included in the mtTaskParameter object.
Parameter ID.
name
String
Included in the mtTaskParameter object.
Parameter name.
type
String
Included in the mtTaskParameter object.
Parameter type.
description
String
Included in the mtTaskParameter object.
Parameter description.
customFuncId
String
Mapplet ID for mapplet type parameters.
uiProperties
String
Included in the mtParameter object.
Display property for the parameter. Includes the following information:
  • cnxtype. Connection type for the parameter.
  • logcnx. Logical connection.
  • order. Display order.
  • wizstep. Wizard step to display the parameter.
  • default. Default value.
  • visible. Whether the parameter is visible.
  • editable. Whether the parameter is editable.
  • required. Whether the parameter is required.
  • paramtype. UI control type for string parameters. Returns one of the following responses:
    • Condition. Filter condition input control.
    • Expression. Expression editor input control.
    • Field. Field selection input control.
    • Fieldmap. Field mapping input control. Includes the following attributes:
      • lefttitle. Left title for the field mapping display.
      • righttitle. Right title for the field mapping display.
      • leftfs. Set of fields to display in the left table of the field mapping display.
      • rightfs. Set of fields to display in the right table of the field mapping display.
      • leftfilter. Regular expression to limit the fields that display in the left table of the field mapping display.
      • rightfilter. Regular expression to limit the fields that display in the right table of the field mapping display.
      • staticlist. List of fields to display on the right side of the field mapping display.
inOutParameters
In-out parameter used in the mapping. Includes a mtTaskInOutParameter object for each in-out parameter.
id
Long
Included in the mtTaskInOutParameter object.
Parameter ID.
name
String
Included in the mtTaskInOutParameter object.
Parameter name.
description
String
Included in the mtTaskInOutParameter object.
Description of the parameter.
initialValue
String
Included in the mtTaskInOutParameter object.
Initial value for the parameter.
datatype
String
Included in the mtTaskInOutParameter object.
Data type of the parameter.
precision
String
Included in the mtTaskInOutParameter object.
Precision of the parameter.
scale
String
Included in the mtTaskInOutParameter object.
Scale of the parameter.
retentionPolicy
String
Included in the mtTaskInOutParameter object.
Determines when the task retains the current value.
aggregationType
String
Included in the mtTaskInOutParameter object.
Determines the final current value of the parameter when the task runs.
currentValue
String
Included in the mtTaskInOutParameter object.
Current value for the parameter.
mappingPreviewFileRecordId
String
ID of the image file that is used when previewing a mapping.
deployedMappingPreviewFileRecordId
String
ID of the image file that is used when previewing a deployed mapping.
references
Reference information. Returns the reference object, which includes the following attributes:
refObjectId
String
Included in the reference object.
refType
String
Included in the reference object.

GET Example

To request mapping details for all mappings in the organization, you might use the following request: 
GET <serverUrl>/api/v2/mapping 
Accept: application/xml
icSessionId: <icSessionId>
0 COMMENTS
We’d like to hear from you!