Changes for page Managing HDC Projects
Last modified by Dennis Segebarth on 2024/08/14 17:08
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 4 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,3 +1,7 @@ 1 +{{box cssClass="floatinginfobox" title="Table of Contents"}} 2 +{{toc depth="2"/}} 3 +{{/box}} 4 + 1 1 This section of the User Guide describes the features available to Project Administrators to manage their Project. 2 2 3 3 Each Project is owned by a Project Administrator, a role analogous to an academic Principal Investigator. More than one person can hold the Project Administrator role, allowing for role delegation and backup. Creation of your own Project can be requested by submitting an inquiry (see //Contact Us//). ... ... @@ -179,39 +179,211 @@ 179 179 180 180 The following table describes available Project roles and their permissioned data and project operations: 181 181 182 - 183 - 184 - 185 -|(% style="background-color:#dcdcdc; text-align:center" %) Activity |(% colspan="3" style="background-color:#dcdcdc; text-align:center" %)Green Room File Operations 186 +|(% style="background-color:#dcdcdc; text-align:center" %) **Activity** |(% colspan="3" style="background-color:#dcdcdc; text-align:center" %)**Green Room File Operations** 186 186 | |(% style="background-color:#edf1f4; text-align:center" %)**Project Administrator**|(% style="background-color:#edf1f4; text-align:center" %)**Project Collaborator**|(% style="background-color:#edf1f4; text-align:center" %)**Project Contributor** 187 -|Access own files in Project Green Room|(%style 188 -|Access all files in Project Green Room|(%style 189 -|Upload and annotate files to Project Green Room|(%style 190 -|Download files from own Project Green Room folder|(%style 191 -|Download files from any Project Green Room folder|(%style 192 -|Request file copy from Green Room to Core|(%style 193 -|Copy files from Green Room to Core|(%style (%style="text-align:center" %)☑️ Allowed|194 -|(% style="background-color:#dcdcdc; text-align:center" %) Activity |(% colspan="3" style="background-color:#dcdcdc; text-align:center" %)Core Room File Operations 188 +|Access own files in Project Green Room|(% style="text-align:center" %)☑️ Allowed|(% style="text-align:center" %)☑️ Allowed|(% style="text-align:center" %)☑️ Allowed 189 +|Access all files in Project Green Room|(% style="text-align:center" %)☑️ Allowed| | 190 +|Upload and annotate files to Project Green Room|(% style="text-align:center" %)☑️ Allowed|(% style="text-align:center" %)☑️ Allowed|(% style="text-align:center" %)☑️ Allowed 191 +|Download files from own Project Green Room folder|(% style="text-align:center" %)☑️ Allowed|(% style="text-align:center" %)☑️ Allowed|(% style="text-align:center" %)☑️ Allowed 192 +|Download files from any Project Green Room folder|(% style="text-align:center" %)☑️ Allowed| | 193 +|Request file copy from Green Room to Core|(% style="text-align:center" %)☑️ Allowed|(% style="text-align:center" %)☑️ Allowed| | 194 +|Copy files from Green Room to Core|(% style="text-align:center" %)☑️ Allowed| | 195 +|(% style="background-color:#dcdcdc; text-align:center" %) **Activity** |(% colspan="3" style="background-color:#dcdcdc; text-align:center" %)**Core Room File Operations** 195 195 | |(% style="background-color:#edf1f4; text-align:center" %)**Project Administrator**|(% style="background-color:#edf1f4; text-align:center" %)**Project Collaborator**|(% style="background-color:#edf1f4; text-align:center" %)**Project Contributor** 196 -|Access own files in Project Core|(%style 197 -|Access all files in Project Core|(%style 198 -|Upload and annotate files from from Workspace to Project Core (via Command Line Interface)|(%style 199 -|Download files from Project Core own folder|(%style 200 -|Download files from Project Core any folder|(%style 201 -|(% style="background-color:#dcdcdc; text-align:center" %) Activity |(% colspan="3" style="background-color:#dcdcdc; text-align:center" %)User Management 197 +|Access own files in Project Core|(% style="text-align:center" %)☑️ Allowed|(% style="text-align:center" %)☑️ Allowed| 198 +|Access all files in Project Core|(% style="text-align:center" %)☑️ Allowed|(% style="text-align:center" %)☑️ Allowed| 199 +|Upload and annotate files from from Workspace to Project Core (via Command Line Interface)|(% style="text-align:center" %)☑️ Allowed|(% style="text-align:center" %)☑️ Allowed| 200 +|Download files from Project Core own folder|(% style="text-align:center" %)☑️ Allowed|(% style="text-align:center" %)☑️ Allowed| 201 +|Download files from Project Core any folder|(% style="text-align:center" %)☑️ Allowed|(% style="text-align:center" %)☑️ Allowed| 202 +|(% style="background-color:#dcdcdc; text-align:center" %) **Activity** |(% colspan="3" style="background-color:#dcdcdc; text-align:center" %)**User Management** 202 202 | |(% style="background-color:#edf1f4; text-align:center" %)**Project Administrator**|(% style="background-color:#edf1f4; text-align:center" %)**Project Collaborator**|(% style="background-color:#edf1f4; text-align:center" %)**Project Contributor** 203 -|View, add, remove, manage Project members|(%style 204 -|(% style="background-color:#dcdcdc; text-align:center" %) Activity |(% colspan="3" style="background-color:#dcdcdc; text-align:center" %)Project Management 204 +|View, add, remove, manage Project members|(% style="text-align:center" %)☑️ Allowed| | 205 +|(% style="background-color:#dcdcdc; text-align:center" %) **Activity** |(% colspan="3" style="background-color:#dcdcdc; text-align:center" %)**Project Management** 205 205 | |(% style="background-color:#edf1f4; text-align:center" %)**Project Administrator**|(% style="background-color:#edf1f4; text-align:center" %)**Project Collaborator**|(% style="background-color:#edf1f4; text-align:center" %)**Project Contributor** 206 -|Update Project Information|(%style 207 -|Create and manage File Attribute templates|(%style 208 -|Fulfill Project member file copy requests from Green Room to Core|(%style 209 -|Approve Project member VM access requests|(%style 210 -|Create Project Announcements|(%style 211 -|(% style="background-color:#dcdcdc; text-align:center" %) Activity |(% colspan="3" style="background-color:#dcdcdc; text-align:center" %)Workspace Tools 207 +|Update Project Information|(% style="text-align:center" %)☑️ Allowed| | 208 +|Create and manage File Attribute templates|(% style="text-align:center" %)☑️ Allowed| | 209 +|Fulfill Project member file copy requests from Green Room to Core|(% style="text-align:center" %)☑️ Allowed| | 210 +|Approve Project member VM access requests|(% style="text-align:center" %)☑️ Allowed| | 211 +|Create Project Announcements|(% style="text-align:center" %)☑️ Allowed| | 212 +|(% style="background-color:#dcdcdc; text-align:center" %) **Activity** |(% colspan="3" style="background-color:#dcdcdc; text-align:center" %)**Workspace Tools** 212 212 | |(% style="background-color:#edf1f4; text-align:center" %)**Project Administrator**|(% style="background-color:#edf1f4; text-align:center" %)**Project Collaborator**|(% style="background-color:#edf1f4; text-align:center" %)**Project Contributor** 213 -|Access Jupyterhub|(%style 214 -|Access Superset|(%style 215 -|Access XWiki|☑️ Allowed|☑️ Allowed|☑️ Allowed 214 +|Access Jupyterhub|(% style="text-align:center" %)☑️ Allowed|(% style="text-align:center" %)☑️ Allowed| 215 +|Access Superset|(% style="text-align:center" %)☑️ Allowed|(% style="text-align:center" %)☑️ Allowed| 216 +|Access XWiki|(% style="text-align:center" %)☑️ Allowed|(% style="text-align:center" %)☑️ Allowed|(% style="text-align:center" %)☑️ Allowed 216 216 218 +Note: Be reminded that Platform Administrators hold no Project specific role, and are, therefore, not listed in the table above. However, within each Project, they have - by default - the same permissions as a Project Administrator. 219 + 220 +== Viewing Project Member Profiles and Account Activities == 221 + 222 +Project Administrators can review the Project membership, member profiles and account activities. 223 + 224 +1. Launch your Project and open the **Project Members** page. 225 +1. Click the **Action icon** (three vertical dots) in the member’s entry in the **Members **table and click **Profile**. 226 +1. The Member Profile page displays basic profile information and history of actions in their account (invited when and by whom, date activated, role changes). 227 + 228 +== Changing Project Member Roles == 229 + 230 +Project Administrators can change the role of any Project member other than themselves. 231 + 232 +1. Launch your Project and open the **Members **table in the **Project Members** page. 233 +1. In the member’s entry, click **Change Role **and select a new role from the dropdown menu. 234 +1. A popup window prompts you to confirm the change. Click **OK** to confirm, or **Cancel** to exit without making the change. 235 + 236 +After clicking **OK**, the role change takes effect immediately and the Project member will receive an email notification confirming their new role assignment. 237 + 238 +=== Considerations === 239 + 240 +* Assigning a Project Member to a less privileged role may cause them to lose access to Project data they previously had access to. 241 +* As a Project Administrator you cannot change your own role, but another Project Administrator can change your role. 242 + 243 +== Removing Members from the Project == 244 + 245 +Project Administrators can remove members from the Project. 246 + 247 +1. Launch your Project and open the **Members** table on the **Project members** page. 248 +1. Click the **Action icon** (three vertical dots) in the member’s entry and click **Delete**. 249 +1. A popup window prompts you to confirm the change. Click **OK** to confirm, or **Cancel** to exit without making the change. 250 + 251 +After clicking **OK**, the member is removed from the Project immediately. Their membership in other Projects is not affected. The member will not receive an email notification. 252 + 253 +Note: removing a member from a Project removes their access to all the Project data in the Green Room, Core, and Workspace VMs. However, the user will continue to have access to Project data held in any Datasets they have created as long as their user account is active. 254 + 255 += Managing Project Workspace Tools = 256 + 257 +Workspace tools like Jupyterhub enable your Project members to work with the Project data right within the HDC platform, fostering remote collaboration. In addition, the workspace tool XWiki allows your Project members to collaboratively work on your Project wiki documentation. Integrated Workspace tools are configured at the time of Project creation, or later, by a Platform Administrator. 258 + 259 +As Project Administrator, you can check the deployment status of Workspace tools by opening the Project **Settings** page and clicking the **Workspace** tab. 260 + 261 +[[image:Manage Projects Workspace Deployment v2.1.5 2023-02-02 1517.png||height="24%" width="50%"]] 262 + 263 + 264 +If you need a Workspace tool deployed for the project, please contact a Platform Administrator. 265 + 266 +== Jupyterhub == 267 + 268 +After Jupyterhub is deployed for the Project, members can click **Jupyterhub **in the Workspace icon group to launch their own Jupyter environment. Login is seamless with single sign-on - just click **Sign in with Keycloak**. See //Using Jupyterhub// for more details on how to use the application in the platform. 269 + 270 +== XWiki == 271 + 272 +After XWiki is deployed for the Project, members can click **XWiki** in the Workspace icon group to launch the application and be logged in seamlessly with single sign-on. See //Using XWiki// for more details on how to use the application in the platform. 273 + 274 += Creating Project Announcements = 275 + 276 +Project Administrators can use the **Announcements **page to send messages to all Project members to convey relevant Project news and information. Project Members can use this page to view Project announcements. 277 + 278 +[[image:Manage Projects Announcements v2.1.5 2023-01-30.png||height="19%" width="20%"]] 279 + 280 + 281 +To create a Project announcement as Project Administrator, 282 + 283 +1. Launch your Project and click the **Announcements **icon in the left menu bar. 284 +1. In the **Create new announcement** window, enter your announcement (maximum length 250 characters) and click **Publish**. 285 +1. Your announcement will be visible to all Project members in **Announcements **page of the corresponding Project, as well as in their Notifications area (accessible via the orange bell icon in the navigation bar at the top of the portal website), and in their **Newsfeed **on the **Dashboard **page. 286 + 287 += Managing File Attribute Templates = 288 + 289 +Project Administrators can create and configure File Attribute templates that will be available to all Project Members to annotate files during or after upload (see //Working with HDC Project Files in the Portal// > //Adding and Modifying File Attributes//). 290 + 291 +== Creating a File Attribute Template == 292 + 293 +To create a new File Attribute template for your project as Project Administrator, 294 + 295 +[[image:Manage Projects File Attributes v2.1.5 2023-02-01.png||height="7%" width="50%"]] 296 + 297 + 298 +1. Launch your Project and click on the Project **Settings **icon. 299 +1. Select the **File Attributes** tab and click **Create New Attribute Template**. 300 +1. Enter a name for the Template and click **Next Step.** 301 +1. ((( 302 +Click **+ Add Attribute** to create a new attribute and configure the key parameters: 303 + 304 +* //Name//: Provide the name of the attribute (letters or numbers, no spaces, maximum 32 characters). 305 +* //Type: //Select the type of information to be collected (text, multiple choice). Text fields will allow entries of up to 100 characters. 306 +* //Value~:// If you selected multiple choice as type, you can define the available value options (maximum 32 characters each), pressing Enter after each entry. 307 +* //Optional~:// Specify whether the Attribute is optional or mandatory (optional by default). Uncheck the box if the Attribute is mandatory. 308 +))) 309 +1. Click the **checkmark **to save the new field or **X** to clear the field. 310 +1. To add more fields, repeat steps 4-5 until all fields have been added. 311 +1. Review the newly created fields for accuracy and completeness. Be sure to click the **checkmark **in the Actions column beside each field to save the entry, or **X **to discard the field. Once a field is saved, use the **Edit **or **Delete **icons to make any changes. Note: after a File Attribute template has been saved, new fields can be added to the template but existing fields cannot be edited or removed, and any new attributes added to the template must be Optional. 312 +1. Click **Create**.** ** 313 + 314 +Your new File Attribute template is saved and Project Members will be able to see the template and annotate files with these Attributes. For more details on how to annotate files, see //Working with HDC Project Files in the Portal// > //Adding and Modifying File Attributes//. 315 + 316 +You can create multiple File Attribute templates for the Project, but a Project file can only be annotated with a single File Attribute template. 317 + 318 +== Managing a File Attributes Template == 319 + 320 +After a File Attribute template has been created, a Project Administrator can make limited changes to the template, delete it, or export it as a JSON file. 321 + 322 +1. Launch your Project and click on the Project **Settings **icon. 323 +1. Select the **File Attributes** tab and locate an existing template. 324 +1. Click an available action: 325 +1*. **Rename**: When an Attribute template is renamed, all Files annotated with the template will show the new template name. Click **Save**, or **Cancel **to exit without making the change. 326 +1*. **Delete**: An Attribute template can only be deleted if it has not yet been used to annotate any files. 327 +1*. **Export**: Click to download the Attributes template as a JSON file. 328 +1*. **Add Attribute**: Attributes denoted as Optional can be added to the template, as described above in step 4 of the section //Creating a File Attribute Template//. Click the **checkmark **to save each addition. 329 +1**. Attributes denoted as Mandatory cannot be added. 330 +1**. Existing attributes cannot be edited or removed. 331 +1. The changes will be effective for any new File Attribute annotations. 332 + 333 +== Importing File Attribute Templates == 334 + 335 +Instead of using the Project **Settings **page to create Attributes template, Project Administrators can import the template configuration as a JSON file. 336 + 337 +1. On your local computer, create and save a JSON file containing your annotations, see //Formatting Guideline for JSON File Attribute Templates// below. 338 +1. Launch your Project and click on the **Settings** icon. 339 +1. Select the **File Attributes** and click **Import Attribute Template**. 340 +1. Enter an Attribute Template name, upload the JSON file you created, then click **OK**. If there are errors in the JSON file, a parse error message will be returned. Please review the //Formatting Guideline for JSON File Attribute Templates// section below, then check your uploaded file and try again after adapting it accordingly. 341 +1. Once the file has been successfully uploaded and saved, it will be available to all Project Members to annotate files. 342 + 343 +=== Formatting Guideline for JSON File Attribute Templates === 344 + 345 +JSON is built around two structures: 346 + 347 +* ((( 348 +Objects 349 + 350 +* Key-value pairs 351 +* Surrounded by curly brackets ({}) 352 +))) 353 +* ((( 354 +Arrays 355 + 356 +* Lists of items 357 +* Surrounded by square brackets ([]) 358 +))) 359 + 360 +Parameters for File Attributes JSON templates are as follows: 361 + 362 +* //Name//: The Attribute name (letters or numbers, no spaces). 363 +* //Type//: The type of information to be collected (text, multiple choice) 364 +* //Value//: If the Type is Multiple Choice, a list of the accepted values, separated by commas. 365 +* //Optional//: Default is true. Set to false if the Attribute should be mandatory on collection. 366 + 367 +The following example depicts a File Attribute template created in the Project Settings menu and the corresponding JSON file format. You can use this example as a guideline to create your own JSON file. 368 + 369 +Template created in the Project Settings menu: 370 + 371 +[[image:Manage Projects File Attributes Example for JSON v2.1.5 2023-02-01.png||height="17%" width="50%"]] 372 + 373 +Corresponding JSON file format: 374 + 375 +{{code language="json"}} 376 +{"attributes":[{"name":"Group","options":["A","B","C","D"],"type":"multiple_choice","optional":true},{"name":"FaveMeal","options":["breakfast","lunch","dinner"],"type":"multiple_choice","optional":false},{"name":"FaveFruit","options":["apples","oranges","strawberries","bananas","other"],"type":"multiple_choice","optional":true},{"name":"OtherFaveFruit","type":"text","optional":true}]} 377 +{{/code}} 378 + 379 += Deleting and Archiving Projects = 380 + 381 +Please contact a Platform Administrator if you need to delete or archive your Project. 382 + 383 + 384 +---- 385 + 386 +Copyright © 2023 [[Indoc Research>>url:https://www.indocresearch.org/]]. 387 + 388 +HealthDataCloud is powered by Pilot technology, a product of [[Indoc Research>>url:https://www.indocresearch.org/]]. 389 + 390 + 391 + 392 + 217 217
- Manage Projects Announcements v2.1.5 2023-01-30.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.sgevans - Size
-
... ... @@ -1,0 +1,1 @@ 1 +102.7 KB - Content
- Manage Projects File Attributes Example for JSON v2.1.5 2023-02-01.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.sgevans - Size
-
... ... @@ -1,0 +1,1 @@ 1 +45.1 KB - Content
- Manage Projects File Attributes v2.1.5 2023-02-01.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.sgevans - Size
-
... ... @@ -1,0 +1,1 @@ 1 +289.0 KB - Content
- Manage Projects Workspace Deployment v2.1.5 2023-02-02 1517.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.sgevans - Size
-
... ... @@ -1,0 +1,1 @@ 1 +667.4 KB - Content