# 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](Admin-Mapping-Items-to-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 - [How OPD Item Listing Works — Overview](Admin-OPD-Item-Listing-Overview) - [Mapping Items to a Department](Admin-Mapping-Items-to-Department) - [OPD Services Overview](Admin-OPD-Services-Overview)