AAHC retrieves the medical journal logs via a remote Logpoint server. You have to configure the Logpoint server in AAHC.
1
Configure Remote Logpoint in AAHC
Go to LP Configuration from the left navigation bar.
Logpoint Settings
In Logpoint Settings:
Provide the search URL in the following formats:
https://aahc.lwa.logpoint.local
or
https://<qualified domain name of the remote Logpoint server>
Provide a Logpoint Username.
Provide the Secret Key to fetch logs from the Logpoint server. You can get the secret key from the API Access Key tab in the Preferences panel in Logpoint.
Getting Logpoint Secret Key
Upload the SSL certificate for the Logpoint server in the Logpoint Certificate field. AAHC requires the same certificate as uploaded in the Logpoint's HTTPS system settings (Settings >> System >> System Settings >> HTTPS). See Important Considerations for Installation for details.
Click Fetch Preference to get the timezone, date format, and hour format from the Logpoint server.
Fetch Preference
Note: You must click Fetch Preference every time you change the Logpoint URL.
In the Filter Value section, enter the event list configured in the Logpoint. AAHC uses this list to filter the search results. See the Event List for AAHC section to create the required event list.
Click Save.
App Preferences
Preferences you can set for AAHC include:
Broadcast messages.
Date format, time format, and language.
Include search filters in downloaded search results' headers and footers.
Include row count in downloaded search results.
Upload organization logo.
Upload TLS/SSL certificates.
App Preferences
1
Broadcast a message
Enable Broadcast Message.
Enter your message.
Click Save.
AAHC displays the message on the Search page.
2
Date and time format
Click the Date Format drop-down and select a format.
Click Save.
Changes are reflected in the AAHC UI and generated reports.
3
App language
AAHC supports English and Swedish. Select the corresponding radio button and click Save.
4
Application logo
Before uploading a logo, ensure the size is 240 × 90 pixels.
Ways to upload a logo:
In Application logo:
Drag and drop your logo image file, or
Browse to the file location and click Save.
All AAHC pages and generated reports will show the updated logo.
5
TLS/SSL certificates
TLS/SSL enables HTTPS for AAHC (secure browser-to-server communication).
Ways to upload TLS/SSL certificates:
In TLS/SSL Certificates:
Drag and drop the files, or
Click the area to browse files, then click Save.
Search Permission Groups
Search permission groups define user access to specific repositories and column templates. A user in a search permission group can search only the repos and column templates specified.
1
Create a Search Permission Group
Go to Search Group from the navigation bar.
Click Create Group.
Creating a Search Permission Group
Enter a Group Name.
Select the Repos.
Select the Column Templates (use Select All to select all templates).
Click CREATE.
AAHC includes a default search permission group (admins and super admins can edit it).
2
Update a Search Permission Group
Go to Search Group.
Click the Edit icon in the Actions column.
Editing a Search Permission Group
Edit values and click Update.
3
Delete a Search Permission Group
Before deleting, ensure the group isn't associated with any user or scheduler.
Go to Search Group.
Click the Delete icon in the Actions column.
Deleting a Search Permission Group
Click Yes to confirm.
Authentication Settings
You can configure IdP settings and role mappings from Auth Settings. Admin login is required.
1
IDP Settings
Go to Auth Setting from the navigation bar.
IDP Settings
Enter the Metadata URL of your IdP server.
Click Fetch to retrieve metadata (entity ID, login/logout URLs, token signing certificate). This metadata is exchanged for secure authentication.
2
Create IDP Mapping
IDP Mapping links IdP user groups to AAHC roles and permissions (based on attributes in the SAML token).
Click Create IDP Mapping.
Creating an IDP Mapping
Enter the IDP User Group (value of roles attribute in the SAML token).
Select Role Access:
User Access — search by User ID.
Patient Access — search by Patient SSN.
All Access — search by User ID and Patient SSN.
Report Access — view AAHC reports only.
Report Admin — view and delete archived reports.
Super Admin — create predefined search queries and report schedulers.
Select Search Permission Group.
Click Create.
3
Export AAHC Metadata
To enable the IdP to communicate with AAHC (SSO):
Go to Auth Setting.
Click Export (bottom right).
An XML file with AAHC metadata will be downloaded.
Exporting AAHC Metadata
Users
Super admin or admin users can create and manage other users. There is only a single Admin user (Admin role cannot be assigned to other users). See User Roles for role details.
1
Create a User
Select Users from the left navigation bar.
Click Create User.
Creating a User
Enter Fullname.
Enter Username (used to log into AAHC).
Default password: _1am@aaHc_
Select the user's Roles.
Select the user's Search Permission Groups (a user can belong to multiple groups).
Deselect Enable User if you want the user disabled by default (users are enabled by default).
Select the Care Provider and its care units (user has permissions for selected care units only).
You can import care providers and care units in JSON using Export and Import. If not imported, the Care Provider list is empty.
Upgrading to AAHC v1.8.0 adds existing users to the default search permission group.
Click Create.
2
View user details
Select Users.
Click the View icon in the Actions column.
Viewing a User
3
Edit a user
Select Users.
Click the Edit icon in the Actions column.
Editing a User
Change required parameters and click UPDATE.
4
Disable a user
Select Users.
Click the Edit icon in the Actions column.
Deselect Enable User.
Click Update.
Disabling a User
5
Reset a user's password
Select Users.
Click the Edit icon under Actions.
Toggle Reset Password? to ON.
Resetting the Password
Click Yes to confirm.
Click Update.
6
Unlock a user
Select Users.
Click the Edit icon under Actions.
Toggle Unlock User? to ON.
Unlocking a User
Click Yes to confirm.
Click Update.
Columns
Columns are data fields displayed in search results. Admin and super admin users can create predefined column templates to define included fields and their order.
There are two types of column templates:
User type — for users with User Access role.
Patient type — for users with Patient Access role.
1
Add a column template
Go to Columns from the left navigation bar.
AAHC provides two default column templates; Log Date is included in both by default:
Default user search — fields from previous AAHC version for User.
Default patient search — fields from previous AAHC version for Patient.
Columns
Click Add Column Template.
In Create Column Template, provide:
Name for the template.
Type: Patient or User.
Select Date only or Date and time to group search results.
Group by Date — groups by Log Date, single entry for identical events on same day.
Group by Date and time — groups by Log Timestamp (log_ts), single entry for identical events at same timestamp (multiple entries allowed for identical events same day).
Drag fields from the Fields table (left) to Search Fields (right).
Create Column Template
Click Save.
Added templates appear on the Result table fields page for edit or delete.
2
Select a default search template
You can set a custom column template as the default search template based on template type:
Default USER Search template — used for users with User Access role.
Default PATIENT Search template — used for users with Patient Access role.
New Column Template Added
Map Fields in AAHC
From Mapping you can map AAHC search fields to corresponding Logpoint fields.
Mapping Page
1
Map existing search fields
Select Mapping from the left navigation bar.
For all default search Fields, AAHC sets default Normalized Fields.
Click the Edit icon in the Actions column.
Updating the Field Mapping
Enter the corresponding Normalized Field in Logpoint for the Field Name (default Field Name cannot be edited).
Click Update.
2
Create and map a custom search field
Select Mapping.
Click Add Field Mapping.
Creating a Map
Enter a Field Name (displayed as a column in AAHC).
Enter the corresponding Normalized Field in Logpoint.
Select Use As Search Filter? to use the field as a search parameter.
Select Is Required? to make it mandatory.
Select Field Type (Text input, Number input, Date input, Select).
For Select, enter Field Options separated by semicolons (;).
Click Create.
You can use custom fields in column templates. You can edit or delete custom maps — ensure a map is not used in any column template before deletion. Default maps cannot be deleted.
Column Template using mapping
Language Settings
AAHC supports English and Swedish for UI and report elements. Language elements are grouped by category.
1
Set up language elements
Select Languages from the left navigation bar.
The Languages page lists each element with English and Swedish translations.
Languages
Locate the element in the table.
Select the term to change.
Change the term as required.
Changing a Swedish Term
Notes:
Some values contain placeholders (ALL CAPS) which must not be translated. Example: report.generated.date value is "Generated at : GENERATED_DATE" — translate only the literal text and keep GENERATED_DATE unchanged.
AAHC supports Swedish NZE characters.
Click the Reload Language icon (top right) to apply changes.
2
Download and upload language configurations
To reuse translations across AAHC machines:
Select Languages.
Click the Download icon (top right) — exports a CSV translation file.
Downloading Languages
On target machines, click the Upload translation icon (top right) to open Import translations.
Click Select to browse for the translation file (use Reset to change the selected file).
Uploading Translations
Click Upload.
Warning: Uploading replaces all existing translations — ensure you upload the correct file.
Click the Reload Language icon to reflect changes.
Event List for AAHC
The event list is a customized list of user activities recorded by the medical journal and configured in the Logpoint server.
1
Add an event list to Logpoint
In Logpoint, go to Settings >> Knowledge Base >> Lists and Tables.
Click Add.
In Lists, select Static List.
Static List
Provide a Name for the list.
Provide the activities in the List of Values.
Click Submit.
Once added, go to the Filter section in the LP Configuration tab of AAHC and enter the event list name in the Event box.
Filter Event List
Example: AAHC_ACTIVITY_LIST contains GetEvent, EventRecord, GetEventRecord. Using AAHC_ACTIVITY_LIST as filter returns logs with those activity values.
Sample JSON File for Care Providers and Care Units
Following is a sample JSON file containing care providers and their units:
Audit Trail
AAHC generates audit records for login attempts, configuration, and search history, and forwards audit logs to a remote Syslog server (Logpoint or other).
1
Add the AAHC server in Logpoint
Log into Logpoint.
Go to Settings >> Configuration >> Devices.
Click Add.
Enter Name for the device.
Enter the IP address(es) of the AAHC server.
Enter Device Groups, Log Collection Policy, Distributed Collector, and Time Zone.
Define risk values for Confidentiality, Integrity, and Availability.
Click Save.
Create Device
In Available Collectors Fetchers, click Syslog Collector.
Add the Syslog Collector to the device.
Syslog Collector
Make sure to apply the logpoint normalization policy to correctly normalize the audit logs.
2
View AAHC audit logs in Logpoint
Go to Search in Logpoint and run:
Audit Logs
Export and Import
From Export and Import, you can:
Export/import field mappings and column templates.
Export/import care providers and care units.
Export/import search queries.
1
Export field mappings and column templates
Select Export and Import from the navigation bar.
Click Select Entity Action and choose Export - Field mappings and column templates.
Export Field Mappings
Click Export — AAHC exports a .pak file.
2
Import field mappings and column templates
Select Export and Import.
Set Select Entity Action to Import - Field mappings and column templates.
Drag and drop the .pak file or browse to it.
Import Field Mappings
Click Import.
Importing replaces current field mappings and column templates.
3
Export care providers and care units
Select Export and Import.
Choose Export - Care providers and care units.
Export Care Providers
Click Export — AAHC exports a JSON file.
To view a care provider’s care units, click the arrow to expand the list.
4
Import care providers and care units
Select Export and Import.
Choose Import - Care providers and care units.
Import Care Providers
Drag and drop the JSON file or browse to it. You can create a JSON file (see Sample JSON File for Care Providers and Care Units).
Click Import.
5
Export search queries
Select Export and Import.
Choose Export - Search queries.
Export Search Queries
Click Export — AAHC exports a JSON file.
6
Import search queries
Select Export and Import.
Choose Import - Search queries.
Import Search Queries
Drag and drop the JSON file or browse to it. You can create a JSON file for search queries.
Ensure the search query names in the JSON do not match existing AAHC search query names.
