Required Document Templates: Conditional Fields

Public House applications dynamically request each Required Document based on the household and financial details the applicant provides evaluated against the conditions defined by your organization.

The application provides the flexibility to request all the documents you need but not to request information when it does not apply under all circumstances or for all household members.

For example, your application will only ask for DD-214 Veteran forms if a household member has indicated that they are a veteran. Or you can ask for Photo IDs from household members over 18 years of age.

Conditional Fields: How do they work?

Conditional true/false fields dictate the circumstances for when a Required Document is requested in an application. Though typically true/false formulas, conditional fields can also be checkboxes that staff selects to request additional Required Documents for unique circumstances.

When a Conditional Field result is TRUE (checked), the Required Document is automatically added to the application in the specified location. If the result is FALSE, a Document Required will not appear.

Required Document Templates without a Conditional Field will always appear on the application.

Note: If a conditional Field is modified, when the application interface is opened for a specific applicant, any existing Required Documents that fail to meet the new condition will be deleted along with any files uploaded to the cloud storage.

Creating/Editing a Conditional Fields

Conditional fields are defined in the Required Document Templates. System Admins and savvy users can edit existing conditions or create new ones as needed.

Required Documents and their conditional fields are associated with a location in the application. Find the associated custom object by following the Location Object Link on the Required Document Template.

Required Documents Location Object
In the Asset sectionAsset
In the Income sectionIncome Source
In the Household MemberHousehold Member
Financial History, Current Living Situation, Homeownership InterestService File
Table demonstrating which Custom Object to Create or Edit a Custom Field

To create a new Conditional Field, on the Location Object, select ‘New’, select formula, checkbox, and follow the directions to create your formula. The new conditional Field name should begin with “Req Doc” to ensure it is easy to locate.

Enter the API Name on the “Conditional” entry of the Required Document Template.

To edit a custom Field, search for your conditional Field name on Location Object.

Tip: The system will not allow you to save invalid Conditional Fields, Programs or Document Review Fields.

Savings Account Example

Custom Field & Condition for Savings Account Required Document Template. Once created, the API name is entered as the conditional Field in the Required Document Template set-up (below). When a Savings Account is added to an application, the Savings Account statements will show as required documents to upload!

Common Formulas

Required DocumentLocationFormula
Primary ApplicantHousehold MemberISPICKVAL(HOMEtracker__Application_Role__c,”Primary Applicant”)
VeteranHousehold MemberISPICKVAL( PHA__MilitaryStatus__c,”Retired”)
Zero IncomeHousehold MemberAND(
  OR(
    ISPICKVAL(HOMEtracker__Employment_Status__c,”Homemaker”),
    ISPICKVAL(HOMEtracker__Employment_Status__c,”Full-time student”)
    ISPICKVAL(HOMEtracker__Employment_Status__c,”Permanently unable to work”)
    ISPICKVAL(HOMEtracker__Employment_Status__c,”Unemployed and seeking work”)
    ISPICKVAL(HOMEtracker__Employment_Status__c,”Unemployed and not seeking work”)
    ISPICKVAL(HOMEtracker__Employment_Status__c,”Retired”)
  )
)
Self-EmploymentIncome SourceISPICKVAL(Income_Type__c,”Self-Employment”)

Using checkboxes as conditional fields

Staff Conditional Check Boxes can be used as conditional fields for Required Document Templates. This allows staff to add Required Documents to an application for special circumstances at their own discretion during Document Review. Submit a support ticket to request to add the document as an optional one in the Staff Review section of the Application Interface.