Skip to main content

<a id=“SuperOffice_WebApi_Data_TicketEntity”></a> Class TicketEntity

Namespace: SuperOffice.WebApi.Data
Assembly: SuperOffice.WebApi.dll
Carrier object for TicketEntity. The ticket entity is used for representing a service ticket

Inheritance

objectCarrierTicketEntity

Inherited Members

Carrier.TableRight, Carrier.FieldProperties, object.ToString(), object.Equals(object), object.Equals(object, object), object.ReferenceEquals(object, object), object.GetHashCode(), object.GetType(), object.MemberwiseClone()

Examples

Get TicketEntity 123 using the WebApi client: <pre><code class=“lang-csharp”>var configuration = new WebApiConfiguration(url); var agent = new TicketAgent(configuration); var ticketEntity = agent.GetTicketEntity( 123 );</code></pre>

Remarks

Use <xref href=“SuperOffice.CRM.Services.ArchiveAgent?text=Archive+agent” data-throw-if-not-resolved=“false”></xref>: All TicketEntity: <pre><code class=“lang-csharp”>“Ticket”</code></pre> Messages: <pre><code class=“lang-csharp”>“TicketMessage”</code></pre> with restriction <pre><code class=“lang-csharp”>“ticketId eq ” + id</code></pre>.

Constructors

<a id=“SuperOffice_WebApi_Data_TicketEntity__ctor”></a> TicketEntity()

Default constructor - defaults any enum props to 0.

Properties

<a id=“SuperOffice_WebApi_Data_TicketEntity_Activate”></a> Activate

When the ticket should be activated, if it is postponed.

Property Value

DateTime

<a id=“SuperOffice_WebApi_Data_TicketEntity_ActiveStatusMonitorId”></a> ActiveStatusMonitorId

Active status monitor identity for related contact. This is a read-only property and is ignored on Save

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_AlertLevel”></a> AlertLevel

The alert level for the ticket. Matches the level value of the ticket_alert table.

Property Value

short

<a id=“SuperOffice_WebApi_Data_TicketEntity_AlertTimeout”></a> AlertTimeout

The datetime for when the ticket should jump to the next alert_level.

Property Value

DateTime

<a id=“SuperOffice_WebApi_Data_TicketEntity_Author”></a> Author

A string representing the author of the ticket (same as author of first message).

Property Value

string

<a id=“SuperOffice_WebApi_Data_TicketEntity_BaseStatus”></a> BaseStatus

The status of the ticket. I.e. active/closed/postponed/deleted NULL if unknown enum value.

Property Value

TicketBaseStatus?

See Also

TicketEntity.BaseStatus_String

<a id=“SuperOffice_WebApi_Data_TicketEntity_BaseStatus_String”></a> BaseStatus_String

The status of the ticket. I.e. active/closed/postponed/deleted Raw string enum value.

Property Value

string

See Also

TicketEntity.BaseStatus

<a id=“SuperOffice_WebApi_Data_TicketEntity_Category”></a> Category

The ticket category entity which this ticket is connected to <p>Use MDO List name “ejcategory” to get list items.</p>

Property Value

TicketCategoryEntity

<a id=“SuperOffice_WebApi_Data_TicketEntity_ClosedAt”></a> ClosedAt

When the ticket was closed.

Property Value

DateTime

<a id=“SuperOffice_WebApi_Data_TicketEntity_ConnectId”></a> ConnectId

If a ticket is connected to another ticket, this field is set to the id of the &apos;master&apos; ticket.

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_CreatedAt”></a> CreatedAt

When the ticket was created.

Property Value

DateTime

<a id=“SuperOffice_WebApi_Data_TicketEntity_CreatedBy”></a> CreatedBy

The associate who created this ticket

Property Value

Associate

<a id=“SuperOffice_WebApi_Data_TicketEntity_CustomFields”></a> CustomFields

Udef + Extra fields added to the carrier. Extra fields as defined by changes to database schema + user-defined fields as defined by admin. Custom fields combines user defined fields and extra fields into one bucket. The individual <xref href=“SuperOffice.WebApi.Data.TicketEntity.ExtraFields” data-throw-if-not-resolved=“false”></xref> and UserDefinedFields properties are deprecated in favor of this combined collection. The value string is the encoded value: “[I:123]” or “[DT:2019-09-11]”.

Property Value

StringDictionary

Remarks

The naming convention of the key string is as follows: <table><tbody><tr><td class=“term”>Extra field data</td><td class=“description”> [Extra field name]<p></p> Example: <pre><code class=“lang-csharp”>‘x_gorp’ = ‘[I:123]’</code></pre> </td></tr><tr><td class=“term”>User defined field data</td><td class=“description”> [Prog-id name]<p></p> Example: <pre><code class=“lang-csharp”>‘SuperOffice:1’ = ‘[I:123]’</code></pre><p></p> </td></tr></tbody></table>

<a id=“SuperOffice_WebApi_Data_TicketEntity_Deadline”></a> Deadline

Deadline for ticket.

Property Value

DateTime

<a id=“SuperOffice_WebApi_Data_TicketEntity_ExtraFields”></a> ExtraFields

Deprecated: Use <xref href=“SuperOffice.WebApi.Data.TicketEntity.CustomFields” data-throw-if-not-resolved=“false”></xref> instead. Extra fields added to the carrier. This could be data from Plug-ins, the foreign key system, external applications, etc. The value string is the encoded value: “[I:123]” or “[DT:2019-09-11]”.

Property Value

StringDictionary

Remarks

The naming convention of the key string is as follows: <table><tbody><tr><td class=“term”>Plug-in data</td><td class=“description”> [Plug-in name].[Property name] Example: DocumentPlugin.DocumentType </td></tr><tr><td class=“term”>Foreign key data</td><td class=“description”> The device identity is appended directly to the device name if it exists. This is not commonly used, but the database opens for this as a possibility to have several devices with the same name, and hence we would ensure an unique key if this field is used. Example: Audience.SecretService.DefaultCountry </td></tr><tr><td class=“term”>User defined table data</td><td class=“description”> [Table name].[Field name] Example: Phunneling.AggregatedSales </td></tr><tr><td class=“term”>Other</td><td class=“description”> Other data sources must ensure an unique name. If the key already exists we do not add the data to the dictionary. We also ensure that SuperOffice data are added first, so that existing data doesnt change when more data sources are added (with duplicate data keys). </td></tr></tbody></table>

<a id=“SuperOffice_WebApi_Data_TicketEntity_FirstReadByOwner”></a> FirstReadByOwner

The datetime for when the ticket first was read by the current owner.

Property Value

DateTime

<a id=“SuperOffice_WebApi_Data_TicketEntity_FirstReadByUser”></a> FirstReadByUser

The datetime for when the ticket first was read by a user.

Property Value

DateTime

<a id=“SuperOffice_WebApi_Data_TicketEntity_FormSubmission”></a> FormSubmission

The form submission that this ticket is connected to

Property Value

TicketFormSubmission

<a id=“SuperOffice_WebApi_Data_TicketEntity_FromAddress”></a> FromAddress

The from-address used when this ticket got created, e.g. by email

Property Value

string

<a id=“SuperOffice_WebApi_Data_TicketEntity_HasAttachment”></a> HasAttachment

Boolean indicating if this ticket has one or more attachments.

Property Value

bool

<a id=“SuperOffice_WebApi_Data_TicketEntity_IconHint”></a> IconHint

Icon representing ticket’s state

Property Value

string

<a id=“SuperOffice_WebApi_Data_TicketEntity_Language”></a> Language

The language of the first external message

Property Value

string

<a id=“SuperOffice_WebApi_Data_TicketEntity_LastChanged”></a> LastChanged

The last time the ticket was modified.

Property Value

DateTime

<a id=“SuperOffice_WebApi_Data_TicketEntity_Messages”></a> Messages

TicketMessageId,CreatedAt,SLevel and Important for all the messages connected to this ticket. For message body see the TicketMessageEntity or the TicketMessage archive.

Property Value

TicketMessage[]

<a id=“SuperOffice_WebApi_Data_TicketEntity_NumMessages”></a> NumMessages

The total number of messages for this request.

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_NumReplies”></a> NumReplies

The number of replies (messages) to the customer for this request.

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_OrigHumanCategoryId”></a> OrigHumanCategoryId

Will contain the category id selected by the user, when having the choice of using the suggested category or manually selecting a category

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_Origin”></a> Origin

What is the origin of this ticket NULL if unknown enum value.

Property Value

TicketOrigin?

See Also

TicketEntity.Origin_String

<a id=“SuperOffice_WebApi_Data_TicketEntity_Origin_String”></a> Origin_String

What is the origin of this ticket Raw string enum value.

Property Value

string

See Also

TicketEntity.Origin

<a id=“SuperOffice_WebApi_Data_TicketEntity_OwnedBy”></a> OwnedBy

The associate who owns this ticket. Setting the id to 0 will make the ticket unassigned. Setting the id to 2147483647 (MaxInt) will make it automatically assigned according to the ticket category assignment rules. <p>Use MDO List name “associate” to get list items.</p>

Property Value

Associate

<a id=“SuperOffice_WebApi_Data_TicketEntity_Person”></a> Person

The primary person that this ticket is connected to <p>Use MDO List name “person_new” to get list items.</p>

Property Value

Person

<a id=“SuperOffice_WebApi_Data_TicketEntity_Priority”></a> Priority

The ticket priority entity which this ticket is connected to <p>Use MDO List name “ticketpriority” to get list items.</p>

Property Value

TicketPriorityEntity

<a id=“SuperOffice_WebApi_Data_TicketEntity_Project”></a> Project

The project that this ticket is connected to <p>Use MDO List name “project” to get list items.</p>

Property Value

Project

<a id=“SuperOffice_WebApi_Data_TicketEntity_ReadByCustomer”></a> ReadByCustomer

The datetime for when the ticket was read by the customer.

Property Value

DateTime

<a id=“SuperOffice_WebApi_Data_TicketEntity_ReadByOwner”></a> ReadByOwner

The datetime for when the ticket last was read by the owner.

Property Value

DateTime

<a id=“SuperOffice_WebApi_Data_TicketEntity_ReadStatus”></a> ReadStatus

Whether the owner has read the ticket or not (red, yellow, green). NULL if unknown enum value.

Property Value

TicketReadStatus?

See Also

TicketEntity.ReadStatus_String

<a id=“SuperOffice_WebApi_Data_TicketEntity_ReadStatus_String”></a> ReadStatus_String

Whether the owner has read the ticket or not (red, yellow, green). Raw string enum value.

Property Value

string

See Also

TicketEntity.ReadStatus

<a id=“SuperOffice_WebApi_Data_TicketEntity_RealTimeSpentExternally”></a> RealTimeSpentExternally

The total time (seconds) within 24x7 the ticket has been in a external waiting status (configurable), not including current state

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_RealTimeSpentInternally”></a> RealTimeSpentInternally

The total time (seconds) within 24x7 the ticket has been in an open status (configurable), not including current state

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_RealTimeSpentQueue”></a> RealTimeSpentQueue

The total time (seconds) within 24x7 hours the ticket has been in a queue status, not including current state

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_RealTimeToClose”></a> RealTimeToClose

Same as time_to_close, but not calculated based on priority.

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_RealTimeToReply”></a> RealTimeToReply

Same as time_to_reply, but not calculated based on priority.

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_RepliedAt”></a> RepliedAt

The datetime for when the ticket was replied to. I.e. the first external message added to the ticket.

Property Value

DateTime

<a id=“SuperOffice_WebApi_Data_TicketEntity_Sale”></a> Sale

The sale that this ticket is connected to <p>Use MDO List name “sale” to get list items.</p>

Property Value

Sale

<a id=“SuperOffice_WebApi_Data_TicketEntity_SecondaryPersons”></a> SecondaryPersons

The secondary persons this ticket is connected to <p>Use MDO List name “person_new” to get list items.</p>

Property Value

Person[]

<a id=“SuperOffice_WebApi_Data_TicketEntity_Sentiment”></a> Sentiment

The sentiment index of the last external message

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_SentimentConfidence”></a> SentimentConfidence

The sentiment confidence of the last external message

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_Slevel”></a> Slevel

The securitylevel of the ticket. NULL if unknown enum value.

Property Value

TicketSecurityLevel?

See Also

TicketEntity.Slevel_String

<a id=“SuperOffice_WebApi_Data_TicketEntity_Slevel_String”></a> Slevel_String

The securitylevel of the ticket. Raw string enum value.

Property Value

string

See Also

TicketEntity.Slevel

<a id=“SuperOffice_WebApi_Data_TicketEntity_Status”></a> Status

The ticket status entity which this ticket is connected to <p>Use MDO List name “ticketstatus” to get list items.</p>

Property Value

TicketStatusEntity

<a id=“SuperOffice_WebApi_Data_TicketEntity_SuggestedCategoryId”></a> SuggestedCategoryId

Suggestion for categorization, based on the text of the message (AI)

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_SuggestedCategoryName”></a> SuggestedCategoryName

Suggested category from AI

Property Value

string

<a id=“SuperOffice_WebApi_Data_TicketEntity_Tags”></a> Tags

An array containing the tags assigned to this request

Property Value

Tag[]

<a id=“SuperOffice_WebApi_Data_TicketEntity_TicketId”></a> TicketId

The primary key (auto-incremented)

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_TicketType”></a> TicketType

Type of the Request <p>Use MDO List name “TicketType” to get list items.</p>

Property Value

TicketType

<a id=“SuperOffice_WebApi_Data_TicketEntity_TimeSpent”></a> TimeSpent

The total time (minutes). Aggregated time spent from ticket&apos;s messages. Read-only for external use.

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_TimeSpentExternally”></a> TimeSpentExternally

The total time (seconds) within the priority’s office hours the ticket has been in a external waiting status (configurable), not including current state

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_TimeSpentInternally”></a> TimeSpentInternally

The total time (seconds) within the priority’s office hours the ticket has been in an open status (configurable), not including current state

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_TimeSpentQueue”></a> TimeSpentQueue

The total time (seconds) within the priority’s office hours the ticket has been in a queue status, not including current state

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_TimeToClose”></a> TimeToClose

The time (minutes) between when the ticket was created and when it was closed. Calculated based on priority&apos;s timeframe.

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_TimeToReply”></a> TimeToReply

The time (minutes) between when the ticket was created and when it was replied to. Calculated based on priority&apos;s timeframe.

Property Value

int

<a id=“SuperOffice_WebApi_Data_TicketEntity_Title”></a> Title

The title of the ticket.

Property Value

string

See Also

TicketAgent, ArchiveAgent,