nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

Displaying a custom error message from a document form validator

faizel

Hi all,

The Formsbuilder developer guide 6.6 states :

Document validators
A document validator validates the entire form before submission. For example, it might check that the
start date for a project precedes the end date.
The boolean-valued validate method of a document validator returns true if the form contains valid
values, false if not. The Java code for a document validator must implement the following interface:

public interface IDocumentValidator extends IAdaptor {
public boolean validate(Document document) throws XFormsProcessorException;
}

where, Document is in the org.w3c.dom package, and XFormsProcessorException is in the
com.documentum.xforms.engine package.

To display a custom error message, you need to throw an AdaptorException with the custom error
message as the AdaptorException message parameter.

Now the red part i don't understand. The method signature of the validate() method specifies an XformsProcessorException, so where should i throw the AdaptorException ?

Find more posts tagged with

Comments

avink

Instead of throwing xforms, replace with AdaptorException:

throw new AdaptorException("message");

Thanks

faizel

Thank you for your swift reply, i use this implementation code :

public boolean validate(final Document document)   throws XFormsProcessorException {

        ......
        throw new AdaptorException("this is the custom error message");
    }

But Composer gives an error : Unhandled exception type AdaptorException

Tord

Hi,

The AdaptorException is a checked exception so you cannot throw it from a Document Validator (only from a Document Processor, Data Source Adaptor, Set Value Adaptor etc which explicitly declares it, just like you point out).

May I suggest you try to throw a XFormsProcessorException instead, i.e. something like:

public boolean validate(final Document document)   throws XFormsProcessorException {
        
        ......
        throw new XFormsProcessorException("this is the custom error message");
}

I haven't verified that it'll work, but it is worth a try at least.

Hope it helps

--Tord

faizel

Hi Tord,

Thank you for claryfing this. The result is, when the validation fails and an XFormsProcessorException is thrown :

A red errorbox on the bottom of the form which says:

Unable to execute adaptor $ADAPTOR_NAME$: $XFormsProcessorException.Message$ Please contact your administrator or see the server logs for more information.
This form contains errors, please fix accordingly.

I was actually hoping that only the $XFormsProcessorException.Message$ would be shown.

Tord

Hi again,

Unfortunately I think this is as close as you get with a custom message for the Document Validator, but that depends, what version and what patch level are you on?

Also, what type of validations are you performing? Might it be possible to have item level validations or even regular expressions on the individual fields?

Thanks

--Tord

Tord

If you are on at least P04 on 6.6 you can do something like this, though probably not supported:

Edit the InstanceNlsProp.properties in forms-engine.jar

Change this

MSG_ERROR_DOCUMENT_VALIDATOR=Unable to execute adaptor <{0}>: {1}. Please contact your administrator or see the server logs for more information.

To this:

MSG_ERROR_DOCUMENT_VALIDATOR={1}

Now it'll work as you expected when you throw the XFormsProcessorException.

Thanks

--Tord

Nicolas.Goyet

Hi Tord,

The solution works but with this solution we have a problem when we must deployed a new version.

I have tried to create InstanceNlsProp.properties file in custom/strings/com/documentum.... folder but it doesn't work. Have you a solution like this ?

Regards

Nicolas

MelT

Hello Tord,

I'm having the same problem.

But I change the InstanceNlsProp.properties in the XFormsEngine.jar (..\taskspace\webapps\taskspace\WEB-INF\lib\XformsEngine.jar) which is found in the following folder com\documentum\xforms\engine\chiba\.

InstanceNlsProp.properties.jpg

But it still doesn't modify my error message. (Below)

Am I doing it right ? OR ?

Thank you in advance for your help.

Regards,

Mel

Haroon_A

Try to throw "AdaptorException", i.e.

throw new AdaptorException("Your message here");

MelT

Hello Ahmad,

I've already thrown the AdaptorException and modified also the InstanceNlsProp.properties but it still shows the default error message + my message thrown in the AdaptorException.

Is that the correct way to do this?

Thanks for your help.

Mel

Ronak.Bhavsar

Mel,

This is an old post but did you find the solution of this. I am running in the same issue. updated the properties file and throwing AdaptorException but still getting the original exception message along with the custom error.

TIA