Conditional display and validation of properties

Overview

Each type can have properties assigned to it, such as Name, Author, Related media, Parent, etc. You can show or hide these properties when a certain condition has been met. To do so you need a JSON value that defines the conditions for showing and validating a field, based on another field values. When you change the value of the target field (fieldName), the field that has the Conditional visibility and validation will be displayed or hidden and it will validate both in the UI and the server, based on this condition.

Procedure

To define the conditions for visibility and validation, perform the following:

Click Administration » Settings » Advanced » WebServices » Routes.
Expand <your-route> » <your-service> » <your-type> » Property mappings.
Provide the JSON input in the Conditional Display And Validation field.
Click Save changes.

EXAMPLE:

JSON

{
 "operator" : "Or",
 "conditions": [
   {
   "fieldName": "name",
   "operator": "Contains",
   "value": "value"
   }
 ]
}

JSON schema

JSON

{
    "required": [
        "operator",
        "conditions"
    ],
    "type": "object",
    "properties": {
        "operator": {
            "$id": "#/properties/operator",
            "enum": [
                "Or",
                "And"
            ],
            "type": "string"
        },
        "conditions": {
            "$id": "#/properties/conditions",
            "type": "array",
            "additionalItems": false,
            "items": {
                "$id": "#/properties/conditions/items",
                "type": [
                    {
                        "$id": "#/properties/conditions/items/anyOf/0",
                        "required": [
                            "fieldName",
                            "operator",
                            "value"
                        ],
                        "type": "object",
                        "properties": {
                            "fieldName": {
                                "$id": "#/properties/conditions/items/anyOf/0/properties/fieldName",
                                "type": "string"
                            },
                            "operator": {
                                "$id": "#/properties/conditions/items/anyOf/0/properties/operator",
                                "enum": [
                                    "Equals",
                                    "NotEquals",
                                    "Contains",
                                    "NotContains"
                                ],
                                "type": "string"
                            },
                            "value": {
                                "$id": "#/properties/conditions/items/anyOf/0/properties/value",
                                "type": "string"
                            }
                        },
                        "additionalProperties": false
                    }
                ]
            }
        }
    },
    "additionalProperties": false
}

Want to learn more?

Enhance your Sitefinity skills by enrolling in free training sessions. Become Sitefinity certified through Progress Education Community to strengthen your professional credentials.

Get started with Integration Hub | Sitefinity Cloud

This free lesson teaches administrators, marketers, and other business professionals how to use Sitefinity Integration Hub to create automated workflows between Sitefinity and other business systems.

Web Security for Sitefinity Administrators

This free lesson teaches administrators the basics about protecting your Sitefinity instance and your sites from external threats. Configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.

Foundations of Sitefinity ASP.NET Core Development

The free on-demand video course teaches developers how to use Sitefinity ASP.NET Core and take advantage of its decoupled architecture and modern development model.