Boomi Platform API Reference (1.0.0) - EnvironmentMapExtensionsSummary
The Environment Map Extensions Summary object refers to an extensible data map for an environment to which you attach a given process. An extensible map to which the object refers is represented by the Environment Map Extension object. Data map extensions are overrides to field mappings or fields augmenting profile-based object definitions. Data map extensions represent the generalized mapping between two object definitions. For more information, refer to the topic Data map extensions. Before you can request a GET or UPDATE operation on an Environment Map Extension object, you must perform a QUERY operation on the Environment Map Extensions Summary object to obtain the object IDs for extensible maps. The Environment Map Extensions Summary object also returns any connection fields required to reimport the source and destination profiles for customization.
Note: You use the Environment Map Extension Summary object to configure extended maps only. Using the Environment Extensions object, you manage all other types of extensions, such as connections and process properties.
Required Privileges
You need these privileges in the target environment:
Write access
- N/A
Read access
- API — Use the Boomi Platform API to access account data.
- ATOM_MANAGEMENT — Configure and administer integration runtimes.
- ATOM_MANAGEMENT_READ_ONLY — Read only access to runtime configuration and administration.
Queries for an EnvironmentMapExtensionsSummary object(s)
For general information about the structure of QUERY filters, their sample payloads, and how to handle the paged results, refer to Query filters and Query paging.
Authorizations:
Request Body schema: optional
Possible properties include: environmentId, extensionGroupId
required | object | ||||||||||
| |||||||||||
Responses
Response Schema:
| numberOfResults | integer <int32> |
| queryToken | string By default, the queryToken parameter is not available in the query response. It appears only when the query response contains more than 100 results. The maximum number of results returned per query is 100. To retrieve the next set of results, use the queryToken in the queryMore request. |
Array of objects (EnvironmentMapExtensionsSummary) |
Request samples
- Payload
{- "QueryFilter": {
- "expression": {
- "operator": "EQUALS",
- "property": "environmentId",
- "argument": [
- "456789ab-cdef-0123-4567-89abcdef0123"
]
}
}
}Response samples
- 200
- 403
- 410
- 503
{- "numberOfResults": 1,
- "@type": "QueryResult",
- "result": [
- {
- "@type": "EnvironmentMapExtensionsSummary",
- "enviromentId": "456789ab-cdef-0123-4567-89abcdef0123",
- "extensionGroupId": "",
- "id": "Ab0Cd1Ef1Gh3Ij4Kl5Mn6Op7Qr8St9Uv0Wx9Yz8Zy7Xw6Vu5Ts4Rq3Po2Nm1Lk0Ji1Hg",
- "processId": "789abcde-f012-3456-789a-bcdef0123456",
- "mapId": "01234567890123456789012345",
- "name": "Account - Customer",
- "DestinationFieldSet": {
- "@type": "MapExtensionBrowseData",
- "BrowseField": [
- {
- "@type": "BrowseField",
- "name": "password"
}
]
}
}
]
}Retrieves additional results for an EnvironmentMapExtensionsSummary query
To learn about using queryMore, refer to the topic Query paging.
Authorizations:
Request Body schema: text/plainrequired
Responses
Response Schema:
| numberOfResults | integer <int32> |
| queryToken | string By default, the queryToken parameter is not available in the query response. It appears only when the query response contains more than 100 results. The maximum number of results returned per query is 100. To retrieve the next set of results, use the queryToken in the queryMore request. |
Array of objects (EnvironmentMapExtensionsSummary) |
Response samples
- 200
- 403
- 410
- 503
{- "numberOfResults": 1,
- "@type": "QueryResult",
- "result": [
- {
- "@type": "EnvironmentMapExtensionsSummary",
- "enviromentId": "456789ab-cdef-0123-4567-89abcdef0123",
- "extensionGroupId": "",
- "id": "Ab0Cd1Ef1Gh3Ij4Kl5Mn6Op7Qr8St9Uv0Wx9Yz8Zy7Xw6Vu5Ts4Rq3Po2Nm1Lk0Ji1Hg",
- "processId": "789abcde-f012-3456-789a-bcdef0123456",
- "mapId": "01234567890123456789012345",
- "name": "Account - Customer",
- "DestinationFieldSet": {
- "@type": "MapExtensionBrowseData",
- "BrowseField": [
- {
- "@type": "BrowseField",
- "name": "password"
}
]
}
}
]
}