GetTransformer
Retrieves the details for the transformer specified by the transformer ID. A transformer describes how to process the incoming EDI documents and extract the necessary information to the output file.
Request Syntax
{
"transformerId": "string
"
}
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
The request accepts the following data in JSON format.
- transformerId
-
Specifies the system-assigned unique identifier for the transformer.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 64.
Pattern:
[a-zA-Z0-9_-]+
Required: Yes
Response Syntax
{
"createdAt": "string",
"ediType": { ... },
"fileFormat": "string",
"mappingTemplate": "string",
"modifiedAt": "string",
"name": "string",
"sampleDocument": "string",
"status": "string",
"transformerArn": "string",
"transformerId": "string"
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- createdAt
-
Returns a timestamp for creation date and time of the transformer.
Type: Timestamp
- ediType
-
Returns the details for the EDI standard that is being used for the transformer. Currently, only X12 is supported. X12 is a set of standards and corresponding messages that define specific business documents.
Type: EdiType object
Note: This object is a Union. Only one member of this object can be specified or returned.
- fileFormat
-
Returns that the currently supported file formats for EDI transformations are
JSON
andXML
.Type: String
Valid Values:
XML | JSON
- mappingTemplate
-
Returns the mapping template for the transformer. This template is used to map the parsed EDI file using JSONata or XSLT.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 350000.
- modifiedAt
-
Returns a timestamp for last time the transformer was modified.
Type: Timestamp
- name
-
Returns the name of the transformer, used to identify it.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 254.
- sampleDocument
-
Returns a sample EDI document that is used by a transformer as a guide for processing the EDI data.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 1024.
- status
-
Returns the state of the newly created transformer. The transformer can be either
active
orinactive
. For the transformer to be used in a capability, its status mustactive
.Type: String
Valid Values:
active | inactive
- transformerArn
-
Returns an Amazon Resource Name (ARN) for a specific AWS resource, such as a capability, partnership, profile, or transformer.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 255.
- transformerId
-
Returns the system-assigned unique identifier for the transformer.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 64.
Pattern:
[a-zA-Z0-9_-]+
Errors
For information about the errors that are common to all actions, see Common Errors.
- AccessDeniedException
-
You do not have sufficient access to perform this action.
HTTP Status Code: 400
- InternalServerException
-
This exception is thrown when an error occurs in the AWS B2B Data Interchange service.
HTTP Status Code: 500
- ResourceNotFoundException
-
Occurs when the requested resource does not exist, or cannot be found. In some cases, the resource exists in a region other than the region specified in the API call.
HTTP Status Code: 400
- ThrottlingException
-
The request was denied due to throttling: the data speed and rendering may be limited depending on various parameters and conditions.
HTTP Status Code: 400
- ValidationException
-
Occurs when a B2BI object cannot be validated against a request from another object.
HTTP Status Code: 400
Examples
Example
The following example retrieves details for the specified transformer.
Sample Request
{
"transformerId": "tr-1234abcd5678efghj"
}
Sample Response
{
"createdAt": "2023-11-01T21:51:05.504Z",
"ediType": {
"x12Details": {
"transactionSet": "X12_110",
"version": "VERSION_4010"
}
},
"fileFormat": "JSON",
"mappingTemplate": "$",
"modifiedAt": "2023-11-01T21:51:05.504Z",
"name": "transformJSON",
"sampleDocument": "s3://test-bucket/sampleDoc.txt",
"status": "inactive",
"transformerArn": "arn:aws:b2bi:us-west-2:123456789012:transformer/tr-1234abcd5678efghj",
"transformerId": "tr-1234abcd5678efghj"
}
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: