Field Dependency

Often we want to show options in a field depending on value of some other field. We can achieve that using HD Form Script.

Note:This is only applicable while creating tickets.

Setting

Adding somea context:

Custom Field

1. Create a new field using customize form. To do so, goswitch to deskDesk and navigate to HD Ticket doctype, then use the Customize Form option (for more details, follow this documentation)
2. Copy the field name you want the user to fill while creating ticket.
3. Go to HD Ticket Tempalte doctype (in desk ) => open document named "default" => Past the name in the table shown in "fields" section. (url: http://yoursitename//app/hd-ticket-template/Default)

e.g.

Implementing Field Dependency

FieldNow that you have added required custom fields, field dependency iscan be implemented using HD Form ScriptsScript in Desk:

Open Desk: Switch to Desk and navigate to HD Form Script. Select Doctype: Choose the Doctype (e.g., HD Ticket) where you want to add the custom action. You'll be presented with a boilerplate code. Apply To: Choose "Form". Enabling Script: Check "Apply on new page" & "Enabled" field. Define Your onChange handler: Here's how to define different types of handlers for different Fields:

Let us say we have created two Select Fields called "App" & "Category", & based on the App selected I want to filter the options on "Category" field.

function setupForm({doc, applyFilters}) {

    function update_category(value) {
        if(value=="ERPNext"){
            options = ["Manufacturing","Accounting","Selling","Purchase"]
        }
        else if(value =="Frappe Cloud"){
            options = ["Payment","Bench Down","Site Down", "FC Marketplace"]
        }
        else if(value== "HRMS") {
            options = ["Attendance","Shift","Tax"]

        }
        applyFilters("custom_category",options)
    }

    return {
        onChange:{
//          works only for new ticket page
            "custom_app":(newVal)=>update_category(newVal)
        }
    }
}

In the example mentioned above when the custom_app field changes the update_cateogory function will be triggered and the new value of the custom_app field will be passed to the update_category function, and based on the new value we update the options using apply_filters function

this function takes 2 values as an argument

1. Field you want to change (can be a Select field or a Link field).

2. The Options you wanna show in the dropdown. (make sure to use the correct spelling). If null is passed then the options will reset to default.

Here is an example of implementation:

Some more customisations

• To hide or show a field use display_depends_on functionality using form customisation, watch this video to know more

e.g for update_category: eval:doc.custom_app!==""

• To make a field mandatory bases on another field use mandatory_depends_on functionality using form customisation. To know more read this

e.g for making a application field mandatory use this expression: eval:doc.ticket_type==="Bug"

video showcasing mandatory_depends_on & display_depends_on