Class Submission

java.lang.Object
org.apache.cayenne.PersistentObject
org.apache.cayenne.BaseDataObject
org.apache.cayenne.CayenneDataObject
All Implemented Interfaces:
IEntity, Serializable, org.apache.cayenne.DataObject, org.apache.cayenne.Persistent, org.apache.cayenne.Validating

@CommitLog public class Submission extends _Submission
Provides an entity containing data submitted by the user along with additional information and status values.
See Also:
  • Field Details

    • ABANDONMENT_REASON_PROPERTY

      public static final String ABANDONMENT_REASON_PROPERTY
      Provides the 'abandonmentReason' property name.
      See Also:
    • CLIENT_CODE_PROPERTY

      public static final String CLIENT_CODE_PROPERTY
      Provides the 'clientCode' property name.
      See Also:
    • CLIENT_NAME_PROPERTY

      public static final String CLIENT_NAME_PROPERTY
      Provides the 'clientName' property name.
      See Also:
    • DATA_VALIDATION_MESSAGE_PROPERTY

      public static final String DATA_VALIDATION_MESSAGE_PROPERTY
      Provides the 'dataValidationMessage' property name.
      See Also:
    • FORM_CODE_PROPERTY

      public static final String FORM_CODE_PROPERTY
      Provides the 'formCode' property name.
      See Also:
    • FORM_NAME_PROPERTY

      public static final String FORM_NAME_PROPERTY
      Provides the 'formName' property name.
      See Also:
    • IP_ADDRESS_PROPERTY

      public static final String IP_ADDRESS_PROPERTY
      Provides the 'ipAddress' property name.
      See Also:
    • PERCENTAGE_COMPLETED_PROPERTY

      public static final String PERCENTAGE_COMPLETED_PROPERTY
      Provides the 'percentageCompleted' property name.
      See Also:
    • PROCESSING_STATUS_PROPERTY

      public static final String PROCESSING_STATUS_PROPERTY
      Provides the 'processingStatus' property name.
      See Also:
    • PROCESSING_STATUS_TIME_PROPERTY

      public static final String PROCESSING_STATUS_TIME_PROPERTY
      Provides the 'processingStatusTime' property name.
      See Also:
    • REFERER_PROPERTY

      public static final String REFERER_PROPERTY
      Provides the 'referer' property name.
      See Also:
    • REQUEST_URL_PROPERTY

      public static final String REQUEST_URL_PROPERTY
      Provides the 'requestUrl' property name.
      See Also:
    • SAVED_MESSAGE_PROPERTY

      public static final String SAVED_MESSAGE_PROPERTY
      Provides the 'savedMessage' property name.
      See Also:
    • SUBMISSION_MESSAGE_PROPERTY

      public static final String SUBMISSION_MESSAGE_PROPERTY
      Provides the 'submissionMessage' property name.
      See Also:
    • TASK_EMAIL_SUBJECT_PROPERTY

      public static final String TASK_EMAIL_SUBJECT_PROPERTY
      Provides the 'taskEmailSubject' property name.
      See Also:
    • TASK_EMAIL_MESSAGE_PROPERTY

      public static final String TASK_EMAIL_MESSAGE_PROPERTY
      Provides the 'taskEmailMessage' property name.
      See Also:
    • TASK_MESSAGE_PROPERTY

      public static final String TASK_MESSAGE_PROPERTY
      Provides the 'taskMessage' property name.
      See Also:
    • USER_AGENT_PROPERTY

      public static final String USER_AGENT_PROPERTY
      Provides the 'userAgent' property name.
      See Also:
    • USER_AGENT_BROWSER_TYPE_PROPERTY

      public static final String USER_AGENT_BROWSER_TYPE_PROPERTY
      Provides the 'userAgentBrowserType' property name.
      See Also:
    • USER_AGENT_BROWSER_VERSION_PROPERTY

      public static final String USER_AGENT_BROWSER_VERSION_PROPERTY
      Provides the 'userAgentBrowserVersion' property name.
      See Also:
    • USER_AGENT_OS_TYPE_PROPERTY

      public static final String USER_AGENT_OS_TYPE_PROPERTY
      Provides the 'userAgentOsType' property name.
      See Also:
    • USER_AGENT_OS_VERSION_PROPERTY

      public static final String USER_AGENT_OS_VERSION_PROPERTY
      Provides the 'userAgentOsVersion' property name.
      See Also:
    • TASK_GROUP_NAME_PROPERTY

      @Deprecated public static final String TASK_GROUP_NAME_PROPERTY
      Deprecated.
      as of TM 4.1, tasks can be associated with multiple groups. Use SUBMISSION_GROUP_NAMES_PROPERTY instead.
      An auxiliary property combining the name of the assignee group for task submissions
      See Also:
    • SUBMISSION_GROUP_NAMES_PROPERTY

      public static final String SUBMISSION_GROUP_NAMES_PROPERTY
      An auxiliary property listing the names of all groups associated with a submission
      See Also:
    • USER_AGENT_BROWSER_PROPERTY

      public static final String USER_AGENT_BROWSER_PROPERTY
      An auxiliary property combining all available information about the user's browser
      See Also:
    • USER_AGENT_OS_PROPERTY

      public static final String USER_AGENT_OS_PROPERTY
      An auxiliary property combining all available information about the user's operating system
      See Also:
    • STATUS_Assigned

      public static final String STATUS_Assigned
      Provides an "Assigned" status
      See Also:
    • STATUS_Opened

      public static final String STATUS_Opened
      Provides a "Opended" status
      See Also:
    • STATUS_Saved

      public static final String STATUS_Saved
      Provides a "Saved" status
      See Also:
    • STATUS_Abandoned

      public static final String STATUS_Abandoned
      Provides an "Abandoned" status
      See Also:
    • STATUS_Submitted

      public static final String STATUS_Submitted
      Provides a "Submitted" status
      See Also:
    • STATUS_Required

      public static final String STATUS_Required
      Provides a "Required" status
      See Also:
    • STATUS_Optional

      public static final String STATUS_Optional
      Provides an "Optional" status
      See Also:
    • STATUS_In_Progress

      public static final String STATUS_In_Progress
      Provides an "In Progress" status
      See Also:
    • STATUS_Pending

      public static final String STATUS_Pending
      Provides an "Pending" status
      See Also:
    • STATUS_NotReady

      public static final String STATUS_NotReady
      Provides a "Not Ready" status
      See Also:
    • STATUS_NotRequired

      public static final String STATUS_NotRequired
      Provides a "Not Ready" status
      See Also:
    • STATUS_Ready

      public static final String STATUS_Ready
      Provides a "Ready" status
      See Also:
    • STATUS_DetailsRequired

      public static final String STATUS_DetailsRequired
      Provides a "Details Required" status
      See Also:
    • STATUS_PaymentRequired

      public static final String STATUS_PaymentRequired
      Provides a "Payment Required" status
      See Also:
    • STATUS_Sent_Email

      public static final String STATUS_Sent_Email
      Provides a "Sent Email" status
      See Also:
    • STATUS_Completed

      public static final String STATUS_Completed
      Provides a "Completed" status
      See Also:
    • STATUS_COMPLETED_UPLOAD

      public static final String STATUS_COMPLETED_UPLOAD
      Provides a "Completed - Upload Scanned Copy" status
      See Also:
    • STATUS_COMPLETED_MANUALLY

      public static final String STATUS_COMPLETED_MANUALLY
      Provides a "Completed - Deliver Manually" status
      See Also:
    • STATUS_Expired

      public static final String STATUS_Expired
      Provides an "Expired" status
      See Also:
    • STATUS_Cancelled

      public static final String STATUS_Cancelled
      Provides a "Cancelled" status
      See Also:
    • STATUS_Undeliverable

      public static final String STATUS_Undeliverable
      Provides an "Undeliverable" status
      See Also:
    • STATUS_Error

      public static final String STATUS_Error
      Provides an "Error" status
      See Also:
    • STATUS_Error_No_Data

      public static final String STATUS_Error_No_Data
      Provides an "Error - No Data" status
      See Also:
    • STATUS_Ineligible

      public static final String STATUS_Ineligible
      Provides an "Ineligible" status
      See Also:
    • TASK_TYPE_FORM

      public static final String TASK_TYPE_FORM
      The Constant 'Form' Task Type.
      See Also:
    • TASK_TYPE_REVIEW

      public static final String TASK_TYPE_REVIEW
      The Constant 'Review' Task Type.
      See Also:
    • PAYMENT_TYPE_BPAY

      public static final String PAYMENT_TYPE_BPAY
      Indicates that the payment method "BPAY" was selected
      See Also:
    • PAYMENT_TYPE_CreditCard

      public static final String PAYMENT_TYPE_CreditCard
      Indicates that the payment method "Credit/Debit Card" was selected
      See Also:
    • PAYMENT_TYPE_Hosted

      public static final String PAYMENT_TYPE_Hosted
      Indicates that the payment method "Hosted" was selected
      See Also:
    • PAYMENT_TYPE_EFT

      public static final String PAYMENT_TYPE_EFT
      Indicates that the payment method "EFT" was selected
      See Also:
    • PAYMENT_TYPE_Manual

      public static final String PAYMENT_TYPE_Manual
      Indicates that the payment was completed manually.
      See Also:
    • FORM_STATUS_VALUES

      public static final String[] FORM_STATUS_VALUES
      The set of form status values
    • SUBMISSION_FORM_STATUS_VALUES

      public static final String[] SUBMISSION_FORM_STATUS_VALUES
      The set of searchable submission form status values (the same as FORM_STATUS_VALUES excluding Assigned and Opened )
    • TASK_STATUS_VALUES

      public static final String[] TASK_STATUS_VALUES
      The set of form status values relevant to tasks
    • ATTACHMENT_STATUS_VALUES

      public static final String[] ATTACHMENT_STATUS_VALUES
      The set of attachment status values
    • PAYMENT_STATUS_VALUES

      public static final String[] PAYMENT_STATUS_VALUES
      The set of payment status values
    • RECEIPT_STATUS_VALUES

      public static final String[] RECEIPT_STATUS_VALUES
      The set of receipt status values
    • DELIVERY_STATUS_VALUES

      public static final String[] DELIVERY_STATUS_VALUES
      The set of delivery status values
    • EMAIL_VERIFICATION_STATUS_VALUES

      public static final String[] EMAIL_VERIFICATION_STATUS_VALUES
      The set of email verification status values
    • TASK_TYPE_VALUES

      public static final String[] TASK_TYPE_VALUES
      The set of task type values.
    • PAYMENT_TYPE_VALUES

      public static final String[] PAYMENT_TYPE_VALUES
      The set of payment type values
    • DELIVERY_WEB_SERVICE_PULL

      public static final String DELIVERY_WEB_SERVICE_PULL
      Indicates that the delivery method is web service pull
      See Also:
    • DELIVERY_EMAIL

      public static final String DELIVERY_EMAIL
      Indicates that the delivery method is standard email
      See Also:
    • DELIVERY_EMAIL_SECURE

      public static final String DELIVERY_EMAIL_SECURE
      Indicates that the delivery method is secure email
      See Also:
    • DELIVERY_PROCESS

      public static final String DELIVERY_PROCESS
      Indicates that the delivery method is LiveCycle process delivery
      See Also:
    • DELIVERY_MANUAL

      public static final String DELIVERY_MANUAL
      Indicates that delivery was manually set to completed
      See Also:
    • HOST_CONTEXT_FieldWorker

      public static final String HOST_CONTEXT_FieldWorker
      The 'FieldWorker' form host context.
      See Also:
    • HOST_CONTEXT_IFRAME

      public static final String HOST_CONTEXT_IFRAME
      The 'IFrame' form host context.
      See Also:
    • HOST_CONTEXT_PAGE

      public static final String HOST_CONTEXT_PAGE
      The 'Page' form host context.
      See Also:
    • LC_OUTPUT_FILTER

      public static final int LC_OUTPUT_FILTER
      The bit filter for LC Output
      See Also:
    • LC_FORMS_FILTER

      public static final int LC_FORMS_FILTER
      The bit filter for LC Forms
      See Also:
    • LC_DIGITAL_SIGNATURES_FILTER

      public static final int LC_DIGITAL_SIGNATURES_FILTER
      The bit filter for LC Digital Signatures
      See Also:
    • LC_READER_EXTENSIONS_FILTER

      public static final int LC_READER_EXTENSIONS_FILTER
      The bit filter for LC Reader Extensions
      See Also:
    • LC_PROCESS_MANAGEMENT_FILTER

      public static final int LC_PROCESS_MANAGEMENT_FILTER
      The bit filter for LC Process Management
      See Also:
    • JOB_PROCESS_IMMEDIATE_FILTER

      public static final int JOB_PROCESS_IMMEDIATE_FILTER
      The bit filter for job-related submissions with immediate processing turned on
      See Also:
  • Constructor Details

    • Submission

      public Submission()
  • Method Details

    • getTaskGroupName

      @Deprecated public String getTaskGroupName()
      Deprecated.
      as of TM 4.1, tasks can be associated with multiple groups. Please use getSubmissionGroupNameSet instead (which returns all group names regardless whether the submission is a task), or getSubmissionGroupNames.
      Return the name of the assignee group for task submissions, or null if no group is assigned or the submission is not based on a task
      Returns:
      the name of the task group
      Since:
      4.0.0
    • getSubmissionGroupNameSet

      public Set<String> getSubmissionGroupNameSet()
      Return the set of names of the group(s) associated with the submission, or null if no group is assigned
      Returns:
      the set of group names
      Since:
      4.1.0
    • getSubmissionGroupNames

      public String getSubmissionGroupNames()
      Return the submission group names, sorted ascending.
      Returns:
      the submission group names.
      Since:
      4.0.0
    • getUserAgentBrowser

      public String getUserAgentBrowser()
      Returns:
      information about the user's browser
    • getUserAgentOs

      public String getUserAgentOs()
      Returns:
      information about the user's os
    • isEmailVerificationOutstanding

      public boolean isEmailVerificationOutstanding()
      Return whether submission email verification is outstanding
      Returns:
      true if the email verification status is STATUS_Required, STATUS_Pending or STATUS_Error
    • isEmailVerificationRequired

      public boolean isEmailVerificationRequired()
      Return whether submission email verification is required (meaning the initial email has not yet been sent)
      Returns:
      true if the email verification status is STATUS_Required
    • isEmailVerificationCompleted

      public boolean isEmailVerificationCompleted()
      Return whether submission email verification has been completed
      Returns:
      true if the email verification status is STATUS_Completed
    • isEmailVerificationAbandoned

      public boolean isEmailVerificationAbandoned()
      Return whether submission email verification has been abandoned
      Returns:
      true if the email verification status is STATUS_Abandoned
    • isDataValidationError

      public boolean isDataValidationError()
      Return true if a submission data validation error has occurred.
      Returns:
      true if a submission data validation error has occurred
      Since:
      4.2.0
    • isFormCancelledByAdministrator

      public boolean isFormCancelledByAdministrator()
      Return true if the Undeliverable flag was used to force submissions to be cancelled
      Returns:
      true if the delivery status is STATUS_Undeliverable and the form status is not STATUS_Completed
    • isFormAssigned

      public boolean isFormAssigned()
      Return whether the submission is currently assigned.
      Returns:
      true if the form status is STATUS_Assigned
    • isFormOpened

      public boolean isFormOpened()
      Return whether the form is currently opened.
      Returns:
      true if the form status is STATUS_Opened
    • isFormSaved

      public boolean isFormSaved()
      Return whether the form is currently saved.
      Returns:
      true if the form status is STATUS_Saved
    • isFormSubmitted

      public boolean isFormSubmitted()
      Return whether the form has been submitted
      Returns:
      true if the form status is STATUS_Submitted
    • isFormCompleted

      public boolean isFormCompleted()
      Return whether the form status is completed
      Returns:
      true if the form status is STATUS_Completed
    • isFormExpired

      public boolean isFormExpired()
      Return whether the form status is expired
      Returns:
      true if the form status is STATUS_Expired
    • isFormAbandoned

      public boolean isFormAbandoned()
      Return whether the form status is abandoned
      Returns:
      true if the form status is STATUS_Abandoned
    • isFormOpenAbandoned

      public boolean isFormOpenAbandoned()
      Return true if the form status is Abandoned and form abandonment status is Opened.
      Returns:
      true if the form status is Abandoned and form abandonment status is Opened
      Since:
      4.2.0
    • isFormStartAbandoned

      public boolean isFormStartAbandoned()
      Return true if the form status is Abandoned and form abandonment status is Saved and is not user save.
      Returns:
      true if the form status is Abandoned and form abandonment status is Saved and is not user save.
      Since:
      4.3.3
    • getFormAbandonmentType

      public String getFormAbandonmentType()
      Return the form abandonment type [ Bounced | Started | Cancelled | Submitted | Saved | Assigned | Expired] if the form status is "Abandoned", or null otherwise
      Returns:
      the form abandonment type [ Bounced | Started | Cancelled | Submitted | Saved | Assigned | Expired ]
      Since:
      5.0.0
    • isHostContextIFrame

      public boolean isHostContextIFrame()
      Return whether the form host context is 'IFrame'
      Returns:
      true if the form host context is HOST_CONTEXT_IFRAME
    • isReceiptReady

      public boolean isReceiptReady()
      Return whether the submission is ready for its receipt to be rendered
      Returns:
      true if the receipt status is STATUS_Ready
    • isReceiptInProgress

      public boolean isReceiptInProgress()
      Return whether the submission is in the process of being rendered by a background job
      Returns:
      true if the receipt status is STATUS_In_Progress
      Since:
      4.3.4
    • isReceiptCompleted

      public boolean isReceiptCompleted()
      Return whether a receipt has been created for the submission
      Returns:
      true if the receipt status is STATUS_Completed
    • isReceiptError

      public boolean isReceiptError()
      Return whether an error occurred during receipt generation
      Returns:
      true if the receipt status is STATUS_Error
    • isPaymentRequired

      public boolean isPaymentRequired()
      Return whether the submission requires payment
      Returns:
      true if the payment status is STATUS_Required
    • isPaymentError

      public boolean isPaymentError()
      Return whether an error occurred during payment
      Returns:
      true if the payment status is STATUS_Error
    • isPaymentCompleted

      public boolean isPaymentCompleted()
      Return whether the payment has been completed
      Returns:
      true if the payment status is STATUS_Completed
    • isPaymentPending

      public boolean isPaymentPending()
      Return whether the payment is pending confirmation
      Returns:
      true if the payment status is STATUS_Pending
    • isPaymentOutstanding

      public boolean isPaymentOutstanding()
      Return whether payment is still outstanding
      Returns:
      true if the payment status is STATUS_Required, STATUS_Error
    • isPaymentTypeBPAY

      public boolean isPaymentTypeBPAY()
      Return whether the submission payment type is "BPAY"
      Returns:
      true if the payment type is PAYMENT_TYPE_BPAY
    • isPaymentTypeCreditCard

      public boolean isPaymentTypeCreditCard()
      Return whether the submission payment type is "Credit/Debit Card"
      Returns:
      true if the payment type is PAYMENT_TYPE_CreditCard
    • isPaymentTypeHosted

      public boolean isPaymentTypeHosted()
      Returns whether this submission requires payment via a hosted service (e.g. WestpacQuickWeb)
      Returns:
      true if the payment type is PAYMENT_TYPE_Hosted
    • isPaymentTypeEFT

      public boolean isPaymentTypeEFT()
      Return whether the submission payment type is "EFT"
      Returns:
      true if the payment type is PAYMENT_TYPE_EFT
    • isDeliveryCompleted

      public boolean isDeliveryCompleted()
      Return whether submission delivery has been completed
      Returns:
      true if the delivery status is STATUS_Completed
    • isDeliveryError

      public boolean isDeliveryError()
      Return whether an error occurred during submission delivery
      Returns:
      true if the delivery status is STATUS_Error
    • isDeliveryReady

      public boolean isDeliveryReady()
      Return whether the submission is ready to be delivered
      Returns:
      true if the delivery status is STATUS_Ready
    • isDeliveryNotReady

      public boolean isDeliveryNotReady()
      Return whether the submission is not ready for delivery (generally due to outstanding user work)
      Returns:
      true if the delivery status is STATUS_NotReady
    • isDeliveryNotRequired

      public boolean isDeliveryNotRequired()
      Return whether the submission delivery is not required
      Returns:
      true if the delivery status is STATUS_NotRequired
    • isDeliveryInProgress

      public boolean isDeliveryInProgress()
      Return whether the submission is delivery is in progress
      Returns:
      true if the delivery status is STATUS_In_Progress
      Since:
      3.6.0
    • isDeliveryPending

      public boolean isDeliveryPending()
      Return whether the submission is delivery is pending
      Returns:
      true if the delivery status is STATUS_Pending
      Since:
      3.6.0
    • isUndeliverable

      public boolean isUndeliverable()
      Return whether the submission has been marked as undeliverable
      Returns:
      true if the delivery status is STATUS_Undeliverable
    • isDeliveryConfigured

      public boolean isDeliveryConfigured()
      Return whether delivery details are configured for the submission.
      Returns:
      true if delivery details are configured for the submission
    • isAttachmentsCompleted

      public boolean isAttachmentsCompleted()
      Return whether attachments have been completed
      Returns:
      true if the attachment status is STATUS_Completed
    • isAttachmentsOptional

      public boolean isAttachmentsOptional()
      Return whether all mandatory attachments have been completed.
      Note: Even after completing mandatory attachments, the user has to explicitly confirm that have finished working on the attachments - otherwise, the submission will not progress.
      Returns:
      true if the attachment status is STATUS_Optional
    • isAttachmentsOutstanding

      public boolean isAttachmentsOutstanding()
      Return whether attachments are still outstanding
      Returns:
      true if the attachment status is STATUS_Required or STATUS_Optional
    • isAuthenticationCompleted

      public boolean isAuthenticationCompleted()
      Return whether the user has logged on to acknowledge a submission
      Returns:
      true if the authentication status is STATUS_Completed
    • isAuthenticationRequired

      public boolean isAuthenticationRequired()
      Return whether the user needs to log on to acknowledge a submission
      Returns:
      true if the authentication status is STATUS_Required
    • isAuthenticationCancelled

      public boolean isAuthenticationCancelled()
      Return whether the user has rejected an unauthenticated submission
      Returns:
      true if the authentication status is STATUS_Cancelled
    • isUserWorkCompleted

      public boolean isUserWorkCompleted()
      Return whether the user has completed everything about the submission (i.e. everything that is outstanding are tasks performed by SmartForm Manager, such as virus scanning)
      Returns:
      true if the submission has been completed by the user
    • isUserWorkCompletedExcludingAuthentication

      public boolean isUserWorkCompletedExcludingAuthentication()
      TODO: LP to check-in proper method
      Returns:
      todo
    • getCurrentRequestLog

      public RequestLog getCurrentRequestLog()
      Return the most recent form or receipt request log associated with the submission.
      Returns:
      the request log with the most recent request, or null if no request log was found
    • getCurrentFormRequestLog

      public RequestLog getCurrentFormRequestLog()
      Return the most recent form request log associated with the submission.
      Returns:
      the request log with the most recent request, or null if no form request log was found
      Since:
      17.10.4
    • isLcOutputSubmission

      @Deprecated public boolean isLcOutputSubmission()
      Deprecated.
      do not use; this will be removed in a future release
      Returns:
      false
    • setLcOutputSubmission

      @Deprecated public void setLcOutputSubmission(boolean isLcOutputSubmission)
      Deprecated.
      do not use; this will be removed in a future release
      Parameters:
      isLcOutputSubmission - unused
    • isLcFormsSubmission

      @Deprecated public boolean isLcFormsSubmission()
      Deprecated.
      do not use; this will be removed in a future release
      Returns:
      false
    • setLcFormsSubmission

      @Deprecated public void setLcFormsSubmission(boolean isLcFormsSubmission)
      Deprecated.
      do not use; this will be removed in a future release
      Parameters:
      isLcFormsSubmission - unused
    • isLcDsigSubmission

      @Deprecated public boolean isLcDsigSubmission()
      Deprecated.
      do not use; this will be removed in a future release
      Returns:
      false
    • setLcDsigSubmission

      @Deprecated public void setLcDsigSubmission(boolean isLcDsigSubmission)
      Deprecated.
      do not use; this will be removed in a future release
      Parameters:
      isLcDsigSubmission - unused
    • isLcReaderExtensionsSubmission

      @Deprecated public boolean isLcReaderExtensionsSubmission()
      Deprecated.
      do not use; this will be removed in a future release
      Returns:
      false
    • setLcReaderExtensionsSubmission

      @Deprecated public void setLcReaderExtensionsSubmission(boolean isLcReSubmission)
      Deprecated.
      do not use; this will be removed in a future release
      Parameters:
      isLcReSubmission - unused
    • isLcProcessManagementSubmission

      @Deprecated public boolean isLcProcessManagementSubmission()
      Deprecated.
      do not use; this will be removed in a future release
      Returns:
      false
    • setLcProcessManagementSubmission

      @Deprecated public void setLcProcessManagementSubmission(boolean isLcPmSubmission)
      Deprecated.
      do not use; this will be removed in a future release
      Parameters:
      isLcPmSubmission - unused
    • isJobSubmissionWithProcessImmediate

      @Deprecated public boolean isJobSubmissionWithProcessImmediate()
      Deprecated.
      do not use; this will be removed in a future release Please instead use this check: getJob() != null invalid input: '&'invalid input: '&' getJob().isProcessImmediateFlag()
      Returns:
      deprecated
    • setJobSubmissionWithProcessImmediate

      @Deprecated public void setJobSubmissionWithProcessImmediate(boolean isJobWithImmediateProcessing)
      Deprecated.
      do not use; this will be removed in a future release
      Parameters:
      isJobWithImmediateProcessing - unused
    • isJobFormEditable

      public boolean isJobFormEditable()
      Return true if submission job form is editable.
      Returns:
      true if submission job form is editable
      Since:
      4.2.0
    • isAssociatedWithPortal

      public boolean isAssociatedWithPortal(Portal portal)
      Return whether the submission is associated with the given portal
      Parameters:
      portal - the portal (required)
      Returns:
      true if the submission has been submitted using the portal, or its form has been assigned the given portal
    • setSaveChallengeAnswer

      public void setSaveChallengeAnswer(String rawChallengeAnswer)
      Processes the challenge answer and stores the hash value. If the answer is null or blank, null is stored as the hash value.
      Parameters:
      rawChallengeAnswer - the answer as parsed out of the form
    • isSavedFormChallengeAnswerCorrect

      public boolean isSavedFormChallengeAnswerCorrect(String proposedAnswer)
      Compares a proposed challenge answer to the answer stored for the submission. Note: All whitespace is stripped from the proposed answer, and it is converted to lower case prior to comparing. No other processing is done, so the data format must match.
      Parameters:
      proposedAnswer - the proposed answer entered by the user
      Returns:
      true if the user's answer matched the answer stored for the submission, false otherwise
    • hasSaveChallengeHash

      public boolean hasSaveChallengeHash()
      Returns:
      true if the submission has a save challenge hash value.
      Since:
      4.3.1
    • hasSaveChallengeTimedOut

      public boolean hasSaveChallengeTimedOut()
      Return true if a save challenge timeout is defined and its value has timed out.
      Returns:
      true if a save challenge timeout is defined and its value has timed out
      Since:
      4.3.0
    • getDataExtractMap

      public Map<String,String> getDataExtractMap()
      Return submission data extract map (name/value). Please note this map provides a convenient view of the submission data extracts, and does not model a Cayenne relationship. This data extract map is ordered by data extract sequence number.
      Returns:
      submission data extract map (name/value)
      Since:
      3.5.1
    • getFormDataMap

      public Map<String,String> getFormDataMap()
      Return the Form Data Map for the submission based on the submission extract data. Extract names will be converted into Java property format to enable easier use in scripts.
       "First Name" -> "firstName
       
      Returns:
      the submission form data extract map, or null if access is not permitted
      Since:
      4.1.1
    • incrementDeliveryProcessAttempts

      public void incrementDeliveryProcessAttempts()
      Increment the number of delivery process attempts by one.
      Since:
      3.6.0
    • incrementReceiptRenderAttempts

      public void incrementReceiptRenderAttempts()
      Increment the number of delivery process attempts by one.
      Since:
      5.0.3
    • setReceiptErrorProgressiveRetryDelay

      public void setReceiptErrorProgressiveRetryDelay()
      Set the receipt render error progressive retry delay.
      Since:
      5.0.3
    • getSubmissionPropertyValue

      public String getSubmissionPropertyValue(String name)
      Return the named submission property with the value or null if not defined.
      Parameters:
      name - the submission property name (required)
      Returns:
      the submission property value
      Since:
      3.6.0
    • setSubmissionPropertyValue

      @Deprecated public void setSubmissionPropertyValue(String name, String value)
      Deprecated.
      Set the named submission property with the given value, or create a new submission property if it does not exist.
      Parameters:
      name - the submission property name (required)
      value - the submission property value
      Since:
      3.6.0
    • setSubmissionPropertyValue

      public void setSubmissionPropertyValue(String name, String value, boolean encrypted)
      Set the named submission property with the given value, or create a new submission property if it does not exist.
      Parameters:
      name - the submission property name (required)
      value - the submission property value
      encrypted - specify whether the value should be encrypted in the database
      Since:
      4.3.0
    • getRequiredAttachmentMap

      public Map<String,RequiredAttachment> getRequiredAttachmentMap()
      Return a map of submission required attachments (attachment name/required attachment). Please note this map provides a convenient view of the submission required attachments, and does not model a Cayenne relationship. This required attachments map is ordered by attachment name.
      Returns:
      a map of submission required attachments (attachment name/required attachment).
      Since:
      3.6.5
    • isFormTaskSubmission

      public boolean isFormTaskSubmission()
      Return whether this submission is based on a form task
      Returns:
      true iff the task type is TASK_TYPE_FORM
      Since:
      4.0.0
    • isReviewTaskSubmission

      public boolean isReviewTaskSubmission()
      Return whether this submission is based on a review task
      Returns:
      true iff the task type is TASK_TYPE_REVIEW
      Since:
      4.0.0
    • isTaskSubmission

      public boolean isTaskSubmission()
      Return whether this submission is based on a task
      Returns:
      true iff the task key is not empty
      Since:
      4.0.0
    • getSubsequentTasks

      @Deprecated public List<Submission> getSubsequentTasks()
      Deprecated.
      Return the list of subsequent task submissions, this method is provided for backward compatibility with 3.x
      Returns:
      the list of subsequent task submissions
    • isSubmissionExpired

      public boolean isSubmissionExpired()
      Return true if the submission expiry date is defined and this value is older than the current time.
      Returns:
      true if the submission expiry date is defined and this value is older than the current time
      Since:
      4.3.0
    • getTrackingCode

      public String getTrackingCode()
      Return the submission tracking number. This method provides an adaptor for the tracking number.
      Returns:
      the submission tracking number
      Since:
      4.0.0
    • isSaveChallengeRender

      public boolean isSaveChallengeRender()
      Returns:
      true if a save challenge render
      Since:
      4.3.1
    • setTrackingNumber

      public void setTrackingNumber(String trackingNumber)
      Set the trackingNumber value, trimming and converting any value to upper case.
      Overrides:
      setTrackingNumber in class _Submission
      Parameters:
      trackingNumber - the trackingNumber value to set
      Since:
      4.1.0
    • setVersion

      public void setVersion(TemplateVersion version)
      Set the form version. This method also updates the form type to ensure they are always aligned.
      Overrides:
      setVersion in class _Submission
      Parameters:
      version - the template version
      Since:
      4.2.0
    • getSubmissionData

      @Deprecated public SubmissionData getSubmissionData()
      Deprecated.
      This method should not be used, instead please use the submissions associated Submission Data Storage service.
      Overrides:
      getSubmissionData in class _Submission
      Returns:
      the submissionData value
      Since:
      4.2.0
    • setSubmissionData

      @Deprecated public void setSubmissionData(SubmissionData submissionData)
      Deprecated.
      This method should not be used, instead please use the submissions associated Submission Data Storage service.
      Overrides:
      setSubmissionData in class _Submission
      Parameters:
      submissionData - the submissionData value to set
      Since:
      4.2.0
    • getAbandonmentReason

      public String getAbandonmentReason()
      Return the abandonmentReason value.
      Returns:
      abandonmentReason the abandonmentReason value
      Since:
      5.1.0
    • setAbandonmentReason

      public void setAbandonmentReason(String abandonmentReason)
      Set the abandonmentReason value.
      Parameters:
      abandonmentReason - the abandonmentReason value to set
      Since:
      5.1.0
    • getClientCode

      public String getClientCode()
      Return the clientCode value. Provided for backward compatibility.
      Returns:
      clientCode the clientCode value
      Since:
      5.1.0
    • getClientName

      public String getClientName()
      Return the clientName value. Provided for backward compatibility.
      Returns:
      clientName the clientName value
      Since:
      5.1.0
    • getContentLength

      public String getContentLength()
      Return the contentLength value. Provided for backward compatibility.
      Returns:
      contentLength the contentLength value
      Since:
      5.1.0
    • getContentType

      public String getContentType()
      Return the contentType value. Provided for backward compatibility.
      Returns:
      contentType the contentType value
      Since:
      5.1.0
    • getDataValidationMessage

      public String getDataValidationMessage()
      Return the dataValidationMessage value.
      Returns:
      dataValidationMessage the dataValidationMessage value
      Since:
      5.1.0
    • setDataValidationMessage

      public void setDataValidationMessage(String dataValidationMessage)
      Set the dataValidationMessage value.
      Parameters:
      dataValidationMessage - the dataValidationMessage value to set
      Since:
      5.1.0
    • getDeliveryServer

      @Deprecated public ServerNode getDeliveryServer()
      Deprecated.
      Return null. Provided for backward compatibility.
      Returns:
      null
      Since:
      5.1.0
    • getDurationClientResponse

      public Integer getDurationClientResponse()
      Return the durationClientResponse value. Provided for backward compatibility.
      Returns:
      durationClientResponse the durationClientResponse value
      Since:
      5.1.0
    • getDurationRender

      public Integer getDurationRender()
      Return the durationRender value. Provided for backward compatibility.
      Returns:
      durationRender the durationRender value
      Since:
      5.1.0
    • getDurationTotal

      public Integer getDurationTotal()
      Return the durationTotal value. Provided for backward compatibility.
      Returns:
      durationTotal the durationTotal value
      Since:
      5.1.0
    • getFieldworkerSyncTime

      @Deprecated public Date getFieldworkerSyncTime()
      Deprecated.
      Return null. Provided for backward compatibility.
      Returns:
      fieldworkerSyncTime the fieldworkerSyncTime value
      Since:
      5.1.0
    • getFormCode

      public String getFormCode()
      Return the formCode value. Provided for backward compatibility.
      Returns:
      formCode the formCode value
      Since:
      5.1.0
    • getUrlSafeFormCode

      public String getUrlSafeFormCode()
      Return the url encoded formCode value. Provided for backward compatibility.
      Returns:
      formCode the url encoded formCode value
      Since:
      18.11.0
    • getFormName

      public String getFormName()
      Return the formName value. Provided for backward compatibility.
      Returns:
      formName the formName value
      Since:
      5.1.0
    • getIpAddress

      public String getIpAddress()
      Return the ipAddress value. Provided for backward compatibility.
      Returns:
      ipAddress the ipAddress
      Since:
      5.1.0
    • getOfflineSubmitKey

      public String getOfflineSubmitKey()
      Return the offlineSubmitKey value. Provided for backward compatibility.
      Returns:
      offlineSubmitKey the offlineSubmitKey value
      Since:
      5.1.0
    • getPercentageCompleted

      public Integer getPercentageCompleted()
      Return the percentageCompleted value. Provided for backward compatibility.
      Returns:
      percentageCompleted the percentageCompleted value
      Since:
      5.1.0
    • getPortalServer

      public ServerNode getPortalServer()
      Deprecated.
      Return null. Provided for backward compatibility.
      Returns:
      null
      Since:
      5.1.0
    • getPortalServerName

      @Deprecated public String getPortalServerName()
      Deprecated.
      Return null. Provided for backward compatibility.
      Returns:
      null
      Since:
      5.1.0
    • getProcessingStatus

      public String getProcessingStatus()
      Return the processingStatus value. Provided for backward compatibility.
      Returns:
      processingStatus the processingStatus value
      Since:
      5.1.0
    • getProcessingStatusTime

      public Date getProcessingStatusTime()
      Return the processingStatusTime value. Provided for backward compatibility.
      Returns:
      processingStatusTime the processingStatusTime value
      Since:
      5.1.0
    • getReferer

      public String getReferer()
      Return the referer value. Provided for backward compatibility.
      Returns:
      referer the referer value
      Since:
      5.1.0
    • getRequestCookie

      public String getRequestCookie()
      Return the requestCookie value. Provided for backward compatibility.
      Returns:
      requestCookie the requestCookie value
      Since:
      5.1.0
    • getRequestUrl

      public String getRequestUrl()
      Return the requestUrl value. Provided for backward compatibility.
      Returns:
      requestUrl the requestUrl value
      Since:
      5.1.0
    • getSavedMessage

      public String getSavedMessage()
      Return the savedMessage value.
      Returns:
      savedMessage the savedMessage value
      Since:
      5.1.0
    • setSavedMessage

      public void setSavedMessage(String savedMessage)
      Set the savedMessage value.
      Parameters:
      savedMessage - the savedMessage value to set
      Since:
      5.1.0
    • getSubmissionMessage

      public String getSubmissionMessage()
      Return the submissionMessage value.
      Returns:
      submissionMessage the submissionMessage value
      Since:
      5.1.0
    • setSubmissionMessage

      public void setSubmissionMessage(String submissionMessage)
      Set the submissionMessage value.
      Parameters:
      submissionMessage - the submissionMessage value to set
      Since:
      5.1.0
    • getTaskEmailSubject

      public String getTaskEmailSubject()
      Return the taskEmailSubject value.
      Returns:
      taskEmailSubject the taskEmailSubject value
      Since:
      5.1.0
    • setTaskEmailSubject

      public void setTaskEmailSubject(String taskEmailSubject)
      Set the taskEmailSubject value.
      Parameters:
      taskEmailSubject - the taskEmailSubject value to set
      Since:
      5.1.0
    • getTaskEmailMessage

      public String getTaskEmailMessage()
      Return the taskEmailMessage value.
      Returns:
      taskEmailMessage the taskEmailMessage value
      Since:
      5.1.0
    • setTaskEmailMessage

      public void setTaskEmailMessage(String taskEmailMessage)
      Set the taskEmailMessage value.
      Parameters:
      taskEmailMessage - the taskEmailMessage value to set
      Since:
      5.1.0
    • getTaskMessage

      public String getTaskMessage()
      Return the taskMessage value.
      Returns:
      taskMessage the taskMessage value
      Since:
      5.1.0
    • setTaskMessage

      public void setTaskMessage(String taskMessage)
      Set the taskMessage value.
      Parameters:
      taskMessage - the taskMessage value to set
      Since:
      5.1.0
    • getUserAgent

      public String getUserAgent()
      Return the userAgent value. Provided for backward compatibility.
      Returns:
      userAgent the userAgent value
      Since:
      5.1.0
    • getUserAgentBrowserType

      public String getUserAgentBrowserType()
      Return the userAgentBrowserType value.Provided for backward compatibility.
      Returns:
      userAgentBrowserType the userAgentBrowserType value
      Since:
      5.1.0
    • getUserAgentBrowserVersion

      public String getUserAgentBrowserVersion()
      Return the userAgentBrowserVersion value. Provided for backward compatibility.
      Returns:
      userAgentBrowserVersion the userAgentBrowserVersion value
      Since:
      5.1.0
    • getUserAgentOsType

      public String getUserAgentOsType()
      Return the userAgentOsType value. Provided for backward compatibility.
      Returns:
      userAgentOsType the userAgentOsType value
      Since:
      5.1.0
    • getUserAgentOsVersion

      public String getUserAgentOsVersion()
      Return the userAgentOsVersion value. Provided for backward compatibility.
      Returns:
      userAgentOsVersion the userAgentOsVersion value
      Since:
      5.1.0
    • isAbandonmentTypeIneligible

      public boolean isAbandonmentTypeIneligible()
      Return whether this submission has been marked as ineligible.
      Returns:
      true if the abandonment type is STATUS_Ineligible
      Since:
      5.1.0
    • setAbandonmentTimestamp

      public void setAbandonmentTimestamp(Date abandonmentTimestamp)
      Description copied from class: _Submission
      Set the abandonmentTimestamp value.
      Overrides:
      setAbandonmentTimestamp in class _Submission
      Parameters:
      abandonmentTimestamp - the abandonmentTimestamp value to set
    • setDeletedTimestamp

      public void setDeletedTimestamp(Date deletedTimestamp)
      Description copied from class: _Submission
      Set the deletedTimestamp value.
      Overrides:
      setDeletedTimestamp in class _Submission
      Parameters:
      deletedTimestamp - the deletedTimestamp value to set
    • setDeliveryTime

      public void setDeliveryTime(Date deliveryTime)
      Description copied from class: _Submission
      Set the deliveryTime value.
      Overrides:
      setDeliveryTime in class _Submission
      Parameters:
      deliveryTime - the deliveryTime value to set
    • setPurgeTime

      public void setPurgeTime(Date purgeTime)
      Description copied from class: _Submission
      Set the purgeTime value.
      Overrides:
      setPurgeTime in class _Submission
      Parameters:
      purgeTime - the purgeTime value to set
    • setPurgeTimeDataDelivered

      public void setPurgeTimeDataDelivered(Date purgeTimeDataDelivered)
      Description copied from class: _Submission
      Set the purgeTimeDataDelivered value.
      Overrides:
      setPurgeTimeDataDelivered in class _Submission
      Parameters:
      purgeTimeDataDelivered - the purgeTimeDataDelivered value to set
    • setReceiptRenderTime

      public void setReceiptRenderTime(Date receiptRenderTime)
      Description copied from class: _Submission
      Set the receiptRenderTime value.
      Overrides:
      setReceiptRenderTime in class _Submission
      Parameters:
      receiptRenderTime - the receiptRenderTime value to set
    • setSaveAbandonScheduledTime

      public void setSaveAbandonScheduledTime(Date saveAbandonScheduledTime)
      Description copied from class: _Submission
      Set the saveAbandonScheduledTime value.
      Overrides:
      setSaveAbandonScheduledTime in class _Submission
      Parameters:
      saveAbandonScheduledTime - the saveAbandonScheduledTime value to set
    • setTaskCreatedTimestamp

      public void setTaskCreatedTimestamp(Date taskCreatedTimestamp)
      Description copied from class: _Submission
      Set the taskCreatedTimestamp value.
      Overrides:
      setTaskCreatedTimestamp in class _Submission
      Parameters:
      taskCreatedTimestamp - the taskCreatedTimestamp value to set
    • setTimeFormCompleted

      public void setTimeFormCompleted(Date timeFormCompleted)
      Description copied from class: _Submission
      Set the timeFormCompleted value.
      Overrides:
      setTimeFormCompleted in class _Submission
      Parameters:
      timeFormCompleted - the timeFormCompleted value to set
    • setTimeLastUserActivity

      public void setTimeLastUserActivity(Date timeLastUserActivity)
      Description copied from class: _Submission
      Set the timeLastUserActivity value.
      Overrides:
      setTimeLastUserActivity in class _Submission
      Parameters:
      timeLastUserActivity - the timeLastUserActivity value to set
    • setTimeRequest

      public void setTimeRequest(Date timeRequest)
      Description copied from class: _Submission
      Set the timeRequest value.
      Overrides:
      setTimeRequest in class _Submission
      Parameters:
      timeRequest - the timeRequest value to set
    • setTimeSubmission

      public void setTimeSubmission(Date timeSubmission)
      Description copied from class: _Submission
      Set the timeSubmission value.
      Overrides:
      setTimeSubmission in class _Submission
      Parameters:
      timeSubmission - the timeSubmission value to set