Create or Update Data Table Column
post
/rest/v16/datatables/{tableName}/fields
This endpoint is used to create or update a data table column.
Request
Supported Media Types
- application/json
Path Parameters
-
tableName(required): string
The data table name.
Root Schema : dataTableField-createRequestCollection
Type:
Show Source
object
-
items:
array Column List
Title:
Column List
List of columns to be created or updated
Nested Schema : Column List
Type:
array
Title:
Column List
List of columns to be created or updated
Show Source
-
Array of:
object dataTableField-createRequest
Data table column create request model
Nested Schema : dataTableField-createRequest
Type:
object
Data table column create request model
Show Source
-
_proxy_id:
string
Title:
Proxy Id
The proxy Id -
description:
string
Title:
Column Description
The column description. -
index:
boolean
Title:
Index
This attribute identifies if the column is indexed. -
key:
boolean
Title:
Key
This attribute identifies if this is a key column. A key, also known as a 'Natural Key' can be a single column or a combination of several columns that produce a unique identifier for each record (row) for faster access to the data. -
name:
string
Title:
Column Name
The name of the data table column. -
order:
integer
Title:
Column Display Order
Order of the column within the table. -
relationship:
object relationship-request
-
type:
string
Title:
Column Data Type
The data type of the column. -
validation:
object validation-request
Nested Schema : relationship-request
Type:
Show Source
object
-
name:
string
Title:
Relationship Name
Name of the relationship -
refField:
object referenceField-request
-
refOnDelete:
string
Title:
Reference On Delete
Allowed Values:[ "On Delete No Action", "On Delete Cascade", "On Delete Set Null" ]
On delete behavior for the relationship -
refTable:
object referenceTable-request
Nested Schema : validation-request
Type:
Show Source
object
-
hierarchy:
string
Title:
Attribute Hierarchy
Attribute hierarchy -
type:
string
Title:
Validation Type
Allowed Values:[ "Config", "Commerce" ]
Type of the validation
Nested Schema : referenceField-request
Type:
Show Source
object
-
name:
string
Title:
Referencing Column
the name of the referencing column.
Nested Schema : referenceTable-request
Type:
Show Source
object
-
name:
string
Title:
Reference Table Name
Name of the referencing table
Response
Supported Media Types
- application/json
Default Response
Created or updated column details
Root Schema : dataTableField-collection
Type:
Show Source
object
-
items:
array Columns list
Title:
Columns list
List of columns
Nested Schema : Columns list
Type:
array
Title:
Columns list
List of columns
Show Source
-
Array of:
object dataTableField
Data table column model
Nested Schema : dataTableField
Type:
object
Data table column model
Show Source
-
_proxy_id:
string
Title:
Proxy Id
Proxy Id -
dateAdded:
string
Title:
Date Created
The date the column was created. -
dateModified:
string
Title:
Date Last Modified
The date of the last column modification. -
description:
string
Title:
Column Description
The column description. -
id:
integer(int64)
Title:
Column Id
The unique identifier of the column. -
index:
boolean
Title:
Index
This attribute identifies if the column is indexed. -
key:
boolean
Title:
Key
This attribute identifies if this is a key column. A key, also known as a 'Natural Key' can be a single column or a combination of several columns that produce a unique identifier for each record (row) for faster access to the data. -
links:
array Links
Title:
Links
Links to the related objects -
name:
string
Title:
Column Name
The name of the data table column. -
order:
integer
Title:
Column Display Order
Order of the column within the table. -
relationship:
object relationship-response
-
type:
string
Title:
Column Data Type
The data type of the column. -
validation:
object validation-response
Nested Schema : Links
Type:
array
Title:
Links
Links to the related objects
Show Source
-
Array of:
object Reference Links
Title:
Reference Links
Reference links for the Parent, Self, Children and Related as applicable
Nested Schema : relationship-response
Type:
Show Source
object
-
name:
string
Title:
Relationship Name
Name of the relationship -
refField:
object referenceField-response
-
refOnDelete:
string
Title:
Reference On Delete
Allowed Values:[ "On Delete No Action", "On Delete Cascade", "On Delete Set Null" ]
On delete behavior for the relationship -
refTable:
object referenceTable-response
Nested Schema : validation-response
Type:
Show Source
object
-
attribute:
string
Title:
Attribute Name
The name of the attribute the column is mapped to. -
hierarchy:
string
Title:
Attribute Hierarchy
Attribute hierarchy -
links:
array Links
Title:
Links
Links to the related objects. -
type:
string
Title:
Validation Type
Allowed Values:[ "Config", "Commerce" ]
Type of the validation.
Nested Schema : Reference Links
Type:
object
Title:
Reference Links
Reference links for the Parent, Self, Children and Related as applicable
Show Source
-
href:
string
Title:
href
URL to the related object -
rel:
string
Title:
Link
Link relationship to the current object
Nested Schema : referenceField-response
Type:
Show Source
object
-
links:
array Links
Title:
Links
Links to the related objects. -
name:
string
Title:
Referencing Column
the name of the referencing column.
Nested Schema : referenceTable-response
Type:
Show Source
object
-
links:
array Links
Title:
Links
Links to the related objects. -
name:
string
Title:
Reference Table Name
Name of the referencing table
Nested Schema : Links
Type:
array
Title:
Links
Links to the related objects.
Show Source
-
Array of:
object Reference Links
Title:
Reference Links
Reference links for the Parent, Self, Children and Related as applicable
Nested Schema : Links
Type:
array
Title:
Links
Links to the related objects.
Show Source
-
Array of:
object Reference Links
Title:
Reference Links
Reference links for the Parent, Self, Children and Related as applicable
Nested Schema : Links
Type:
array
Title:
Links
Links to the related objects.
Show Source
-
Array of:
object Reference Links
Title:
Reference Links
Reference links for the Parent, Self, Children and Related as applicable
Examples
The following examples show how to create or update a data table column for the specified data table for the specified data table by submitting a POST request to the REST resource using cURL. For more information about cURL, see Use cURL.
curl - X POST - i - H "Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQg" - H "Content-type: application/json" https://sitename.oracle.com/rest/v16/datatables/Rack_Domain/fields
Request Body Sample
{ "name": "Type", "description": "This field identifies the component type.", "index": true, "key": false, "order": 2 }
Response Body Sample
{ "id": 41361422, "dateModified": "10/17/2019 10:30 AM", "links": [{ "rel": "parent", "href": "https://sitename.oracle.com/rest/v16/datatables/Rack_Domain/fields" }, { "rel": "self", "href": "https://sitename.oracle.com/rest/v16/datatables/Rack_Domain/fields/Type" } ], "name": "Type", "description": "This field identifies the component type.", "dateAdded": "10/08/2019 12:48 PM", "type": "String", "order": 2, "index": true, "key": false }