Create a new field definition
Content
Resource URL
https://apps.ticketmatic.com/api/1/{accountname}/settings/system/fielddefinitions
Example
Request
1use Ticketmatic\Endpoints\Settings\System\Fielddefinitions;
2
3$result = Fielddefinitions::create($client, array(
4 "typeid" => 10001,
5 "align" => "left",
6 "description" => "Created timestamp",
7 "key" => "createdtimestamp",
8 "sqlclause" => "tm.order.createdts",
9 "uitype" => "number",
10 "variablewidth" => true,
11 "width" => 50,
12));
Response
1object(\Ticketmatic\Model\FieldDefinition) (12) {
2 ["id"]=>
3 int(0)
4 ["typeid"]=>
5 int(0)
6 ["align"]=>
7 string(4) "left"
8 ["description"]=>
9 string(17) "Created timestamp"
10 ["key"]=>
11 string(16) "createdtimestamp"
12 ["sqlclause"]=>
13 string(18) "tm.order.createdts"
14 ["uitype"]=>
15 string(6) "number"
16 ["variablewidth"]=>
17 bool(true)
18 ["width"]=>
19 int(0)
20 ["isarchived"]=>
21 bool(false)
22 ["createdts"]=>
23 object(\DateTime) (3) {
24 ["date"]=>
25 string(26) "2014-09-26 15:24:36.000000"
26 ["timezone_type"]=>
27 int(3)
28 ["timezone"]=>
29 string(3) "UTC"
30 }
31 ["lastupdatets"]=>
32 object(\DateTime) (3) {
33 ["date"]=>
34 string(26) "2014-09-26 15:24:36.000000"
35 ["timezone_type"]=>
36 int(3)
37 ["timezone"]=>
38 string(3) "UTC"
39 }
40}
Request
1import (
2 "github.com/ticketmatic/tm-go/ticketmatic"
3 "github.com/ticketmatic/tm-go/ticketmatic/settings/system/fielddefinitions"
4)
5
6result, err := fielddefinitions.Create(client, &ticketmatic.FieldDefinition{
7 Typeid: 10001,
8 Align: "left",
9 Description: "Created timestamp",
10 Key: "createdtimestamp",
11 Sqlclause: "tm.order.createdts",
12 Uitype: "number",
13 Variablewidth: true,
14 Width: 50,
15})
Response
1result := &ticketmatic.FieldDefinition{
2 Id: 123,
3 Typeid: 10001,
4 Align: "left",
5 Description: "Created timestamp",
6 Key: "createdtimestamp",
7 Sqlclause: "tm.order.createdts",
8 Uitype: "number",
9 Variablewidth: true,
10 Width: 50,
11 Isarchived: false,
12 Createdts: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
13 Lastupdatets: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
14}
Request
1POST /api/1/{accountname}/settings/system/fielddefinitions HTTP/1.1
2Content-Type: application/json
3
4{
5 "typeid": 10001,
6 "align": "left",
7 "description": "Created timestamp",
8 "key": "createdtimestamp",
9 "sqlclause": "tm.order.createdts",
10 "uitype": "number",
11 "variablewidth": true,
12 "width": 50
13}
Response
1HTTP/1.1 200 OK
2Content-Type: application/json
3
4{
5 "id": 123,
6 "typeid": 10001,
7 "align": "left",
8 "description": "Created timestamp",
9 "key": "createdtimestamp",
10 "sqlclause": "tm.order.createdts",
11 "uitype": "number",
12 "variablewidth": true,
13 "width": 50,
14 "isarchived": false,
15 "createdts": "2014-09-26 15:24:36",
16 "lastupdatets": "2014-09-26 15:24:36"
17}
Request body fields
| Field | Description |
|---|---|
|
typeid
int
(required) |
Type ID Example value:10001
|
|
align
string
(required) |
Alignment of the field definition, when used in a view. Values can be ‘left’, ‘right’ or ‘center’ Example value:"left"
|
|
description
mlstring
(required) |
Human-readable name for the field definition Example value:"Created timestamp"
|
|
key
string
(required) |
Key for the field definition. Should only consist of lowercase alphanumeric characters Example value:"createdtimestamp"
|
|
sqlclause
string
(required) |
The actual definition of the field definition. Contains the sql clause that will retrieve the information element in the database. Example value:"tm.order.createdts"
|
|
uitype
string
(required) |
Will decide how the field will be rendered when used in a view. Example value:"number"
|
|
variablewidth
bool
(required) |
Indicates whether the width for the field definition can be adapted when stretching a view that includes the field definition across the whole available width. Example value:true
|
|
width
int
(required) |
Width of the field definition, when used in a view Example value:50
|
Type reference: FieldDefinition
Result fields
| Field | Description |
|---|---|
|
id
int
|
Unique ID Example value:123
|
|
typeid
int
|
Type ID Example value:10001
|
|
align
string
|
Alignment of the field definition, when used in a view. Values can be ‘left’, ‘right’ or ‘center’ Example value:"left"
|
|
description
|
Human-readable name for the field definition Example value:"Created timestamp"
|
|
key
string
|
Key for the field definition. Should only consist of lowercase alphanumeric characters Example value:"createdtimestamp"
|
|
sqlclause
string
|
The actual definition of the field definition. Contains the sql clause that will retrieve the information element in the database. Example value:"tm.order.createdts"
|
|
uitype
string
|
Will decide how the field will be rendered when used in a view. Example value:"number"
|
|
variablewidth
bool
|
Indicates whether the width for the field definition can be adapted when stretching a view that includes the field definition across the whole available width. Example value:true
|
|
width
int
|
Width of the field definition, when used in a view Example value:50
|
|
isarchived
bool
|
Whether or not this item is archived |
|
createdts
timestamp
|
Created timestamp Example value:"2014-09-26 15:24:36"
|
|
lastupdatets
timestamp
|
Last updated timestamp Example value:"2014-09-26 15:24:36"
|
Type reference: FieldDefinition