Submit Feedback

Object Validation Rule YAML Configuration Reference

To define an Object Validation Rule client extension, add the objectValidationRule type to your client-extension.yaml file.

Usage Details

This client-extension.yaml example defines a validation rule and an OAuth user agent:

easy-object-validation-rule-1:
    name: Easy Object Validation Rule 1
    oAuth2ApplicationExternalReferenceCode: easy-oauth-application-user-agent
    resourcePath: /object/validation/rule/1
    type: objectValidationRule

easy-oauth-application-user-agent:
    type: oAuthApplicationUserAgent

The required resourcePath property defines the Object Validation Rule handler’s location. Point to any implementation of an Object Validation Rule handler that’s accessible as an external application (for example, a Java Spring Boot application). This value is combined with the homePageURL value of the associated OAuth2 application profile to form the complete URL.

Object Validation Rule client extensions require OAuth2 application profiles to secure the requests they trigger in Liferay. The client-extension.yaml defines an additional OAuth user agent client extension for this profile, and the oAuth2ApplicationExternalReferenceCode property references that client extension’s key value.

The sample workspace demonstrates how to use an Object Validation Rule client extension with Spring Boot application.

Restricting Client Extension Scope

By default, object validation rule client extensions are available to all object definitions in all Liferay instances.

To restrict access by object definition, add the allowedObjectDefinitionNames property along with a list of objects that can use the validation:

easy-object-validation-rule-1:
    allowedObjectDefinitionNames:
        - C_EasyObject
        - User

In this example, easy-object-validation-rule-1 only appears as an option when defining validations for the C_EasyObject and User objects.

To restrict access by instance, add the dxp.lxc.liferay.com.virtualInstanceId property with the desired virtual instance’s ID:

easy-object-validation-rule-1:
    allowedObjectDefinitionNames:
        - C_EasyObject
        - User
    dxp.lxc.liferay.com.virtualInstanceId: easy-virtual-host-1.com

In this example, easy-object-validation-rule-1 only appears as an option for the C_EasyObject and User objects in the easy-virtual-host-1.com instance.

YAML Properties

These properties are specific to Object Validation Rule client extensions:

Name	Data Type	Description
`allowedObjectDefinitionNames`	List	Scope the client extension to specified object definitions (e.g., `C_EasyObject`, `User`)
`dxp.lxc.liferay.com.virtualInstanceId`	String	Scope the client extension to a specified virtual instance using its ID (e.g., `easy-virtual-host-1.com`).
`resourcePath`	String (partial URL)	(Required) The path to the Object Validation Rule handler. This value is combined with the OAauth2 application profile’s `homePageURL` value for a complete URL.
`oAuth2ApplicationExternalReferenceCode`	String	(Required) The external reference code for an OAuth2 application profile, needed for securing requests.