Configure AAHC

Configure AAHC

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

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.

  • Click Import.

Last updated

Was this helpful?