dhis2-devs team mailing list archive
-
dhis2-devs team
-
Mailing list archive
-
Message #27958
[Branch ~dhis2-documenters/dhis2/dhis2-docbook-docs] Rev 952: Starting user manual update. Removed creating user from getting started section. Covered elsewhere.
------------------------------------------------------------
revno: 952
committer: Jason P. Pickering <jason.p.pickering@xxxxxxxxx>
branch nick: dhis2-docbook-docs
timestamp: Wed 2014-02-05 18:35:13 +0200
message:
Starting user manual update. Removed creating user from getting started section. Covered elsewhere.
added:
src/docbkx/en/resources/images/getting_started/
src/docbkx/en/resources/images/getting_started/login.png
modified:
src/docbkx/en/dhis2_user_man_getting_started.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
=== modified file 'src/docbkx/en/dhis2_user_man_getting_started.xml'
--- src/docbkx/en/dhis2_user_man_getting_started.xml 2013-06-01 12:33:28 +0000
+++ src/docbkx/en/dhis2_user_man_getting_started.xml 2014-02-05 16:35:13 +0000
@@ -97,130 +97,23 @@
<para>To log on to the application just enter <ulink url="http://localhost:8080/dhis" type="">http://localhost:8080/dhis</ulink> if you
are using the DHIS2 live package, or replace localhost with the name or IP
address of the server where the server version is installed.</para>
- <para>Once you have started DHIS2, either on-line or offline, the displayed
- screen will prompt you to enter your registered ‘user name’ and
- ‘password’. After entering the required information click on log-in button
- to log into the application. The default user name and password are 'admin' and 'district'. They should be changed immediately upon logging on the first time. </para>
- </section>
- <section id="users">
- <title>Creating new users and roles</title>
- <para>This section will describe how to add new users to the DHIS 2
- application.</para>
- <section>
- <title>Open User Menu</title>
- <para>To create or find a user begin with clicking on the ‘user’ module
- displayed in the drop down menu of the Maintenance module located on the
- main tool bar on the top part of the displayed screen.</para>
- <screenshot>
- <screeninfo>Select Users menu item</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="100%" fileref="resources/images/dhis2UserManual/select_user_menu.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>User names already registered will appear as a list as seen in the screen shot below.</para>
- <screenshot>
- <screeninfo>Search by user name</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="100%" fileref="resources/images/dhis2UserManual/search_user_by_name.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>You can search for specific user names in the user list by
- entering the name in the ‘filter by user name’ field as shown
- above.</para>
- </section>
- <section id="user_roles">
- <title>Define a new role</title>
- <para>As part of creating a user name you are required to define the user
- role. Do so by clicking on the ‘user role’ appearing on the left side of
- the displayed screen. This will lead you to the Role Management page where you will have
- to click on <guibutton>Add new</guibutton> to create a new role.</para>
- <screenshot>
- <screeninfo>Add new user role</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="100%" fileref="resources/images/dhis2UserManual/add_user_role.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>The following screen will open and here in the first text box you
- need to give Name of the Role such as Super User, Admin User, etc. The
- second text box called ‘Description’ gives more information about the
- type of User Role that is being created for e.g. State Admin User,
- District Data Entry.</para>
- <screenshot>
- <screeninfo>Role maintenance page</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="100%" fileref="resources/images/dhis2UserManual/role_maintenance_page.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- <para>Next you will specify the particular data set(s) that are to be
- made available to the particular role. You will also need to specify the
- type of ‘authority’ to be given to the particular user. For each of the
- three options namely Datasets, Reports and Authorities user can select
- multiple options from the scroll down menu provided against each field.
- A user can choose multiple options either by moving them
- one-by-one.</para>
- <para>In order for particular users to be able to enter data, you must
- add them to both a dataset as well as an organisational unit level. You
- can also select multiple datasets individually by pressing the Ctrl key
- on the keyboard and clicking on individual datasets.</para>
- <para>Finally when you have entered the required fields click on
- <guibutton>Save</guibutton> which is located on the lower part of the
- displayed screen. The desired user role and related authorisation will
- be saved to the database, and can then be assigned to a particular
- user.</para>
- </section>
- <section>
- <title>Add New User</title>
- <para>Under particular user role there can be more than one user. To add
- new users go to the User options under the Maintenance module.</para>
- <para>To add a new user, just follow these steps:</para>
- <itemizedlist>
- <listitem>
- <para>Click on the <guibutton>Add New</guibutton> button.</para>
- </listitem>
- <listitem>
- <para>Enter New User details like <guilabel>User name</guilabel>, <guilabel>Password</guilabel>, <guilabel>Confirm password</guilabel>, <guilabel>Surname</guilabel>, <guilabel>First name</guilabel> and <guilabel>Email</guilabel> in new user’s option tabs.</para>
- </listitem>
- <listitem>
- <para>Click on <guibutton>Add</guibutton> button for confirmation of
- new user details and follow the user error while creation of new
- user.</para>
- </listitem>
- <listitem>
- <para>The recently created new user can be seen in main’ User
- management Screen</para>
- </listitem>
- <listitem>
- <para>You can edit (like password, surname….etc) and delete the
- details of new/old users by selecting corresponding User’s
- <guibutton>Edit</guibutton> and <guibutton>Delete</guibutton>
- Buttons.</para>
- </listitem>
- <listitem>
- <para>Click on <guibutton>Save</guibutton> tab after editing all
- details of a particular selected user.</para>
- <screenshot>
- <screeninfo>User management screen</screeninfo>
- <mediaobject>
- <imageobject>
- <imagedata width="100%" fileref="resources/images/dhis2UserManual/user_management.png" format="PNG"/>
- </imageobject>
- </mediaobject>
- </screenshot>
- </listitem>
- </itemizedlist>
- </section>
+ <para>Once you have started DHIS2, either on-line or off-line, the displayed
+ screen will prompt you to enter your registered username and
+password. After entering the required information click on log-in button
+ to log into the application. The default user name and password are 'admin' and 'district'. They should be changed immediately upon logging on the first time.</para>
+ <mediaobject>
+ <imageobject>
+ <imagedata width="40%" align="center" fileref="resources/images/getting_started/login.png" format="PNG"/>
+ </imageobject>
+ </mediaobject>
+ <para>You can select the language which you wish to display DHIS2 in from the "Change language" dialog box at the bottom of the screen. Not all languages may be available. </para>
+ <para>Should you have forgotten your password, you can click on the "Forgot password?" link. You must have informed DHIS2 of your email address and the server must be properly configured to send emails. </para>
+ <para>If you want to create your own account (and the server administrator allows this), simply click "Create an account" and follow the directions provided. </para>
+ <para>Once you have logged into DHIS2, refer to the specific sections in this manual for the different functionality which is available. </para>
</section>
<section id="mod2_4">
<title>Logging out of DHIS 2</title>
- <para>Just click on the Log out link in the top right corner to exit the application.</para>
+ <para>Just click on the Profile->Log in the top-right corner of the DHIS2 menu. </para>
</section>
<section id="database_design">
<title>Quick intro to designing a DHIS 2 database</title>
=== added directory 'src/docbkx/en/resources/images/getting_started'
=== added file 'src/docbkx/en/resources/images/getting_started/login.png'
Binary files src/docbkx/en/resources/images/getting_started/login.png 1970-01-01 00:00:00 +0000 and src/docbkx/en/resources/images/getting_started/login.png 2014-02-05 16:35:13 +0000 differ