Skip to main content

Department Range Function (FSN.Range.Departments)

Department Range Function (FSN.Range.Departments)

The FSN.Range.Departments function returns a dynamic array that can be used to quickly build out worksheets that segment data based upon the department. The syntax for the function is:

Argument NameInput InformationRequiredDefault Value
Include FilterSpecifies the departments 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 departments
Exclude FilterSpecifies the departments to exclude. Values can be specified as they are in the Include FilterNoExclude none
SubsidiarySpecifies the subsidiary to use to determine the departments to return. Only departments that are valid for the subsidiary are returned.NoDoes not filter by subsidiary
Include BlankDetermines whether or not to include the <No Department> explicit blank value in the listNoTRUE
LevelSpecifies the maximum level of the hierarchy to return. A value of 2 will return all levels <= 2NoIncludes all levels
Include InactiveSpecifies whether or not to return departments marked as IsInactive=T in NetSuiteNoFALSE (Excludes inactive)
Include RollupInclude rollup value (Hierarchy) for values with childrenNoTRUE (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 departments, 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.

Example

Suppose that a report is needed which shows balances based upon department. Start with a standard Balance Sheet template, then select the Department cell D12. From the Finsyte ribbon, select the Clear option submenu in the Productivity section and select Clear All. This will clear the cell's formatting and data validation rules for the dropdown. In the same cell, enter the formula =FSN.Range.Departments(,,D$5,,,,,,TRUE) to generate the list of departments horizontally. From there, copy column D over to column E. This will generate a #SPILL! error, since the formula was copied over to column E. Simply delete the value in cell E12 to remove the #SPILL! error. Finally, copy column E across the worksheet in each column where a value appears for the departments.