Class: Merge::Ticketing::TicketRequest

Inherits:
Object
  • Object
show all
Defined in:
lib/merge_ruby_client/ticketing/types/ticket_request.rb

Overview

# The Ticket Object

### Description
The `Ticket` object is used to represent a ticket or a task within a system.
### Usage Example
TODO

Constant Summary collapse

OMIT = 
Object.new

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name: OMIT, assignees: OMIT, creator: OMIT, due_date: OMIT, status: OMIT, description: OMIT, collections: OMIT, ticket_type: OMIT, account: OMIT, contact: OMIT, parent_ticket: OMIT, attachments: OMIT, tags: OMIT, completed_at: OMIT, ticket_url: OMIT, priority: OMIT, integration_params: OMIT, linked_account_params: OMIT, remote_fields: OMIT, additional_properties: nil) ⇒ Merge::Ticketing::TicketRequest

Parameters:

  • name (String) (defaults to: OMIT) —

    The ticket’s name.

  • assignees (Array<Merge::Ticketing::TicketRequestAssigneesItem>) (defaults to: OMIT)
  • creator (Merge::Ticketing::TicketRequestCreator) (defaults to: OMIT) —

    The user who created this ticket.

  • due_date (DateTime) (defaults to: OMIT) —

    The ticket’s due date.

  • status (Merge::Ticketing::TicketStatusEnum) (defaults to: OMIT) —

    The current status of the ticket.

    • ‘OPEN` - OPEN

    • ‘CLOSED` - CLOSED

    • ‘IN_PROGRESS` - IN_PROGRESS

    • ‘ON_HOLD` - ON_HOLD

  • description (String) (defaults to: OMIT) —

    The ticket’s description. HTML version of description is mapped if supported by the third-party platform.

  • collections (Array<Merge::Ticketing::TicketRequestCollectionsItem>) (defaults to: OMIT)
  • ticket_type (String) (defaults to: OMIT) —

    The sub category of the ticket within the 3rd party system. Examples include incident, task, subtask or to-do.

  • account (Merge::Ticketing::TicketRequestAccount) (defaults to: OMIT) —

    The account associated with the ticket.

  • contact (Merge::Ticketing::TicketRequestContact) (defaults to: OMIT) —

    The contact associated with the ticket.

  • parent_ticket (Merge::Ticketing::TicketRequestParentTicket) (defaults to: OMIT) —

    The ticket’s parent ticket.

  • attachments (Array<Merge::Ticketing::TicketRequestAttachmentsItem>) (defaults to: OMIT)
  • tags (Array<String>) (defaults to: OMIT)
  • completed_at (DateTime) (defaults to: OMIT) —

    When the ticket was completed.

  • ticket_url (String) (defaults to: OMIT) —

    The 3rd party url of the Ticket.

  • priority (Merge::Ticketing::PriorityEnum) (defaults to: OMIT) —

    The priority or urgency of the Ticket.

    • ‘URGENT` - URGENT

    • ‘HIGH` - HIGH

    • ‘NORMAL` - NORMAL

    • ‘LOW` - LOW

  • integration_params (Hash{String => Object}) (defaults to: OMIT)
  • linked_account_params (Hash{String => Object}) (defaults to: OMIT)
  • remote_fields (Array<Merge::Ticketing::RemoteFieldRequest>) (defaults to: OMIT)
  • additional_properties (OpenStruct) (defaults to: nil) —

    Additional properties unmapped to the current class definition



112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 112

def initialize(name: OMIT, assignees: OMIT, creator: OMIT, due_date: OMIT, status: OMIT, description: OMIT,
               collections: OMIT, ticket_type: OMIT, account: OMIT, contact: OMIT, parent_ticket: OMIT, attachments: OMIT, tags: OMIT, completed_at: OMIT, ticket_url: OMIT, priority: OMIT, integration_params: OMIT, linked_account_params: OMIT, remote_fields: OMIT, additional_properties: nil)
  @name = name if name != OMIT
  @assignees = assignees if assignees != OMIT
  @creator = creator if creator != OMIT
  @due_date = due_date if due_date != OMIT
  @status = status if status != OMIT
  @description = description if description != OMIT
  @collections = collections if collections != OMIT
  @ticket_type = ticket_type if ticket_type != OMIT
  @account =  if  != OMIT
  @contact = contact if contact != OMIT
  @parent_ticket = parent_ticket if parent_ticket != OMIT
  @attachments = attachments if attachments != OMIT
  @tags = tags if tags != OMIT
  @completed_at = completed_at if completed_at != OMIT
  @ticket_url = ticket_url if ticket_url != OMIT
  @priority = priority if priority != OMIT
  @integration_params = integration_params if integration_params != OMIT
  @linked_account_params =  if  != OMIT
  @remote_fields = remote_fields if remote_fields != OMIT
  @additional_properties = additional_properties
  @_field_set = {
    "name": name,
    "assignees": assignees,
    "creator": creator,
    "due_date": due_date,
    "status": status,
    "description": description,
    "collections": collections,
    "ticket_type": ticket_type,
    "account": ,
    "contact": contact,
    "parent_ticket": parent_ticket,
    "attachments": attachments,
    "tags": tags,
    "completed_at": completed_at,
    "ticket_url": ticket_url,
    "priority": priority,
    "integration_params": integration_params,
    "linked_account_params": ,
    "remote_fields": remote_fields
  }.reject do |_k, v|
    v == OMIT
  end
end

Instance Attribute Details

#account ⇒ Merge::Ticketing::TicketRequestAccount (readonly)

Returns The account associated with the ticket.

Returns:



48
49
50
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 48

def 
  @account
end

#additional_properties ⇒ OpenStruct (readonly)

Returns Additional properties unmapped to the current class definition.

Returns:

  • (OpenStruct) —

    Additional properties unmapped to the current class definition



74
75
76
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 74

def additional_properties
  @additional_properties
end

#assignees ⇒ Array<Merge::Ticketing::TicketRequestAssigneesItem> (readonly)

Returns:



28
29
30
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 28

def assignees
  @assignees
end

#attachments ⇒ Array<Merge::Ticketing::TicketRequestAttachmentsItem> (readonly)

Returns:



54
55
56
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 54

def attachments
  @attachments
end

#collections ⇒ Array<Merge::Ticketing::TicketRequestCollectionsItem> (readonly)

Returns:



43
44
45
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 43

def collections
  @collections
end

#completed_at ⇒ DateTime (readonly)

Returns When the ticket was completed.

Returns:

  • (DateTime) —

    When the ticket was completed.



58
59
60
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 58

def completed_at
  @completed_at
end

#contact ⇒ Merge::Ticketing::TicketRequestContact (readonly)

Returns The contact associated with the ticket.

Returns:



50
51
52
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 50

def contact
  @contact
end

#creator ⇒ Merge::Ticketing::TicketRequestCreator (readonly)

Returns The user who created this ticket.

Returns:



30
31
32
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 30

def creator
  @creator
end

#description ⇒ String (readonly)

Returns The ticket’s description. HTML version of description is mapped if supported by the third-party platform.

Returns:

  • (String) —

    The ticket’s description. HTML version of description is mapped if supported by the third-party platform.



41
42
43
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 41

def description
  @description
end

#due_date ⇒ DateTime (readonly)

Returns The ticket’s due date.

Returns:

  • (DateTime) —

    The ticket’s due date.



32
33
34
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 32

def due_date
  @due_date
end

#integration_params ⇒ Hash{String => Object} (readonly)

Returns:

  • (Hash{String => Object}) 


68
69
70
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 68

def integration_params
  @integration_params
end

#linked_account_params ⇒ Hash{String => Object} (readonly)

Returns:

  • (Hash{String => Object}) 


70
71
72
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 70

def 
  @linked_account_params
end

#name ⇒ String (readonly)

Returns The ticket’s name.

Returns:

  • (String) —

    The ticket’s name.



26
27
28
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 26

def name
  @name
end

#parent_ticket ⇒ Merge::Ticketing::TicketRequestParentTicket (readonly)

Returns The ticket’s parent ticket.

Returns:



52
53
54
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 52

def parent_ticket
  @parent_ticket
end

#priority ⇒ Merge::Ticketing::PriorityEnum (readonly)

Returns The priority or urgency of the Ticket.

  • ‘URGENT` - URGENT

  • ‘HIGH` - HIGH

  • ‘NORMAL` - NORMAL

  • ‘LOW` - LOW.

Returns:



66
67
68
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 66

def priority
  @priority
end

#remote_fields ⇒ Array<Merge::Ticketing::RemoteFieldRequest> (readonly)

Returns:



72
73
74
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 72

def remote_fields
  @remote_fields
end

#status ⇒ Merge::Ticketing::TicketStatusEnum (readonly)

Returns The current status of the ticket.

  • ‘OPEN` - OPEN

  • ‘CLOSED` - CLOSED

  • ‘IN_PROGRESS` - IN_PROGRESS

  • ‘ON_HOLD` - ON_HOLD.

Returns:



38
39
40
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 38

def status
  @status
end

#tags ⇒ Array<String> (readonly)

Returns:

  • (Array<String>) 


56
57
58
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 56

def tags
  @tags
end

#ticket_type ⇒ String (readonly)

Returns The sub category of the ticket within the 3rd party system. Examples include incident, task, subtask or to-do.

Returns:

  • (String) —

    The sub category of the ticket within the 3rd party system. Examples include incident, task, subtask or to-do.



46
47
48
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 46

def ticket_type
  @ticket_type
end

#ticket_url ⇒ String (readonly)

Returns The 3rd party url of the Ticket.

Returns:

  • (String) —

    The 3rd party url of the Ticket.



60
61
62
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 60

def ticket_url
  @ticket_url
end

Class Method Details

.from_json(json_object:) ⇒ Merge::Ticketing::TicketRequest

Deserialize a JSON object to an instance of TicketRequest

Parameters:

  • json_object (String)

Returns:



163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 163

def self.from_json(json_object:)
  struct = JSON.parse(json_object, object_class: OpenStruct)
  parsed_json = JSON.parse(json_object)
  name = parsed_json["name"]
  assignees = parsed_json["assignees"]&.map do |item|
    item = item.to_json
    Merge::Ticketing::TicketRequestAssigneesItem.from_json(json_object: item)
  end
  if parsed_json["creator"].nil?
    creator = nil
  else
    creator = parsed_json["creator"].to_json
    creator = Merge::Ticketing::TicketRequestCreator.from_json(json_object: creator)
  end
  due_date = (DateTime.parse(parsed_json["due_date"]) unless parsed_json["due_date"].nil?)
  status = parsed_json["status"]
  description = parsed_json["description"]
  collections = parsed_json["collections"]&.map do |item|
    item = item.to_json
    Merge::Ticketing::TicketRequestCollectionsItem.from_json(json_object: item)
  end
  ticket_type = parsed_json["ticket_type"]
  if parsed_json["account"].nil?
     = nil
  else
     = parsed_json["account"].to_json
     = Merge::Ticketing::TicketRequestAccount.from_json(json_object: )
  end
  if parsed_json["contact"].nil?
    contact = nil
  else
    contact = parsed_json["contact"].to_json
    contact = Merge::Ticketing::TicketRequestContact.from_json(json_object: contact)
  end
  if parsed_json["parent_ticket"].nil?
    parent_ticket = nil
  else
    parent_ticket = parsed_json["parent_ticket"].to_json
    parent_ticket = Merge::Ticketing::TicketRequestParentTicket.from_json(json_object: parent_ticket)
  end
  attachments = parsed_json["attachments"]&.map do |item|
    item = item.to_json
    Merge::Ticketing::TicketRequestAttachmentsItem.from_json(json_object: item)
  end
  tags = parsed_json["tags"]
  completed_at = (DateTime.parse(parsed_json["completed_at"]) unless parsed_json["completed_at"].nil?)
  ticket_url = parsed_json["ticket_url"]
  priority = parsed_json["priority"]
  integration_params = parsed_json["integration_params"]
   = parsed_json["linked_account_params"]
  remote_fields = parsed_json["remote_fields"]&.map do |item|
    item = item.to_json
    Merge::Ticketing::RemoteFieldRequest.from_json(json_object: item)
  end
  new(
    name: name,
    assignees: assignees,
    creator: creator,
    due_date: due_date,
    status: status,
    description: description,
    collections: collections,
    ticket_type: ticket_type,
    account: ,
    contact: contact,
    parent_ticket: parent_ticket,
    attachments: attachments,
    tags: tags,
    completed_at: completed_at,
    ticket_url: ticket_url,
    priority: priority,
    integration_params: integration_params,
    linked_account_params: ,
    remote_fields: remote_fields,
    additional_properties: struct
  )
end

.validate_raw(obj:) ⇒ Void

Leveraged for Union-type generation, validate_raw attempts to parse the given

hash and check each fields type against the current object's property
definitions.

Parameters:

  • obj (Object)

Returns:

  • (Void) 


254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 254

def self.validate_raw(obj:)
  obj.name&.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
  obj.assignees&.is_a?(Array) != false || raise("Passed value for field obj.assignees is not the expected type, validation failed.")
  obj.creator.nil? || Merge::Ticketing::TicketRequestCreator.validate_raw(obj: obj.creator)
  obj.due_date&.is_a?(DateTime) != false || raise("Passed value for field obj.due_date is not the expected type, validation failed.")
  obj.status&.is_a?(Merge::Ticketing::TicketStatusEnum) != false || raise("Passed value for field obj.status is not the expected type, validation failed.")
  obj.description&.is_a?(String) != false || raise("Passed value for field obj.description is not the expected type, validation failed.")
  obj.collections&.is_a?(Array) != false || raise("Passed value for field obj.collections is not the expected type, validation failed.")
  obj.ticket_type&.is_a?(String) != false || raise("Passed value for field obj.ticket_type is not the expected type, validation failed.")
  obj..nil? || Merge::Ticketing::TicketRequestAccount.validate_raw(obj: obj.)
  obj.contact.nil? || Merge::Ticketing::TicketRequestContact.validate_raw(obj: obj.contact)
  obj.parent_ticket.nil? || Merge::Ticketing::TicketRequestParentTicket.validate_raw(obj: obj.parent_ticket)
  obj.attachments&.is_a?(Array) != false || raise("Passed value for field obj.attachments is not the expected type, validation failed.")
  obj.tags&.is_a?(Array) != false || raise("Passed value for field obj.tags is not the expected type, validation failed.")
  obj.completed_at&.is_a?(DateTime) != false || raise("Passed value for field obj.completed_at is not the expected type, validation failed.")
  obj.ticket_url&.is_a?(String) != false || raise("Passed value for field obj.ticket_url is not the expected type, validation failed.")
  obj.priority&.is_a?(Merge::Ticketing::PriorityEnum) != false || raise("Passed value for field obj.priority is not the expected type, validation failed.")
  obj.integration_params&.is_a?(Hash) != false || raise("Passed value for field obj.integration_params is not the expected type, validation failed.")
  obj.&.is_a?(Hash) != false || raise("Passed value for field obj.linked_account_params is not the expected type, validation failed.")
  obj.remote_fields&.is_a?(Array) != false || raise("Passed value for field obj.remote_fields is not the expected type, validation failed.")
end

Instance Method Details

#to_json(*_args) ⇒ String

Serialize an instance of TicketRequest to a JSON object

Returns:

  • (String) 


244
245
246
 
# File 'lib/merge_ruby_client/ticketing/types/ticket_request.rb', line 244

def to_json(*_args)
  @_field_set&.to_json
end