Class Submission

  • All Implemented Interfaces:
    IEntity, Serializable, org.apache.cayenne.DataObject, org.apache.cayenne.Persistent, org.apache.cayenne.Validating

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

      • ABANDONMENT_REASON_PROPERTY

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

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

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

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

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

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

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

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

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

        public static final String PROCESSING_STATUS_TIME_PROPERTY
        Provides the 'processingStatusTime' property name.
        See Also:
        Constant Field Values
      • REQUEST_COOKIE_PROPERTY

        public static final String REQUEST_COOKIE_PROPERTY
        Provides the 'requestCookie' property name.
        See Also:
        Constant Field Values
      • REQUEST_URL_PROPERTY

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

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

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

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

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

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

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

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

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

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

        public static final String USER_AGENT_OS_VERSION_PROPERTY
        Provides the 'userAgentOsVersion' property name.
        See Also:
        Constant Field Values
      • 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:
        Constant Field Values
      • 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:
        Constant Field Values
      • 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:
        Constant Field Values
      • 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:
        Constant Field Values
      • STATUS_DetailsRequired

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

        public static final String STATUS_PaymentRequired
        Provides a "Payment Required" status
        See Also:
        Constant Field Values
      • STATUS_COMPLETED_UPLOAD

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

        public static final String STATUS_COMPLETED_MANUALLY
        Provides a "Completed - Deliver Manually" status
        See Also:
        Constant Field Values
      • STATUS_Undeliverable

        public static final String STATUS_Undeliverable
        Provides an "Undeliverable" status
        See Also:
        Constant Field Values
      • STATUS_Error_No_Data

        public static final String STATUS_Error_No_Data
        Provides an "Error - No Data" status
        See Also:
        Constant Field Values
      • PAYMENT_TYPE_BPAY

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

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

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

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

        public static final String PAYMENT_TYPE_Manual
        Indicates that the payment was completed manually.
        See Also:
        Constant Field Values
      • SIGNATURE_TYPE_DIGITAL

        public static final String SIGNATURE_TYPE_DIGITAL
        Indicates that the form is to be digitally signed
        See Also:
        Constant Field Values
      • SIGNATURE_TYPE_ESIGNATURE

        @Deprecated
        public static final String SIGNATURE_TYPE_ESIGNATURE
        Deprecated.
        Indicates that the form is to be signed with eSignatures
        See Also:
        Constant Field Values
      • SIGNATURE_TYPE_WET

        public static final String SIGNATURE_TYPE_WET
        Indicates that the form is to be signed with wet ink
        See Also:
        Constant Field Values
      • 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
      • SIGNATURE_STATUS_VALUES

        public static final String[] SIGNATURE_STATUS_VALUES
        The set of possible signature status values
      • DIGITAL_SIGNATURE_STATUS_VALUES

        public static final String[] DIGITAL_SIGNATURE_STATUS_VALUES
        The set of possible digital signature status values
      • WET_SIGNATURE_STATUS_VALUES

        public static final String[] WET_SIGNATURE_STATUS_VALUES
        The set of possible wet signature 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
      • SIGNATURE_TYPE_VALUES

        public static final String[] SIGNATURE_TYPE_VALUES
        The set of signature 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:
        Constant Field Values
      • DELIVERY_EMAIL

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

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

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

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

        public static final String HOST_CONTEXT_FieldWorker
        The 'FieldWorker' form host context.
        See Also:
        Constant Field Values
      • LC_OUTPUT_FILTER

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

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

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

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

        public static final int LC_PROCESS_MANAGEMENT_FILTER
        The bit filter for LC Process Management
        See Also:
        Constant Field Values
      • 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:
        Constant Field Values
    • Constructor Detail

      • Submission

        public Submission()
    • Method Detail

      • 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
      • isESignatureRequired

        @Deprecated
        public boolean isESignatureRequired()
        Deprecated.
        Returns:
        false
      • isWetSignatureRequired

        public boolean isWetSignatureRequired()
        Return whether wet signatures are required
        Returns:
        true if the signature type is SIGNATURE_TYPE_WET and the signature status is STATUS_Required
      • 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 && 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