Create a new custom field

Content

Resource URL

https://apps.ticketmatic.com/api/1/{accountname}/settings/system/customfields

Example

Request

 1use Ticketmatic\Endpoints\Settings\System\Customfields;
 2
 3$result = Customfields::create($client, array(
 4    "typeid" => 13001,
 5    "availability" => array(
 6        "saleschannels" => array(
 7            14,
 8        ),
 9        "usescript" => false,
10    ),
11    "caption" => "Genre",
12    "description" => "Where have you heard from us?",
13    "edittypeid" => 22002,
14    "fieldtypeid" => 12001,
15    "key" => "genre",
16    "manualsort" => false,
17    "requiredtypeid" => 30002,
18));

Response

 1object(\Ticketmatic\Model\CustomField) (13) {
 2  ["id"]=>
 3  int(0)
 4  ["typeid"]=>
 5  int(0)
 6  ["availability"]=>
 7  object(\Ticketmatic\Model\CustomfieldAvailability) (2) {
 8    ["saleschannels"]=>
 9    array(1) {
10      [0]=>
11      int(0)
12    }
13    ["usescript"]=>
14    bool(false)
15  }
16  ["caption"]=>
17  string(5) "Genre"
18  ["description"]=>
19  string(29) "Where have you heard from us?"
20  ["edittypeid"]=>
21  int(0)
22  ["fieldtypeid"]=>
23  int(0)
24  ["key"]=>
25  string(5) "genre"
26  ["manualsort"]=>
27  bool(false)
28  ["requiredtypeid"]=>
29  int(0)
30  ["isarchived"]=>
31  bool(false)
32  ["createdts"]=>
33  object(\DateTime) (3) {
34    ["date"]=>
35    string(26) "2014-09-26 15:24:36.000000"
36    ["timezone_type"]=>
37    int(3)
38    ["timezone"]=>
39    string(3) "UTC"
40  }
41  ["lastupdatets"]=>
42  object(\DateTime) (3) {
43    ["date"]=>
44    string(26) "2014-09-26 15:24:36.000000"
45    ["timezone_type"]=>
46    int(3)
47    ["timezone"]=>
48    string(3) "UTC"
49  }
50}

Request

 1import (
 2    "github.com/ticketmatic/tm-go/ticketmatic"
 3    "github.com/ticketmatic/tm-go/ticketmatic/settings/system/customfields"
 4)
 5
 6result, err := customfields.Create(client, &ticketmatic.CustomField{
 7    Typeid: 13001,
 8    Availability: &ticketmatic.CustomfieldAvailability{
 9        Saleschannels: []int64{
10            14,
11        },
12        Usescript: false,
13    },
14    Caption: "Genre",
15    Description: "Where have you heard from us?",
16    Edittypeid: 22002,
17    Fieldtypeid: 12001,
18    Key: "genre",
19    Manualsort: false,
20    Requiredtypeid: 30002,
21})

Response

 1result := &ticketmatic.CustomField{
 2    Id: 123,
 3    Typeid: 13001,
 4    Availability: &ticketmatic.CustomfieldAvailability{
 5        Saleschannels: []int64{
 6            14,
 7        },
 8        Usescript: false,
 9    },
10    Caption: "Genre",
11    Description: "Where have you heard from us?",
12    Edittypeid: 22002,
13    Fieldtypeid: 12001,
14    Key: "genre",
15    Manualsort: false,
16    Requiredtypeid: 30002,
17    Isarchived: false,
18    Createdts: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
19    Lastupdatets: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
20}

Request

 1POST /api/1/{accountname}/settings/system/customfields HTTP/1.1
 2Content-Type: application/json
 3
 4{
 5    "typeid": 13001,
 6    "availability": {
 7        "saleschannels": [ 14 ],
 8        "usescript": false
 9    },
10    "caption": "Genre",
11    "description": "Where have you heard from us?",
12    "edittypeid": 22002,
13    "fieldtypeid": 12001,
14    "key": "genre",
15    "manualsort": false,
16    "requiredtypeid": 30002
17}

Response

 1HTTP/1.1 200 OK
 2Content-Type: application/json
 3
 4{
 5    "id": 123,
 6    "typeid": 13001,
 7    "availability": {
 8        "saleschannels": [ 14 ],
 9        "usescript": false
10    },
11    "caption": "Genre",
12    "description": "Where have you heard from us?",
13    "edittypeid": 22002,
14    "fieldtypeid": 12001,
15    "key": "genre",
16    "manualsort": false,
17    "requiredtypeid": 30002,
18    "isarchived": false,
19    "createdts": "2014-09-26 15:24:36",
20    "lastupdatets": "2014-09-26 15:24:36"
21}

Request body fields

FieldDescription
typeid
int 
(required)

Type ID

Example value:13001
availability

Rules that define in what conditions this custom field is available when edit type is checkout

Example value:{ "saleschannels": [ 14 ], "usescript": false }
caption
mlstring 
(required)

Human-readable name for the custom field

Example value:"Genre"
description
mlstring 
(required)

Human-readable description for the custom field. Will be visible for end-users when edittype checkout is used

Example value:"Where have you heard from us?"
edittypeid
int 
(required)

Type of editing that is allowed for the custom field. Links to systemtype category 22xxx

Example value:22002
fieldtypeid
int 
(required)

Type of the custom field. Links to systemtype category 12xxx

Example value:12001
key
string 
(required)

The identifier for the custom field. Should contain only alphanumeric characters and no whitespace, max length is 30 characters. The custom field will be available in the api and the public data model as c_

Example value:"genre"
manualsort
bool 
(required)

Indicated whether the field is manually sortable

        </td>
    </tr><tr>
        <td class="field">
            <div class="name">requiredtypeid</div>
            <div class="type">int&nbsp;<div class="required">(required)</div></div>
        </td>
        <td class="description">
            <p>Indicates where the custom field is required. Links to systemtype category 30xxx</p> 
            <strong>Example value:</strong><code>30002</code>
        </td>
    </tr>
</tbody>

Type reference: CustomField

Result fields

FieldDescription
id
int

Unique ID

Example value:123
typeid
int

Type ID

Example value:13001
availability

Rules that define in what conditions this custom field is available when edit type is checkout

Example value:{ "saleschannels": [ 14 ], "usescript": false }
caption

Human-readable name for the custom field

Example value:"Genre"
description

Human-readable description for the custom field. Will be visible for end-users when edittype checkout is used

Example value:"Where have you heard from us?"
edittypeid
int

Type of editing that is allowed for the custom field. Links to systemtype category 22xxx

Example value:22002
fieldtypeid
int

Type of the custom field. Links to systemtype category 12xxx

Example value:12001
key
string

The identifier for the custom field. Should contain only alphanumeric characters and no whitespace, max length is 30 characters. The custom field will be available in the api and the public data model as c_

Example value:"genre"
manualsort
bool

Indicated whether the field is manually sortable

requiredtypeid
int

Indicates where the custom field is required. Links to systemtype category 30xxx

Example value:30002
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: CustomField