dhis2-devs team mailing list archive

[noreply@xxxxxxxxxxxxx]

------------------------------------------------------------
revno: 683
committer: Lars Helge Øverland <larshelge@xxxxxxxxx>
branch nick: dhis2-docbook-docs
timestamp: Wed 2013-03-13 13:23:17 +0100
message:
  Sharing
added:
  src/docbkx/en/resources/images/sharing/sharing-settings.png
modified:
  src/docbkx/en/dhis2_user_man_sharing.xml
  src/docbkx/en/resources/images/sharing/sharing-dialog.png


--
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_sharing.xml'
--- src/docbkx/en/dhis2_user_man_sharing.xml	2013-03-11 18:04:11 +0000
+++ src/docbkx/en/dhis2_user_man_sharing.xml	2013-03-13 12:23:17 +0000
@@ -5,12 +5,19 @@
   <para>This chapter discusses the sharing of entities feature in DHIS 2.</para>
   <section>
     <title>Sharing of objects</title>
-    <para>A large part of the objects in DHIS 2, like reports, charts and indicators, can be shared.
-      Sharing means making an object, like a report, available for reading or modification to a
-      group of users or to everyone.</para>
-    <para>For instance for reports, the sharing dialog can be opened by clicking on the "share"
-      button next to each report in the list. The sharing dialog is where sharing is
-      controlled.</para>
+    <para>A large part of the objects in DHIS 2, like reports, charts, maps and indicators, can be
+      shared. Sharing means making an object, like a report, available for reading or modification
+      to a group of users or to everyone. For instance for reports, the sharing dialog can be opened
+      by clicking on the "Sharing settings" button next to each report in the list.</para> 
+    <screenshot>
+      <screeninfo>The sharing dialog.</screeninfo>
+      <mediaobject>
+        <imageobject>
+          <imagedata width="30%" fileref="resources/images/sharing/sharing-settings.png" format="PNG"/>
+        </imageobject>
+      </mediaobject>
+    </screenshot>
+    <para>Clicking on the "Sharing settings" button will open the sharing dialog. The sharing dialog is where sharing is controlled.</para>
     <screenshot>
       <screeninfo>The sharing dialog.</screeninfo>
       <mediaobject>
@@ -19,11 +26,37 @@
         </imageobject>
       </mediaobject>
     </screenshot>
+    <para>You can share your report with everyone or with a number of user groups. Next to "Public
+      access" you can choose your access option: "None", "Can view" or "Can edit and view". To share
+      with a group, simply start typing the name of the group and the "Search for user groups" input
+      field, and select your desired group. Click on the "+" icon next to the input field to share
+      with that group. For each group you can set an access option, similar to public access.</para>
+    <para>Sharing with a user group implies that all users in that group will get access to the
+      shared object. To create a user group you can go to the dashboard module and click on "Groups"
+      on the front page. This will lead you to the list of groups where you can click "Add new" in
+      the top right corner. Creating user groups is open for everyone.</para>
   </section>
   <section>
-    <title>Supported objects</title>
-    <para>Currently the objects which support sharing are: Indicator, indicator group, indicator
+    <title>Sharing and access control</title>
+    <para>Currently the objects which support sharing are indicator, indicator group, indicator
       group set, data dictionary, data set, program, user group, standard report, resource, report
       table, chart and map. </para>
+    <para>In order to be able to create objects with public access (view or edit) your user account
+      must have the authority to do so. All supported objects have a corresponding authority for
+      creating public objects. As an example, to create a public accessible report your user must
+      have the "Create public report" authority granted. The public access option will be disabled
+      if not.</para>
+    <para>To share an object with another person and let her edit the object will in most cases
+      require that the person's user account has the authority for updating that type of objects
+      granted. For instance, if you want to let another person edit your report, that person's user
+      account must have the "Update report" authority granted. This does not apply for objects which
+      are open for anyone to create, which currently are report table, map, chart and user
+      group.</para>
+    <para>When you create an object it will automatically become viewable for everyone if your user
+      account has the authority to do so. As an example, if you create a report and you have the
+      "Create public report" authority granted, the report will become viewable for everyone and
+      editable for users with the "Update report" authority. If you do not have that authority
+      granted the report will be private to yourself. After you have created an object, you can
+      navigate to the sharing settings dialog and set your desired access options.</para>
   </section>
 </chapter>

=== modified file 'src/docbkx/en/resources/images/sharing/sharing-dialog.png'
Binary files src/docbkx/en/resources/images/sharing/sharing-dialog.png	2013-03-11 18:04:11 +0000 and src/docbkx/en/resources/images/sharing/sharing-dialog.png	2013-03-13 12:23:17 +0000 differ
=== added file 'src/docbkx/en/resources/images/sharing/sharing-settings.png'
Binary files src/docbkx/en/resources/images/sharing/sharing-settings.png	1970-01-01 00:00:00 +0000 and src/docbkx/en/resources/images/sharing/sharing-settings.png	2013-03-13 12:23:17 +0000 differ