Table to JSON API reference

Request examples

Minimal request

{
    "api": "hub",
    "authToken": "AuthorizedToken",
    "action": "createTransform",
    "params": {
        "transformName": "TestTransform1",
        "transformActions": [
            {
                "inputFields": [
                    "In1"
                ],
                "outputFields": [
                    "Out1"
                ],
                "transformActionName": "tableFieldsToJson",
                "transformParams": {
                    "mapOfFieldsToProperties": [
                        {
                            "propertyPath": "In1",
                            "fieldName": "In1"
                        }
                    ]
                }
            }
        ]
    }
}

Maximal request

{
    "api": "hub",
    "apiVersion": "1.0",
    "requestId": "00000006",
    "authToken": "AuthorizedToken",
    "action": "createTransform",
    "params": {
        "transformName": "TestTransform1",
        "transformActions": [
            {
                "inputFields": [
                    "In1",
                    "In2",
                    "In3",
                    "In4",
                    "In5"
                ],
                "outputFields": [
                    "Out1"
                ],
                "transformActionName": "tableFieldsToJson",
                "transformParams": {
                    "metadata": {
                       "myTag": "my data"
                   }
               }
            }
        ]
    },
    "responseOptions": {
        "binaryFormat": "base64",
        "dataFormat": "arrays",
        "numberFormat": "number"
    }
}

Response example

{
    "authToken": "AuthorizedToken",
    "result": {},
    "requestId": "00000003",
    "errorCode": 0,
    "errorMessage": ""
}

API reference for the table to JSON transform method

API referenceJSON hub APItable API referencetable to JSONJSON transform

`"params"`

The "params" property is an object that contains an action's parameters. Each action defines its own required and optional properties.

Property summary

Table 1. "params" property summaries

Property

Description

Default

Type

Limits

"transformActions"

specifies "transformAction" objects

Required - No default value

array of objects

"transformName"

specifies the name of a transform process. The name cannot be one of the FairCom-provided transform names

Required - No default value

string

Minimum length: 1

Maximum length: 64

`"transformActions"`

The "transformActions" property is an optional array of "transformAction" objects. It defaults to an empty array.

"inputFields"

The "inputFields" property is a required array containing one or more of the fields in the integration table. The FairCom server sends the value of each of these fields to the transform action as its primary input.

Typically a transform action only needs one input field and the most common input field is "source_payload".
When a transform is applied to an integration table, the server automatically adds missing fields to the table. Thus, any field can be the source of a transform. A transform can only put the result of a transform in a field specially created to hold the transform's output value. In other words, a transform's output field cannot be a field that is built into the table or a field that is being used by another transform.
When a transform has multiple transform actions, you typically daisy chain the "output" field of one transform action to be either the input field of another transform or the field that is being written to by another transform.

"mapOfFieldsToProperties"

The "mapOfFieldsToProperties" property is a required array of "mapOfFieldsToProperties" objects. It defaults to an empty array.

        "mapOfFieldsToProperties": 
        [
        {
          "propertyPath": "In1",
          "fieldName": "In1"
        }
        ]