OBJECT
OnlineFormTypeEntity
Online form definition: the fields and settings of a web form whose submissions create or update records.
link GraphQL Schema definition
- type OnlineFormTypeEntity {
- # True when the record has unpublished draft changes, including pending
- # translation changes, that can be published.
- : Boolean
- # True when the record is protected against deletion because it must always exist
- # in the space. Deleting a record that is not protected can still fail on other
- # checks. Read-only.
- : Boolean!
- # Typed, read-only view of the online form definition (formEdit): its fields,
- # layout and settings.
- : OnlineForm
- # False for types whose read-only setting is fixed, such as the recurrent
- # appointment type; true otherwise.
- : Boolean
- # Unique identifier of entity.
- : ID!
- # Specifies if the entity is considered deleted.
- : Boolean
- # Last modification time.
- : DateTime
- # Creation time.
- : DateTime
- # User who owns the online form.
- : ClientEntity
- # Visual style applied to the form when rendered.
- : OnlineFormStyleEntity
- # When true, the embedded form JavaScript pre-fills fields from URL query
- # parameters on load.
- : Boolean
- # Free-text description shown alongside the form definition in the UI.
- : String
- # API name of the custom entity the form targets. Set only when entityType is
- # CustomEntity; otherwise empty.
- : String
- # Entity the form is built for: its fields can be placed on the form and each
- # submission is linked to a record of this entity. For custom entities,
- # entityApiName identifies the custom entity.
- : BaseEntityTypeEnum!
- # Definition of the form layout (fields, sections, settings) shown to respondents,
- # as a JSON object conforming to the online-form layout schema. Validated on
- # write. This payload conforms to the `OnlineForm` JSON Schema:
- # https://api-doc.coevera.com/schemas/OnlineForm.json
- : JSONString!
- # When true, the form is published and accepts new submissions; when false, the
- # form returns an error to respondents.
- : Boolean!
- # True when the form is system-managed and its schema cannot be edited by users.
- : Boolean!
- # Timestamp of the most recent change to formEdit (form schema).
- : DateTime
- # Timestamp of the most recent change to isEnabled.
- : DateTime
- # Name of the entity and its default text representation.
- : String!
- # Tracks which threshold-reached notifications have already been sent for the
- # current form configuration. Reset when the configuration changes.
- : JSONString
- # Id of the owning user.
- : ID!
- # Id of the form style.
- : ID!
- # Revision when entity was lastly changed.
- : Int
- # Minimum response count required for the form to be considered "responsive" in
- # reports and notifications. Empty when no threshold is configured.
- : Int
- # Total number of times the form link has been delivered to recipients.
- : Int
- # Number of distinct recipients the form link has been delivered to.
- : Int
- # Total number of submissions (responses) recorded for the form.
- : Int
- # Fraction (0–1) of unique recipients who submitted a response.
- : Float
- # Timestamp of the most recent submission. Empty when the form has no responses.
- : DateTime
- # Name or email address of the respondent on the most recent submission. Empty
- # when the form has no responses or the respondent could not be identified.
- : String
- # Solutions whose canvas contains this record. Deleted solutions are not included.
- #
- # Arguments
- # before: Cursor until which to take entities to result set.
- # after: Cursor after which to start taking entities to result
- # set.
- # first: Number of entities to return from beginning of the
- # result set.
- # last: Return only the "last" number of entities from result
- # set.
- (: String, : String, : Int, : Int): SolutionEntityConnection
- # Submissions (one per response) recorded for this form.
- #
- # Arguments
- # filter: Filter OnlineForm relations by target OnlineForm
- # attributes.
- # orderBy: Order OnlineForm relations by target OnlineForm
- # attributes.
- # includeDeleted: Returns deleted target records as well. Default
- # is true.
- # before: Cursor until which to take entities to result set.
- # after: Cursor after which to start taking entities to result
- # set.
- # first: Number of entities to return from beginning of the
- # result set.
- # last: Return only the "last" number of entities from result
- # set.
- (
- : OnlineFormFilterInput,
- : [OnlineFormOrderByInput!],
- : Boolean,
- : String,
- : String,
- : Int,
- : Int
- ): OnlineFormEntityConnection
- # Short identifier used in the public form URL (see link). Stable across the
- # lifetime of the form.
- : String!
- # Sum of response values used to evaluate the response acceptance threshold (e.g.
- # total responses, or evaluated value of the custom acceptance condition). Empty
- # when no threshold is configured.
- : Int
- # Public URL for accessing the form (suitable for sharing with respondents).
- : String
- # Overall state of the form: Inactive while it has no active configuration, Active
- # while accepting responses, Completed once the configured end condition is met.
- : ProcessStatusEnum
- # True when the form is configured with custom reCAPTCHA credentials; false when
- # using the platform default reCAPTCHA setup.
- : Boolean!
- # Permissions the current user has on this record, out of the requested ones.
- #
- # Arguments
- # permissions: Permissions to check; the result lists those the
- # current user has.
- (: [EntityPermsEnum!]!): [EntityPermsEnum!]!
- # Ids of all fields that appear in at least one submission of this form.
- : [ID!]!
- # Records the form was sent to or that responded to it, one item per record with
- # its send and response dates and number of responses.
- #
- # Arguments
- # category: Which records to list: those that responded, those
- # the form was sent to, those sent the form without responding, or responses not
- # linked to any record.
- # sortBy: Column to sort by; the response or send date by
- # default, per category.
- # sortOrder: Sort direction; descending by default.
- # before: Cursor until which to take entities to result set.
- # after: Cursor after which to start taking entities to result
- # set.
- # first: Number of entities to return from beginning of the
- # result set.
- # last: Return only the "last" number of entities from result
- # set.
- (
- : ResponseSummaryRelationCategory!,
- : OnlineFormTypeDetailGridSortBy,
- : SortOrder,
- : String,
- : String,
- : Int,
- : Int
- ): OnlineFormResponseSummaryItemConnection
- # Submissions of this form with their answers.
- #
- # Arguments
- # filter: Conditions the submissions must match.
- # sortBy: Column to sort by; the response date by default.
- # sortByFieldId: Form field whose answers the submissions are
- # sorted by; required when `sortBy` is ResponseValue.
- # sortOrder: Sort direction; descending by default.
- # before: Cursor until which to take entities to result set.
- # after: Cursor after which to start taking entities to result
- # set.
- # first: Number of entities to return from beginning of the
- # result set.
- # last: Return only the "last" number of entities from result
- # set.
- (
- : FieldFilterParams,
- : OnlineFormTypeDetailResponseGridSortBy,
- : ID,
- : SortOrder,
- : String,
- : String,
- : Int,
- : Int
- ): OnlineFormResponseItemConnection
- # Files uploaded through the submissions of this form.
- #
- # Arguments
- # filter: Conditions selecting the submissions whose files are
- # returned.
- # fieldIds: Limits the files to those uploaded through these form
- # fields; all fields when omitted.
- (: OnlineFormFilterInput, : [UUID!]): OnlineFormUploadedFiles!
- }
link Require by
- CloudObjectFolderEntityFolder that organizes files, either in the company documents or within a record.
- CreateOnlineFormTypePayloadResult of the createOnlineFormType mutation.
- DeleteOnlineFormTypePayloadResult of the deleteOnlineFormType mutation.
- OnlineFormEntitySubmission (response) of an online form, with the answers and the records it created or updated.
- OnlineFormTypeEmailRelationEntityEmail that sent an online form link to a recipient, with the record it was sent on.
- OnlineFormTypeEntityEdgeA Relay edge containing a `OnlineFormTypeEntity` and its cursor.
- OnlineFormTypeRepositoryRead operations for OnlineFormType records.
- UpdateOnlineFormTypePayloadResult of the updateOnlineFormType mutation.