Changes for page Managing the HDC Platform

Last modified by Dennis Segebarth on 2024/08/14 17:06
From version 1.1
edited by Susan Evans
on 2023/07/12 15:05
Change comment: There is no comment for this version
To version 10.1
edited by Dennis Segebarth
on 2024/08/14 17:05
Change comment: Deleted image "Main Menu Platform Management v2.2.6 2023-04-12.png"

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.sgevans
1 +XWiki.dsegebarth
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 contains information for Platform Administrators to manage the Platform deployment. Platform Administrator is a high-privilege role that should be restricted to designated trained individuals who are knowledgeable on all aspects of the platform operation. Platform Administrators can view all Projects and create new Projects.
2 2  
3 3  = About the Platform Administrator Role =
... ... @@ -13,7 +13,7 @@
13 13  
14 14  When Platform Administrators log into the Platform they see the same major features of the Portal layout described in //Portal Navigation//, with additional features for **Platform Management**.
15 15  
16 -[[image:Main Menu Platform Management v2.2.6 2023-04-12.png||height="5%" width="50%"]]
20 +[[image:1723654856770-216.png||height="87" width="856"]]
17 17  
18 18  = Managing User Accounts =
19 19  
... ... @@ -23,7 +23,7 @@
23 23  
24 24  Platform Administrators can view and manage all users across the Platform. To access the platform-wide User Management tools, click **Platform Management** and select the **User Management** tab.
25 25  
26 -[[image:Platform Admin User Management v2.1.6 2023-02-09.png]]
30 +[[image:1723654869019-473.png||height="310" width="867"]]
27 27  
28 28  
29 29  Within the **Platform Users** table, Platform Administrators can:
... ... @@ -68,7 +68,7 @@
68 68  
69 69  To invite a new user to the Platform,
70 70  
71 -[[image:Platform Admin Invite User v2.1.6 2023-02-09.png||height="35%" width="40%"]]
75 +[[image:1723654887329-788.png||height="335" width="384"]]
72 72  
73 73  
74 74  1. Click **Platform Management** in the Main Menu, and open the **User Management** tab.
... ... @@ -75,13 +75,10 @@
75 75  1. Click **Invite User**.
76 76  1. In the popup window, enter the email address of the new user.
77 77  Note: If the user’s email address already exists in the platform, a warning is displayed.
78 -1. (((
79 -Select the Role
80 -
81 -1. //Platform Administrator//** **provides access to all Platform management.
82 +1. Select the Role
83 +1*. //Platform Administrator//** **provides access to all Platform management.
82 82  **Note: Platform Administrator is the highest privilege role. Only select this option for suitably trained individuals.**
83 -1. //Platform User// is a basic registered user with no Project membership who can only view the Project Landing page and see the basic information about Projects listed there.
84 -)))
85 +1*. //Platform User// is a basic registered user with no Project membership who can only view the Project Landing page and see the basic information about Projects listed there.
85 85  1. A pop-up window prompts you to review the provided information. Click **Send** to complete the invitation, or **Cancel** to exit.
86 86  
87 87  === Viewing Sent Invitations ===
... ... @@ -99,7 +99,7 @@
99 99  
100 100  Platform Administrators can disable the account of any user in any role. Disabling a user account immediately prevents the user from logging into the platform and removes them from the Members list of their Projects. This action is reversible.
101 101  
102 -[[image:Platform Admin Disable Account v2.1.6 2023-02-09.png||height="11%" width="50%"]]
103 +[[image:1723654904200-429.png||height="187" width="871"]]
103 103  
104 104  === Disabling a User Account ===
105 105  
... ... @@ -140,17 +140,14 @@
140 140  
141 141  Platform Administrators create Projects in the Portal, set up the XWiki Project page, and invite the first Project Administrator.
142 142  
143 -[[image:Platform Admin Create Project v2.2.6 2023-05-23.png||height="10%" width="50%"]]
144 +[[image:1723654919917-639.png||height="176" width="856"]]
144 144  
145 145  == Creating the new Project in the Portal ==
146 146  
147 147  1. Navigate to the Projects Landing Page and click **+ New Project**.
148 -1. (((
149 -Provide the required information to get the Project started:
150 -
151 -1. //Project Name//** **(can be changed later by the Project Administrator) - A short name for the project to differentiate it from other projects. Maximum 100 characters
152 -1. //Project Code// (immutable) - Uniquely identifies the Project across the platform. Between 1-32 characters. Must start with a letter and contain only lower case letters (a-z) and numbers (0-9)
153 -)))
149 +1. Provide the required information to get the Project started:
150 +1*. //Project Name//** **(can be changed later by the Project Administrator) - A short name for the project to differentiate it from other projects. Maximum 100 characters
151 +1*. //Project Code// (immutable) - Uniquely identifies the Project across the platform. Between 1-32 characters. Must start with a letter and contain only lower case letters (a-z) and numbers (0-9).
154 154  1. If desired, provide optional Project information. The Project Administrator can add or edit these later. See //Managing HDC Projects //for a detailed description of Project information.
155 155  1. Review all information for completeness, then click **Create** to create the project (or **Cancel** to exit).
156 156  1. After creating the Project, it becomes visible in the Project Landing Page.
... ... @@ -161,7 +161,7 @@
161 161  
162 162  1. Create the XWiki Project page,
163 163  1. Create the XWiki Project Group.
164 -1. Configure access for the Project Group to access the Project Page.
162 +1. Configure permissions for the Project Group to access the Project Page.
165 165  
166 166  Thereafter, when Project members click the XWiki icon from within the Project they will gain access to the XWiki Project page and will be able to create and edit content.
167 167  
... ... @@ -174,45 +174,52 @@
174 174  1*. The default wiki page for the Project is loaded with the Notice “The requested page could not be found.” This is __normal__ because the Project page has not yet been created - this is done in Step 2.
175 175  1*. Confirm the page title matches the Project code and the browser URL path and navigation breadcrumbs indicate the page’s location under the top level page: “Project Pages”.
176 176  1*. Note: If you receive an “//Error: You are not allowed to view this page or perform this action//”, then you lack sufficient administrative privilege in XWiki. Please contact another Platform Administrator with XWiki administrative privilege to grant you access.
177 -[[image:HDC Xwiki edit page to create v1.0.0 2023-07-11.png||height="18%" width="50%"]]
175 +[[image:1723654940817-472.png||height="280" width="786"]]
178 178  1. Click the link in the Notice: “**You can edit this page to create it**.”
179 179  1*. A new page opens with the **Create Page** options displayed. Under Default, click **Blank page**.
180 -1*.
181 -
178 +[[image:1723654956739-551.png||height="202" width="274"]]
182 182  1. The page editor is now open. In page editing mode, set up the basic Project page information:
183 183  1*. Change the TITLE to match the Project’s title.
184 184  1*. //Optional//: in the page edit window add a simple welcome message, such as “Welcome to the {Project Title} wiki.” to let Project members know they’ve arrived in the right place (Project members can edit this content later after they have been granted access to the Project).
182 +[[image:1723654975083-102.png||height="243" width="785"]]
183 +
185 185  1. Click **Save & View**. The page is now configured and is visible in the Navigation menu under the Project Pages top level page.
186 186  )))
187 187  
188 188  Note: HDC users can see all their Project pages in the Navigation menu but cannot access Project pages if they are not a member of that Project in the HDC Portal.
189 189  
190 -
191 191  === Creating the XWiki Project Group ===
192 192  
193 193  After creating the Project page, the next step is to create the XWiki Project Group.
194 194  
195 -**Note:** if any Project member attempts to access the XWiki Project page by clicking the Project XWiki icon before the the Platform Administrator creates the XWiki Project Group, then an API is triggered to automatically create the Group. In this case, skip this Step and proceed to the next step, //Configuring the Project wiki page access for Project members//.
193 +{{box}}
194 +**Note:** if any Project member attempts to access the XWiki Project page by clicking the Project XWiki icon __before__ the the Platform Administrator creates the XWiki Project Group, then an API is triggered to automatically create the Group. In this case, skip this Step and proceed to the next step, //Configuring the Project wiki page access for Project members//.
195 +{{/box}}
196 196  
197 +(((
197 197  1. From the upper right corner of any XWiki page (beside your User Profile) click the **Drawer icon** (three horizontal lines beside your User Profile), then click **Administer Wiki**. The **Global Administration: Home** page opens.
199 +[[image:1723655011372-773.png||height="350" width="307"]]
198 198  1. Click **Users & Rights**, then click **Groups** to access the **Global Administration: Groups** page.
199 -1. Click **Create Group** and enter the name for the XWiki Project Group according to the naming convention “hdc-{project code}”, i.e., prefix “**hdc-**” followed immediately by the Project code assigned during Project creation. For example, the Project “IndocTestP-2” with the code “indoctestp2” has the XWiki Project Group name **hdc-indoctestp2**.
201 +1. Click **Create Group** and enter the name for the XWiki Project Group according to the naming convention “**hdc-{project code}**”, i.e., the prefix “**hdc-**” followed immediately by the Project code assigned during Project creation. For example, the Project “IndocTestP-2” with the code “indoctestp2” has the XWiki Project Group name **hdc-indoctestp2**.
202 +[[image:1723655027415-926.png||height="368" width="814"]]
203 +1. **Review the Group Name before proceeding**. Formatting the Group Name incorrectly will cause the Group to be decoupled from the Project in the Portal and Project members will not be able to access the page.
204 +1. Click **Create** to finish the Group creation.
205 +1. [[image:1723655066936-299.png||height="391" width="831"]]
206 +1. Check the Groups list to confirm the new Group is present.
207 +
208 +)))
200 200  
201 -1*.Note: formatting the Group Name incorrectly will cause the Group to be decoupled from the Project in the Portal and Project members will not be able to access the page.
210 +=== Configuring the Xwiki Project Page access for Project members ===
202 202  
203 -1. Click **Create** to finish the group creation.
204 -1. Check the Groups list to confirm the new Group is present
205 -
206 -=== Configuring the Project wiki page access for Project members ===
207 -
208 208  After the XWiki Project page and the XWiki Project group have been created, the final step is to assign page rights for the group so Project Members can view their Project page.
209 209  
214 +(((
210 210  1. From the newly created XWiki Project page, click **More Actions** (three dots) at the top right of the page to open the **Manage** menu, then click **Administer Page**. The **Page Administration** menu options are now available.
216 +[[image:1723655080086-832.png||height="663" width="294"]]
211 211  1. Click **Users & Rights **> then **Rights: Page & Children**. Ensure the **Groups** radio button is selected.
212 -1. (((
213 -Locate the Group corresponding to the Project XWiki page and check the boxes under **View, Comment, and Edit** to assign these privileges to the Group.
214 -
215 -1. Note: Double check that you have assigned the permissions for the correct group before leaving the page.
218 +1. Locate the Group corresponding to the Project XWiki page and check the boxes under **View, Comment, and Edit** to assign these privileges to the Group.
219 +1. Before leaving the page, **review the configuration settings **to confirm that you have assigned the permissions for the correct Group.
220 +1*. [[image:1723655098299-387.png||height="424" width="796"]]
216 216  )))
217 217  
218 218  The Project XWiki page is now configured. Project Members with any role can click on XWiki icon from the Project to launch XWiki in a new browser tab and view the Project XWiki page. They can also open any of the other XWiki Project pages to which they have access, and the User Guide, from XWiki’s left Navigation menu.
... ... @@ -223,5 +223,57 @@
223 223  
224 224  To invite the first Project Administrator, see //Inviting New Users// in this article.
225 225  
231 += Maintenance Notifications =
226 226  
227 -
233 +[[image:1723655113847-996.png||height="178" width="863"]]
234 +
235 +Maintenance notifications inform Platform users of scheduled maintenance so they can plan their platform use around these times to minimize the impact on their work. Maintenance notifications are displayed prominently at the top of the Portal when a user logs into the platform and can be dismissed by the user. Platform Administrators can create and manage Maintenance notifications.
236 +
237 +=== Creating a Maintenance Notification ===
238 +
239 +[[image:1723655123479-904.png||height="221" width="867"]]
240 +
241 +1. Click **Platform Management** in the Main Menu, and open the **Notifications** tab.
242 +1. Enter the date, time, estimated duration, and a message to users (the window is populated with a suggested default message).
243 +1. Click **Preview **to see how the notice will appear to users. Check the information for accuracy.
244 +1. Click **Publish Now**.
245 +1. After you publish the notification, it is immediately seen by all Platform users as a banner in Portal.
246 +1. Maintenance Notifications remain posted in the Portal until you disable them. **Remember to disable the notification when the maintenance is complete or cancelled**.
247 +
248 +=== Interacting with Published Maintenance Notifications ===
249 +
250 +* More than one maintenance notification can be displayed at the same time. The banners stack on top of each other in the Portal and sort in descending order with the next upcoming maintenance window at the top.
251 +* To edit a published notification, return to the Notifications tab, select a Notification, and click **Edit**.
252 +* Users can dismiss the Maintenance notification for their current login session by clicking **x** in the banner, or forever by clicking **Don’t show again**. If a user clicks **Don’t show again**, they can still view the maintenance details up to the time the notification is disabled by clicking the **Bell icon** in the Main Menu.
253 +
254 +=== Disabling a Maintenance Notification ===
255 +
256 +After you publish a Maintenance notification, it remain posted in the Portal until you disable it. To disable a notification,
257 +
258 +1. Click **Platform Management** in the Main Menu, and open the **Notifications** tab.
259 +1. Find the published notification in the list and click to **open **it. Notifications that occurred in the past are flagged with a red dot signalling you should disable it, but you can disable any notification in the list.
260 +1. Click **X Disable Notification**.
261 +1. In the pop-up window, confirm by clicking **Disable Notification**.
262 +1. The notification is removed from the list, and users will no longer see the banner or Notification.
263 +
264 += Portal Email Service =
265 +
266 +Platform Administrators can send a short email to Platform users from the Portal Email Service. If the communication is for upcoming maintenance notice, consider using a Maintenance Notice instead.
267 +
268 +To send an email to some or all Platform users,
269 +
270 +1. Click **Platform Management** in the Main Menu, and open the **User Management** tab.
271 +1. Click **Send Email**.
272 +1. In the Email window, provide the required information:
273 +1*. Recipients - select one or more usernames, or **All Users **from the dropdown menu.
274 +1*. email Subject
275 +1*. email Content (maximum 1000 characters).
276 +1. Click** Send**.
277 +1. The email is sent to the selected recipients.
278 +
279 +----
280 +
281 +Copyright © 2023-2024 [[Indoc Systems>>url:https://www.indocsystems.com]].
282 +
283 +HealthDataCloud is powered by Pilot technology, a product of [[Indoc Systems>>url:https://www.indocsystems.com]].
284 +
Main Menu Platform Management v2.2.6 2023-04-12.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.sgevans
Size
... ... @@ -1,1 +1,0 @@
1 -4.3 KB
Content
1723654856770-216.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +5.2 KB
Content
1723654869019-473.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +160.9 KB
Content
1723654887329-788.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +192.2 KB
Content
1723654904200-429.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +81.9 KB
Content
1723654919917-639.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +59.4 KB
Content
1723654940817-472.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +126.2 KB
Content
1723654956739-551.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +382.8 KB
Content
1723654975083-102.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +79.0 KB
Content
1723655003266-405.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +127.3 KB
Content
1723655011372-773.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +127.3 KB
Content
1723655027415-926.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +156.5 KB
Content
1723655066936-299.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +167.6 KB
Content
1723655080086-832.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +448.2 KB
Content
1723655098299-387.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +184.1 KB
Content
1723655113847-996.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +118.7 KB
Content
1723655123479-904.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.dsegebarth
Size
... ... @@ -1,0 +1,1 @@
1 +125.2 KB
Content
HDC Xwiki Administer Page v1.0.0 2023-06-08.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.sgevans
Size
... ... @@ -1,0 +1,1 @@
1 +486.2 KB
Content
HDC Xwiki Administer XWiki v1.0.0 2023-07-11.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.sgevans
Size
... ... @@ -1,0 +1,1 @@
1 +121.6 KB
Content
HDC Xwiki Assign Group Permissions v1.0.0 2023-07-11.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.sgevans
Size
... ... @@ -1,0 +1,1 @@
1 +708.2 KB
Content
HDC Xwiki Confirm Group in List v1.0.0 2023-07-11.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.sgevans
Size
... ... @@ -1,0 +1,1 @@
1 +665.5 KB
Content
HDC Xwiki Create Group v1.0.0 2023-07-11.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.sgevans
Size
... ... @@ -1,0 +1,1 @@
1 +651.6 KB
Content
HDC Xwiki Create Page page cropped v1.0.0 2023-06-13.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.sgevans
Size
... ... @@ -1,0 +1,1 @@
1 +512.5 KB
Content
HDC Xwiki Project Page edit no autosave v1.0.0 2023-07-11.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.sgevans
Size
... ... @@ -1,0 +1,1 @@
1 +428.0 KB
Content
Maintenance Notifications v2.2.6 2023-04-13.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.sgevans
Size
... ... @@ -1,0 +1,1 @@
1 +553.7 KB
Content
Platform Admin Maintenance Notification v2.2.6 2023-05-23.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.sgevans
Size
... ... @@ -1,0 +1,1 @@
1 +621.2 KB
Content