The training catalogue is an online webspace within EOSC-hub website for publishing training materials and advertising training events.
It is based on Drupal (v7.58), and supports local and Identity Federation mechanism based on the OIDC protocol. The overall architecture of the catalogue is based on the EOSCpilot “D7.2 – Interim report and catalogue of EOSC skills training and educational materials”.
The EOSC-hub Training Catalogue (also referred as catalogue in the rest of this document), includes two web areas:
Training Materials: https://www.eosc-hub.eu/training-material/. Initially, we distinguish two categories of training materials:
- Generic training materials for EOSC-hub services: these training materials will finally be linked to EOSC-hub service catalogue providing as reference documents for users to get to know about the services.
- Other materials related to EOSC-hub service training, e.g. from various training events.
Training events: https://www.eosc-hub.eu/training-events/, this area will include all the list events delivered in the context of the project, including: webinars, face-to-face training, tech. talks, workshops, etc.
Only authorised members can add and/or modify training related content. Each authorised member may have one of the following access rights:
Training Editor (TE): This user can only insert and modify contents into the training catalogue.
Training Admin (TA): This user not only can only insert and modify contents into the training catalogue as the TE, but he/she can also moderate the publication and deletion of training materials. TAs can also grant or deny roles to other members.
Before to add and/or edit any content in the training catalogue, the trainer has to ask for the ‘Training Editor’ role.
HowTo
To get this role, please contact: training@mailman.eosc-hub.eu.
How to add new entries in the Training Catalogue
Before to insert a new ‘Training Event’, a good practice suggests to start fill first ‘Contacts’ related to involved people, then the ‘Training Materials’. It is also possible to insert directly the Training Event but the insertion procedure becomes much more complex and requires a little skill in Drupal web content insertion.
Login
Connect to the EOSC-hub web site and access selecting one of the available authentication services. You can select the authentication services to access from the right side of the web pages related to the training:
Warning: In case you decide to access the catalogue with the EGI AAI Check-In service, please remember that you need to be registered as a member of the EGI community. To join this community, just visit first the website: https://aai-dev.egi.eu/signup and follow the instructions.
Add a new contact
If you have the correct rights, in the top level menu of the EOSC-hub web site, it is possible to select the voice: Add Content ➔ Contact
A web form appears and once it has been completed it will be possible to preview or save the new content. Mandatory fields are marked with a red asterisk beside the form labels.
Repeat this procedure for all people involved in the training event and responsible of training materials. The full list of text fields requested to add a new contact are available in Appendix.
Add a new contact
Training materials are viewable by the URL: https://www.eosc-hub.eu/training-material.
All events are shown sorted by ‘date created’ field and one or more search filters can be applied using several filters specified at the top of the page.
In case training materials are already available in the agenda of the training event, there is no need to register training materials in the catalogue, since the link of the training home page or agenda is one of the requested field. It is also possible to register external referenced training materials in the training events catalogue.
To insert a new training material, select from the top menu: Add Content ➔ Training Material
and provide the information requested in the dedicated web form:
Mandatory fields are marked with a red asterisk. Once the web form has been completed it will be possible to preview or save the new content. Repeat this procedure for all training materials involved in the training event.
Training materials require the moderation of ‘Training Admin’ users who can decide to public the new material and make it publicly available or reject it.
To publish the new material, the ‘Training Admin’ has to select the check box ‘Publish’ under Publishing Options placed at the bottom of the insertion/edit web form as shown in the figure below
The full list of text fields requested to add a new training material are available in Appendix.
Add a new training event
The full list of training events sorted by the event’ starting date are available at: https://www.eosc-hub.eu/training-events. One or more filters can also be selected to search for some specific events.
To insert a new training event, select from the top menu: Add Content ➔ Training Event
and provide the information requested in the dedicated web form:
Mandatory fields are marked with a red asterisk. Once the web form has been completed it will be possible to preview or save the new content.
Training events DO NOT require the moderation of ‘Training Admin’ users, so that the publishing responsibility is directly assigned to the user compiling the form. In order to publish the content, just select the check box ‘Publish’ under Publishing Options placed at the bottom of the insertion web form.
The full list of text fields requested to add a new training event are available in Appendix I.
Manage training roles
Role management may be necessary to grant or revoke the Training roles: Training Admin (TA) or Training Editor (TE) among registered members. Only users with the Training Admin role can grant or revoke training roles to other users.
To manage training roles:
- Select ‘People’ from the top bar menu;
- Identify the user from the list;
- Access to the user’s profile page and set the role;
- Save the preferences.
At this point, the list of all registered members will be displayed and the user to grant/revoke training roles has to be identified in the list. Then, click on the edit label in the user record in order to access the user’ details page. In the new displayed page, under the label ‘Roles’ it is possible to add/revoke one of the two training roles. At the end, press ‘Save’ button to apply the changes.
Appendix
Terminology
Since the Training Catalogue has been developed with Drupal, several terms are described below in order to clarify their meaning later used by the next chapters.
- Content Type: Drupal uses ‘Content Type’ entity to register new web page contents. For the Training Catalogue the Content Type can be seen as a database table storing the information about Training Catalogue’ records, in particular: ‘Training Event’, ‘Training Material’, ‘Contact’, etc.
- Taxonomy: These entities are used to collect set of values to be used by the ‘Content Type’ input forms.
