<
  CFN Website    SupportSoutien  

The following NCEs have contributed to the development of the Forum:
GRAND, AGE-WELL, GlycoNet, CFN
Les RCE suivants ont contribué au développement du Forum : GRAND, AGE-WELL, GlycoNet, CFN

Difference between revisions of "Help:Contents"

From CFN Forum

(Reporting HQP graduation (inactivating HQP))
 
(4 intermediate revisions by the same user not shown)
Line 62: Line 62:
 
<tr><td>Collaborator</td><td>Project Collaborator</td><td>Someone outside of the network who is collaborating or contributing to a project</td></tr>
 
<tr><td>Collaborator</td><td>Project Collaborator</td><td>Someone outside of the network who is collaborating or contributing to a project</td></tr>
 
<tr><td>Knowledge</td><td>Knowledge User</td><td>Someone who will benefit from research in the network</td></tr>
 
<tr><td>Knowledge</td><td>Knowledge User</td><td>Someone who will benefit from research in the network</td></tr>
 +
<tr><td>Partner</td><td>Partner</td><td>Partners are organizations that contribute cash and/or in-kind resources to projects, according to terms negotiated by the applicants</td></tr>
  
 
<tr><td>Scientific Director</td><td>TVN Scientific Director</td><td></td></tr>
 
<tr><td>Scientific Director</td><td>TVN Scientific Director</td><td></td></tr>
Line 73: Line 74:
 
A user's role can change throughout their participation in TVN, and a user can assume multiple roles at the same time. Users with no roles are considered to be "Inactive".
 
A user's role can change throughout their participation in TVN, and a user can assume multiple roles at the same time. Users with no roles are considered to be "Inactive".
  
 +
=== Impersonation/Delegation ===
 +
Impersonation/Delegation is a feature which allows a user to view the forum as if they were logged in as someone else.  If you have been granted delegate access to someone's account, you will see a [[Special:Impersonate | Delegate]] link at the side tool bar.  There you will see a list of people that you are able to impersonate.  Select the person that you want to impersonate so that you can start a session.  A session lasts 6 hours, but you can renew or end the session at any time by using the options in the blue box at the top of each page.
  
 
== Forum Pages ==
 
== Forum Pages ==
Line 162: Line 165:
 
   
 
   
 
Then (once the account has been created and the HQP has received the relevant email message from the Forum) you need to indicate your supervision relation; to do that
 
Then (once the account has been created and the HQP has received the relevant email message from the Forum) you need to indicate your supervision relation; to do that
* go to edit relations [[Special:EditRelations | Edit Relations]],
+
* go to [[Special:ManagePeople | Manage People]],
* type the HQP name in the textbox under the label "Search/Add HQPs", and
+
* Add the HQP to the table by clicking the "Add Existing User" button
* select the name when it appears in the selection box below and add the HQP to the list of the HQP you supervise.
+
* click the edit icon under the Relations column
 +
* Add the "Supervises" relation
  
 
=== Reporting HQP graduation (inactivating HQP) ===
 
=== Reporting HQP graduation (inactivating HQP) ===
Line 174: Line 178:
  
 
The process to make the corresponding changes to the Forum is as follows:
 
The process to make the corresponding changes to the Forum is as follows:
* Go to the [[Special:EditMember | Edit Member]] tool and look for the HQP
+
* Go to the [[Special:ManagePeople | Manage People]] tool and look for the HQP
* If the HQP is no longer working with you on your project (but has not graduated or otherwise moved on), go to the Projects tab and unselect the project with which the HQP is no longer associated.
+
* If the HQP is no longer working with you on your project (but has not graduated or otherwise moved on), go to the Projects column and changed the End Date for to when the user left the project.
* Else, if the HQP has graduated or moved on, go to the Roles tab and unselect the HQP role.
+
* Else, if the HQP has graduated or moved on, go to the Roles column and change the End Date of the HQP role.
** You will also need to go to the HQP's profile and edit the '''HQP Alumni''' tab.  Here you will be able to enter information about when they graduated/moved on, where they are now, and enter information about their thesis.
+
** you should also go to the HQP's profile and go to the HQP Alumni tab where you have to enter:
 +
*** whether he/she has graduated or moved on,
 +
*** information about the new position of the HQP in question, and
 +
*** any additional comments you may have on the HQP
  
 
=== Products ===
 
=== Products ===
Line 202: Line 209:
  
 
=== Editing People-Project Membership Information ===
 
=== Editing People-Project Membership Information ===
 
+
To change the roles and project membership of a user, go to the [[Special:ManagePeople | Manage People]] page.
To change the roles and project membership of a user, go to the [[Special:EditMember | Edit Roles]] page.  
+
  
 
NIs can change the roles and projects of their HQP.
 
NIs can change the roles and projects of their HQP.
  
Project leaders can request changes to the membership of their projects. These requests are reviewed and approved by TVN administration.
+
Project leaders can request changes to the membership of their projects.
  
 
=== Editing My HQP list (for NIs) ===
 
=== Editing My HQP list (for NIs) ===
  
To change your list of HQP, go to [[Special:EditRelations | Edit Relations]]. The left column contains your current HQP, and the right contains the full listing of HQP. If one of your HQP is graduating, go to [[Special:EditMember | Edit Member]], where you can deselect the HQP role for them, add a comment on what they will be doing after graduation, and mention their thesis.
+
To change your list of HQP, go to [[Special:ManagePeople | Manage People]]. If you don't see the person you supervise/have a relation with then click the "Add Existing Member" button.  Once you have added the person to the table, click the edit icon under the Relations column.  This will bring up a box where you can add the relations that you have with that person, in this case the "Supervises" relation. If one of your HQP is graduating you should also go to their profile under the tab HQP Alumni, where you can add a comment on what they will be doing after graduation, and mention their thesis.
  
 
If the HQP is continuing as an HQP in TVN, but you no longer are his/her supervisor, then simply remove him/her from the left column of your HQP list.  
 
If the HQP is continuing as an HQP in TVN, but you no longer are his/her supervisor, then simply remove him/her from the left column of your HQP list.  

Latest revision as of 18:19, 24 October 2016

For general information on MediaWiki, on which the TVN Forum is based, see the MediaWiki Help Page.

FAQ

The Forum serves two fundamental purposes:

  • to enable the TVN administration collect the information it needs for reporting to the NCE Secretariat, and
  • to enable TVN researchers communicate information of interest with project collaborators, the TVN members, and potential community receptors.

With respect to administrative tasks with deadlines, specific instructions are emailed to TVN members as necessary. More generally, project members should ensure that information available on the Forum about themselves (their own profiles) and their projects is correct and up to date.

With respect to collaboration, the Forum provides a number of mailing lists for different groups, including mailing lists for each project and for different types of investigators, whose messages are archived in (and can be searched through) the Forum. Moreover, since the Forum is based on Mediawiki, anyone can create new pages within their project namespace (i.e., pages starting with their project prefix) to collaborate with project members. How the Forum will be used for collaboration is left up to the individual projects.

Access to the Forum

The general public has limited access to the Forum, including -

  • Main Project Pages
  • Researcher Pages for NIs (excluding private bio and financial contributions to TVN activities)
  • Publications, Products, Presentations and Multimedia

Forum Accounts

Typically, your Forum account ID is your name in First.Last format. If you have forgotten your account password you can request a new one, and a temporary password will automatically be emailed to the address specified in your Forum account.

  1. Go to the Main Page, your login name is in the form "First.Last".
  2. If you do not have a password, leave the password empty and click "login".
  3. Click the button labelled "E-mail new password"
  4. The system will send you a temporary password to your email address.
  5. Once you login with this temporary password, you will have to change it to a more memorable password for the long term.

User Roles

There are various types of users on the Forum. Each role implies privileges and restrictions to different areas of the Forum. Admin

BOD Chair Board of Directors Collaborator Government NCE Rep Network Investigator Research Management Comittee Scientific Advisory Board

Staff


RoleFull NameDescription
HQP/TraineeHighly Qualified PersonnelStudents, Technicians, etc.
ExternalExternal Researcher
CICo-InvestigatorA researcher who is not funded on a given project
PIPrincipal InvestigatorA researcher who is funded on a given project
PLProject LeaderThe leader of a given project
RMCResearch Management Committee
SABScientific Advisory Board
BODBoard of Directors
CollaboratorProject CollaboratorSomeone outside of the network who is collaborating or contributing to a project
KnowledgeKnowledge UserSomeone who will benefit from research in the network
PartnerPartnerPartners are organizations that contribute cash and/or in-kind resources to projects, according to terms negotiated by the applicants
Scientific DirectorTVN Scientific Director
Associate Scientific DirectorTVN Associate Scientific Director
StaffTVN Staff
ManagerTVN Network Manager
AdminTVN Administrator

A user's role can change throughout their participation in TVN, and a user can assume multiple roles at the same time. Users with no roles are considered to be "Inactive".

Impersonation/Delegation

Impersonation/Delegation is a feature which allows a user to view the forum as if they were logged in as someone else. If you have been granted delegate access to someone's account, you will see a Delegate link at the side tool bar. There you will see a list of people that you are able to impersonate. Select the person that you want to impersonate so that you can start a session. A session lasts 6 hours, but you can renew or end the session at any time by using the options in the blue box at the top of each page.

Forum Pages

Project pages

The Main tab of the project contains all the project-related information available to the general public:

  • Project Name: The full name of the project.
  • Project Theme: The TVN theme in which the project belongs.
  • Project Leader(s): The leader(s) of the project, with links to their wiki page.
  • ARs: The Affiliated Researchers in the project
  • HQPs: The Highly Qualified Personnel in the project
  • Collaborators: The collaborators from the project
  • Project Overview: The description of the project, as written by the Project Leaders.

Further, Forum users (that are not associated with the project) can also see the Dashboard and the Visualizations tabs of the Project.

The Dashboard is designed to provide an overview of project and researcher activity in TVN. The data reported in the dashboard has already been input to the Forum through the various functionalities of the Toolbox (the sidebar to the left of the Forum user interface). The table has several columns:

  • People, the names of the project leaders, NIs.
  • Roles, their roles within the project.
  • Publications, all project-related publications co-authored by the any of the Project NIs. Publications are of different types, but in principle should appear in archival venues and can be cited.
  • Products, all project-related artifacts co-produced by any of the Project NIs. Artifacts include curated data repositories, open-source software, and artistic works. They are annotated as "peer reviewed" or "non peer-reviewed".
  • Presentations, all project-related presentations in which any of the Project NIs were involved. Presentations include paper sessions, keynote speeches, and panel discussions, as given at workshops, seminars, and conferences.

The Visualizations of project activity include several tabs:

  • Timeline, a Gantt chart showing the involvement of each contributor over the years.
  • Productivity Chart, a pie chart showing the output within each year, within other projects, and as co-authors.
  • Relations, a chord diagram showing the co-production (and other) relations among the project members.
  • Tag Cloud, of the important terms appearing in the project's products.

Project leaders have access to the Project Budget, displayed as a roll-up of the individual NIs Project-related budgets.

Researcher Pages

Each TVN contributor has a page that describes their activities. This page is accessible -

  • By searching for the person's name through the search box at the top of the page (right next to the TVN logo).
  • By clicking on any of the HQP, NIs or RMC tabs, then selecting the person's name from the list. Click first on the TVN tab under the TVN logo if these tabs are not visible.

Each Researcher Page has several tabs:

  1. Contact: The name, role(s), email, title, university, and department of the researcher. Additional information may be available:
    • Twitter: This link is generated if the user has edited their preferences with their twitter handle. The link will go to a page with their most recent tweets.
  2. Profile: A short bio of the researcher. Every user has both a public and private profile. The public profile is accessible without login, while the private profile can only be accessed by members of the Forum.
  3. Projects: A list of projects that this researcher is a part of, linking to the relevant project pages.
  4. Relations: For researchers supervising HQP, a Supervises table shows the start and end dates, position, projects, and name of the supervised HQP. For HQP, a Supervisors table lists all their supervisors.
  5. Dashboard: As for the Project Pages, a table is displayed that lists the member's Projects, either HQP (if supervisor) or Supervisors (if supervised), Publications, Artifacts, Presentations, Press, and Awards.
  6. Visualizations: As for the Project Pages, visualization tabs show a Timeline Gantt chart, a Productivity pie chart, and a Network diagram of the member's projects and relations to other members.

Product Pages

When the TVN tab is selected under the TVN logo, tabs include access to the Publications (and other product types) created by TVN members. Each of these tabs displays a table that lists the Date, Category/Type, Title, Authors, and Projects of each product. If more information is available, the Title will link to product details, and individual author names will link to their profile pages.

Once logged in, a TVN user can edit any product. Editing a publication will generate notifications to all the authors previously and currently listed for the product.

Finding information in the Forum

TVN Tabs

Main entities in the Forum are grouped and listed by type under the TVN tabs. They are visible after clicking on the TVN tab under the TVN logo.

Most of these pages include a search box at the top of the page that filters table content. For example, the researcher-listing pages can be filtered by name, project, or university.

Global Search

You can use the Global Search located at the top left of any page to search for most entities in the Forum. The entities that you can search for are:

  • People
  • Projects
  • Outputs
  • Wiki Pages

Adding information to the Forum

Adding a new member (HQP)

To add a new member to the Forum, use the Add Member page. The form is submitted to the Forum administrator, who will review and approve the request. Make sure to specify the roles and projects of the new user.

More specifically, when creating a new account for a new HQP,

  • go to Add Member,
  • enter the HQP data (First and Last name),
  • define the role for the new account, by selecting the HQP checkbox, and
  • associate the new HQP with the projects on which s/he works, by selecting the checkboxes corresponding to these projects.

Then (once the account has been created and the HQP has received the relevant email message from the Forum) you need to indicate your supervision relation; to do that

  • go to Manage People,
  • Add the HQP to the table by clicking the "Add Existing User" button
  • click the edit icon under the Relations column
  • Add the "Supervises" relation

Reporting HQP graduation (inactivating HQP)

When a HQP moves on, you have to indicate this change on the Forum. In general, there are many types of changes that can occur in the NI-HQP relationship:

  • the HQP may stop working on a project;
  • the HQP may graduate; or
  • the HQP may simply move on.

The process to make the corresponding changes to the Forum is as follows:

  • Go to the Manage People tool and look for the HQP
  • If the HQP is no longer working with you on your project (but has not graduated or otherwise moved on), go to the Projects column and changed the End Date for to when the user left the project.
  • Else, if the HQP has graduated or moved on, go to the Roles column and change the End Date of the HQP role.
    • you should also go to the HQP's profile and go to the HQP Alumni tab where you have to enter:
      • whether he/she has graduated or moved on,
      • information about the new position of the HQP in question, and
      • any additional comments you may have on the HQP

Products

Under the general term "Forum Products", we include Publications, Presentations, Artifacts, Activities, Press, and Awards. All are rolled up in the various Dashboards.

To add or edit your products, you can go to Manage Products link in the sidebar. You will be shown a table with all the products which you are currently associated with (what this entails is described in detail below, and on the Manage Products page).

There are several ways to add products to the Forum. Each option opens up a dialogue where you will see the following

  • Add Product: This is how to add a single product to the Forum. You need to enter in at least the title, category, and type for it to be added to the Forum.
  • Add From DOI: You can import a single product from a DOI (Digital Object Identifier). Please note that not all products will be able to be imported from doi.
  • Upload CCV: You can upload your Canadian Common CV (the XML document downloaded from ResearchNet). Any product that can be read into the Forum will automatically imported, but will not be visible to anyone else on the Forum except you. The product will be placed in a separate "private" queue, and can be released to the rest of the Forum by unchecking the "private" checkbox in the Product Management table. This way any unwanted products will not get added to the Forum, and also gives you a chance to make changes to the product and associate it with projects before releasing it. A product will not get added twice into the Forum, so uploading the CCV a second time will generally not result in duplicate entries.
  • Import BibTeX: You can import BibTeX references by pasting all your BibTeX references in the form. Any product that can be read into the Forum will automatically imported, but will not be visible to anyone else on the Forum except you. The product will be placed in a separate "private" queue, and can be released to the rest of the Forum by unchecking the "private" checkbox in the Product Management table. This way any unwanted products will not get added to the Forum, and also gives you a chance to make changes to the product and associate it with projects before releasing it.

Products will show up in this list if one of the following conditions is true.

  • You are listed as being one of the authors; or
  • One of your HQP is listed as being one of the authors (only applicable to Supervisors).

Products which are listed as being 'Private' will not show up anywhere else on the Forum except from on this page. To "release" the product to the rest of the Forum, uncheck the Private checkbox. Once all of your changes are done, make sure to press the Save All button.

The addition and/or editing of a product will send notifications to all persons previously and currently associated with the publication.

A typical cause of "publication not showing up" is that it is not associated with the right persons (as authors) and/or projects. There are two lists of all publications in the Forum; the first one lists the publications recognized as belonging to TVN - [1]; the second includes publications that are not recognized as belonging to TVN (because they are not associated with projects). The correct associations can be made by editing a product.

Editing People-Project Membership Information

To change the roles and project membership of a user, go to the Manage People page.

NIs can change the roles and projects of their HQP.

Project leaders can request changes to the membership of their projects.

Editing My HQP list (for NIs)

To change your list of HQP, go to Manage People. If you don't see the person you supervise/have a relation with then click the "Add Existing Member" button. Once you have added the person to the table, click the edit icon under the Relations column. This will bring up a box where you can add the relations that you have with that person, in this case the "Supervises" relation. If one of your HQP is graduating you should also go to their profile under the tab HQP Alumni, where you can add a comment on what they will be doing after graduation, and mention their thesis.

If the HQP is continuing as an HQP in TVN, but you no longer are his/her supervisor, then simply remove him/her from the left column of your HQP list.

On the same form, NIs can edit the list of people with whom they work closely.

Communication

Notifications

Many of the features on the Forum create notifications for various actions. For example, if someone changes your project membership on the Forum, you and the project leader will both be notified. The number of notifications that you have are listed in the My Notifications tab in the page header. Click the tab to view the notifications. The notification is deleted once you have viewed the page that the Notification links to.

Project Wiki Pages

To access wiki page for your project, go to the Project's main page and select the "Wiki" tab (this tab will only be available if you are a member of the project). You will see a table of the existing wiki pages. Clicking the title will bring to the wiki page and you will be able to edit it by hovering over the "Actions" dropdown in the top right corner and clicking the "Edit" option. If you would like to create a new wiki page click the "New Wiki Page" button on the "Wiki" tab of the project's page.

Mailing Lists

Generally speaking, projects will have their own mailing list which is automatically managed by the Forum. Furthermore, there may be role specific and university specific mailing lists. You can view the archives of these lists by going to the My Mailing Lists page. You will only be able to able to view the archives of the lists you are currently in. You can unsubscribe from a list on this page as well by checking checkbox in the unsubscribe column. This will remove you from the list, and prevent you from being re-subscribed to it again in the future.