Home Administration

Administration

Setup and configuration related questions
Sebastian Leidig
By Sebastian Leidig
11 articles

User Roles & Permissions

Aam Digital offers a configurable access control system to limit user permissions. Users can be assigned one or more roles that can limit permissions on various levels: - limit access to selected types of data (e.g. restricting sensitive health or learning details) - limit access to selected groups of records (e.g. allowing access only to beneficiaries at a specific location) - limit access to selected documents (e.g. users can only access individually assigned notes) - limit selected actions (e.g. allowing only coordinators to register new beneficiaries) User management is based upon the Keycloak system, which offers options for integration with other single-sign-on providers, 2-factor-authentication and advanced authentication options. also see: - Data Security one-pager - User Guide: Invite & Disable users User Roles A role defines a set of access rules that give users permissions regarding certain data records. One role usually defines several rules that logically depend on each other. This keeps user management simple, as you only have to assign one (or very few) roles to each user. (e.g. one role could give read-only access to all participant records and also permission to create and update notes). for details about the available access rules, see below Roles are assigned to individual user accounts. A user can also be assigned to multiple user permission roles. The permissions of each role are then combined to give that user access to the combination of all the roles’ access rights. (e.g. a user could be assigned roles of “health worker” and “teacher”, giving access to health and education details for that account) Access Rules An access rule defines a subset of data and an allowed action that this user role is allowed to take on the given subset of data Actions that can be granted/restricted are: - create: add new data records - read: access existing data records - update: edit existing data records - delete: completely remove existing data records Subsets of data can be defined by a combination of: - Entity type (e.g. Participants / Notes / Events / …) - Value of a field of the record (e.g. participants with “gender” = “male”; events with “status” = “approved”) - (!) it is not possible to use “indirect values” for permissions (e.g. participants whose linked school is located in region X) - Link to the current user (e.g. notes where the user is included in the “authors” field) - Link to a “project” entity that the current user is added to (e.g. the user’s profile is linked to several “project” entities, participant records are also linked to a project entity, the user receives access only to those participants that are linked to the same project that the user account is linked to) Example: Rules for approval workflow Roles: - manager - Access to all records - All actions (read / update / delete) - fieldworker - Access to records linked to own user account - Allowed to create and read these records - Allowed to edit records only if the record’s “status” field is “to be reviewed” Scenario / Workflow: (exact fields and status categories below can be freely customized for your specific system) 1. fieldworker registers new participant. 1. → creates new record in Aam Digital. 2. “registered by” field of the new record is automatically pre-filled with a link to the user account. This gives the team clarity who recorded this data and grants the fieldworker continued access to this new record 3. “status” field of the new record is automatically pre-filled to “to be reviewed”. This gives the manager an indication to check this record (and approve it) and allows the fieldworker to continue editing the record making corrections. 2. manager approves the new participant. 1. → edits the record created by the field worker and checks the details. 2. manager changes the “status” field to “approved”. This gives the team an indication that this record has been checked. The fieldworker can still see the record (he/she is still assigned in the “registered by” field) 3. … but the fieldworker now cannot edit the information anymore (because the status is not “to be reviewed”). This ensures there are no accidental changes that contradict the approval. 3. … the manager at any time can also change the status of a record back to “to be reviewed”, which allows the fieldworker to again edit the record and make corrections until the manager changes the status again.

Last updated on Sep 14, 2024

Manage User Accounts & Add Users

You can manage user accounts yourself within the Aam Digital application, if your account has the required "account_manager" permission role. 1. Navigate to the Users list 2. Click the "Create New" button to add a new record (or open an existing record to edit that user) 3. When creating a new user account, there are two steps: 1. Create the "profile" record by filling and saving the initial form (1) + (2). This makes that person available in the system to link records with, e.g. assign notes or tasks to this profile. 2. Create the "account" for login to the platform by navigating to the "User Account & Security" tab in the record. Fill the email, assign user roles and then "send invitation" to that email. 3. The system then sends an automatic message to that email id with a link to create an initial password, enabling that user to log in and access your Aam Digital system. also see User Roles & Access Permissions Deactivate User Account To deactivate an account and prevent that person from login into your Aam Digital system, also edit that User record's details: 1. Open User Details from the user list 2. Select the “Security” or “User Account” tab 3. Click “Edit” in that tab 4. Now the “Deactivate user” button is visible, 5. Click that to block logins for that user. 6. You can also activate that user account again by “Edit” from the tab Deleting User Records You can also delete user records completely, using the "Delete" option in the three dot menu of the record. The related user login (if any account exists for this record) is then delete automatically as well. Please be aware that deleting a user record will completely remove this data from your system. This includes links to notes, tasks or other activities that identified this user as a an author or responsible person for these. If the user has been linked to any data, you most likely do not want to delete the record and instead only archive or anonymize it: see Archiving and Anonymizing records

Last updated on Jul 21, 2025

Adding a new field to a profile form

Aam Digital is extremely customizable and you can easily change the fields and data structures of your record types (e.g. add an additional phone number field to the "student" profile - or change anything else around this). You can even create as many new "record types" as you need to manage your specific project (e.g. adding "school", "village" or other lists of related records with their own profiles). In this guide, we explain how you can change the form of an existing record type. As an example here, we'll walk you through the process of adding a "mother's name" field to the "Children" record type. (You can follow along in our interactive demo system: demo.aam-digital.com) 1. Open the Admin UI for the record type: 1. navigate to the list of Children (or open a child's details) 2. click the three-dot menu in the top right 3. select "Edit Data Structure" 2. Navigate to the "Details View" section of the Admin UI: 1. Now you see a preview of your profile view for that record type. You can edit the fields and layout here by dragging and dropping elements. 3. Drag & drop the "Create New Field" block from the sidebar on the right into the place in your form where you want to see the new field 4. When you drop this somewhere in the form preview, a popup opens to configure the newly created field. 1. Add a "label" (the text that will be displayed to users) 2. Select a "type". For our example this will simply be "text". 3. The type defines what kind of data can be entered in this field. Apart from simple text you can also define dropdown fields, links to other records, file attachments or other special field types. 4. 5. Save the popup form. Your new field is now shown in the preview. 5. You can also display the new field in the list of all records. 1. These steps to display the field in the list are optional. You can also just add the field to the details profile and skip this. 2. Switch to "List View" on the left of the Admin UI to display the new field in your overall table of all children also 3. Click the "+" button at the bottom of the page below the preview of the currently displayed table columns 4. Activate the "toggle" by clicking on the name of your field to display it in that list view 6. Save the Admin View overall, using the "Save" button on the top right of the page 7. You can now use your new field whenever you create or edit a "Child" record.

Last updated on Sep 16, 2024

Getting Started configuring & customizing your system

Aam Digital is very flexible and you can customize the structures and views to exactly fit your project's needs. This article gives a general overview of the steps to customize your system - both the "technical" tasks and the processes we recommend for your internal planning and change management. Steps of a typical setup process 1. Get initial access to your Aam Digital system 2. Configure basic data structures and interface 3. Test this "prototype" with a small group of your team 4. Refine the configuration 5. Import existing data (if needed) [see Importing data] 6. Introduce your team to the new system [see User Training] 7. Start day-to-day use officially; Make further reviews and adjustments Configuring a custom system 1. Define the primary "entity types" that you manage in your system 1. e.g. Students and Schools; or Patients, Health Workers and Clinics 2. "entity types" are the different kinds of records you keep data on. You can view these as lists or in a detailed profile view for one selected record 2. Define the "secondary" entity types, the data that you want to record related to your primary entities above 1. e.g. Notes, Exam Results and School Attendance; or Vaccination Details and Health Camp Events 2. Technically, these entity types work the same like your primary entities. However, it can be helpful to think of these two categories of records you manage when designing a new system. 3. Add relevant form fields to entity types 1. e.g. name, date of birth and address fields for your Student profile 2. Detailed guide to using the Form Builder: Adding a new field to a profile form 4. Add relationships between entity types 1. e.g. Showing a list of the Notes related to a Student in that student's profile view 2. TODO: EXPLANATION 3. (not supported in Admin UI yet - please set this up with the technical support team) 5. Test & Improve

Last updated on Nov 14, 2024

User Training

How can you prepare your team to use Aam Digital and get comfortable with the new software? Our vision is to make Aam Digital so intuitive that you don't need any training or additional documentation. It can be useful to organize a short introduction to the system for your team. In such a "training session" you can ideally achieve two things: Get everyone comfortable with the software; And agree on the processes and details how you want to use the system as a team. Understanding Aam Digital functionalities As part of (paid) setup packages, our team at Aam Digital organizes an interactive online training session for your team. If you are familiar with your system, you can easily do such a training yourself also. We are sharing some suggestions and learning here below: - Slides: Basic User Training (Google Slides) - feel free to copy these slides and make adjustments - some slides are available in multiple alternatives for different use cases (e.g. for "event management" or "case management" focused systems/users). Notice the tag on the top right of the slide and skip those that are not relevant for your audience. - Try to add some interactive practice to the session itself. - Let your team members log into the system with their account, click around and create a test record. This gives a much clearer understanding and removes the initial doubts and hesitation that people often still have after training. Discuss how you want to use the system Introducing a software is not only a technical question. In fact, the more challenging part often is that your whole team agrees and adjusts to a new process. This may just mean to use the new software instead of the tools you used for this before. But it can also mean to change some other habits, like documenting more details than you previously did. 1. Which common tasks are now done in Aam Digital? 1. Discuss when and what everyone should record in the new system. Compare how and where the team previously recorded something like attendance or registered a new participant and where they should do that now in Aam Digital. 2. Do you need to move existing data? When does everyone have to start using the new system? 1. If you still have old systems in place, discuss when you make the switch. 2. It can create problems if some people still use or update data in the old system while others use the new system already. In that case it will not be clear what the latest information is. 3. How do you want to use the new features that Aam Digital offers? 1. How can Aam Digital become a tool that saves your time and makes things easier? 2. What can Aam Digital help you achieve that previously was not even possible, because you did not have the necessary information?

Last updated on Nov 14, 2024

Creating a "Public Form" for external users

The Aam Digital case management platform at its core is designed for you as a team to manage all relevant data. We are not primarily a data collection or survey form tool. However, you can allow outside people, who do not have a user account for your system, to submit new data - for example, letting participants self-register so that you don't have to type contact details from some other form into your database. This is what "Public Forms" are for. The link to a public form can be shared with anybody, they can fill the fields, and the submitted data directly creates a new record in your Aam Digital system. To create a new Public Form, open the Admin interface ("Edit Data Structure") for the list/record that the form should collect data for: In the Admin UI for the record type, you can manage all Public Forms for that type. Navigate to the "Public Forms" section on the left menu within the Admin UI: Then either select an existing Public Form to edit it or use the "+" button of that table to create a new one. You can configure description and the link for the Public Form. Copy the link from the "Form Link ID" field and share it with people to use the form: Use the tabs ("General Settings", "Configure Fields", ...) to also configure other aspects of the form. "Configure Fields" using the drag&drop form builder to define which fields are visible to the person filling this form: "Configure Pre-filled Values" to fix some field to a certain value without the user filling that into the form manually. This is especially important if you want to mark the records that were created through the form. You can then filter the list of your data to find and review submitted data, for example:

Last updated on Feb 06, 2025

Automated updates to a field based on the linked entity

There may be situations where you need to update a field in one record based on changes in another record. For example, a participant's “status” field may have to be updated when the activity they are participating in is marked as completed. However, updating them manually, one by one, can be time-consuming and cumbersome. There is also the risk of forgetting to update some records, leading to inconsistent and inaccurate data. Aam Digital offers a feature that can automatically update values based on linked entities. When you update a record's status, the statuses of related records are also automatically updated. This ensures that your data remains accurate and consistent with real-life situations. By automating these updates, you save time and can focus on other important tasks. Example Scenario To better explain this feature, let's take an example of a coaching class being run: Let’s assume multiple students and teachers are part of a coaching class. You want to track each student's status based on the status of the class (whether it is only planned, ongoing, or already finished). Updating the status of each student individually can be time-consuming and cumbersome. However, with this feature, you can automate the status update for all students in the class simultaneously. While updating the status for the entire class, you will also have the option to manually change the status of specific students if needed. Screenshot of updating the status of a Recurring activity and the status of the students linked to that activity. Through this guide, we will show you how to configure fields so that updating the status of the class will automatically update the related status for the students linked to it. The entity types in this example are - Students / Participants (“Child” records in the demo system) - Coaching Class (a “Recurring Activity” in the demo system) Using the automated field updates The demo system (demo.aam-digital.com) already has an example pre-configured: 1. Navigate to Attendance > Recurring Activities 2. Open one Activity 3. Edit the field “Status of Activity”, and click on the Save button. 4. --> A dialogue box will appear with a list of students with the automated status update: You can manually change the participants' statuses from this screen. After you have edited the status of the participants and confirmed to "Update related records", the status of each of the linked children will be updated. Configuring automated fields Step 1: Checking the trigger 1. Navigate to Attendance> Recurring Activities 2. Click on Manage Activities, and a list of classes will appear; select a class. 3. In the “Participants tab” of the class, there is a list of students linked to this coaching class. For the sake of this guide, the field “Status Activity” in the “Basic Information” tab will be set as the trigger field for automating the updates. The field has the following dropdown options: - Planned - Ongoing - Completed Note that currently, only a “dropdown” type field can trigger automations for other fields. We are now creating an automation rule, which entails creating a link between the children's status and the status of the class. Step 2: Editing the field to be automatically updated 1. Navigate to the Children entity. 2. Open the Admin UI (“Edit data structure”), and click on the field “Status”. (This field can be set as a text, dropdown field, or any other data type.) This is the field to be updated automatically when the “trigger” field (step 1) changes. Step 3: Setting up the automation rule In the dialog to edit the field, click on the tab "Advanced Options & Validation": In the "Advanced Options & Validation" tab you can active the functionality through the "Default Value" setting. Click on the last icon there for "Auto Update": This option is only available if this entity type is linked to from another type (here: from the “Recurring Activity” entities) Step 4: On clicking the Auto update icon, you can select which other entity should trigger updates to this field: We are creating an automation rule between the child entity and the recurring activity (coaching class). The system will then suggest to automatically update this field whenever the status of the coaching class changes in recurring activity. Step 5: After selecting the entity (Recurring Activity, in our scenario), click “Configure Automation” to define the further details. 1. Select the “related reference field”  (in our scenario, the participants/children part of the coaching class) 2. Choose the field that will help trigger automated updates (in our scenario, Status of Activity) Step 6: Define mapping of trigger and target values You can now configure the exact automation rule. The change in the trigger field (Status of Activity) will update the status of the Children linked to the coaching class. Automation configuration for our example: - Trigger Field (Status of Activity) --> Updated status (Status) - Planned --> Requested - Ongoing --> In Class - Completed --> Finished For example, if the Coaching class status is updated to Completed, the system automatically updates the children's status to Finished. Step 7: Test the configuration Go back to the first section of this guide and try your automation action. Does it update Children's status when you change a related Recurring Activity, as expected?

Last updated on Jun 03, 2025

Analyzing data: Dashboards & Reports

As you document more and more of your work digitally, you are building a detailed database for your project that allows you to monitor, evaluate and coordinate your work. Aam Digital has two modules to help you analyze: - Dashboard widgets give you a quick summary of your project in real-time. You can see simple numbers (e.g. how many participants are registered in your program currently) and critical developments (e.g. a list of students who have been absent in more than one class this week). Aam Digital's dashboard serves you as a kind of virtual assistant that highlights things that need your attention. - Reports calculate or summarize your data in a very flexible way. You can create as many custom report "templates" as you need and run them to give you results for your current data (or a specific time period that you select, e.g. calculating the report for the last financial year). Reports are basically database queries that can combine any of your different data structures and also do calculations based on them (e.g. counting the number of unique participants across different events; combining fields of student, school and note records into one big table for export and analysis; calculating average improvements of beneficiaries based on their individual baseline and endline survey responses; ...) Example of a Dashboard: Example of Reports: The difference between Dashboard and Report Dashboard and Reports are designed for slightly different purposes. Therefore, some things are only possible with a "report" but not on the dashboard. Any advanced analysis or calculation from data requires a report. The simple "record count" dashboard widget can show the total number of active records and disaggregate (i.e. split) them by any single field that's part of these records (e.g. show the number of children in the system and how many of them are male/female). Anything beyond this, like filtering or combining details of multiple fields, cannot be done on the Dashboard directly but needs to be implemented with a report. Visualization (graphs & charts) At the moment Aam Digital cannot generate any graphs or charts from your data directly on the system. You can easily download any list or report result and open it as a spreadsheet (or any other software) to create visualizations. If you are interested in co-funding an Aam Digital feature for this, please reach out to us!

Last updated on Jun 06, 2025

Configure the dashboard

Our dashboard is designed with your workflow in mind, giving you instant access to essential information whenever you need it! This view gives an overview at a quick glance of the things that require your attention. For example, you can identify urgent tasks or navigate to common pages through shortcut links. Please Note: For advanced analysis based on statistics, calculations and generic relationships of data the “Reports” feature offers you more options than the dashboard. → see Analyzing data: Dashboards & Reports You have flexibility to customize this dashboard based on your needs and requirements. In this guide, we will demonstrate how to edit the dashboard. Configure the dashboard To configure the dashboard widgets, open the dashboard. In the right-hand corner of the page you will see a three-dot menu. - Click on the three-dot menu. - Click on “Configure Dashboard”. In the configuration screen, you can customize individual widgets to modify the information displayed and add new widgets. Rearrange Widgets: You can rearrange the dashboard to emphasize the information that's most important to you. Click on the drag and drop button (the blue six dots) to move any widget around the screen. Delete a Widget: You can easily clean up your dashboard by clicking the X in the top right corner of any widget you wish to remove. Add a new Widget: You can add new widgets to help display the information you need on the dashboard. - Click on “Add Widget - Click on “Select the Widget type” to define the new widget in the dashboard. - Select any one of the pre-defined options. You can further customize it after adding it to the dashboard by clicking on “Edit Widget” Configure settings of a Widget In the configuration screen, hover over any widget. You will see a button to edit the particular widget. This opens a special settings window for that specific widget. - Click on “Edit Widget” - A dialogue box opens. Here, you can modify the widget based on your specifications for your dashboard. The settings that are available in that dialog are different for each widget type. - To overwrite the general settings of a widget, like name and description, click on “Subtitle & Explanation” at the bottom. Configuring an “Entity Count Widget” We are now taking an example of configuring the widget: Counting the number of records of a certain type and grouping them based on selected filters. - Click on the field “Select entity type” to change the statistics displayed. Based on the selected entity, you can further refine the dashboard data. - To further refine the data, click on “Group by fields” to select the filters. You can select multiple filters to break down the data by criteria that matter to you. This will help in breaking down the data by selecting the fields with which you want to group the data. In this example. We have selected the Entity as Child; we can break down the data further based on the gender and the mother tongue of the child. - After clicking save, you can view the dashboard widget with the required information in the selected groupings. Adding a Shortcuts on the Shortcut Widget You can create shortcuts to provide quick access to your most-used features, which in turn helps you save time and improve navigation. We have already added some shortcuts for you, you can personalise these shortcuts to navigate to features that you use most frequently or for features you would like to have handy at all times. To configure a shortcut: - Click on the widget labelled as “Quick Actions” - Click “Configure Widget”, a dialogue box opens. Here you can edit the label of the shortcut: - You can configure the link to access the shortcut you want. - Open Aam Digital in a new tab, navigate to your desired entity. - In this example, I want to create a shortcut for “Adding a new School” - Click on the URL link and copy the suffix from the URL, as highlighted below: - Paste this suffix in the field “Link” in the widget to create your required shortcut. - Click on Save, and your new shortcut will be available in the dashboard.

Last updated on Sep 04, 2025

Configure relationships between entities

The power of a case management system is in the custom structures to put details into relation: Link your participants to the partners, activities, survey responses and tasks that you need to manage. This allows you to design a 360° view of your cases. And it builds a powerful database of all data that you can analyse in many ways. This guide describes how you can configure the data structures between different record types. You create a relationship from one record to another record with a "entity" field in one of the records. The other record can then automatically list all the records that link to it, also. For example, let's consider the scenario of Students and Activities in which students participate in: The record linking to another record: In this case, we would add a field to the Activity data structure with a type "link to another record" (also see "Adding a new field to a profile form"): (Relationships can be a one-to-one or one-to-many, if you enable the "multi-select" option for the field) When you edit a specific Activity, you can then select any of the existing Student records (or create a new Student): The record being linked to from another record: You do not need to explicitly update any details in the Student's profile. The relationship is automatically available on both records. To display the Activities that link to a particular Student in that Student's profile, you can add a new "Related Entity Section" in its Details View through the Admin UI: Then select the "Entity Type" of the related records that you want to list: In our example, we want to list the related Activity records. The system will automatically only show those Activities that are linked the the Student whose details you are currently showing. You can also select which of the fields of the Activity you want to show in the section in the Student details. If the "Entity Type" in the Admin UI for the Related Entity Section doesn't contain the type you are looking for, make sure that that type has a field with type "link to another record" that links to this record type (see above). For our example: The Activity record type must have a field that links to "Student" records to be available here. After you added the student to one or more activities by editing the activity, you will automatically see all activities that link to the current student: You can also add new Activity records here from the student's details, using the (+) icon on the embedded table. General considerations about designing relationships When to work with different record types and relationships (instead of putting everything in one record) You can apply the structure above to any kind of relationship between records. For example: - Exam results linked to a student - Survey responses of a participant - Details of multiple family members in a household - ... Especially if you need to record multiple items with the same structure, making that a separate record type that links back to the primary type is useful. Also, if you don't know how many items you need to record (e.g. how many family members are there?). Or if you want to record multiple observations over time (e.g. do an annual survey and monitor the progress over the years). Which of the records should contain the "link to another record" field? Often there is a clear, logical hierarchy in the things your records represent: For example, a survey response is a "secondary" detail related to a participant while the participant record is a more central "primary" thing in your system. In this case, add a field to the secondary record to select the linked primary record. That way you can easily list multiple related secondary details in that primary record. If you are designing a one-to-one relationship and there is no clear hierarchy, either record could be suitable to hold the field. Consider the example of the resulting user interface above: Maybe one of the records seems more natural to hold an "indirect" link (through an embedded table in its details view) than the other. It is not advisable to add a "link to another record" field to both record types, however. That would mean you need to edit both records or may have confusing and inconsistent data, if only one of the records' link is filled. Using a secondary record type to limit access through permissions Aam Digital can control access to different data through user roles. However, these permissions always grant access to all fields of record. If you have some details that are more confidential, you can create a separate record type that links back to the primary profile. Access to that secondary record can then be more limited to fewer users (e.g. the contact details of a student can be a separate record type that is only available to the project management).

Last updated on Sep 08, 2025