AgileApps Support Wiki Pre Release

Dynamic Filters

From AgileApps Support Wiki
Revision as of 18:58, 1 July 2013 by imported>Aeric

Dynamic Filters define a query with field variables, enabling more powerful controls.

  • Use Dynamic Filters when complex associations are needed for Record Selection Criteria
How it Works
  • In a Technology Asset record, display a list of Technicians certified to support or repair the equipment
  • For an Inventory Application, add a field to a Part Record that finds only component parts (subcomponents of the Part)
  • For a Product or Service Ordering Application, add a field to a Brand Record that limits the lookup to products that belong to the brand family
  • In a Candy Manufacturing Application, add a field to a Recipe Record that identifies organic ingredients only
Guidelines for building Dynamic Filters
The format of a Dynamic Filter changes, depending on the type of field:
  • Lookup
  • Other (text, date, other alphanumeric field)
To specify Dynamic filters in the UI, insert a derived field name in the Value field of the Record Selection Criteria builder
  • To create a derived field name, include a dollar sign ($) before the internal field name (this identifies the value as a dynamic filter)
  • If a Lookup field is chosen, use the $fieldname_name format
  • For all other fields, use $fieldname
Where fieldname can be found in Field Name
Examples
  • In a Lookup field of Object "Employee", to restrict the Employees available depending on the Location, set filter to {0} in the Location field. If the Location is any other field type, set filter to {1} in the Location field.
  • An IT assets object is linked to the Service Techs object, which includes staff members who are responsible for support
  • Service Techs have an Area of Responsibility that matches one of the available IT asset Types: "Laptop", "Desktop", or "Server"
  • The Service Tech object is defined as follows:
  • In the IT asset object, the Lookup field to the Service Tech object includes Record Selection Criteria that limits the lookup to Service Techs with Areas of Expertise that match the Asset Type:
  • When assigning the asset to a user, a Service Tech is selected, and the list of Service Techs displayed in the Lookup Window shows only the techs with expertise in the required area of technology
User-specific template variables
Record data can be compared to the User object data for the current user. Those criteria have the form:
{field_name} {operator} $user.{User_object_field}
For example:
  • Owner equals $user.id - Records owned by the current user
  • Created By equals $user.id - Records created by the current user
  • Modified By equals $user.id - Records modified by the current user
  • City equals $user.city - Records in the current user's city
Similarly, were you to add a custom hiredate field or birthday field to the User object, you select records that came before or after that date using the less than and greater than operators.
LabelTemplate VariableComment
Current Date $today Current date in Company date format
Current Date User Date Format $today_dateformatted Current date in User's date format
User Id  $user.id  
User Full Name $user.fullname First name and last name, together
User First Name $user.firstname  
User Last Name $user.lastname  
User Email Address $user.email    
City $user.city  
State/Province $user.state  
Zip/Postal Code $user.zip  
Country $user.country  
Title $user.title  
Division $user.division  
Phone $user.phone  
Fax $user.fax  
Mobile Phone $user.mobile  
Street $user.street  
User HTML Signature $user.html_signature  
User Text Signature $user.text_signature  
User Name $user.username User's login name

All custom fields defined on the User Object