Přeskočit obsah
For the complete DHIS2 documentation index, see llms.txt.
Uživatelské příručky
Trasování údajů na úrovni jednotlivců

Použití aplikace Capture

O aplikaci Capture

In the Capture app you register events that occurred at a particular time and place. An event can happen at any given point in time. This stands in contrast to routine data, which is captured for predefined, regular intervals. Events are sometimes called cases or records. In DHIS2, events are linked to a program. The Capture app lets you select the organisation unit and program and specify a date when an event happened, before entering information for the event. Some events are linked to a tracked entity, for example a person, allowing longitudinal follow-up.

Zaregistrujte událost

  1. Otevřete aplikaci Capture.

  2. Vyberte organizační jednotku.

  3. Select an event program.

Uvidíte pouze programy přidružené k vybrané organizační jednotce a programy, ke kterým máte přístup, a které jsou sdíleny s vaší skupinou uživatelů prostřednictvím sdílení na úrovni dat.

  1. Pokud má program nastavenou kombinaci kategorií, bude nutné vybrat možnost kategorie.

  2. Click Create new event.

    vytvořit novou událost

  3. Vyplňte požadované informace. Pokud je programová fáze programu nakonfigurována k zachycení umístění:

    • If the field is a coordinate field you can either enter the coordinates directly or you can click the map icon to the left of the coordinate field. The latter one will open a map where you can search for a location or set on directly by clicking on the map.

    • If the field is a polygon field you can click the map icon to the left of the field. This will open a map where you can search for a location and capture a polygon (button in the upper right corner of the map).

  4. If desired, you can add a note by clicking the Write note button at the bottom of the form. Be aware that Event notes are attributed to a user and cannot be deleted.

  5. V případě potřeby můžete přidat vztah kliknutím na tlačítko Přidat vztah ve spodní části formuláře. Další informace naleznete v části Přidání vztahu.

  6. Klikněte na Uložit a ukončit nebo klikněte na šipku vedle tlačítka a vyberte Uložit a přidat další.

    • Uložit a přidat další uloží aktuální událost a vymaže formulář. All the events that you have captured will be displayed in a list at the bottom of the page. When you want to finish capturing events you can, if the form is blank, click the finish button or if your form contains data click the arrow next to Save and add another and select Save and exit.

Note

Some data elements in an event might be mandatory (marked with a red star next to the data element label). All mandatory data elements must be filled in before the user is allowed to complete the event. The exception to this is if the user has the authority called "Ignore validation of required fields in Tracker and Event Capture". If the user has this authority, the mandatory data elements will not be required and the red star will not be displayed next to the data element label. Note that super user that have the "ALL" authority automatically have this authority.

Tip

The data entry form can also be displayed in row view. In this mode the data elements are arranged horizontally. This can be achieved by clicking the Switch to row view button on the top right of the data entry form. If you are currently in row view you can switch to the default form view by clicking the Switch to form view button on the top right of the data entry form.

Register a tracked entity

There are two different ways one can register a tracked entity under an organisation unit. The first way, is to register a tracked entity without enrolling it to a tracker program. The second option, is to register a tracked entity with program and enroll it.

Bez zápisu do programu

  1. Otevřete aplikaci Capture.

  2. Vyberte organizační jednotku.

  3. Click Create new.

    obrázek

    You'll now be navigated to the registration page. In that page you will see a drop down menu similar to the one in the image below. You can type to filter and select a tracked entity type, eg. Building, Person etc.

    obrázek

  4. Vyberte typ trasované entity, pro který chcete vytvořit novou instanci.

    obrázek

  5. V okamžiku, kdy vyberete typ trasované entity, se na obrazovce zobrazí formulář.

    The "Profile" section will be shown. In this section you can add data relevant to the tracked entity. The profile section mainly contains all the tracked entity attributes linked to the tracked entity type.

    obrázek

  6. Vyplňte požadované informace.

Pokud je typ trasované entity nakonfigurován tak, aby zachytil umístění:

- If the field is a coordinate field you can either enter the coordinates
directly or you can click the **map** icon to the left of the coordinate field.
The latter one will open a map where you can search for a location or set on
directly by clicking on the map.

- If the field is a polygon field you can click the **map** icon to the left of
the field. This will open a map where you can search for a location and capture
a polygon (button in the upper right corner of the map).

  1. Click the Save person button to register the tracked entity.

  2. You will now be prompted to the tracked entity dashboard.

    The dashboard will show relevant information about the newly created tracked entity.

Se zápisem do programu

  1. Otevřete aplikaci Capture.

  2. Vyberte organizační jednotku.

  3. Select a tracker program of your choice.

  4. Click Create new person. Note that the label of this button corresponds to the tracked entity type of the program, which could vary, such as "Building," "Person," etc.

    vytvořit novou událost

  5. Nyní uvidíte formulář podobný obrázku níže.

    The enrollment form has different layouts depending on how the program is customized. The top section has the title "Enrollment", and it holds all the relevant information about the enrollment details. This section will always be present, regardless of layout. Underneath, the different data input fields relevant to the tracked entity will be displayed. These fields will either be displayed within sections or as a completely custom form. The sections, or custom form, mainly contains all the tracked entity attributes linked to the program or tracked entity type.

    create new event

  6. Fill in the required information for the enrollment. Pokud je typ trasované entity nakonfigurován tak, aby zachytil umístění:

    • If the field is a coordinate field you can either enter the coordinates directly or you can click the map icon to the left of the coordinate field. The latter one will open a map where you can search for a location or set on directly by clicking on the map.

    • If the field is a polygon field you can click the map icon to the left of the field. This will open a map where you can search for a location and capture a polygon (button in the upper right corner of the map).

  7. Click Save person to register the tracked entity. The Save button shows a loading spinner and the Cancel button is disabled while the request is processing.

  8. You will now be prompted to the tracked entity dashboard.

    The dashboard will show relevant information about the newly created tracked entity.

Note

Some data elements in an event might be mandatory (marked with a red star next to the data element label). All mandatory data elements must be filled in before the user is allowed to complete the event. The exception to this is if the user has the authority called "Ignore validation of required fields in Tracker and Event Capture". If the user has this authority, the mandatory data elements will not be required and the red star will not be displayed next to the data element label. Note that super user that have the "ALL" authority automatically have this authority.

Tip

The data entry form can also be displayed in row view. In this mode the data elements are arranged horizontally. This can be achieved by clicking the Switch to row view button on the top right of the data entry form. If you are currently in row view you can switch to the default form view by clicking the Switch to form view button on the top right of the data entry form.

Enrollment with auto generated events

Události lze automaticky vytvářet při zápisu do programu.

Chcete-li automaticky generovat události, můžete provést nezbytnou konfiguraci v aplikaci pro údržbu. 1. Otevřete aplikaci údržby

  1. Select the Program tab

  2. Select a Tracker program

  3. Select the Program stages tab

  4. Click on the program stage you would like to generate an event for

  5. Select "Auto-generate event"

V rámci programu můžete nastavit automatické generování více fází programu (to vytvoří událost pro každou fázi programu nakonfigurovanou tímto způsobem)

Enrollment with open data entry form

A program can be configured to automatically take the user to register a new event immediately after enrolling a tracked entity. To enable this behavior, the program must have at least one program stage with the "Open data entry form after registration" option checked. If more than one program stage has this option enabled, the first stage will be used.

Chcete-li jej nakonfigurovat, musíte postupovat podle kroků popsaných v části Zápis s automaticky generovanými událostmi a poté zaškrtnout možnost „Otevřít formulář pro zadávání dat po zápisu“.

Enrollment with first stage on registration page

For tracker programs enable the "First stage appears on registration page" flag in the Maintenance. The enrollment registration page will now display the first program stage the user has access to.

Active type of event

If the stage has the "Open data entry form after enrollment" selected, then the event will be generated into the ACTIVE status. Also its execution date will be calculated for the event, in addition to a due date. The generation happens based on either the enrollment date or the incident date. You can choose the reporting date from the dropdown menu "Report date to use".

As shown in the image you have three options, a) Incident date b) Enrollment date or c) No value. Choosing reporting date as "Incident date" indicates that both the event execution date and due date will be the same as the incident date. Choosing reporting date as either "Enrollment date" or "No value" indicates that both the event execution date and due date will be the same as the enrollment date.

Schedule type of event

When the "Open data entry after enrollment" is not checked, it means that the event generated will be a SCHEDULE event. The scheduled event does not have an execution date, but only a due date. The due date for these future events are calculated based on either enrollment date or incident date. If the flag below is checked, the reference date is the enrollment date, if the flag is not checked, the incident date is used.

Pokud není uvedeno žádné datum incidentu, referenční datum se vrátí k datu zápisu bez ohledu na to, zda je zaškrtnutý příznak výše.

On SCHEDULE type of events the user can also configure the "Scheduled days from start". Which means if a stage has a number in "Scheduled days from start" the reference date will increased by that number. In the example below we increase the due date by 30 days.

Pokud „Plánované dny od začátku“ neobsahuje číslo nebo obsahuje 0, použije se referenční datum, aniž by se k němu přidávaly dny.

Možná detekce duplikátů

In both cases of registering a tracked entity, (with enrollment or without enrollment) the system will start looking for possible duplicates. Note that programs need to be correctly configured through the maintenance app for the system to start detecting duplicates when enrolling a new person in a program.

Chcete-li nakonfigurovat program prostřednictvím aplikace Údržba, budete muset:

  1. Open the maintenance app.

  2. In the program section select your program. We select Child Programme for this example.

  3. Select the Attributes tab.

  4. Enable duplicates search by checking program attributes as searchable

Atributy, které jste vybrali jako „Prohledávatelné“, budou atributy, které systém použije k detekci možných duplikátů. Vysvětlíme to na příkladu, který demonstruje detekci možných duplikátů při zápisu dítěte do Programu dětí.

  1. Otevřete aplikaci Capture.

  2. Select your organisation unit and program from the menu on the top.

  3. Click Create new person

  4. Fill in the first name in the form. Remember, the first name we have checked as "Searchable" in the maintenance app. Click Save person. The system will start looking for possible duplicates that match the name Sarah.

  5. The system will automatically show a list of possible duplicates if there are any.

  6. You can choose to make a new enrollment by clicking Save as new or if you see the right person in the list - you can view the dashboard.

Tip

Detekci duplikátů pro sledované typy entit můžete nakonfigurovat stejným způsobem jako u programů.

Provádění pravidel programu

In both cases of registering a tracked entity (with enrollment or without enrollment), the system will run program rules you have configured. Note that rules can be configured in the maintenance app.

To see a rule being executed while enrolling a tracked entity you will have to take the following steps.

  1. Configure a rule in the maintenance app. For the example below we configured a rule that throws a warning when a tracked entity's age is outside the expected range for the program.

  2. Otevřete aplikaci Capture.

  3. Select your organisation unit and program from the menu on the top.

  4. Fill in the birth date with a value that falls outside the expected age range. In our case this is 18th of August 2026.

  5. You will now be able to see the warning produced by the program rule underneath the birth date field.

Re-enroll an existing tracked entity

When you are on the re-enroll page, the teID will be visible in the URL parameters. The attributes of the tracked entity will be pre-filled with the current values.

Přidání vztahu

Relationships can be added either during registration, editing or viewing of an event. The Capture App supports several relationship types, including Event to tracked entity and tracked entity to tracked entity (e.g. Sibling, Mother-Child). The relationship types available depend on your program configuration.

  1. V případě události klikněte na Přidat vztah.

  2. Vyberte typ vztahu, který chcete vytvořit.

Nyní máte dvě možnosti:

  • Link to an existing [tracked entity type] or

  • Create new.

The Link to an existing button label reflects your program's tracked entity type, for example Link to an existing Person. The Create new button does not.

možnosti vztahu

  1. Click Link to an existing [tracked entity type].

  2. You will be presented with some options for searching for a tracked entity. Máte možnost vybrat si program. Pokud je vybrán program, atributy jsou odvozeny od vybraného programu. If no program is selected, only the attributes that belong to the tracked entity will be visible.

    search for tracked entity

    • If the tracked entity or program is configured with a unique attribute, this attribute can be used for finding a specific tracked entity or program. This attribute should be presented alone. Po vyplnění pole jedinečného atributu klikněte na tlačítko Hledat vpravo dole the unique attribute field.

    • If the tracked entity or program has attributes these can be used for searching by expanding the Search by attributes box. When all desired attribute fields have been filled out, click the Search by attributes button located at the bottom. You can also limit the search by setting the Organisation unit scope. If set to All accessible you will search for the tracked entity in all organisation units you have access to. If you select Selected, you will be asked to select which organisation units to search within.

  3. After a successful search you will be presented with a list of tracked entities matching the search criteria. To create a relationship click the Link button on the tracked entity you would like to create a relationship to.

  4. If you did not find the tracked entity you were looking for, you can either click the New search or Edit search buttons. Nové vyhledávání vás přenese na nové prázdné vyhledávání, zatímco Upravit hledání vás vrátí zpět k právě provedenému vyhledávání při zachování kritérií vyhledávání.

Create new tracked entity

  1. Click Create new [tracked entity type].

  2. You are now presented with a form for registering a new tracked entity. You can choose to either register with or without a program. If a program is selected, the new tracked entity will be enrolled in said program. You can also change the Organisation unit by removing the one that is automatically set and selecting a new one.

register new tracked entity

  1. Vyplňte požadované (a případně povinné) atributy a podrobnosti registrace.

  2. Click Save new [tracked entity type] and link.

Note

When filling in data you might face a warning telling you that a possible duplicate has been found. You can click the warning to see these duplicates and if the duplicate is a match you can choose to link that tracked entity by clicking the Link button. If the warning is still present when you click Save new [tracked entity type] and link, a dialog listing the possible duplicates opens automatically instead of saving. If any of these duplicates matches the tracked entity you are trying to create you can click the Link button, if not you can click Save as new [tracked entity type] to register a new tracked entity, or Cancel to go back.

Upravit událost

  1. Otevřete aplikaci Capture.

  2. Vyberte program.

  3. Select an organisation unit, or if none is selected, click the See working list without organisation unit link to view events across all accessible organisation units.

    Všechny události registrované k vybranému programu se zobrazí v seznamu.

  4. Klikněte na událost, kterou chcete upravit.

  5. Klikněte na tlačítko Upravit událost.

  6. Upravte podrobnosti události a klikněte na Uložit.

Note
If you cannot edit the event, the Edit event button is replaced by a View only badge explaining why. This happens when:

  • You only have view access to the program, program stage(s), or tracked entity type.
  • The event's date is outside the program's editing period (expiry days), or the event is completed and outside the program's complete events expiry days window.
  • The event is completed and the program stage has Block entry form after completed enabled.

Users with the Edit expired data authority can still edit events affected by the last two cases.

Smazat událost

  1. Otevřete aplikaci Capture.

  2. Vyberte organizační jednotku.

  3. Vyberte program.

Všechny události registrované k vybranému programu se zobrazí v seznamu.

  1. Klikněte na ikonu trojitá tečka u události, kterou chcete smazat.

  2. V zobrazené nabídce klikněte na Smazat událost.

    smazat událost

  3. A confirmation dialog opens warning that deleting an event is permanent and cannot be undone. Click Yes, delete event to confirm, or No, cancel to back out.

    delete event confirmation

Upravte rozložení seznamu událostí

Můžete vybrat, které sloupce se mají v seznamu událostí zobrazit nebo skrýt. To může být užitečné například v případě, že máte dlouhý seznam datových prvků přiřazených k určité fázi programu.

  1. Otevřete aplikaci Capture.

  2. Vyberte organizační jednotku.

  3. Vyberte program.

Všechny události registrované k vybranému programu se zobrazí v seznamu.

  1. Klikněte na ikonu ozubeného kola v pravém horním rohu seznamu událostí.

  2. Vyberte sloupce, které chcete zobrazit, a klikněte na Uložit.

    upravit seznam událostí

Tip

You can reorganize the order of the data elements by dragging and dropping them in the list.

Filtrování seznamu událostí

  1. Otevřete aplikaci Capture.

  2. Vyberte organizační jednotku.

  3. Vyberte program.

Všechny události registrované k vybranému programu se zobrazí v seznamu.

V horní části seznamu událostí jsou tlačítka se stejnými názvy jako záhlaví sloupců v seznamu.

  1. Use the buttons on the top of the list to filter.

    filtrovat událost

Each filter adapts to the data element's value type, for example, numeric data elements provide a range selector, text data elements a search input, and date data elements a date picker. Filtering is available for all value types except MULTI_TEXT (multi-select option sets).

Filter on empty or non-empty values

Data element filters show two checkboxes at the top:

  • Is empty – matches events that have no value for the selected data element.
  • Is not empty – matches events that have any value for the selected data element.

Only one option can be active at a time per filter. Selecting Is empty or Is not empty clears any value-based criteria for the filter.

For image, file and coordinate data elements, Is empty and Is not empty are the only available filter options.

Note

The empty / non-empty checkboxes are not shown on the main filters (report date, status, assignee, etc.).

Filtering on empty / non-empty values requires DHIS2 server version 2.42 or higher. On older servers the checkboxes are not shown.

Třídit seznam událostí

  1. Otevřete aplikaci Capture.

  2. Vyberte organizační jednotku.

  3. Vyberte program. Všechny události registrované k vybranému programu se zobrazí v seznamu.

  4. Kliknutím na jedno ze záhlaví sloupců seřadíte seznam u daného datového prvku vzestupně.

    Two arrows (up and down) are displayed next to each sortable column. When sorted ascending, the upward arrow is highlighted. Unsorted columns show both arrows greyed out.

  5. Opětovným kliknutím na záhlaví sloupce seřadíte seznam u daného datového prvku v sestupném pořadí.

    When sorted descending, the downward arrow is highlighted.

    řazení události

Stáhněte si seznam událostí

  1. Otevřete aplikaci Capture.

  2. Vyberte organizační jednotku.

  3. Vyberte program. Všechny události registrované k vybranému programu se zobrazí v seznamu.

  4. Klikněte na ikonu tři tečky v pravém horním rohu seznamu událostí.

  5. Klikněte na Stáhnout data.

  6. Vyberte formát, který chcete stáhnout.

    stáhnout seznam událostí

Note

You can download an event list in JSON or CSV formats.

Předdefinovaná zobrazení seznamu

Můžete nastavit vlastní Pohledy a uložit je pro pozdější použití. Pohledy lze také sdílet s ostatními. Pohled se skládá z filtrů, pořadí sloupců a pořadí řazení událostí.

Ukládání nového pohledu

  1. Vyberte organizační jednotku a program.

  2. Nastavit filtry pomocí tlačítek filtru nad seznamem událostí (podrobně popsáno zde).

  3. Pořadí sloupců nastavíte kliknutím na ikonu ozubeného kola a poté ve vyskakovacím okně určíte rozložení podle svých preferencí (jak upravit rozložení je podrobně popsáno zde).

  4. Události seřaďte kliknutím na jedno ze záhlaví sloupců (podrobně popsáno zde).

  5. Otevřete nabídku Další (ikona se třemi tečkami) vpravo a poté vyberte možnost „Uložit aktuální zobrazení ...“

  6. Vyplňte název pohledu a klikněte na Uložit.

Načítání pohledu

  1. Vyberte organizační jednotku a program s předdefinovaným zobrazením.

  2. Pohledy by měly být k dispozici nad samotným seznamem událostí. Kliknutím na zobrazení jej načtete.

  3. Příklad načteného pohledu.

Aktualizace pohledu

  1. Načtěte pohled, který chcete aktualizovat (viz načítání pohledu).

  2. Proveďte změny filtrů, pořadí sloupců nebo pořadí řazení událostí.

    Note

    An asterisk(*) is appended to the view name when the view has unsaved changes.

  3. Otevřete nabídku Další (ikona se třemi tečkami) vpravo a poté vyberte možnost „Aktualizovat zobrazení“.

Sdílení pohledu

  1. Načtěte pohled, který chcete sdílet (viz načítání pohledu).

  2. Otevřete nabídku Další (ikona se třemi tečkami) vpravo a poté vyberte možnost „Sdílet zobrazení ...“

  3. Proveďte změny. Obvykle byste přidali uživatele / skupiny (1) a / nebo změnili přístupová práva uživatelů / skupin přidaných dříve (2).

Mazání pohledu

  1. Načtěte pohled, který chcete smazat (viz načítání pohledu).

  2. Otevřete další nabídku (ikona se třemi tečkami) vpravo a poté vyberte možnost „Odstranit zobrazení“.

Event bulk actions

You can perform bulk actions on events in the event list.

  1. Select the events you want to perform the action on by clicking the checkbox to the left of the event.

  2. You can choose between quickly completing the selected events or deleting them.

User assignment in events programs

Events can be assigned to users. This feature must be enabled per program by checking Enable user assignment of events in the program settings in the Maintenance app.

Assigning user to new events

  1. Vyberte organizační jednotku a program s povoleným přiřazením uživatelů.

  2. Klikněte na Nová událost v pravém horním rohu.

  3. Sekce postupníka najdete v dolní části stránky pro zadávání údajů. Vyhledejte a vyberte uživatele, kterému chcete událost přiřadit. Při uložení události bude postupník zachován.

Změnit přiřazeného

  1. Vyberte organizační jednotku a program s povoleným přiřazením uživatelů.

  2. Klikněte na událost v seznamu

  3. V pravém sloupci najdete sekci postupníka.

  4. Click the Edit button, or the Assign button if the event is not currently assigned to anyone.

  5. Search for and select the user you would like to reassign the event to. Click the Save button.

Assignee in the event list

V seznamu událostí budete moci zobrazit postupníka na jednu událost. Kromě toho můžete seznam třídit a filtrovat podle postupníka.

Filtrovat podle přiřazeného

  1. Klikněte na filtr Přiřazeno k.

  2. Vyberte preferovaný filtr přiřazeného a klikněte na tlačítko Aktualizovat.

Trasovací programy

The Capture app supports the working lists in tracker programs, and opening a tracked entity takes you to its enrollment dashboard within the Capture app.

Search for tracked entities

V rozsahu programu

  1. Otevřete aplikaci Capture.

  2. Vyberte program.

Uvidíte pouze programy přidružené k vybrané organizační jednotce a programy, ke kterým máte přístup, a které jsou sdíleny s vaší skupinou uživatelů prostřednictvím sdílení na úrovni dat.

  1. Klikněte na tlačítko Hledat.

  2. V rozbalovací nabídce klikněte na první možnost.

Tyto kroky vás přenesou na stránku vyhledávání. Tam na základě konfigurace vaší organizace uvidíte různé atributy, pomocí kterých můžete vyhledávat. Příklad toho, jak to vypadá, je následující.

![](resources/images/search-by-attributes-on-scope-program-overview-0.png)

To enhance search performance, you can configure the **preferredSearchOperator** or **blockedSearchOperators** metadata in Maintenance. Tracked entity attributes with the following value types apply these settings: TEXT, LONG_TEXT, EMAIL, PHONE_NUMBER and PERCENTAGE. If preferredSearchOperator is not defined, the search falls back to the first available operator in [LIKE, SW, EQ] that is not listed in blockedSearchOperators. Attributes with other value types ignore the preferredSearchOperator. Helper text messages are displayed below the attribute search fields to guide the user.

![](resources/images/search-by-attributes-on-scope-program-preferredSearchOperator.png)

Chcete-li provést vyhledávání nyní:

  1. Vyplňte atributy, pomocí kterých chcete hledat.

  2. Klikněte na tlačítko Hledat podle atributů.

  3. Výsledky vyhledávání se zobrazí následovně.

    In this list you can see the entries that match your search. The actions available for each entry depend on the tracked entity's enrollment status in the program you are searching within. Whether an entry's enrollment actually opens once you click into it depends on who owns it and your access to that organisation unit; see Tracked entity ownership below.

    a. View dashboard is always shown as an option. It opens the enrollment dashboard for the tracked entity in the program you are searching within. The enrollment shown is selected automatically: if there is a single enrollment in the program that one is opened, and if there are several, the active enrollment is opened.

    b. View active enrollment is only shown when the tracked entity has an active enrollment in the program you are searching within. It opens the enrollment dashboard for that active enrollment.

    c. Re-enroll is shown when the tracked entity's enrollment in the program you are searching within is completed or cancelled. It takes you to the program's enrollment page so you can enroll the tracked entity again. If there is an active enrollment, this option is not shown.

Execute a full search as described above. If the search you have made has results they will be displayed. However, the actual tracked entity you are searching for may be within a different program. In that case, you may want to extend the search to other programs. This is known as a fallback search.

To execute a fallback search, simply press the button on the bottom saying "Search in all programs". You will see the Results in all programs be appended below the search in the current program. These two modules are collapsible to save space.

Pokud nouzový režim nelze provést, zobrazí se vám modální přechod Zpět na vyhledávání, abyste mohli změnit hledané výrazy.

Poznámka

Zpětné vyhledávání je možné pouze při vyhledávání v rámci programu.

Create new tracked entity

When none of the results match, you can create a new user by clicking Create new button on the bottom of the search page.

Based on the search domain, you will be navigated to the registration of the selected Tracked entity type, with or without program enrollment preselected. The search terms that you typed in before will be prefilled in the registration form.

V oboru typu sledované entity

  1. Otevřete aplikaci Capture.

  2. Kliknutím na tlačítko Hledat otevřete stránku vyhledávání.

  3. Click the Search for field. You can type to filter the list of tracked entity types.

  4. Proveďte výběr ze seznamu.

Na základě konfigurace vaší organizace uvidíte různé atributy, pomocí kterých můžete vyhledávat. Příklad toho, jak to vypadá, je následující.

![](resources/images/search-by-attributes-on-scope-tetype-overview-0.png)

Chcete-li provést vyhledávání nyní:

  1. Vyplňte atributy, pomocí kterých chcete hledat.

  2. Klikněte na tlačítko Hledat podle atributů.

  3. Výsledky vyhledávání se zobrazí následovně.

    In this list you can see the entries that match your search. For each entry you have the option to click the "View Dashboard" button to view the dashboard for the tracked entity.

Příliš mnoho výsledků

The program or tracked entity type you are searching within may be configured with a limit on the number of results that are returned from a search. If your search results exceed this limit you will be shown a warning message like the one below.

Stránkování

Stránka s výsledky zobrazuje až pět výsledků najednou. Měli byste se pokusit použít konkrétní vyhledávací kritéria, aby nebylo příliš mnoho shod. Pokud však existuje více než pět výsledků, můžete zobrazit další výsledky pomocí tlačítka > na konci stránky.

Tracked entity ownership

Every enrollment of a tracked entity in a program has an owning organisation unit. Ownership starts out as the organisation unit that first enrolled the tracked entity into that program, and changes if the enrollment is later transferred to another organisation unit. Ownership is tracked per tracked entity/program combination: the same tracked entity can be owned by different organisation units for different programs (for example, one facility could own a person's HIV program enrollment, while a different facility owns the same person's MCH program enrollment).

Whether you can open an enrollment you don't own depends on the program's access level, which is configured in the Maintenance app, together with which organisation units you have been assigned data capture or search access to:

  • Open or Audited: you can open the enrollment as long as you have at least search access to the owning organisation unit. (Audited additionally logs the access.)
  • Protected: you can open the enrollment if you have data capture access to the owning organisation unit. If you only have search access to it, you'll first have to provide a reason (see Breaking the glass below).
  • Closed: you can open the enrollment only if you have data capture access to the owning organisation unit. If you only have search access to it, you cannot open it at all, and there is no option to request access.

In practice, clicking View dashboard or View active enrollment from a search result doesn't always show the enrollment's content. For a Closed program you'll see an access-denied message if you don't have data capture access to the owning organisation unit. For a Protected program you'll see the breaking the glass prompt if you only have search access, or the same access-denied message if you have neither.

Being able to open an enrollment doesn't necessarily mean you can edit it: edit access depends separately on the program's sharing settings, and you may still see a View only label if you don't have write access.

Breaking the glass

If a program is configured with the Protected access level and you open a tracked entity whose enrollment is owned by an organisation unit you only have search access to (not data capture access), you'll be prompted to provide a reason before you can view the enrollment. This is informally known as "breaking the glass."

  1. Search for and open the tracked entity as normal.
  2. A Check for enrollments panel appears, explaining that the program is protected and that you must provide a reason to check for enrollments. All activity is logged.
  3. Enter a reason in the Reason to check for enrollments field. This is required; you cannot submit without one.
  4. Click Check for enrollments to proceed, or Cancel to go back to search.

Once submitted, you get access to the enrollment for about 3 hours. This is tied to your user account rather than the organisation unit. So only the user gains access for 3 hours. Once the 3 hours pass, you'll need to provide a reason again. Every request is logged for audit purposes.

Whether you can edit the enrollment once you have access still depends on the program's sharing settings, the same as for any enrollment you own. Breaking the glass only grants visibility, not special edit rights.

List tracked entities enrolled in program

  1. Otevřete aplikaci Capture.

  2. Vyberte organizační jednotku.

  3. Vyberte trasovací program s nastavením "Zobrazit seznam úvodní stránky" na hodnotu true.

  4. Program může mít přidružené kategorie (příkladem takové kategorie by byl implementující partner). Pokud je to váš případ, vyplňte je.

Custom tracked entity working list for programs with "Display front page list" set to false.

  1. Otevřete aplikaci Capture.

  2. Vyberte organizační jednotku.

  3. Vyberte trasovací program s nastavením "Zobrazit seznam úvodní stránky" na hodnotu false.

  4. Pokud má program nějaký vlastní pracovní seznam, můžete na něj kliknout a načíst jej.

Filtrovat seznam

Use the buttons above the list to filter it.

As an example, you could filter the list to show only tracked entities where the enrollment status is "Completed": Click the "Enrollment status" filter (1), select "Completed" (2) and then "Update" the changes (3).

Each filter adapts to the attribute's value type, for example, numeric attributes provide a range selector, text attributes a search input, and date attributes a date picker. Filtering is available for all value types except MULTI_TEXT (multi-select option sets).

Filter on empty or non-empty values

Data element filters show two checkboxes at the top:

  • Is empty – matches events that have no value for the selected data element.
  • Is not empty – matches events that have any value for the selected data element.

Only one option can be active at a time per filter. Selecting Is empty or Is not empty clears any value-based criteria for the filter.

For image, file and coordinate data elements, Is empty and Is not empty are the only available filter options.

Note

The empty / non-empty checkboxes are not shown on the main filters (report date, status, assignee, etc.).

Filtering on empty / non-empty values requires DHIS2 server version 2.42 or higher. On older servers the checkboxes are not shown.

Seřadit seznam

Click one of the column headers to sort the list by that column. Two arrows (up and down) are displayed next to each sortable column header. The active sort direction is highlighted, and unsorted columns show both arrows greyed out. Click again to toggle between ascending and descending order.

Upravte rozložení seznamu

Můžete vybrat, které sloupce se mají v seznamu zobrazit, a také reorganizovat pořadí sloupců.

Click the gear icon in the top right corner of the list. Tick the checkboxes for the columns you would like to display (1) and reorganize the columns by dragging and dropping using the six-dot handle on the left side of each column name (2).

Načítání předdefinovaného zobrazení seznamu

Předdefinovaná zobrazení seznamu najdete nad filtry seznamu. Kliknutím načtete pohled.

Download the tracked entities list

  1. Otevřete aplikaci Capture.
  2. Vyberte organizační jednotku.
  3. Vyberte trasovací program s nastavením "Zobrazit seznam úvodní stránky" na hodnotu true.
  4. Click the three dots icon on the top right of the tracked entities list.
  5. Klikněte na Stáhnout data.
  6. Vyberte formát, který chcete stáhnout.
    download tracked entities list

    Note You can download the tracked entities list in JSON or CSV formats.

Tracked entity bulk actions

You can perform bulk actions on tracked entities and their enrollments in the tracked entity list.

Completing active enrollments

  1. Select the tracked entities you want to perform the action on by clicking the checkbox to the left of the tracked entity.

  2. Click the Complete enrollments button.

    1. You can also choose if you want to complete all active events within the selected enrollments.

  3. Confirm the action in the dialog that appears.

Deleting enrollments

  1. Select the tracked entities you want to perform the action on by clicking the checkbox to the left of the tracked entity.

  2. Click the Delete enrollments button.

  3. In the dialog that appears, select what enrollment statuses you want to delete and confirm the action.

  4. You can choose any combination of enrollment statuses to delete.

  5. Confirm the action in the dialog that appears.

Tracker program stage working list

V pracovním seznamu můžete zobrazit datové prvky z jedné fáze. Vyberte možnost "Fáze programu" z rozbalovací nabídky "Další filtry" a poté vyberte fázi programu.

The tracker program stage list can be filtered, sorted, modified, saved, updated, deleted and shared in the same way as other working lists. Additionally, the program stage list can be filtered by assignee, just like an event program list.

Informace o implementátorovi / správci

Ukládání metadat do mezipaměti

Z důvodu výkonu aplikace Capture ukládá do paměti metadata v klientském prohlížeči. Když se na serveru aktualizují metadata, je třeba změny šířit na klienty, kteří již metadata uložili do mezipaměti. V závislosti na změně se to děje jedním ze tří způsobů:

  1. Pokud je změna vázána na program, budete muset zvýšit verzi programu pro daný program. Například pokud změníte datové prvky v programu nebo v pravidle programu, je třeba zvýšit verzi vázaného programu.

  2. Pokud změna NENÍ vázána na program, budete muset zvýšit JAKOUKOLI verzi programu, aby se změna mohla rozšířit na klienty. Příkladem jsou změny konstant, úrovní organizačních jednotek nebo skupin organizačních jednotek.

  3. Výjimkou z výše uvedených dvou pravidel jsou sady možností. Sady možností mají svou vlastní vlastnost verze, tj. Zvýšení verze sady možností by mělo zajistit, že se metadata sady možností rozšíří na klienty.

Enrollment dashboard

Reaching the enrollment dashboard via url

You reach the enrollment dashboard either by typing in the address bar of your browser or using the user interface of the capture app. In this section we are focusing on the first use-case, where you type or paste the url you want to access in the Address bar.

One way to reach the enrollment dashboard and view a specific tracked entity's enrollment is by using only the enrollment id. For example the link .../capture#/enrollment?enrollmentId=wBU0RAsYjKE will take you to the dashboard for the enrollment with id wBU0RAsYjKE.

Horní část ovládacího panelu definuje váš kontext. Například na obrázku níže je kontext následující, vybraný program je "Child Programme", organizační jednotka je "Ngelehun CHC", vybraná osoba je "Anna Jones" a vybraná registrace je "2017-11-16 11 :38".

Kontext můžete změnit kliknutím na tlačítko „x“.

What each context box shows

The context selector shows one box for each level of your context, from left to right:

  • Program - the selected program. You only see programs that are shared with you and your user group, and if you have selected an organisation unit, that are assigned to that organisation unit.
  • Organisation unit - the organisation unit you are working in.
  • Tracked entity - this box is titled with the tracked entity type (for example "Person" or "Building"), and its value shows the display name of the specific tracked entity instance (see How the tracked entity display name is built below).
  • Enrollment - the selected enrollment, labelled with its enrollment date.

When you open an event from the program stage list, two more boxes are added to the right:

  • Stage - the program stage the event belongs to.
  • Report date - the event's date, labelled with the stage's date label (for example "Date of discharge").
How the tracked entity display name is built

The name shown for the tracked entity in the top bar is derived from the tracked entity's attribute values, in the following order:

  1. The values of the first two tracked entity type attributes that are set to Display in list, shown together (for example the "First name" and "Last name" attributes, giving "Anna Jones").
  2. If that produces no value - either because no attributes are set to Display in list, or because the tracked entity has no value for them - the values of the first two attributes configured on the tracked entity type (in their configured order) are used instead.
  3. If no attribute value can be shown at all, the tracked entity's unique identifier (UID) is shown as a fallback.

Note for implementers/administrators: If the top bar shows a UID instead of a readable name, it means no suitable attribute value could be shown for the tracked entity. To control which attributes are used for the name, set the relevant tracked entity type attributes to Display in list in the Metadata Management app, and make sure the tracked entity has values for them.

Deselecting the program

Když zrušíte výběr programu, uvidíte následující

Selecting a program with enrollments

When program and enrollment selections are empty, you first have to select a program. Since only one enrollment can be active per program at a time, if the tracked entity (in this case "Anna Jones") already has an active enrollment under the program you select, you will be taken directly to that enrollment's dashboard.

Selecting a program with zero enrollments

If the tracked entity (in this case "Anna Jones") does not have enrollments under the program you select you will see a message explaining that there are no enrollments for that program. You will also be given the option to enroll "Anna Jones" in that program.

Selecting an event program

Když vyberete program události, uvidíte následující. (Pamatujte si, že programy událostí nemají v systému zápisy, ale pouze trasovací programy).

Budete mít také možnost buď vytvořit novou událost pro vybraný program, nebo zobrazit pracovní seznamy pro vybraný program.

Selecting a program with a different tracked entity type

When your selected tracked entity type is a person, as in our example with Anna Jones, and you select a program that is not of type person but for example of a type Malaria case you will see the following.

You are also given the option to enroll a tracked entity in the program you selected.

Deselecting the organisation unit

Když zrušíte výběr organizační jednotky, uvidíte následující

Deselecting the tracked entity

When you deselect the tracked entity, in this case "Anna Jones" you are taken to the working lists in that Tracker program.

Deselecting the enrollment

Když zrušíte výběr zápisu, uvidíte následující

Clearing all selections

In addition to deselecting individual boxes, the top bar provides an action to clear all current selections at once. This resets the organisation unit, program, tracked entity and enrollment and returns you to an empty scope. If you have unsaved changes in an open form, you are first asked to confirm before the selections are discarded.

Read-only mode

The enrollment dashboard becomes read-only when you don't have full write access, or when the tracked entity is deactivated. In read-only mode you can still view all data, but actions that would create, edit, delete, or complete data are hidden rather than just disabled.

  • If you have no write access at all (to the program, the tracked entity type, and every program stage), a single View only badge is shown next to the context bar at the top of the dashboard, explaining why.

  • If you have write access to some parts but not others (for example, write access to some program stages but not others, or to the program but not the tracked entity type), the page-level badge is not shown. Instead, each affected widget shows its own View only badge and hides only the actions it doesn't allow.

In both cases the action buttons in the affected widgets are hidden, while all existing data stays visible.

Quick actions

Widget rychlé akce nabízí zkratky pro často používané akce pro aktuální registraci.

Program stage list

Fáze lze sbalit nebo rozbalit a odhalit události uvnitř.

Collapsed stages

In the collapsed state, you can view the summary information about this stage including: - Ikona - Název fáze programu - Popis fáze programu (při najetí na informační ikonu) - Celkový počet událostí - Last updated date Depending on the status of events, there can be additional information regarding: total number of overdue events or total number of scheduled events.

Expanded stages

When you expand the list, you will see the table contains the data of events in the stage. This includes mandatory columns: Status, Report date and Organisation unit, the following columns depend on the data elements that have been selected as Display in list of event.

Události jsou seřazeny s nejnovějšími nahoře a lze seřadit i další sloupce.

When clicking New {stage event name} button, you will be redirected to the Add new event page for this selected stage.

Expanded stages with more than 5 events

In case there are more than 5 events in the list, only the first 5 are shown. You will be able to view the rest by clicking Show more.

Enrollment widget

Na stránce zápisu můžete vidět widget pro zápis

Enrollment actions

When you click on the enrollment actions button, a menu with all the available actions will open. You can:

  • Change the enrollment status to Active, Cancelled or Completed using the buttons in the menu.
  • Mark or remove the enrollment for a follow-up.
  • Transfer the enrollment to another organisation unit
  • Delete the enrollment
  • Add coordinates to the enrollment

There can only be one active enrollment at a time. If there are no active enrollments, there will be a button Add new to enroll the tracked entity in the program again. If the program only allows one enrollment per tracked entity, the Add new button will be disabled with a tooltip saying Only one enrollment per {TET} is allowed in this program.

Transfer the enrollment to another organisation unit

In the enrollment actions, you could also choose to transfer the enrollment to another organisation unit. Click the transfer button and select the organisation unit you want to transfer the enrollment to.

Transferring changes the owning organisation unit of the enrollment, which affects data visibility and access. After the transfer, the tracked entity will be owned by the new organisation unit, meaning users without access to that organisation unit may no longer be able to view or edit the enrollment. The transfer does not move historical event data; it only changes the ownership going forward. See Tracked entity ownership for how ownership determines who can view and edit an enrollment.

Delete the enrollment

You can delete the enrollment by clicking the delete button and confirming the action in the modal.

Complete the enrollment

You can complete the enrollment by clicking the complete button. When there are active events, you can choose to complete the enrollment along with the events from the confirmation modal.

Enrollment note widget

The enrollment note widget displays notes and allows addition of notes, associated with the current enrollment.

By clicking in the text field, you will be able to enter new text and see action buttons Save note and Cancel. Be aware that Enrollment notes are attributed to a user and cannot be deleted.

Relationship widget

The Relationships widget on the enrollment dashboard is used for viewing the record’s linked relationships to other records. The number next to the title signifies the total number of relationships

For tracked entity relationships, the key attributes shown in the widget are the attributes that have been selected to be displayed on the relationship type page in Maintenance.

If no attributes are selected, it will just show a row per record with tracked entity type name and relationship creation date.

When clicking a tracked entity you should be taken to the Enrollment Dashboard. If the relationship type includes a program, you should be taken to the latest enrollment for that program. If no program is specified, you should still be sent to the enrollment dashboard, but without a program.

Click the New Relationship button to add a new relationship. Adding a new relationship opens a dialog where you can select the applicable relationship type.

Choose between linking to an existing tracked entity or creating a new one.

Existing tracked entity

Use the search form to find any existing record to link to.

New tracked entity

Use the form to create a new record and link.

tracked entity profile widget

On the enrollment dashboard, you can view the tracked entity profile widget. Inside the profile widget you can view the key attributes values.

Click the Edit button to make changes to the tracked entity profile. Editing the profile opens a dialog where the profile attributes can be changed.

The ⋯ (more) icon next to the Edit button opens an overflow menu with further actions on the tracked entity: View changelog (if enabled for the tracked entity type), Deactivate/Activate, and Delete.

Select Delete [tracked entity type] from the overflow menu to delete the tracked entity. You can confirm the action from the dialog. Once confirmed, the tracked entity and all its associated enrollments and events across all programs will be deleted. To delete a tracked entity that has any enrollments, the user needs the authority Delete tracked entity instance and associated enrollments and events.

Deactivate or activate a tracked entity

Deactivating a tracked entity marks it read-only: its profile can no longer be edited, and no new enrollments or events can be created for it in any program. This is useful for records that should be preserved for historical or reporting purposes but should no longer receive new data, for example a person who is deceased or has permanently left the catchment area.

To deactivate a tracked entity:

  1. Open the enrollment dashboard for the tracked entity.
  2. In the tracked entity profile widget, click the ⋯ (more) icon and select Deactivate [tracked entity type].

  1. Confirm by clicking Yes, deactivate [tracked entity type] in the dialog.

This option is only shown to users with write access to the tracked entity type.

Once deactivated, the tracked entity shows a View only badge wherever it's opened, and appears dimmed with its checkbox disabled in tracked entity working lists, so it can't be picked up for bulk actions.

To reverse this, open the overflow menu again and select Activate [tracked entity type], then confirm. This restores normal write access according to the user's existing data access permissions.

Feedback widget

Feedback widget on the enrollment dashboard showing program rule-triggered text

On the enrollment dashboard, the feedback widget displays text and values that are triggered by certain conditions. If the current dashboard triggers some rules set up in the program, the text or values will be automatically displayed.

The displayed text and values support Markdown formatting, including headings, bold/italic text, lists, tables, and legend-colored key/value pairs.

Feedback widget rendering Markdown-formatted text and values

Empty state

If there isn't any feedback for the current dashboard, the widget shows a short empty message. If there aren't any program rules that could show feedback for the current dashboard then the widget is hidden.

Indicator widget

On the enrollment dashboard, the indicator widget displays indicator text and values output related to the current dashboard. The indicators will be sorted alphabetically.

Empty state

If there aren't any related indicators or indicator output for the current dashboard, the widget shows a short empty message. If the current dashboard can't show any indicator output (because it has no related indicators) then the widget is hidden.

Legends

Some indicator values show a colored circle next to the value. The colored circle shows the related legend color for that indicator value. Colored legend circles are only shown for indicator values that have them set up.

Warning widget

On the enrollment dashboard, the warning widget displays warnings related to the current dashboard. The widget shows warnings that are not associated with any specific data item. If there aren't any warnings to show for the current dashboard then the widget is hidden.

Error Widget

On the enrollment dashboard, the errors widget displays errors related to the current dashboard. The widget shows errors that are not associated with any specific data item. If there aren't any errors to show for the current dashboard then the widget is hidden.

Customize the dashboard layout

The widgets described above, and their left/right column order, form the default dashboard layout. Individual users cannot rearrange these widgets from within the Capture app itself.

A user with access to the Datastore Management app or the Tracker Configurator App can instead define a custom layout per tracker program, by adding a configuration entry to the capture datastore namespace. This lets you choose which widgets appear, in which column, and in what order, and even embed custom plugins alongside the built-in widgets. The same mechanism also applies to the Add event and Edit event pages.

See Manual setup (Advanced) for the full configuration reference, including the list of supported widgets and how to embed plugins.

Enrollment event view and edit page

Na stránku úprav události registrace se dostanete kliknutím na libovolnou událost v seznamu etap programu na stránce Přehled registrace.

Top bar context

At the top of the page you can see various information related to the current context. You can see the program, the organisation unit, the tracked entity, the enrollment date, the stage and the report date.

To go to the Enrollment Overview page you can: - click Enrollment dashboard in the breadcrumb. - zrušit výběr scény z horní lišty. - deselect the event (report date) from the top bar.

View/Edit event form

Toto je formulář, kde můžete zobrazit a upravit podrobnosti události registrace.

Form header

Ve formuláři pro zobrazení / úpravu události můžete vidět jméno scény a ikonu.

Scheduled date in edit event form

If an event has the status Scheduled or Overdue, you will be able to see the Report and Schedule tab.

Na kartě Hlášení bude pole s plánovaným datem stále zobrazeno, ale bude zašedlé a vedle něj bude ikona s nápovědou „Přejít na kartu Plán a přeplánovat tuto událost “.

V záložce Plán se zobrazí podobné informace o plánování události jako v pracovním prostoru Nová událost. Budete moci upravit datum plánu a uložit změnu kliknutím na tlačítko Plán.

If an active event has a scheduled date before becoming active or a completed event has scheduled date, this date should still be shown in the workspace. It’ll be locked with an icon next to it and a tooltip saying “Scheduled date cannot be changed for active/completed events”.

Scheduled date with Hide due date enabled

If the flag “Hide due date” in the Maintenance configuration is enabled, scheduled date will not be shown in the form.

However, you can still schedule an event, but it automatically chooses the date based on "Scheduled days from start" that has been configured in Maintenance, and this can not be changed. In the Schedule tab, there will be “Schedule info” saying “Scheduled automatically for xx/xx/xx”, and the user can click Schedule button.

Ask user to complete program when stage is complete

If this flag has been enabled for the stage in Stage details in Maintenance, a modal will show up after the user checks the Complete event checkbox and clicks save.

View mode

When the form is in the view mode the title of the page will appear as: Enrollment: View Event. You can see in the page all the information related to the event. Click the Edit event button to switch to the edit mode. This mode is bypassed for events that are scheduled.

Edit mode

When the form is in the edit mode the title of the page will appear as: Enrollment: Edit Event. You can modify the event and click the Save button. Click the Cancel button to switch to the view mode without saving the changes. Scheduled events are are the exception and they are opened in edit mode directly, without the user having to click Edit event. Click the Cancel button to go back to the enrollment dashboard page without saving the changes.

V tomto formuláři můžete událost také smazat kliknutím na tlačítko Smazat, zobrazí se modální potvrzení, zda chcete tuto událost smazat. Poté budete navigováni zpět na stránku ovládacího panelu zápisu.

Widgets in View/Edit event page

Widgety zobrazené v pravém sloupci se zobrazí a budou fungovat stejným způsobem, jak je uvedeno na panelu zápisu.

Widget assignee

  1. In View/Edit enrollment event page

  2. In the right column you will find the assignee widget.

  3. Click the Edit button, or the Assign button if the event is not currently assigned to anyone.

  4. Search for and select the user you would like to reassign the event to. Click the Save button.

Enrollment event new page

You can reach this page add event page by clicking in the New {stage event name} button in the overview page. In this page you can switch between different tabs: Report to add new event and Schedule to schedule an event. If you have unsaved changes in one tab and switch to another tab, there will be a warning displayed.

New event widget form

Toto je formulář, kde můžete před uložením upravit podrobnosti události. V záhlaví vidíte jméno a ikonu.

New event page without a stage

If you enter the new event page with no stage selected, a list of available stages will be displayed. Select the stage you want to add a new event in by clicking the associated button. To navigate back to the enrollment overview, click the Cancel without saving-button

Ask user to complete program when stage is complete

If this flag has been enabled for the stage in Stage details in Maintenance, a modal will show up after the user clicks the Complete button.

Ask user to create new event when stage is complete

Pokud byl tento příznak povolen pro fázi v podrobnostech fáze v údržbě, zobrazí se modal poté, co uživatel klikne na tlačítko Dokončit nebo zaškrtne políčko Dokončit událost a klepne na tlačítko Uložit. Uživatel může vybrat tlačítko Ano, vytvořit novou událost pro přechod na stránku Nová událost nebo Ne, zrušit pro návrat zpět na řídicí panel registrace. Pokud je k dispozici pouze jedna možná fáze, uživatel bude přesměrován přímo do pracovního prostoru Nová událost pro tuto fázi.

Assigning user to new events

When reporting or scheduling an event, you can assign a user to it. This feature must be enabled per program stage in a tracker program by clicking the "Allow user assignment of events" check box.

Sekce postupníka najdete v dolní části stránky pro zadávání údajů. Vyhledejte a vyberte uživatele, kterému chcete událost přiřadit. Při uložení události bude postupník zachován.

Schedule event widget form

Místo nahlášení události může uživatel zvolit naplánování události na později. Otevře se formulář s navrhovaným plánovaným datem. Toto datum je určeno souborem pravidel, jak je vysvětleno níže.

The suggested date for the first event of a program stage in an enrollment is always based on the enrollment date or the incident date (depending on the program configuration). The program stage configuration setting "scheduled days from start" will be added to the base date to compute the suggested date.

1. Default next scheduled date

If a program stage has a default next scheduled date configured, the suggested date is the most recent next scheduled date. Below is an example of how this can work.

  1. Je třeba vytvořit datový prvek s datem typu hodnoty a přiřadit jej ke konkrétní fázi programu s přístupem k budoucím datům. Název datového prvku může být například: Další navrhované datum sledování. Fáze programu je nakonfigurována tak, aby používala datový prvek jako výchozí při plánování nové události přiřazením datového prvku k výchozímu příštímu plánovanému datu.

  1. A program rule based on the data entered in the program stage, will determine how many days until the next suggested follow up will be. For example: A program rule with the following condition: #{penta_dose} == '1' (The program rule will trigger when the tracked entity has received Penta Dose 1), Assign value to the data element: next suggested follow up date with expression: d2:addDays(V{event_date}, '30') The number suggest how many days from event date the next scheduled event should be.

  2. Open the Capture app and create a tracked entity. As long as Penta Dose has value Dose 1, the suggested next scheduled event is 30 days forward from event date. When scheduling a new event, the system will pick up from the data element as long it has value.

Uživatel může také najít více informací o tom, kolik událostí je naplánováno na stejné vybrané datum nebo interval vybraného data a navrhované datum z informačního pole.

Below the schedule date entry, user can choose to add a note to the scheduled event.

Po kliknutí na tlačítko Plán se uživatel vrátí zpět na stránku s přehledem registrace.

2. Standard interval days

  1. If the program stage has standard interval days configured, the suggested date is calculated by the most recent event date plus the standard interval days value.

  1. If the program stage do not have a default next scheduled date configured, the system will use the standard interval days to calculate the next scheduled event date.

3. If no value is found on either, the suggested date will be defined by enrollment date and incident date.

  1. In case the option Generate events based on enrollment date is checked in the Maintenance app, the next suggested event date is calculated by the enrollment date plus the value of scheduled days from start.

  1. V případě, že je zaškrtnuta možnost Zobrazit datum incidentu, další navrhované datum události se vypočítá jako datum incidentu plus hodnota naplánovaných dnů od začátku.

Program stage event list

Na seznam událostí v programové fázi se dostanete kliknutím na tlačítko Přejít na celý {název fáze události} na stránce přehledu.

Stage Event list

In this view you can see all events in a stage

Stage Event list header

In the header, you can see the stage name and icon

Attribute option combo for Tracker

K datům událostí Trackeru můžete přidat segregaci pomocí kombinací možností atributů. Chcete-li začít, přidejte do konfigurace programu Tracker kombinaci kategorií.

Kombinovaný selektor možností atributu se zobrazí, když přidáváte nebo měníte/prohlížíte události Tracker. Selektor se navíc zobrazí při registraci, pokud jsou události automaticky generovány jako součást procesu registrace.

Příklad z nové události Tracker:

Changelog

The Changelog feature provides a historical record of changes made to data for both events and Tracked Entities. Every time data is added, modified, or deleted, a record is stored in the changelog.

Changelog functionality

Sorting: Clicking the sorting icon next to a column header toggles between default, ascending, and descending order. By default, records are sorted by date (newest first). Sorting by user or data item is also available, but you can only apply one sorting option at a time.

Filtering: You can filter by a specific data item. You can only apply one filter at a time.

Note:
All data items are displayed in the filter dropdown, regardless of whether they have a changelog record.

Pagination: Displays 10 records per page by default, with options to adjust the number of records shown, up to 100 per page.

Event changelog

The Event Changelog tracks changes to data items within an event. These data items include event properties (e.g., report date, scheduled date, and geometry) and data elements.

How to open the event changelog

  1. Navigate to the "View event" page of an event in the Capture app.
  2. Click View Changelog to open the changelog.

Tracked entity changelog

The tracked entity changelog tracks changes to attributes of a tracked entity within an enrollment.

How to open the tracked entity changelog

  1. Go to the Maintenance app and enable the Tracked entity instance audit log.

  2. Open the enrollment dashboard in the Capture app.

  3. Click View Changelog in the Tracked Entity Profile widget to open the changelog.

Related stages and linked events for Tracker programs

You can connect any two program stages via a relationship. This is useful for workflows where completing one stage should trigger or be linked to another, for example linking a lab request stage to a lab result stage, or linking a referral stage to a follow-up consultation stage. To enable this feature, you can set up two program stages in the same program and link them with an event-event relationship in the Maintenance app.

When opening the new event form, a widget called Actions - ${Relationship type name} will appear at the bottom of the page. From this widget, users can: 1. Schedule a new event by selecting a scheduled date and an organisation unit 2. Enter data for the linked event directly 3. Link to an already existing event.

When clicking Complete or Save without completing, the Capture app will create the current event, schedule the linked event and make sure that there is a relationship between them in the correct context.

When there isn't a linked event

If the event is eligible for related stages but isn’t linked yet, a widget called Linked event will appear at the bottom of the page. From this widget, users can: 1. Schedule a new event by selecting a scheduled date and an organisation unit 2. Enter data for the linked event directly 3. Link to an already existing event.

The label of the action button will change based on the user's selections. When clicking Complete or Save without completing, the Capture app will create the current event, schedule the linked event and make sure that there is a relationship between them in the correct context.

When there is a linked event

If the event is already linked, a Linked Event widget will appear at the top of the page. This widget allows users to view details of the linked event.

Additionally, by clicking the Menu in the top-right corner, users can: 1. Unlink the linked event. 2. Unlink and delete the linked event.

Enable the "First stage appears on registration page" flag in the Maintenance for the Tracker program. When opening the form to enroll a new tracked entity, a widget called Actions - ${Relationship type name} will appear at the bottom of the page. From this widget, users can: 1. Schedule a new event by selecting a scheduled date and an organisation unit 2. Enter data for the linked event directly

When clicking Save, the Capture app will enroll the tracked entity, create the event in the first stage, schedule the linked event and make sure that there is a relationship between them in the correct context.