This endpoint returns all the available ways you can map your file columns and values to accepted models that can be imported during a bulk import operation.
This information lets you know what can be imported during your operation, what are the characteristics of those fields and their columns, which columns have a predefined list of possible data, etc.
With this information, you can build your request payload to POST /bulkImportJobs
endpoint to map some information directly from your uploaded file, hardcode some information as static, map your uploaded data to other values, or make whatever mappings are necessary to create your import.
The response object have the properties listed below:
Name | Type | Description |
---|---|---|
| string | The unique name of the mapping type |
| string | A human readable version of the field name |
| string | If |
| array | The names of the |
| array | An array describing the possible field/column mappings available for this mapping type. |
The fields
array, describing the column mappings available in this field item, can have the below properties:
Property | Type | Description |
---|---|---|
| string | The name of the field/column |
| string | A human readable description of the column |
| bool | Whether the column requires a predefined set of possible values, under at least some circumstances |
| bool | If |
| bool | Whether the column can draw values from your uploaded file, rather than requiring values be set statically for the entire upload file |
| array | An array of other fields which must be mapped if this field has prerequisite dependencies |
The parents
array lists one or more prerequisites for this field to be mapped.
Property | Type | Description |
---|---|---|
| string | The name of a field which must be mapped in order for the child mapping to be created |
| array | Optional; A collection of permitted values for the parent field that is a prerequisite for the child mapping. Will be null if there is no constraint on the parent value. |
The limitedToParentValues
array is a collection of the limited set of permitted values which are required for the parent field.
Property | Type | Description |
---|---|---|
| string | The name of the permitted value |
| string | The unique identifier of the permitted value |