• State Not Answered
  • Replies 8 replies
  • Subscribers 12 subscribers
  • Views 150 views
  • Users 0 members are here
Related Discussions
Home » Discussions » User Interface

Condition based validation

rajeshp7374

I need to validate the checkboxes when the submit button is clicked, based on a specific condition. There are four checkboxes, and before submitting the form, the user must check at least one. However, instead of using FormLayout, I’ve created the form using CardLayout and local variables. I’m looking for suggestions on how to improve or streamline this approach.

  Discussion posts and replies are publicly visible

  • 0
    Certified Lead Developer

    Using a formLayout or cardLayout should have no bearing on the outcome. If you could share the code, it would help.

  • 0

    You could try this:

    a!localVariables(
  local!selected,
  {
    a!checkboxField(
      choiceLabels: {"Option 1", "Option 2", "Option 3", "Option 4"},
      choiceValues: {1, 2, 3, 4},
      label: "Checkboxes",
      labelPosition: "ABOVE",
      value: local!selected,
      saveInto: {local!selected},
      required: true,
      requiredMessage: "You should select at least one option",
      validations: {}
    ),
    a!buttonArrayLayout(
      buttons: {
        a!buttonWidget(
          label: "Button",
          style: "OUTLINE",
          validate: true
        )
      },
      align: "START",
      marginBelow: "NONE"
    )
  }
)

  • 0 in reply to Mathieu Drouin

    a!localVariables(
    {
    a!boxLayout(
    label: "Business Risk Acceptance",
    contents: {
    a!boxLayout(
    label: "I am requesting a Business Risk Acceptance because I HAVE NOT completed the following (at least one box must be selected)",
    contents: {
    a!sideBySideLayout(
    items: {
    a!sideBySideItem(
    item: a!checkboxField(
    choiceLabels: {
    "Two Valid Government IDs (1 must contain photo) – Photo ID not retained for audit purposes"
    },
    choiceValues: {
    "Two Valid Government IDs (1 must contain photo) – Photo ID not retained for audit purposes"
    },
    label: "",
    value: local!docRequiredGovId,
    saveInto: local!docRequiredGovId,
    validations: if(
    a!isNotNullOrEmpty(local!docRequiredGovId),
    {},
    "At least one option must be selected."
    )
    )
    ),
    a
    }
    ),
    a!sideBySideLayout(
    items: {
    a!sideBySideItem(
    item: a!checkboxField(
    choiceLabels: {
    "Copy of 2 Valid Government IDs (optional)"
    },
    choiceValues: {
    "Copy of 2 Valid Government IDs (optional)"
    },
    label: "",
    value: local!docOptionalGovId,
    saveInto: local!docOptionalGovId,
    validations: if(
    a!isNotNullOrEmpty(local!docOptionalGovId),
    {},
    "At least one option must be selected."
    )
    )
    ),

    }
    ),
    a!sideBySideLayout(
    items: {
    a!sideBySideItem(
    item: a!checkboxField(
    choiceLabels: {
    "Consent Form and Security Regulations"
    },
    choiceValues: {
    "Consent Form and Security Regulations",

    },
    label: "",
    value: local!docConsentForm,
    saveInto: local!docConsentForm,
    validations: if(
    a!isNotNullOrEmpty(local!docConsentForm),
    {},
    "At least one option must be selected."
    )
    )
    ),

    }
    ),
    a!sideBySideLayout(
    items: {
    a!sideBySideItem(
    item: a!checkboxField(
    choiceLabels: { "ID Verification" },
    choiceValues: { "ID Verification", },
    label: "",
    value: local!docIdVerification,
    saveInto: local!docIdVerification,
    validations: if(
    a!isNotNullOrEmpty(local!docIdVerification),
    {},
    "At least one option must be selected."
    )
    )
    ),

    }
    ),
    a!sideBySideLayout(
    items: {
    a!sideBySideItem(
    item: a!checkboxField(
    choiceLabels: { "Criminal Record Check Report(s)" },
    choiceValues: { "Criminal Record Check Report(s)", },
    label: "",
    value: local!docRequiredCriminalCheck,
    saveInto: local!docRequiredCriminalCheck,
    validations: if(
    a!isNotNullOrEmpty(local!docRequiredCriminalCheck),
    {},
    "At least one option must be selected."
    )
    )
    ),

    }
    ),
    a!sideBySideLayout(
    items: {
    a!sideBySideItem(
    item: a!checkboxField(
    choiceLabels: { "Other" },
    choiceValues: { "Other", },
    label: "",
    value: local!docOther,
    saveInto: local!docOther,
    validations: if(
    a!isNotNullOrEmpty(local!docOther),
    {},
    "At least one option must be selected."
    )
    )
    ),

    }
    )
    },
    isCollapsible: true
    )

    },
    showWhen: not(ri!readonly),
    isCollapsible: true
    ),
    a!richTextDisplayField(),

    a!buttonLayout(
    primaryButtons: a!buttonWidget(
    label: "Submit",
    saveinto:{}
    submit: true,
    style: "SOLID",
    loadingIndicator: true,
    validate: a!validationMessage(
    message: "Invalid",
    showWhen: or(
    a!isNotNullOrEmpty(local!docRequiredGovId),
    a!isNotNullOrEmpty(local!docConsentForm),
    a!isNotNullOrEmpty(local!idVerification),
    a!isNotNullOrEmpty(local!docRequiredCriminalCheck),
    a!isNotNullOrEmpty(local!docOther)
    ),
    validateAfter: "SUBMIT"
    )
    ),
    secondaryButtons: a!buttonWidget(
    label: "Cancel",
    value: true,
    saveInto: { ri!cancel },
    submit: true,
    style: "OUTLINE",
    validate: false
    ),
    showWhen: not(ri!readonly)
    )
    }
    )

  • 0
    Certified Senior Developer

    Using formLayout is nice with the built in validations and buttons, but you can definitely use a cardLayout if you prefer.  Check out the code below for an example.  I set the validation results to local!validations using Appian's built in a!match(). I then use the Alert Banners pattern to display a validation message in a cardLayout toward the bottom.  You can update local!validation with whatever additional validation logic and messages you'd like.

    a!localVariables(
  
  local!options: {
    "Two valid government IDs (1 must contain photo)",
    "Copy of 2 valid government IDs (optional)",
    "Consent form and security regulations",
    "ID Verification",
    "Criminal record check report(s)",
    "other"
  },
  
  local!selections,
  local!otherReason,
  
  local!validations: a!match(
    value: local!selections,
    whenTrue: a!isNullOrEmpty(fv!value),
    then: "Please make a selection",
    whenTrue: and(
      contains(fv!value, "other"),
      a!isNullOrEmpty(local!otherReason)
    ),
    then: "please specify other reason",
    default: ""
  ),
  
  a!cardLayout(
    contents: {
      a!checkboxField(
        choiceLabels: local!options,
        choiceValues: local!options,
        value: local!selections,
        saveInto: local!selections
      ),
      a!textField(
        showWhen: and(
          a!isNotNullOrEmpty(local!selections),
          contains(local!selections, "other")
        ),
        label: "other",
        value: local!otherReason,
        saveInto: local!otherReason
      ),
      
      a!cardLayout(
        showWhen: a!isNotNullOrEmpty(local!validations),
        contents: {
          a!sideBySideLayout(
            items: {
              a!sideBySideItem(
                item: a!richTextDisplayField(
                  labelPosition: "COLLAPSED",
                  value: {
                    a!richTextIcon(
                      icon: "exclamation-circle",
                      color: "NEGATIVE",
                      size: "MEDIUM"
                    )
                  }
                ),
                width: "MINIMIZE"
              ),
              a!sideBySideItem(
                item: a!richTextDisplayField(
                  labelPosition: "COLLAPSED",
                  value: {
                    a!richTextItem(
                      text: "Validation Error",
                      style: "STRONG"
                    ),
                    " ",
                    local!validations
                  }
                )
              )
            },
            alignVertical: "MIDDLE",
            spacing: "STANDARD"
          )
        },
        style: "ERROR",
        marginBelow: "STANDARD",
        accessibilityText: "Error message"
      ),
      a!columnsLayout(
        columns: {
          a!columnLayout(
            contents: {
              a!buttonArrayLayout(
                align: "START",
                buttons: {
                  a!buttonWidget(
                    color: "NEGATIVE",
                    label: "Cancel",
                    validate: false,
                    submit: true
                  )
                } 
              )
            }
          ),
          a!columnLayout(
            contents: {
              a!buttonArrayLayout(
                align: "END",
                buttons: {
                  a!buttonWidget(
                    label: "submit",
                    validate: true,
                    submit: true,
                    disabled: a!isNotNullOrEmpty(local!validations)
                  )
                } 
              )
            }
          )
        }
      ) 
    }
  )
)

  • 0 in reply to rajeshp7374

    I added a section to use the "validations" parameter and be able to place the message you require when clicking on "SUBMIT". Refer the code below. Also you can use   suggestion as posible solution.

    {
    a!boxLayout(
      label: "Business Risk Acceptance",
      contents: {
        a!boxLayout(
          label: "I am requesting a Business Risk Acceptance because I HAVE NOT completed the following (at least one box must be selected)",
          contents: {
            a!sectionLayout(
              contents: {
                a!sideBySideLayout(
                  items: {
                    a!sideBySideItem(
                      item: a!checkboxField(
                        choiceLabels: {
                          "Two Valid Government IDs (1 must contain photo) – Photo ID not retained for audit purposes"
                        },
                        choiceValues: {
                          "Two Valid Government IDs (1 must contain photo) – Photo ID not retained for audit purposes"
                        },
                        label: "",
                        value: local!docRequiredGovId,
                        saveInto: local!docRequiredGovId,
                        validations: if(
                          a!isNotNullOrEmpty(local!docRequiredGovId),
                          {},
                          "At least one option must be selected."
                        )
                      )
                    )
                  }
                ),
                a!sideBySideLayout(
                  items: {
                    a!sideBySideItem(
                      item: a!checkboxField(
                        choiceLabels: {
                          "Copy of 2 Valid Government IDs (optional)"
                        },
                        choiceValues: {
                          "Copy of 2 Valid Government IDs (optional)"
                        },
                        label: "",
                        value: local!docOptionalGovId,
                        saveInto: local!docOptionalGovId,
                        validations: if(
                          a!isNotNullOrEmpty(local!docOptionalGovId),
                          {},
                          "At least one option must be selected."
                        )
                      )
                    ),

                  }
                ),
                a!sideBySideLayout(
                  items: {
                    a!sideBySideItem(
                      item: a!checkboxField(
                        choiceLabels: {
                          "Consent Form and Security Regulations"
                        },
                        choiceValues: {
                          "Consent Form and Security Regulations",

                        },
                        label: "",
                        value: local!docConsentForm,
                        saveInto: local!docConsentForm,
                        validations: if(
                          a!isNotNullOrEmpty(local!docConsentForm),
                          {},
                          "At least one option must be selected."
                        )
                      )
                    ),

                  }
                ),
                a!sideBySideLayout(
                  items: {
                    a!sideBySideItem(
                      item: a!checkboxField(
                        choiceLabels: { "ID Verification" },
                        choiceValues: { "ID Verification", },
                        label: "",
                        value: local!docIdVerification,
                        saveInto: local!docIdVerification,
                        validations: if(
                          a!isNotNullOrEmpty(local!docIdVerification),
                          {},
                          "At least one option must be selected."
                        )
                      )
                    ),

                  }
                ),
                a!sideBySideLayout(
                  items: {
                    a!sideBySideItem(
                      item: a!checkboxField(
                        choiceLabels: { "Criminal Record Check Report(s)" },
                        choiceValues: { "Criminal Record Check Report(s)", },
                        label: "",
                        value: local!docRequiredCriminalCheck,
                        saveInto: local!docRequiredCriminalCheck,
                        validations: if(
                          a!isNotNullOrEmpty(local!docRequiredCriminalCheck),
                          {},
                          "At least one option must be selected."
                        )
                      )
                    ),

                  }
                ),
                a!sideBySideLayout(
                  items: {
                    a!sideBySideItem(
                      item: a!checkboxField(
                        choiceLabels: { "Other" },
                        choiceValues: { "Other", },
                        label: "",
                        value: local!docOther,
                        saveInto: local!docOther,
                        validations: if(
                          a!isNotNullOrEmpty(local!docOther),
                          {},
                          "At least one option must be selected."
                        )
                      )
                    ),

                  }
                )
              },
              validations: a!validationMessage(
                message: "Invalid",
                showWhen: and(
                  a!isNullOrEmpty(local!docRequiredGovId),
                  a!isNullOrEmpty(local!docConsentForm),
                  a!isNullOrEmpty(local!idVerification),
                  a!isNullOrEmpty(local!docRequiredCriminalCheck),
                  a!isNullOrEmpty(local!docOther)
                ),
                validateAfter: "SUBMIT"
              )
            )
          },
          isCollapsible: true
        )
      },
      showWhen: not(ri!readonly),
      isCollapsible: true
    ),
    a!richTextDisplayField(),
    a!buttonLayout(
      primaryButtons: a!buttonWidget(
        label: "Submit",
        saveinto:{},
        submit: true,
        style: "SOLID",
        loadingIndicator: true,
        validate: true,
        /*validate: a!validationMessage(*/
          /*message: "Invalid",*/
          /*showWhen: or(*/
            /*a!isNotNullOrEmpty(local!docRequiredGovId),*/
            /*a!isNotNullOrEmpty(local!docConsentForm),*/
            /*a!isNotNullOrEmpty(local!idVerification),*/
            /*a!isNotNullOrEmpty(local!docRequiredCriminalCheck),*/
            /*a!isNotNullOrEmpty(local!docOther)*/
          /*),*/
          /*validateAfter: "SUBMIT"*/
        /*)*/
      ),
      secondaryButtons: a!buttonWidget(
        label: "Cancel",
        value: true,
        saveInto: { ri!cancel },
        submit: true,
        style: "OUTLINE",
        validate: false
      ),
      showWhen: not(ri!readonly)
    )
  }


  • 0
    Certified Lead Developer
     in reply to Zakary Melvin

    The form layout does a few things you cannot replicate using other layout components. I will post about this soon.

© 2025 Appian. All rights reserved.
We want to hear from you! Submit a review on Gartner or G2.