dhis2-devs team mailing list archive
-
dhis2-devs team
-
Mailing list archive
-
Message #15125
[Branch ~dhis2-documenters/dhis2/dhis2-docbook-docs] Rev 425: Added chapter on settings
------------------------------------------------------------
revno: 425
committer: Lars Helge Overland <larshelge@xxxxxxxxx>
branch nick: dhis2-docbook-docs
timestamp: Fri 2011-12-09 13:31:10 +0100
message:
Added chapter on settings
added:
src/docbkx/en/dhis2_user_man_settings.xml
modified:
src/docbkx/en/dhis2_user_manual_en.xml
--
lp:~dhis2-documenters/dhis2/dhis2-docbook-docs
https://code.launchpad.net/~dhis2-documenters/dhis2/dhis2-docbook-docs
Your team DHIS 2 developers is subscribed to branch lp:~dhis2-documenters/dhis2/dhis2-docbook-docs.
To unsubscribe from this branch go to https://code.launchpad.net/~dhis2-documenters/dhis2/dhis2-docbook-docs/+edit-subscription
=== added file 'src/docbkx/en/dhis2_user_man_settings.xml'
--- src/docbkx/en/dhis2_user_man_settings.xml 1970-01-01 00:00:00 +0000
+++ src/docbkx/en/dhis2_user_man_settings.xml 2011-12-09 12:31:10 +0000
@@ -0,0 +1,110 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This document was created with Syntext Serna Free. --><!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "docbookV4.4/docbookx.dtd" []>
+<chapter>
+ <title>Settings</title>
+ <para>The settings module provides a set of application configuration options. There are two main groups of settings: the <emphasis role="italic">system settings</emphasis> apply to the whole system and all its users while the <emphasis role="italic">user settings</emphasis> apply to the environment of the currently logged in user.</para>
+ <section>
+ <title>User settings</title>
+ <para>The user settings section provides general configuration options and options specifically for email.</para>
+ <section>
+ <title>User general settings</title>
+ <itemizedlist>
+ <listitem>
+ <para>Interface language: Sets the locale / language of the user interface, such as labels, menus and headers. You can currently select between 18 languages.</para>
+ </listitem>
+ <listitem>
+ <para>Database language: Sets the locale / language of the database contents in the system, such as the list of data elements and reports.</para>
+ </listitem>
+ <listitem>
+ <para>Sort order property: Sets the property for which to base the sorting of the element lists in the system, such as the list of data elements and indicators. Available properties are <emphasis role="italic">name</emphasis>, <emphasis role="italic">short name</emphasis>, <emphasis role="italic">alternative name</emphasis> and <emphasis role="italic">code</emphasis>. For instance, if you set the sort order property to short name, all lists will be sorted based on the short name property. You can also do manual sorting of all lists by going to the desired list and click "sort" and perform the sorting. This sorting can then be enabled by selecting <emphasis role="italic">custom</emphasis> as the sort order property.</para>
+ </listitem>
+ <listitem>
+ <para>Display property: Sets the property which will be displayed in the element lists in the system, such as the list of data sets.</para>
+ </listitem>
+ <listitem>
+ <para>Style: Sets the style / look-and-feel of the system. You can choose among four different styles while the <emphasis role="italic">light blue</emphasis> style is the default and recommended style. The user setting overrides the corresponding style system setting.</para>
+ </listitem>
+ <listitem>
+ <para>Dashboard charts to display: Sets the numer of charts to display on the front page of the dashboard module. For small screens, four charts are recommended while eight charts are recommended for widescreens.</para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section>
+ <title>User email settings</title>
+ <itemizedlist>
+ <listitem>
+ <para>Message email notification: Decides whether you want to receive email notifications. Currently the system offers email notifications of messages received in the dashboard. This requires that you have entered your email address in your personal account details - you can access it under "Help" - "User account".</para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ </section>
+ <section>
+ <title>System settings</title>
+ <para>The system settings section provides general configuration options and options specifically for appearance and email.</para>
+ <section>
+ <title>System general settings</title>
+ <itemizedlist>
+ <listitem>
+ <para>Aggregation strategy: This setting defines how the system generates and provides aggregated data to the output tools. There are two options available: <emphasis role="italic">Batch</emphasis> means that all output tools like reports, charts and maps will read aggregate data from pre-built data mart tables in the database. This strategy provides the best performance and inflicts less load on the application since data retrieval only implies reading from one or a few database tables using a simple query.</para>
+ <para>This strategy requries that those data mart tables are populated with the relevant data before the reports are requested. This can preferrably be done using nightly scheduled jobs or manually through the data mart user interface. A potential downside is that users will have to wait to the next day to view their reports after doing data entry. This approach is the recommended for large online deployments where there are medium to high user concurrency.</para>
+ <para><emphasis role="italic">Real-time</emphasis> means that aggregated data is generated and retrieved on-the-fly every time a report is requested. This implies that there is no delay after doing data entry before the data is accessible in reports. Performance will not scale adequately and hence this strategy is suitable for small, typically offline, deployments.</para>
+ </listitem>
+ <listitem>
+ <para>Infrastructural data elements: This setting defines a data element group where the member data elements should describe data about the infrastructure of organisation units. Examples of such infrastructural data elements could be population, doctors, beds, internet connectivity and climate. This infrastructural data can currently be viewed in the GIS module in the facility information sheet.</para>
+ </listitem>
+ <listitem>
+ <para>Infrastructural period type: Sets the frequency for which the data elements in the infrastructural data elements group are captured. This will typically be yearly. When viewing the infrastructual data you will be able to select the time period of the data source.</para>
+ </listitem>
+ <listitem>
+ <para>Feedback recipients: This setting defines a user group where the members will recieve all messages being sent through the function for writing feedback in the dashboard module. This will typically be members of the super user team who are ablet to support and answer questions coming from end-users.</para>
+ </listitem>
+ <listitem>
+ <para>Completeness notification recipients: This setting defines a user group where the members will receive messages as notifications when a form has been marked as complete. A typical use of this is when the forms are considered to be an order of some commodity and a group of users want to be notified when such orders are placed.</para>
+ </listitem>
+ <listitem>
+ <para>Omit indicator values with zero numerator value in data mart: Defines whether aggregated indicator values with zero as the numerator value should be written to the indicator data mart table. Having such values written is required for instance when connecting Excel pivot tables to the data mart as Excel will need the numerator data to correctly aggregate up in the organisation unit hierarchy. If third-party tools like Excel are not used with the application this will reduce the total number of values written to the data mart (which again will improve performance) and could safely be set to omit.</para>
+ </listitem>
+ <listitem>
+ <para>Disable data entry when data set completed: This setting defines whether the data entry forms should be disabled and prevent from futher entry after they have been marked as complete.</para>
+ </listitem>
+ <listitem>
+ <para>Data analysis std dev factor: Sets the number of standard deviations for use in the outlier analysis performed on the captured data in the data entry module. The default value is 2; a high value will catch less outlier values than a low value.</para>
+ </listitem>
+ <listitem>
+ <para>Days after period end to qualify for timely data submission: Sets the number of days after the end of a period in which a data entry form must be marked as complete in order to be considered timely. This affects the "reporting rate" tool in the reporting module which lists forms marked as complete as well as marked as complete in time. The default value is 15.</para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section>
+ <title>System appearance settings</title>
+ <itemizedlist>
+ <listitem>
+ <para>Application title: Sets the application title to the left on the top menu.</para>
+ </listitem>
+ <listitem>
+ <para>Style: Sets the style / look-and-feel of the system. The corresponding user style setting overrides this.</para>
+ </listitem>
+ <listitem>
+ <para>Flag: Sets the flag which is displayed in the left menu of the dashboard module.</para>
+ </listitem>
+ <listitem>
+ <para>Start page: Sets page / module which the user will be redirected to after logging in. The dashboard module is the recommended start module.</para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ <section>
+ <title>System email settings</title>
+ <itemizedlist>
+ <listitem>
+ <para>Host name: Refers to the host name of the SMTP server. For instance when using Google SMTP services this should be smtp.gmail.com.</para>
+ </listitem>
+ <listitem>
+ <para>User name: The user name of the user account with the SMTP server. For instance mail@xxxxxxxxx.</para>
+ </listitem>
+ <listitem>
+ <para>Password: The password of the user account with the SMTP server.</para>
+ </listitem>
+ </itemizedlist>
+ </section>
+ </section>
+</chapter>
=== modified file 'src/docbkx/en/dhis2_user_manual_en.xml'
--- src/docbkx/en/dhis2_user_manual_en.xml 2011-12-09 09:59:49 +0000
+++ src/docbkx/en/dhis2_user_manual_en.xml 2011-12-09 12:31:10 +0000
@@ -60,6 +60,7 @@
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="dhis2_user_man_creating_gis.xml" encoding="UTF-8"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="dhis2_user_man_import_export.xml" encoding="UTF-8"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="dhis2_user_man_data_administration.xml" encoding="UTF-8"/>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="dhis2_user_man_settings.xml" encoding="UTF-8"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="dhis2_user_man_NBITS.xml" encoding="UTF-8"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="dhis2_user_man_mobile.xml" encoding="UTF-8"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"; href="dhis2_user_man_data_dimensions.xml"/>
