Admin Mapping Items to Institution - hmislk/hmis GitHub Wiki

Mapping Items to an Institution

Overview

Institution item mapping controls which services are available across an entire institution. When you map an item to an institution, every department within that institution can potentially bill that item (subject to further department-level filtering). This is the first step in configuring which services are visible at a hospital or branch.

When to Use

  • A new service has been created and needs to be made available at one or more institutions
  • A service that was previously institution-specific needs to be extended to another branch
  • You need to review or clean up which services are currently available at an institution
  • Removing outdated services from an institution's billing catalogue

Navigating to Institution Item Mapping

  1. Click Administration → Manage Items
  2. In the item management index, navigate to Manage Institution Item Mappings

Required privilege: AdminItems

The Screen Layout

The screen is divided into two columns:

Left column — All Items:

  • A table showing all items in the system with columns: Name, Institution, Department, Base Value
  • Use the column filters to search by item name, institution, or department
  • Tick the checkboxes to select items you want to map
  • Multiple rows can be selected at once

Right column — Items Mapped (to selected institution):

  • Shows items already mapped to the institution you selected at the top
  • Columns: Name, Institution, Department, Base Value
  • Tick rows to select them for removal

Adding Items to an Institution

  1. In the Institution field at the top left, type to search and select the target institution
  2. Click Fill Items Added For Institution to load the current mapping in the right column
  3. In the left table, select the items you want to add (use the checkboxes)
  4. Click Add Items to Institution
  5. The selected items appear in the right-column "Items Mapped" table

Tip: You can filter the left table by name or institution to find groups of items quickly. Select all visible rows at once by clicking the header checkbox.

Removing Items from an Institution

  1. Load the current mapping by clicking Fill Items Added For Institution
  2. In the right "Items Mapped" table, select the items to remove
  3. Click Remove Selected

Warning: Removing an item mapping means that item can no longer be billed at this institution. Any department-level mappings for the same item at this institution are also effectively bypassed. Only remove items that are genuinely no longer used at the institution.

Bulk Operations

The table supports multi-row selection. For large item sets:

  • Use the Name filter to narrow to a category or service group
  • Select all filtered rows
  • Add or remove as a batch

After Mapping to an Institution

Institution mapping alone makes items visible to all departments at the institution. To restrict further so only specific departments can bill an item, proceed to Mapping Items to a Department.

Technical Notes (Admin/Developer)

Institution mappings are stored as ItemMapping entities with institution set and department null. The itemMappingController.fillItemMappingsForSelectedInstitution() loads existing mappings; addAllSelectedItemsToInstitution() creates new records; removeSelectedItemMappingForInstitution() deletes them. The itemMappingController.selectedItems holds the selected rows from the left table; selectedItemMappings holds the right-table selection for removal.

Related Features