STARTTRANSFORMERJOB()`¶

About StartTransformerJob¶

Runs a job, using a transformer, to parse input EDI (electronic data interchange) file into the output structures used by Amazon Web Services B2B Data Interchange.

If you only want to transform EDI (electronic data interchange) documents, you don't need to create profiles, partnerships or capabilities. Just create and configure a transformer, and then run the StartTransformerJob API to process your files.

The system stores transformer jobs for 30 days. During that period, you can run GetTransformerJob and supply its transformerId and transformerJobId to return details of the job.

Method Signature¶

METHODS /AWS1/IF_BDI~STARTTRANSFORMERJOB
  IMPORTING
    !IO_INPUTFILE TYPE REF TO /AWS1/CL_BDIS3LOCATION OPTIONAL
    !IO_OUTPUTLOCATION TYPE REF TO /AWS1/CL_BDIS3LOCATION OPTIONAL
    !IV_TRANSFORMERID TYPE /AWS1/BDITRANSFORMERID OPTIONAL
    !IV_CLIENTTOKEN TYPE /AWS1/BDISTRING OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_bdistartxformerjobrsp
  RAISING
    /AWS1/CX_BDIACCESSDENIEDEX
    /AWS1/CX_BDICONFLICTEXCEPTION
    /AWS1/CX_BDIINTERNALSERVEREX
    /AWS1/CX_BDIRESOURCENOTFOUNDEX
    /AWS1/CX_BDITHROTTLINGEX
    /AWS1/CX_BDIVALIDATIONEX
    /AWS1/CX_BDICLIENTEXC
    /AWS1/CX_BDISERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`io_inputfile` `TYPE REF TO /AWS1/CL_BDIS3LOCATION` `/AWS1/CL_BDIS3LOCATION`¶

Specifies the location of the input file for the transformation. The location consists of an Amazon S3 bucket and prefix.

`io_outputlocation` `TYPE REF TO /AWS1/CL_BDIS3LOCATION` `/AWS1/CL_BDIS3LOCATION`¶

Specifies the location of the output file for the transformation. The location consists of an Amazon S3 bucket and prefix.

`iv_transformerid` `TYPE /AWS1/BDITRANSFORMERID` `/AWS1/BDITRANSFORMERID`¶

Specifies the system-assigned unique identifier for the transformer.

Optional arguments:¶

`iv_clienttoken` `TYPE /AWS1/BDISTRING` `/AWS1/BDISTRING`¶

Reserved for future use.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_bdistartxformerjobrsp` `/AWS1/CL_BDISTARTXFORMERJOBRSP`¶

Domain /AWS1/RT_ACCOUNT_ID

Primitive Type NUMC

Examples¶

Syntax Example¶

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->starttransformerjob(
  io_inputfile = new /aws1/cl_bdis3location(
    iv_bucketname = |string|
    iv_key = |string|
  )
  io_outputlocation = new /aws1/cl_bdis3location(
    iv_bucketname = |string|
    iv_key = |string|
  )
  iv_clienttoken = |string|
  iv_transformerid = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_transformerjobid = lo_result->get_transformerjobid( ).
ENDIF.

Sample StartTransformerJob call¶

Sample StartTransformerJob call

DATA(lo_result) = lo_client->starttransformerjob(
  io_inputfile = new /aws1/cl_bdis3location(
    iv_bucketname = |test-bucket|
    iv_key = |input/inputFile.txt|
  )
  io_outputlocation = new /aws1/cl_bdis3location(
    iv_bucketname = |test-bucket|
    iv_key = |output/|
  )
  iv_clienttoken = |foo|
  iv_transformerid = |tr-974c129999f84d8c9|
).

/AWS1/IF_BDI=>STARTTRANSFORMERJOB()¶