Department / Unit Manager

Departments and units are the choices for:

  • Department/Unit on the expense form (required for every expense).
  • Department fields you add in the Form Builder.

Go to Admin > Department / Units. The page, titled Department/Unit Manager, is for Admins only and is always on.


Departments and units

Department/Unit Manager listing departments and units with their type, address, phone and email

  1. Add New Department/Unit. Until at least one type exists, the bar shows PLEASE ADD AT LEAST ONE TYPE BEFORE ADD DEPARTMENTS OR UNITS instead.
  2. Types: add, rename or delete types (see Types).
  3. Click a row to edit or remove that department or unit.

The list is sorted by name; Department/Units shows how many there are.


Add a department or unit

  1. Click Add New Department/Unit.
  2. Enter a Name and choose a Department/Unit Type.
  3. Optionally, enter Address, Phone and Email.
  4. Click Submit Department/Unit.
Field Required Maximum length
Name Yes 50 characters
Department/Unit Type Yes -
Address No 75 characters
Phone No 15 characters
Email No 50 characters

⚠️ Note: Longer values aren't saved and xBit shows an error page. Go back and shorten them.


Edit or remove a department or unit

Click its row to open Edit Department/Unit.

Edit Department/Unit form with Update and Remove buttons

  1. Update: saves your changes.
  2. Remove: deletes it after you confirm Are you sure?. You can't undo this.

You can't remove a department or unit that is used on an expense. xBit shows An error occurred while deleting the department. There is no way to deactivate one; rename it instead if it's no longer current.


Types

Every department or unit has a type, for example "Police Department" or "Forensics Unit". Click Types to open Department/Unit Types.

Department/Unit Types window with edit, in-use count, delete and add controls

  1. Rename the type.
  2. In use: the number of departments or units with this type. A type in use can't be deleted.
  3. Delete a type that isn't in use. There is no confirmation.
  4. Add New Department Type: enter a name and click Add.

New and renamed types appear in the Department/Unit Type choices straight away. The count next to Types in the page bar updates when you reload the page.


Where they're used

  • Expenses: every expense needs a Department/Unit. The choices are all departments and units.
  • Form Builder: a Department field offers every department and unit, whatever its type. Its settings show Go to Department/Unit Manager to edit Choices instead of a list of choices.
  • Report Builder: expense tables can include a Department/Unit column.
  • API: Get Expense Departments (GET /api/v1/expense/department) returns the IDs to use when adding expenses (see API).

See also Optional Settings.