File: webissues.admin.projects.html

package info (click to toggle)
webissues 1.1.5-10
  • links: PTS
  • area: main
  • in suites: bookworm
  • size: 17,108 kB
  • sloc: ansic: 97,819; cpp: 33,773; javascript: 1,171; xml: 465; sh: 378; makefile: 17
file content (199 lines) | stat: -rw-r--r-- 15,127 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>Managing projects</title>
    <link rel="stylesheet" type="text/css" href="common/style.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="home" href="index.html" title="WebIssues Manual" />
    <link rel="up" href="webissues.admin.html" title="Chapter 5. System administration" />
    <link rel="prev" href="webissues.admin.register.html" title="Registration requests" />
    <link rel="next" href="webissues.admin.updating.html" title="Updating the system" />
  </head>
  <body>
    <div id="wrapper">
      <div id="header">
        <div id="header-top">
          <div id="header-left">
            <h1><img src="common/webissues.png" alt="WebIssues" id="logo" />WebIssues Manual</h1>
          </div>
          <div id="header-right">
            <h2 class="subtitle">Version 1.1.5</h2>
          </div>
        </div>
        <div id="infobar">
          <div id="infobar-left"><a accesskey="h" href="index.html">Home</a> &raquo; <a accesskey="u" href="webissues.admin.html">System administration</a></div>
          <div id="infobar-right"></div>
        </div>
      </div>
      <div id="body">
        <div class="navlinks">
          <div class="navleft">&laquo; <a accesskey="p" href="webissues.admin.register.html">Registration requests</a></div>
          <div class="navright"><a accesskey="n" href="webissues.admin.updating.html">Updating the system</a> &raquo;</div>
          <div class="clear"></div>
        </div>
        <div class="sect1">
          <div class="titlepage">
            <div>
              <div>
                <h2 class="title" style="clear: both"><a id="webissues.admin.projects"></a>Managing projects</h2>
              </div>
            </div>
          </div>
          <p>If you are using the Desktop Client, you can manage projects and folders directly from the main window of the program. The relevant commands are available if you activate the project tree by clicking on it. In case of the Web Client, select the <span class="guilabel">Manage Projects</span> command, located above the projects tree, to manage projects and folders.</p>
          <p>If you are a system administrator, you can manage all projects and create new projects. If you are the administrator of a project, you can manage its members and folders.</p>
          <p>To add a new project, select <span class="guilabel">Add Project</span>, enter the name and optional description of the project and click <span class="guibutton">OK</span>.</p>
          <div class="figure">
            <a id="id628688"></a>
            <div class="figure-contents">
              <div class="mediaobject">
                <img src="images/ch05-fig11.png" alt="Creating a project" />
              </div>
            </div>
            <div class="figure-title">Figure 5.10. Creating a project</div>
          </div>
          <p>The system administrator can change the name of any project. To do this, select the project and click <span class="guilabel">Rename Project</span>. You can also delete projects using the <span class="guilabel">Delete Project</span> command. If the project is not empty, a warning will be displayed.</p>
          <div class="warning">
            <h3 class="title">Warning</h3>
            <p>When deleting projects or folders, pay special attention whether you are not mistakenly deleting the wrong data. All issues contained in them are permanently and irreversibly removed from the system, and it's not possible to restore them. You can archive a project instead of deleting it to make it possible to restore it later if necessary.</p>
          </div>
          <p>The project description is displayed when the project is selected in the projects tree in both the Web Client and the Desktop Client. It can be used to provide information about the project, including links to important issues or external resources. Both system administrators and project administrators can add a description to an existing project, edit the description and delete it. Project descriptions use the same format as issue descriptions and comments; see <a class="xref" href="webissues.work.issues.html#webissues.work.issues.comments" title="Comments and descriptions">the section called “Comments and descriptions”</a> for more information.</p>
          <div class="sect2">
            <div class="titlepage">
              <div>
                <div>
                  <h3 class="title"><a id="webissues.admin.projects.folders"></a>Managing folders</h3>
                </div>
              </div>
            </div>
            <p>To add a new folder, select a project and click <span class="guilabel">Add Folder</span>.</p>
            <div class="figure">
              <a id="id628734"></a>
              <div class="figure-contents">
                <div class="mediaobject">
                  <img src="images/ch05-fig12.png" alt="Creating a folder" />
                </div>
              </div>
              <div class="figure-title">Figure 5.11. Creating a folder</div>
            </div>
            <p>When creating a folder, you have to give it a name that is unique within the project and select the type of issues that will be stored in it. After creating a folder its type can't be changed. However, you can rename a folder using the <span class="guilabel">Rename Folder</span> command and delete it using the <span class="guilabel">Delete Folder</span> command.</p>
            <p>You can also move a folder from one project to another. In order to do this, you must be the administrator of the system or of both projects — the source one and destination one. Select the folder you want to move and click <span class="guilabel">Move Folder</span>. Then select the destination project from the list and click <span class="guibutton">OK</span>.</p>
          </div>
          <div class="sect2">
            <div class="titlepage">
              <div>
                <div>
                  <h3 class="title"><a id="webissues.admin.projects.permissions"></a>Project permissions</h3>
                </div>
              </div>
            </div>
            <p>After creating a new project, no regular users have access to it. To manage user privileges for specific projects, go to <span class="guilabel">Manage Projects</span> from the main window, select the project, and then click <span class="guilabel">Manage Permissions</span>. In case of the Desktop Client, this command is available directly from the main window if you activate the projects tree.</p>
            <div class="figure">
              <a id="id628794"></a>
              <div class="figure-contents">
                <div class="mediaobject">
                  <img src="images/ch05-fig08.png" alt="Project permissions" />
                </div>
              </div>
              <div class="figure-title">Figure 5.12. Project permissions</div>
            </div>
            <p>There are two global levels of access for projects:</p>
            <div class="variablelist">
              <dl class="variablelist">
                <dt>
                  <span class="term">Regular project</span>
                </dt>
                <dd>
                  <p>Regular projects are only visible to system administrators and regular users who are members of the project. All new projects are regular projects by default.</p>
                </dd>
                <dt>
                  <span class="term">Public project</span>
                </dt>
                <dd>
                  <p>Public projects are visible to all users in the system, including both system administrators and regular users. There is no need to explicitly grant access to individual members, except for project administrators. This is useful for projects containing common data, such as discussion boards, and also when it's not necessary to restrict user permissions for individual projects. Also, when anonymous access is enabled, the project can be accessed in read only mode without logging in to the system.</p>
                </dd>
              </dl>
            </div>
            <p>To change the global access of a project, click the <span class="guilabel">Change</span> command in the <span class="guilabel">Global Access</span> section. Then choose the new level of access and click <span class="guibutton">OK</span>.</p>
            <div class="figure">
              <a id="id628872"></a>
              <div class="figure-contents">
                <div class="mediaobject">
                  <img src="images/ch05-fig08-01.png" alt="Project global access" />
                </div>
              </div>
              <div class="figure-title">Figure 5.13. Project global access</div>
            </div>
            <p>You can also assign specific access for the project to individual users. There are two levels of access for project members:</p>
            <div class="variablelist">
              <dl class="variablelist">
                <dt>
                  <span class="term">Project administrator</span>
                </dt>
                <dd>
                  <p>Project administrators can manage permissions and folders of the project. They can also delete or move issues and edit and delete all comments and attachments within the project. Finally, they can manage public alerts and modify the project description.</p>
                </dd>
                <dt>
                  <span class="term">Regular member</span>
                </dt>
                <dd>
                  <p>Regular members can view issues in all folders, manage their own alerts, and create new issues and edit existing ones. They can also add comments and attachments, and edit and delete their own comments and attachments.</p>
                </dd>
              </dl>
            </div>
            <p>The global permissions of the user are always more important than permissions for a given project. A system administrator automatically becomes the administrator of all projects, and a disabled user has no access to any project. Regular users only have access to public projects and regular projects that they are members of, according to the permissions that were assigned to them.</p>
            <p>To add new members to the project, select <span class="guilabel">Add Members</span>.</p>
            <div class="figure">
              <a id="id631593"></a>
              <div class="figure-contents">
                <div class="mediaobject">
                  <img src="images/ch05-fig09.png" alt="Adding project members" />
                </div>
              </div>
              <div class="figure-title">Figure 5.14. Adding project members</div>
            </div>
            <p>Select one or more users who are not yet members of the project. Then select the appropriate level of access and click <span class="guibutton">OK</span>.</p>
            <p>To change the access for an existing member, select the member on the list and click <span class="guilabel">Change Access</span>. Then select the new level of access and click <span class="guibutton">OK</span>. You can't deprive your own project administrator rights, unless you are a system administrator.</p>
            <div class="figure">
              <a id="id631642"></a>
              <div class="figure-contents">
                <div class="mediaobject">
                  <img src="images/ch05-fig10.png" alt="Changing member's access" />
                </div>
              </div>
              <div class="figure-title">Figure 5.15. Changing member's access</div>
            </div>
            <p>To remove a member of the project, select the member on the list and click <span class="guilabel">Remove Member</span>. In case of the Desktop Client, you can choose several members on the list, and change their access or remove them from the project simultaneously.</p>
          </div>
          <div class="sect2">
            <div class="titlepage">
              <div>
                <div>
                  <h3 class="title"><a id="webissues.admin.projects.archive"></a>Archiving projects</h3>
                </div>
              </div>
            </div>
            <p>When a project is no longer needed, it is possible to remove it without permanently deleting it. When a project is archived, it is removed from the projects tree and no one can access any folders and issues in that project. However, unlike deleted projects, archived projects can be restored at any time. Only system administrators can archive and restore projects.</p>
            <p>To archive a project, go to <span class="guilabel">Manage Projects</span> from the main window, select the project, and then click <span class="guilabel">Archive Project</span>. In case of the Desktop Client, this command is available directly from the main window if you activate the projects tree.</p>
            <div class="tip">
              <h3 class="title">Tip</h3>
              <p>It is not possible to archive individual folders, but you can create a new project, move the folder or folders that you want to archive to that project, and then archive the project.</p>
            </div>
            <p>To open a list of archived projects, go to the Administration Panel and click <span class="guilabel">Projects Archive</span>. This function is not available in the Desktop Client.</p>
            <p>To restore an archived project, select the project and click <span class="guilabel">Restore Project</span>. The project will be removed from the list of archived projects and will appear in the projects tree. The folders, issues, permissions, alerts and other information related to the project will be preserved.</p>
            <p>To permanently delete an archived project, select the project and click <span class="guilabel">Delete Project</span>. In that case it will no longer be possible to restore any information associated with the project. You can also use the <span class="guilabel">Rename Project</span> command to rename an archived project and the <span class="guilabel">View Description</span> command to view the description of the project, if available. Note that it is not possible to access any folders and issues or to modify the project while it's archived.</p>
          </div>
        </div>
        <div class="navlinks">
          <div class="navleft">&laquo; <a accesskey="p" href="webissues.admin.register.html">Registration requests</a></div>
          <div class="navright"><a accesskey="n" href="webissues.admin.updating.html">Updating the system</a> &raquo;</div>
          <div class="clear"></div>
        </div>
      </div>
      <div id="footer">
        <p class="copyright">Copyright © 2007-2017 WebIssues Team</p>
      </div>
    </div>
  </body>
</html>