When you select Save, Validate, or Submit, performs a series of edit checks on your document. If it encounters any errors, it displays a brief error message at the top of the page. If CGI Advantage finds more than one error, the first error message is displayed along with the total number of errors. For example, a “1 of 3” indicates that there are a total of three error messages and the first one is displayed. Select View All to view all of the error messages.
Error messages with the following severity levels and meanings can be raised during document processing:
Informational - Informational messages, as the name suggests, are for informational purposes only and do not affect the determination of whether a document will be accepted to the next phase. All informational messages that occur during document processing are accumulated so the user can see all of the informational messages for that document version at one time.
Warning - When warning messages are encountered, they are compared with the warning message from a previous validate or submit action. If there are any new warnings since the last time, the user is given the chance to review these warnings before the document is accepted to the next phase. The next time the document is submitted, the document is accepted to the next phase if there are no new warnings. All warning messages that occur during document processing are accumulated so the user can see all of the warning messages for that document version at one time.
Error – When error messages are encountered, the document is rejected and any updates or changes made outside of the document are not committed to the database. All error messages that occur during document processing are accumulated so the user can see all of the error messages for that document version at one time. In addition, the phase of the document remains at the Draft phase until the user fixes the document and validates or submits the document again.
Severe - When severe messages are encountered during the processing of a document, the processing is terminated immediately at that point and control is returned back to the user. All updates or changes made to the document and made outside of the document are not committed to the database. Only the messages that occurred before the severe message and the severe message itself are displayed to the user for review.
A special type of error message called an Override Error can be raised during document processing (validate or submit). This type of error message has a severity level of Error and an associated override level. Override error messages allow the user to downgrade the message from an error to a warning by applying the Override action to the document version. The user’s override level, which is set up in security, needs to be greater than or equal to the override level that is set for the error message in order for the message to be overridden.
The indicator Override Pend Phase Ind is available on the Document Controls page that is used to determine if a document version being submitted from the Draft phase to the Pending phase is allowed to be submitted when override error messages are present. The indicator can have the following values:
Allowed only after reaching – If this indicator is specified, then the override action can be applied only after the document reaches the Pending phase if there are override error messages
Required before reaching – If this indicator is specified, then the override action must be applied before the document reaches the Pending phase if there are override error messages
Allowed before or after reaching – If this indicator is specified, then the override action can be applied before or after the document reaches the Pending phase if there are override error messages
For every document code that can go into the Pending phase, an approval level must be set up that checks whether the document must be routed through workflow for approval.
Related Topic(s):
The Document Message (DOCMSG) page allows you to search for and view document messages that have been added by the Document Message Load batch job. The Document Message Load batch job extracts document messages that are associated with documents included in the parameters set for the batch job and adds them to the DOCMSG page. The Document Message Load batch job can also remove error messages that have been fixed on a document. Please refer to the Document Message Update run sheet in the Utilities Run Sheet Guide for more information about this job.
Document message information can be searched to determine:
Documents that are in draft/pending phase due to errors in the document.
Error Messages present in a given document.
Error Message code, text, severity, override level and explanation for a given document.
Error Messages in a given document where there is no code or explanation.
Documents that have been submitted with information, warnings and override errors.
Incorrect or missing document field values that prevented a given document from validating successfully.
Missing field values that prevented a given document from importing successfully.
A link for a given document that can open the document directly from the result row in the table.
Click the Search link to search for a specific document message by entering values into one or more of the search fields. You can then navigate to the document that contains the message by clicking the link in the Document column in the grid. If a document failed on import due to errors, then the error message is added to the DOCMSG page, even though the document does not exist in Advantage. Therefore, if you click the document hyperlink an error is received that the document does not exist.
Once an error has been fixed for a document and is no longer reported after validating or submitting the document, then an authorized user must run the Document Message Load batch job. Assuming the parameters for the job are set to include the selected document, the previously reported error is removed from the DOCMSG page.