Skip to main content

Employee Range Function (FSN.Range.Employees)

Employee Range Function (FSN.Range.Employees)

The FSN.Range.Employees function returns a dynamic array that can be used to quickly build out worksheets that segment data based upon the employee. This is a specific type of Entity. Note that roll-up values will only show if the parent/child relationship are both employee type entities. The full parent/child hiearchy is viewable by using the full Entity function instead.

The syntax for the function is:

Argument NameInput InformationRequiredDefault Value
Include FilterSpecifies the employees to include. Multiple values can be specified by another dynamic array (e.g., using a named range, specifying a range of cells like E1:E10, etc) or concatenated as a string using the ^ character. Additionally, if the values are numeric wildcards and range values can be used such as 100-200, 10*, or 1*-20?0.NoInclude all employees
Exclude FilterSpecifies the employees to exclude. Values can be specified as they are in the Include FilterNoExclude none
SubsidiarySpecifies the subsidiary to use to determine the employees to return. Only employees that are valid for the subsidiary are returned.NoDoes not filter by subsidiary
Include BlankDetermines whether or not to include the <No Employee> explicit blank value in the listNoTRUE
LevelSpecifies the maximum level of the hierarchy to return. A value of 2 will return all levels <= 2Includes all levels
Include InactiveSpecifies whether or not to return employees marked as IsInactive=T in NetSuiteFALSE (Excludes inactive)
Include RollupInclude rollup value (Hierarchy) for values with childrenTRUE (parent rollup Hierarchy values are returned)
Rollup OnlyIf TRUE, then only top-level rollup values are returnedNoFALSE
HorizontalControls whether the returned dynamic array spills vertically or horizontally. This values is useful when creating reports based on employees, where values are specified in a single row across the sheet.NoFALSE (returns a vertical list)
Rollup FirstWhen TRUE, returns the rollup (Hierarchy) values before the children. When false, the rollup value is returned after the childrenNoTRUE (Rollup value is returned first)

Remarks

  • Review the Function filter syntax for selecting ranges as needed.
  • #SPILL! may appear in the array function cell when the resulting array determined by your parameters will not fit in the provided Excel area.