OBJECT

Job

A job, typically in the field.

link GraphQL Schema definition

  • type Job implements CustomfielddataableInterface, FileableInterface, NoteableInterface, RecentitemableInterface, TaskableInterface, LoggableInterface {
  • # The ID of the entity.
  • id: Int64Bit!
  • # An ID that uniquely identifies this entity across the whole Sonar system.
  • sonar_unique_id: ID!
  • # The date and time this entity was created.
  • created_at: Datetime!
  • # The last date and time this entity was modified.
  • updated_at: Datetime!
  • # A string that shows the version of this entity. It will be incremented whenever
  • # the entity is modified.
  • _version: String!
  • # Whether or not this is complete.
  • complete: Boolean!
  • # The `User` that completed this.
  • completed_by_user_id: Int64Bit
  • # Whether this `Job` was completed successfully or not.
  • completed_successfully: Boolean
  • # The date and time this `Job` was completed.
  • completion_datetime: Datetime
  • # Any notes entered when this `Job` was completed.
  • completion_notes: Text
  • # The ID of a `JobType`.
  • job_type_id: Int64Bit!
  • # The ID of the entity that this `Job` is associated with.
  • jobbable_id: Int64Bit!
  • # The type of entity that this `Job` is associated with.
  • jobbable_type: JobbableType!
  • # The length in minutes for this `Job`.
  • length_in_minutes: Int!
  • # The date and time this `Job` is scheduled for.
  • scheduled_datetime: Datetime
  • # The ID of a `Ticket`.
  • ticket_id: Int64Bit
  • # The entity that this `Job` is associated with.
  • #
  • # Arguments
  • # id: The ID of the entity.
  • # sonar_unique_id: An ID that uniquely identifies this entity
  • # across the whole Sonar system.
  • # created_at: The date and time this entity was created.
  • # updated_at: The last date and time this entity was modified.
  • # paginator: Provides the ability to paginate through results.
  • # sorter: Provides the ability to sort results.
  • # search: Complex search parameters.
  • # general_search: Search across all string fields with partial
  • # matching.
  • jobbable(
  • id: Int64Bit,
  • sonar_unique_id: ID,
  • created_at: Datetime,
  • updated_at: Datetime,
  • paginator: Paginator,
  • sorter: [Sorter],
  • search: [Search],
  • general_search: String
  • ): JobbableInterface
  • # The type of a `Job`.
  • #
  • # Arguments
  • # id: The ID of the entity.
  • # sonar_unique_id: An ID that uniquely identifies this entity
  • # across the whole Sonar system.
  • # created_at: The date and time this entity was created.
  • # updated_at: The last date and time this entity was modified.
  • # _version: A string that shows the version of this entity. It
  • # will be incremented whenever the entity is modified.
  • # account_status_id_completion: If this is set, any `Job` using
  • # this `JobType` that is completed successfully while associated with an `Account`
  • # will change the `Account` to this `AccountStatus`.
  • # account_status_id_failure: If this is set, any `Job` using this
  • # `JobType` that is completed unsuccessfully while associated with an `Account`
  • # will change the `Account` to this `AccountStatus`.
  • # all_companies: Whether or not this `JobType` is valid for all
  • # `Companies`.
  • # allow_completion_with_incomplete_tasks: Whether `Job`s
  • # associated with this `JobType` should be able to be completed with incomplete
  • # tasks.
  • # color: Color.
  • # contract_template_id: The ID of a `ContractTemplate`.
  • # default_length_in_minutes: The default length for a `Job`
  • # created using this `JobType`.
  • # enabled: Whether or not this is enabled.
  • # icon: An icon.
  • # name: A descriptive name.
  • # task_template_id: The ID of a `TaskTemplate`.
  • # ticket_group_id_completion: If this is set, any `Job` using
  • # this `JobType` that is completed successfully will create a `Ticket` and assign
  • # it to this `TicketGroup`.
  • # ticket_group_id_failure: If this is set, any `Job` using this
  • # `JobType` that is completed unsuccessfully will create a `Ticket` and assign it
  • # to this `TicketGroup`.
  • # paginator: Provides the ability to paginate through results.
  • # sorter: Provides the ability to sort results.
  • # search: Complex search parameters.
  • # general_search: Search across all string fields with partial
  • # matching.
  • # aggregation: Provides the ability to return aggregated
  • # mathematical data about your results.
  • # reverse_relation_filters: Reverse relation filters allow you to
  • # filter the result of a relation, and use that filter to affect the returned root
  • # elements.
  • job_type(
  • id: Int64Bit,
  • sonar_unique_id: ID,
  • created_at: Datetime,
  • updated_at: Datetime,
  • _version: String,
  • account_status_id_completion: Int64Bit,
  • account_status_id_failure: Int64Bit,
  • all_companies: Boolean,
  • allow_completion_with_incomplete_tasks: Boolean,
  • color: HtmlHexColor,
  • contract_template_id: Int64Bit,
  • default_length_in_minutes: Int,
  • enabled: Boolean,
  • icon: Icon,
  • name: String,
  • task_template_id: Int64Bit,
  • ticket_group_id_completion: Int64Bit,
  • ticket_group_id_failure: Int64Bit,
  • paginator: Paginator,
  • sorter: [Sorter],
  • search: [Search],
  • general_search: String,
  • aggregation: [Aggregator],
  • reverse_relation_filters: [ReverseRelationFilter]
  • ): JobType
  • # A ticket.
  • #
  • # Arguments
  • # id: The ID of the entity.
  • # sonar_unique_id: An ID that uniquely identifies this entity
  • # across the whole Sonar system.
  • # created_at: The date and time this entity was created.
  • # updated_at: The last date and time this entity was modified.
  • # _version: A string that shows the version of this entity. It
  • # will be incremented whenever the entity is modified.
  • # closed_at: The time this was closed at.
  • # closed_by_user_id: The ID of the `User` that closed this.
  • # description: A human readable description.
  • # due_date: The date this invoice is due by.
  • # inbound_mailbox_id: The ID of an `InboundMailbox`.
  • # parent_ticket_id: The ID of the `Ticket` that this `Ticket` is
  • # a child of.
  • # priority: The priority of this item.
  • # status: The status.
  • # subject: The subject.
  • # ticket_group_id: The ID of a `TicketGroup`.
  • # ticketable_id: The ID of the entity that this `Ticket` is
  • # associated with.
  • # ticketable_type: The type of entity that this `Ticket` is
  • # associated with.
  • # user_id: The ID of a User.
  • # paginator: Provides the ability to paginate through results.
  • # sorter: Provides the ability to sort results.
  • # search: Complex search parameters.
  • # general_search: Search across all string fields with partial
  • # matching.
  • # aggregation: Provides the ability to return aggregated
  • # mathematical data about your results.
  • # reverse_relation_filters: Reverse relation filters allow you to
  • # filter the result of a relation, and use that filter to affect the returned root
  • # elements.
  • ticket(
  • id: Int64Bit,
  • sonar_unique_id: ID,
  • created_at: Datetime,
  • updated_at: Datetime,
  • _version: String,
  • closed_at: Datetime,
  • closed_by_user_id: Int64Bit,
  • description: Text,
  • due_date: Date,
  • inbound_mailbox_id: Int64Bit,
  • parent_ticket_id: Int64Bit,
  • priority: TicketPriority,
  • status: TicketStatus,
  • subject: String,
  • ticket_group_id: Int64Bit,
  • ticketable_id: Int64Bit,
  • ticketable_type: TicketableType,
  • user_id: Int64Bit,
  • paginator: Paginator,
  • sorter: [Sorter],
  • search: [Search],
  • general_search: String,
  • aggregation: [Aggregator],
  • reverse_relation_filters: [ReverseRelationFilter]
  • ): Ticket
  • # The user that completed this `Job`.
  • #
  • # Arguments
  • # id: The ID of the entity.
  • # sonar_unique_id: An ID that uniquely identifies this entity
  • # across the whole Sonar system.
  • # created_at: The date and time this entity was created.
  • # updated_at: The last date and time this entity was modified.
  • # _version: A string that shows the version of this entity. It
  • # will be incremented whenever the entity is modified.
  • # completed_setup: Whether or not the user has completed the
  • # setup process.
  • # email_address: An email address.
  • # enabled: Whether or not this is enabled.
  • # is_sonar_staff: Whether or not this user is a Sonar employee.
  • # language: A supported language.
  • # mobile_number: A mobile phone number. This will be used to send
  • # SMS messages.
  • # name: A descriptive name.
  • # public_name: The publicly viewable name of this user.
  • # role_id: The ID of a Role.
  • # super_admin: Super admins receive all system permissions
  • # automatically, regardless of their role.
  • # username: A username, used for authentication.
  • # paginator: Provides the ability to paginate through results.
  • # sorter: Provides the ability to sort results.
  • # search: Complex search parameters.
  • # general_search: Search across all string fields with partial
  • # matching.
  • # aggregation: Provides the ability to return aggregated
  • # mathematical data about your results.
  • # reverse_relation_filters: Reverse relation filters allow you to
  • # filter the result of a relation, and use that filter to affect the returned root
  • # elements.
  • completed_by_user(
  • id: Int64Bit,
  • sonar_unique_id: ID,
  • created_at: Datetime,
  • updated_at: Datetime,
  • _version: String,
  • completed_setup: Boolean,
  • email_address: EmailAddress,
  • enabled: Boolean,
  • is_sonar_staff: Boolean,
  • language: Language,
  • mobile_number: Numeric,
  • name: String,
  • public_name: String,
  • role_id: Int64Bit,
  • super_admin: Boolean,
  • username: String,
  • paginator: Paginator,
  • sorter: [Sorter],
  • search: [Search],
  • general_search: String,
  • aggregation: [Aggregator],
  • reverse_relation_filters: [ReverseRelationFilter]
  • ): User
  • # A user that can login to Sonar.
  • #
  • # Arguments
  • # id: The ID of the entity.
  • # sonar_unique_id: An ID that uniquely identifies this entity
  • # across the whole Sonar system.
  • # created_at: The date and time this entity was created.
  • # updated_at: The last date and time this entity was modified.
  • # _version: A string that shows the version of this entity. It
  • # will be incremented whenever the entity is modified.
  • # completed_setup: Whether or not the user has completed the
  • # setup process.
  • # email_address: An email address.
  • # enabled: Whether or not this is enabled.
  • # is_sonar_staff: Whether or not this user is a Sonar employee.
  • # language: A supported language.
  • # mobile_number: A mobile phone number. This will be used to send
  • # SMS messages.
  • # name: A descriptive name.
  • # public_name: The publicly viewable name of this user.
  • # role_id: The ID of a Role.
  • # super_admin: Super admins receive all system permissions
  • # automatically, regardless of their role.
  • # username: A username, used for authentication.
  • # paginator: Provides the ability to paginate through results.
  • # sorter: Provides the ability to sort results.
  • # search: Complex search parameters.
  • # general_search: Search across all string fields with partial
  • # matching.
  • # aggregation: Provides the ability to return aggregated
  • # mathematical data about your results.
  • # reverse_relation_filters: Reverse relation filters allow you to
  • # filter the result of a relation, and use that filter to affect the returned root
  • # elements.
  • users(
  • id: Int64Bit,
  • sonar_unique_id: ID,
  • created_at: Datetime,
  • updated_at: Datetime,
  • _version: String,
  • completed_setup: Boolean,
  • email_address: EmailAddress,
  • enabled: Boolean,
  • is_sonar_staff: Boolean,
  • language: Language,
  • mobile_number: Numeric,
  • name: String,
  • public_name: String,
  • role_id: Int64Bit,
  • super_admin: Boolean,
  • username: String,
  • paginator: Paginator,
  • sorter: [Sorter],
  • search: [Search],
  • general_search: String,
  • aggregation: [Aggregator],
  • reverse_relation_filters: [ReverseRelationFilter]
  • ): UserConnection!
  • # The record of a check in to a `Job`.
  • #
  • # Arguments
  • # id: The ID of the entity.
  • # sonar_unique_id: An ID that uniquely identifies this entity
  • # across the whole Sonar system.
  • # created_at: The date and time this entity was created.
  • # updated_at: The last date and time this entity was modified.
  • # _version: A string that shows the version of this entity. It
  • # will be incremented whenever the entity is modified.
  • # check_in_datetime: The date and time that this `Job` was
  • # checked into.
  • # check_out_datetime: The date and time that this `Job` was
  • # checked out of.
  • # checked_in_by_user_id: The ID of the `User` that created this
  • # check in.
  • # checked_out_by_user_id: The ID of the `User` that updated this
  • # check in with a check out date and time.
  • # job_id: The ID of a `Job`.
  • # user_id: The ID of a User.
  • # paginator: Provides the ability to paginate through results.
  • # sorter: Provides the ability to sort results.
  • # search: Complex search parameters.
  • # general_search: Search across all string fields with partial
  • # matching.
  • # aggregation: Provides the ability to return aggregated
  • # mathematical data about your results.
  • # reverse_relation_filters: Reverse relation filters allow you to
  • # filter the result of a relation, and use that filter to affect the returned root
  • # elements.
  • job_check_ins(
  • id: Int64Bit,
  • sonar_unique_id: ID,
  • created_at: Datetime,
  • updated_at: Datetime,
  • _version: String,
  • check_in_datetime: Datetime,
  • check_out_datetime: Datetime,
  • checked_in_by_user_id: Int64Bit,
  • checked_out_by_user_id: Int64Bit,
  • job_id: Int64Bit,
  • user_id: Int64Bit,
  • paginator: Paginator,
  • sorter: [Sorter],
  • search: [Search],
  • general_search: String,
  • aggregation: [Aggregator],
  • reverse_relation_filters: [ReverseRelationFilter]
  • ): JobCheckInConnection!
  • # A `Service` associated with a `Job`.
  • #
  • # Arguments
  • # id: The ID of the entity.
  • # sonar_unique_id: An ID that uniquely identifies this entity
  • # across the whole Sonar system.
  • # created_at: The date and time this entity was created.
  • # updated_at: The last date and time this entity was modified.
  • # _version: A string that shows the version of this entity. It
  • # will be incremented whenever the entity is modified.
  • # job_id: The ID of a `Job`.
  • # quantity: The quantity for this service.
  • # service_id: The ID of a Service.
  • # paginator: Provides the ability to paginate through results.
  • # sorter: Provides the ability to sort results.
  • # search: Complex search parameters.
  • # general_search: Search across all string fields with partial
  • # matching.
  • # aggregation: Provides the ability to return aggregated
  • # mathematical data about your results.
  • # reverse_relation_filters: Reverse relation filters allow you to
  • # filter the result of a relation, and use that filter to affect the returned root
  • # elements.
  • job_services(
  • id: Int64Bit,
  • sonar_unique_id: ID,
  • created_at: Datetime,
  • updated_at: Datetime,
  • _version: String,
  • job_id: Int64Bit,
  • quantity: Int,
  • service_id: Int64Bit,
  • paginator: Paginator,
  • sorter: [Sorter],
  • search: [Search],
  • general_search: String,
  • aggregation: [Aggregator],
  • reverse_relation_filters: [ReverseRelationFilter]
  • ): JobServiceConnection!
  • # Data entered into a `CustomField`.
  • #
  • # Arguments
  • # id: The ID of the entity.
  • # sonar_unique_id: An ID that uniquely identifies this entity
  • # across the whole Sonar system.
  • # created_at: The date and time this entity was created.
  • # updated_at: The last date and time this entity was modified.
  • # _version: A string that shows the version of this entity. It
  • # will be incremented whenever the entity is modified.
  • # custom_field_id: The ID of a CustomField that is associated
  • # with this type of entity.
  • # customfielddataable_id: The ID of the entity that owns this
  • # custom field data.
  • # customfielddataable_type: The type of entity that owns this
  • # custom field data.
  • # value: The value.
  • # paginator: Provides the ability to paginate through results.
  • # sorter: Provides the ability to sort results.
  • # search: Complex search parameters.
  • # general_search: Search across all string fields with partial
  • # matching.
  • # aggregation: Provides the ability to return aggregated
  • # mathematical data about your results.
  • # reverse_relation_filters: Reverse relation filters allow you to
  • # filter the result of a relation, and use that filter to affect the returned root
  • # elements.
  • custom_field_data(
  • id: Int64Bit,
  • sonar_unique_id: ID,
  • created_at: Datetime,
  • updated_at: Datetime,
  • _version: String,
  • custom_field_id: Int64Bit,
  • customfielddataable_id: Int64Bit,
  • customfielddataable_type: CustomfielddataableType,
  • value: String,
  • paginator: Paginator,
  • sorter: [Sorter],
  • search: [Search],
  • general_search: String,
  • aggregation: [Aggregator],
  • reverse_relation_filters: [ReverseRelationFilter]
  • ): CustomFieldDataConnection!
  • # A file.
  • #
  • # Arguments
  • # id: The ID of the entity.
  • # sonar_unique_id: An ID that uniquely identifies this entity
  • # across the whole Sonar system.
  • # created_at: The date and time this entity was created.
  • # updated_at: The last date and time this entity was modified.
  • # _version: A string that shows the version of this entity. It
  • # will be incremented whenever the entity is modified.
  • # description: A human readable description.
  • # file_size_in_bytes: The file size, in bytes.
  • # fileable_id: The ID of the entity that owns this file.
  • # fileable_type: The type of entity that owns this file.
  • # filename: The file name.
  • # mime_type: The MIME type of the file.
  • # primary_image: An image file may be set to the primary image.
  • # This will be used as the displayed image for the object that this file is
  • # associated to throughout Sonar.
  • # user_id: The ID of a User.
  • # paginator: Provides the ability to paginate through results.
  • # sorter: Provides the ability to sort results.
  • # search: Complex search parameters.
  • # general_search: Search across all string fields with partial
  • # matching.
  • # aggregation: Provides the ability to return aggregated
  • # mathematical data about your results.
  • # reverse_relation_filters: Reverse relation filters allow you to
  • # filter the result of a relation, and use that filter to affect the returned root
  • # elements.
  • files(
  • id: Int64Bit,
  • sonar_unique_id: ID,
  • created_at: Datetime,
  • updated_at: Datetime,
  • _version: String,
  • description: String,
  • file_size_in_bytes: Int64Bit,
  • fileable_id: Int64Bit,
  • fileable_type: FileableType,
  • filename: String,
  • mime_type: String,
  • primary_image: Boolean,
  • user_id: Int64Bit,
  • paginator: Paginator,
  • sorter: [Sorter],
  • search: [Search],
  • general_search: String,
  • aggregation: [Aggregator],
  • reverse_relation_filters: [ReverseRelationFilter]
  • ): FileConnection!
  • # A note.
  • #
  • # Arguments
  • # id: The ID of the entity.
  • # sonar_unique_id: An ID that uniquely identifies this entity
  • # across the whole Sonar system.
  • # created_at: The date and time this entity was created.
  • # updated_at: The last date and time this entity was modified.
  • # _version: A string that shows the version of this entity. It
  • # will be incremented whenever the entity is modified.
  • # message: The message.
  • # noteable_id: The ID of the entity that owns this note.
  • # noteable_type: The type of entity that owns this note.
  • # priority: The priority of this item.
  • # user_id: The ID of a User.
  • # paginator: Provides the ability to paginate through results.
  • # sorter: Provides the ability to sort results.
  • # search: Complex search parameters.
  • # general_search: Search across all string fields with partial
  • # matching.
  • # aggregation: Provides the ability to return aggregated
  • # mathematical data about your results.
  • # reverse_relation_filters: Reverse relation filters allow you to
  • # filter the result of a relation, and use that filter to affect the returned root
  • # elements.
  • notes(
  • id: Int64Bit,
  • sonar_unique_id: ID,
  • created_at: Datetime,
  • updated_at: Datetime,
  • _version: String,
  • message: Text,
  • noteable_id: Int64Bit,
  • noteable_type: NoteableType,
  • priority: NotePriority,
  • user_id: Int64Bit,
  • paginator: Paginator,
  • sorter: [Sorter],
  • search: [Search],
  • general_search: String,
  • aggregation: [Aggregator],
  • reverse_relation_filters: [ReverseRelationFilter]
  • ): NoteConnection!
  • # A task.
  • #
  • # Arguments
  • # id: The ID of the entity.
  • # sonar_unique_id: An ID that uniquely identifies this entity
  • # across the whole Sonar system.
  • # created_at: The date and time this entity was created.
  • # updated_at: The last date and time this entity was modified.
  • # _version: A string that shows the version of this entity. It
  • # will be incremented whenever the entity is modified.
  • # complete: Whether or not this is complete.
  • # completed_at: The date and time this was completed.
  • # completed_by_user_id: The `User` that completed this.
  • # due: The date on which the task is due.
  • # task: The task to be performed.
  • # taskable_id: The ID of the entity that the task is associated
  • # with.
  • # taskable_type: The entity that the task is associated with.
  • # user_id: The ID of a User.
  • # paginator: Provides the ability to paginate through results.
  • # sorter: Provides the ability to sort results.
  • # search: Complex search parameters.
  • # general_search: Search across all string fields with partial
  • # matching.
  • # aggregation: Provides the ability to return aggregated
  • # mathematical data about your results.
  • # reverse_relation_filters: Reverse relation filters allow you to
  • # filter the result of a relation, and use that filter to affect the returned root
  • # elements.
  • tasks(
  • id: Int64Bit,
  • sonar_unique_id: ID,
  • created_at: Datetime,
  • updated_at: Datetime,
  • _version: String,
  • complete: Boolean,
  • completed_at: Datetime,
  • completed_by_user_id: Int64Bit,
  • due: Date,
  • task: Text,
  • taskable_id: Int64Bit,
  • taskable_type: TaskableType,
  • user_id: Int64Bit,
  • paginator: Paginator,
  • sorter: [Sorter],
  • search: [Search],
  • general_search: String,
  • aggregation: [Aggregator],
  • reverse_relation_filters: [ReverseRelationFilter]
  • ): TaskConnection!
  • # A log entry.
  • #
  • # Arguments
  • # id: The ID of the entity.
  • # sonar_unique_id: An ID that uniquely identifies this entity
  • # across the whole Sonar system.
  • # created_at: The date and time this entity was created.
  • # updated_at: The last date and time this entity was modified.
  • # _version: A string that shows the version of this entity. It
  • # will be incremented whenever the entity is modified.
  • # current: Current data.
  • # legacy: Whether or not this log was transferred from a Sonar v1
  • # instance. If so, the formatting will not match current version logs.
  • # legacy_title: A title which is only populated on logs that were
  • # imported from Sonar v1.
  • # level: The severity level.
  • # loggable_id: The ID of the entity that this log is attached to.
  • # loggable_type: The type of entity that this log is attached to.
  • # logged_entity_id: The entity ID that triggered the log.
  • # logged_entity_type: The entity that triggered the log.
  • # message: The message.
  • # previous: Previous data.
  • # relation_data: Data from objects related to this change.
  • # type: The type.
  • # user_id: The ID of a User.
  • # paginator: Provides the ability to paginate through results.
  • # sorter: Provides the ability to sort results.
  • # search: Complex search parameters.
  • # general_search: Search across all string fields with partial
  • # matching.
  • # aggregation: Provides the ability to return aggregated
  • # mathematical data about your results.
  • # reverse_relation_filters: Reverse relation filters allow you to
  • # filter the result of a relation, and use that filter to affect the returned root
  • # elements.
  • logs(
  • id: Int64Bit,
  • sonar_unique_id: ID,
  • created_at: Datetime,
  • updated_at: Datetime,
  • _version: String,
  • current: Text,
  • legacy: Boolean,
  • legacy_title: String,
  • level: LogLevel,
  • loggable_id: Int64Bit,
  • loggable_type: String,
  • logged_entity_id: Int64Bit,
  • logged_entity_type: String,
  • message: Text,
  • previous: Text,
  • relation_data: Text,
  • type: LogType,
  • user_id: Int64Bit,
  • paginator: Paginator,
  • sorter: [Sorter],
  • search: [Search],
  • general_search: String,
  • aggregation: [Aggregator],
  • reverse_relation_filters: [ReverseRelationFilter]
  • ): LogConnection!
  • }