Contributions old: Difference between revisions

From Help
m (Mangion moved page Contributions to Contributions old)
 
(104 intermediate revisions by 3 users not shown)
Line 93: Line 93:




[[File:Default_view.jpg|550px|center]]
[[File:Default_view.jpg|250px|center]]




Line 109: Line 109:
To order your selected columns use the up and down button on the right of the pop-up screen.
To order your selected columns use the up and down button on the right of the pop-up screen.


==CREATE A CONTRIBUTION==
==Creating a Contribution==


'''IMPORTANT: Only logged users can reserve/upload contributions.'''
'''IMPORTANT: Only logged users can reserve/upload contributions.'''
Line 115: Line 115:
There are two places on the portal from which a user can reserve a contribution:
There are two places on the portal from which a user can reserve a contribution:


* From the Portal [[Contributions_Portlet|Contributions portlet]] by clicking on the "contribute" button
* From the Portal [[Contributions_Portlet|Contributions tab]] by clicking on the "New contribution" link and selecting a contribution type in the drop-down menu.


[[File:Contribution_Portlet.jpg|450px]]
[[File:Contribution_Portlet.jpg|600px]]




* From the Contribution application itself by clicking on "New contribution"
* From the Contribution application itself by clicking on "New contribution" button.
 
[[File:New_contribution.jpg|500px]]


[[File:New_contribution.jpg|150px]]




After having clicked on one of these buttons, a pop-up opens asking you to choose your [[Contribution_type|contribution types]].


=== Contributing a Meeting Agenda, a Meeting Report, a Change Request, a Liaison Statement, or an "Other contribution" type ===
=== Contributing a Meeting Agenda, a Meeting Report, a Change Request, a Liaison Statement, or an "Other contribution" type ===
Line 135: Line 135:


The '''Contribution Creation''' screen opens on the '''General''' tab.
The '''Contribution Creation''' screen opens on the '''General''' tab.
==== The General tab ====
==== The General tab ====
[[File:Contribution_Creation.jpg|450px|center]]
[[File:Contribution_Creation.jpg|450px]]


Several attributes need to filled, these attributes will allow categorization and retrieval of contribution documents.  
Several attributes need to filled, these attributes will allow categorization and retrieval of contribution documents.  


All attributes except ''Contact'' and ''Abstract'' are mandatory.
:* '''Title''': free text


:* '''Input for Committee''': group to which the contribution will be submitted
:* '''Title''': free text
:* '''Source''': When clicking on the "Change" button near the field "Source", a pop-up "'''Manage Source'''" opens (see figure below). 4 different types of Source are available:  
:* '''Source''': When clicking on the "Change" button near the field "Source", a pop-up "'''Manage Source'''" opens (see figure below). 4 different types of Source are available:  
:** Organisations: a company allowed to contribute to the technical work of a committee
:** Organisations: a company allowed to contribute to the technical work of a committee
Line 152: Line 151:
[[File:Manage_Source.jpg|450px|center]]
[[File:Manage_Source.jpg|450px|center]]


:* '''Main Contact''': Is set automatically to the submitter's name of the contribution this field can be enriched by an additional contact in the text field.


:* '''Contact''': Free text
:* '''Input for Committee''': group to which the contribution will be submitted
 
:* '''Contribution for''': to inform the committee whether your contribution is '''for Decision''', '''for Discussion''', or '''Information'''
:: In case your contribution is for decision you then have to describe the expected decision by filling in the "'''Decision/Action requested'''" box


:* '''Meeting - Allocation''':
:* '''Meeting - Allocation''':
Line 167: Line 170:
Selecting a meeting (and an allocation) in the list(s) will display further information in the grey box below. Once the correct selection is made, you can ssign the contribution to your selected meeting with the [Assign] button. The assignment will be effective after saving your contribution.
Selecting a meeting (and an allocation) in the list(s) will display further information in the grey box below. Once the correct selection is made, you can ssign the contribution to your selected meeting with the [Assign] button. The assignment will be effective after saving your contribution.


:* '''Document For''': to inform the committee whether your contribution is '''for Decision''', '''for Discussion''', or '''Information'''
:* '''Related WIs or deliverables''': You can also attach your contribution to an existing Work Items or deliverable. click on the ''Change'' button
:: In case your contribution is for decision you then have to describe the expected decision by filling in the "'''Decision/Action requested'''" box
:* '''Abstract''': Free text summarizing the content of the contribution
You then have the possibility to link your contribution to a meeting.
 
==== The Related Work Items tab ====
You can also attach your contribution to a related work item


[[File:Related_WI.jpg|450px]]
[[File:Related_WI.jpg|450px]]


The system displays all the work item attached to the committee you contribute for, the text field allow you to filter the content of the box or to search for other ETSI work items. It is possible to select more than one work item. Select one Work item in the displayed list and click the "Add" button, the selected work item appears on the left part of the pop-up with a red cross which allow you to remove it.
The system displays all the work items attached to the committee you contribute to, the text field allow you to filter the content of the box or to search for other ETSI work items. It is possible to select more than one work item. Select one Work item in the displayed list and click on the "Add" button, the selected work item appears on the left part of the pop-up with a red cross which allow you to remove it. then click on the "Done" button.
 
:* '''Abstract''': Free text summarizing the content of the contribution
You then have the possibility to link your contribution to a meeting.


==== The Related Contributions tab ====
==== The Related Contributions tab ====
Line 190: Line 190:


==== Saving your contribution ====
==== Saving your contribution ====
Your contribution can now be Saved.
Your contribution can now been saved.


Note: The information in relation to ''Related Work items'' and ''Related Contributions'' are not mandatory, the contribution can be saved as soon as the attributes from the General Tab are filled (except for ''New WI proposals'' and ''New Drafts'').
Note: As soon as all the mandatory fields from the General Tab have been filled in, the contribution can be Saved(except for ''New WI proposals'' and ''New Drafts'').


Once you click on the Save button, it will receive a Unique contribution Identifier (UID) and a new record will be added to the contribution database.
Once you click on the Save button, it will receive a Unique contribution Identifier (UID) and a new record will be added to the contribution database.
Your contribution appears now with status '''RESERVED'''.
Your contribution appears now with status '''RESERVED'''.


[[File:Contribution_reserved.jpg|600px|center]]
[[File:Contribution_reserved.jpg|550px]]


'''The next steps are:'''
'''The next steps are:'''
Line 207: Line 207:




* Edit the cover page, add your content, and save it on your computer.
* Edit the contribution details and update


<html>
<html>
Line 219: Line 219:
<iframe width="420" height="345" src="http://www.youtube.com/embed/nTQ420t1w9A" frameborder="0" allowfullscreen></iframe>
<iframe width="420" height="345" src="http://www.youtube.com/embed/nTQ420t1w9A" frameborder="0" allowfullscreen></iframe>
</html>
</html>
You can Make available a contribution from the detailled view of the contribution (accessible from the portlet and from the full list view) by clicking on the "Upload/Make Available" button.
Or you can Upload a contribution from the full list view by clicking on the [upload] Icon on the line of the RESERVED contribution:
[[File:Make_ava_from_list.jpg|550px]]


==== Revising a contribution ====
==== Revising a contribution ====
Line 226: Line 234:
</html>
</html>


===Contribute a New Work Item (NWI) proposal===


When informing the system that you intend to contribute a New WI proposal by ticking it in the list of contributions types, a pop-up appears explaining that you won't be able to change the type of your contribution in the next steps. As the new work item is treated in different manner as the other contributions.
You can Revise a contribution from the detailled view of the contribution (accessible from the portlet and from the full list view) by clicking on the "Revise" button.


====Create a New Work Item Proposal====
Or you can Revise a contribution from the full list view by clicking on the [Revise] Icon on the line of the AVAILABLE or NOTED contribution:
 
[[File:Revise.jpg|550px]]
 
===Contribute/Create a New Work Item Proposal===
To create a New Work Item (NWI) proposal, log in the ETSI portal with your EOL account and click on the Technical Body you intend to contribute to.
 
[[File: Login_banner.png|700px|center]]


<html>
<iframe width="420" height="345" src="http://www.youtube.com/embed/AG-jFcUPEcU" frameborder="0" allowfullscreen></iframe>
</html>


In the Contributions portlet, click on "New contribution" and select the type "New WI Proposal / Description" from the drop down list.


[[File: Newcontrib_droplist.png|550px|center]]




To create a NWI proposal, you first need to fill in the attributes from the general tab:
To create a NWI proposal, you first need to fill in the attributes from the general tab:


[[File: NWIgeneral_tab.png|500px|center]]




[[File:Contribution_Creation.jpg|450px|center]]
After having filled in the attributes from this tab, then click on "WI Details" tab.
This tab reflects the content of the New Work Item sheet you are used to utilize.  


[[File: WIdetails_complete_NWI.PNG|600px|center]]




Fill in the following mandatory attributes in order to present the proposal to the community:


After having filled in the attributes from this tab, then click on "next " button or select the tab "WI details" from the top bar menu:
:* ‘‘‘WI committee’’’


:* ‘‘‘Deliverable’’’
: Select either a New Work Item or Revision of an Existing Work Item. 


:* ‘‘‘Formal Title 1 and 2’’’
: If it is a Revision, the system will retrieve most information from the ETSI Work Programme.


[[File:NWI_tab.jpg|450px|center]]
:* ‘‘‘Scope of the work’’’




You can present your contribution to the chosen Committee with only those 4 fields filled in. Nevertheless you will need to inform the system about the other fields in order to be able to "accept" this Work Item.
In addition to the above listed fields, the following fields are mandatory to pass the Work Item proposal from the status "available" to "accepted":
:* ‘‘‘Standard type’’’
: Choose in the drop down list from the six ETSI deliverable types: EN, TR, TS, EG, ES, GS
:* ‘‘‘To be published as version’’’
: If it is a New Work Item, then by default, the version will be 1.1.1
:* ‘‘‘Requested WI reference’’’
: The system will automatically attribute the next available number.
:* ‘‘‘Rapporteur’’’
: Enter the name of the rapporteur, the system will propose matching results and complete the entry automatically.
:* ‘‘‘Supporting Companies’’’
: A minimum of 4 supporting companies is requested. Click on the button “Add/Remove” and enter the name in the new window. Double click to select and add the company. The company’s details appear at the bottom. When done, click “Done” to save the selection and close the window.
[[File: Add_supp_orga.PNG|450px|center]]
:* ‘‘‘Schedule’’’
: A NWI proposal needs at least the TB adoption, WG and TB approval dates in the schedule in order to be accepted.
: ‘‘‘Note: For deliverable type EN’’’, an extra line will appear. Select the Procedure, whether or not it is a Harmonized Standard and Mandate if applicable. 
:* ‘‘‘Keywords’’’
: To select the Keywords, click on “Add/Remove”. Search the keywords and add them with a double click. Click “Done” to save the selection and close the window.
‘‘‘IMPORANT NOTE: If this a Revision of an existing Work Item’’’, then you can enter the ETSI number (e.g. EN 383 001) or the reference of the Work Item to be revised (e.g. DEN/TISPAN-03008) and the system will retrieve all the information available from the Work Programme.
Example of a NWI revision:
[[File:WIdetails_complete_revision.PNG|450px|center]]
==== Check your Work Item Proposal ====


This tab reflects the content of the New Work Item sheet you are used to utilize.
To make available (reserve and upload) a NWI proposal you need to inform the following fields:
- WI committee
- Titles (Formal Title, Formal Title 2)
- Scope of the work


You can present your contribution to the chosen Committee with only those 3 fields filled in. Nevertheless you will need to inform the system about the other fields in order to be able to "accept" this Work Item.
During the creation of the Work Item Proposal, the system displays a warning on the top right corner of the WI details tab.


In addition to the above listed mandatory fields, the following fields are mandatory to pass the Work Item proposal from the status "available" to "accepted":
It will display “WI proposal is NOT READY” until all the mandatory fields necessary to accept the proposal are filled in.  You may mouse over this warning to see what information is missing.


- Deliverable: New or revision of an existing standard


Note: If this new work item proposal is the revision of an existing Work Item, then you can enter the ETSI number (e.g. EN 383 001) or the reference of the Work Item to be revised (e.g. DEN/TISPAN-03008) and the system will retrieve all the information available from the Work Programme.
[[File:Warning_with_info.png|400px|center]]


- Standards type: EN, TR, TS, EG, ES, GS


- To be Published as Version
The warning is refreshed automatically.
Once the Work Item is complete and ready for approval, the system will display the following warning:


- Working Title


- Rapporteur
[[File:Warning_green.PNG|550px|center]]


- Supporting Companies


- Schedule
To save your proposal, click on the "Save changes" button, at the bottom of the window. The system retrieves your contribution details.


- Keywords


Note: A button "Check Work Item proposal" allows you to check whether your contribution is ready for approval, with all needed attributes filled in or not. If not, then the system informs you of the missing fields.
: '''If the proposal is incomplete:'''


[[File:Check_WI_proposal.jpg|450px|center]]
: You may leave your contribution in the "reserved" status and complete it later on. Click then on “Complete later”.  


Then click on "save" button.
The systems retrieves your contribution details.
You can leave the application at any time leaving your contribution in the "reserved" status or you can "upload/make it available" from this screen:


[[File:Make_available_WI.jpg|450px|center]]
[[File:WI_not_complete.PNG|350px|center]]


====Update and Progress an existing Work Item====


<html>
: '''If the proposal is complete:'''
<iframe width="420" height="345" src="http://www.youtube.com/embed/hvKtioco0SY" frameborder="0" allowfullscreen></iframe>
</html>


Should you have created a New Work Item at Working Group/Task Group level and got it approved by this WG/TG. You will need to get it approved by the Parent Technical Body.
: You may leave your contribution in the "reserved" status and make it available later on. Click then on “No later”.  
To do that you need to create a new contribution, choose the type "New Work Item", fill in the data under the "General" Tab, select the "WI Details Tab" and select the button "Update and Progress an existing Work Item (See below). The system enable a new field called "Existing Proposed Work Item (PWI)", in this drop down list the system is asking you to choose the PWI you want to progress and contribute to the parent community.


Note: The PWI of the Work Item you've contributed to the WG.TG can be found on the contribution file.


[[File:Update_and_progress_WI.jpg|450px|center]]
[[File:Pop_up_save_complete.PNG|350px|center]]


When selecting the PWI refernece in the drop down list, the systems retrieves all data from the first creation of this Work Item


[[File:Update_and_progress_WI2.jpg|450px|center]]


You can then attach your contribution to a meeting, related Work Item or Related contribution and click on "Save".
In either case, you will see a confirmation that you contribution has been reserved, with the contribution number allocated.


The systems retrieves your contribution details.
You can leave the application at any time leaving your contribution in the "reserved" status or you can "upload/make available" from this screen:


[[File:Make_available_WI.jpg|450px|center]]
[[File:Confirmation_reserve.jpg|550px|center]]


====Make available a Work Item Proposal====
====Make available a Work Item Proposal====


<html>
<iframe width="420" height="345" src="http://www.youtube.com/embed/Pn192-ksTFs" frameborder="0" allowfullscreen></iframe>
</html>


You can make available a Work Item proposal which is in "Reserved" Status.
You can make available a Work Item proposal which is in "Reserved" Status.
To make it available you need to proceed to the upload of the contribution which is done automatically for this type of contribution.
To make it available you need to proceed to the upload of the contribution which is done automatically for this type of contribution.


Note: For the Work Item Proposal Contribution, there is no need to get cover page as the system will take all data and generate it automatically.


It is possible to upload the file from two destinations:
NOTE: For the Work Item Proposal Contribution, there is no need to get cover page as the system will take all data and generate it automatically.
 


1) From the reservation confirmation screen
There are two ways of making available a New Work Item Proposal.


[[File:Confirmation_reserve.jpg|400px|center]]
: '''From the “Save changes” button'''
: If you wish to make your proposal right away, click “Yes now”.


Click on "upload/make available", a pop-up is displayed


[[File:Automatic_generation.jpg|400px]]
[[File:Pop_up_save_complete.PNG|350px|center]]
 
 
You will be redirected to the following screen.
 
 
[[File:Automatic_generation.jpg|450px|center]]
 
 
 
: '''From the reservation confirmation screen'''
 
 
[[File:Confirmation_reserve.jpg|450px|center]]
 
 
Click on "Upload/Make available", a pop-up is displayed
 
 
[[File:Automatic_generation.jpg|450px|center]]
 


Select if you wish to upload a cover page from your computer or if you want it to be generated by the system itself and then click on "Make Available" and the system will generate a zip file with the cover page and the Work Item sheet.
Select if you wish to upload a cover page from your computer or if you want it to be generated by the system itself and then click on "Make Available" and the system will generate a zip file with the cover page and the Work Item sheet.


Your New Work Item proposal is now in status "Available".
Your New Work Item proposal is now in status "Available".
[[File:NWIavailable.png|550px|center]]
''At this stage, updating the proposal is still possible, however it requires to'' [Revise] ''the contribution.''
===== The Preliminary Work Item number (PWI) =====
Once a NWI contribution is reserved and or made available to the community, a Preliminary Work Item number (PWI) is attributed. It is the identification number of the Work Item until it is approved at the Technical Body level.
The PWI number consists of the following:
::::::  '''“PWI_TBname_Year+sequence number_version”'''
(For example, PWI_TETRA01_1204_1 is a proposed Work Item to TETRA WG1, the 4th proposal in 2012 and it is currently version 1 of the proposal).
That PWI number is visible on top of the WI Details tab in the NWI proposal:
[[File:PWI_WI_details_tab.PNG|350px|center]]
It can also be found in the contribution file, in the New Work Item sheet:
[[File:PWI_WI_sheet.png|500px|center]]


====Change the status of a contribution of type NWI proposal====
====Change the status of a contribution of type NWI proposal====


<html>
<iframe width="420" height="345" src="http://www.youtube.com/embed/NgsuW8fS8v0" frameborder="0" allowfullscreen></iframe>
</html>


===Contribute a draft===
To change the status of the contribution, go the Contribution portlet.
 
Click on the [[File:Glasses_icon.PNG]] on the line of your contribution. This will open the details of the contribution.
 
 
[[File:Status_buttons.png|550px|center]]
 
 
 
There are four changes possible changes to the status:
: '''Accept'''
: '''Reject'''
: '''Note '''
: '''Withdraw'''
 
 
Click on the appropriate status button. A pop-up will open allowing you to enter some comments 
 
 
[[File:Status_confirm_popup.png|350px|center]]
 
 
 
Click “OK”. The status is updated in the General tab of your contribution:


Before to contribute a draft to a TB or WG, the draft MUST first be uploaded on the ETSI server via the '''Latest Drafts''' application.
====Uploading a draft with the Latest Draft application====
Uploading a draft with the Latest Draft application is the only way to make the system aware of the availability of a draft and of its relation with a specific version of a Work Item.
The '''Latest Draft''' application is available on every Technical Body's homepage.


[[File:Latest drafts.jpg|450px|center]]
[[File:Gen_tab_Accepted_status.png|550px|center]]


To upload a new version of a draft: click on the [[File:Manage_draft.jpg|15px]] next to the Work Item reference for which you want to upload a draft. This [[File:Manage_draft.jpg|15px]] will allow you to ''upload a new version'' of a draft, to ''assign a status'' to this draft by choosing a Maturity Milestone ("Early draft ", "Stable draft", or "Final draft for approval") and to ''manage the target dates'' for these Maturity milestones.


Note: If it is the first time a draft is uploaded for a given Work Item, the system will then display a pop-up allowing you to define an optional sub-folder where all drafts versions for this Work Item will be grouped:
You can define this optional sub-folder by modifying the Work Item path, or leave the system's suggestion and click on the "Save" button.


[[File:First_upload_draft.jpg|350px]]
From this same screen, you may progress the Work Item to the parent Technical Body for adoption.  




The following pop-up window is then displayed:
See description under section [[Contributions#Progress_the_New_Work_Item_to_the_Technical_Body|Progress the New Work Item to Technical Body]] of the Contribution application helpfiles.


==== Progress the New Work Item to the Technical Body ====


[[File:Manage_your_draft.jpg|300px]]


Should you have created a New Work Item at Working Group/Task Group level and got it approved by this WG/TG; you will need to get it approved by the Parent Technical Body.


To upload a new version of a draft, select in the above screen "the upload new draft button", then click on the browse button and choose your file from your computer.


Should you wish to change the status of this draft, select it in the new status drop down list.
To do that click on the [[File:Glasses_icon.PNG]] in the contribution application for the concerned NWI proposal.  


You can also "Manage target dates" for this draft by clicking on the button related:


[[File:Manage_target_dates.jpg|300px]]
In the contribution General tab, click on [[File:Submit_tbappr_button.PNG|170px]]


Click on "Save" should you change these target dates and then clcik on "Save" to confirm the upload of your draft. The system displays a upload confirmation message.
Your draft has been succesfully uploaded.


====Contribute a draft from the Latest drafts application====
A drop down list appears with all the upcoming meeting of the parent Technical Body. Select the meeting the contribution should be attached to, or “No meeting” if applicable.  
Now that your draft is available of the latest drafts server you can contribute it from this application by clicking the [[File:Contribute.jpg|15px]] button that will directly drive you to the creation screen of the contribution application.


[[File:Contribute_a_draft.jpg|400px|center]]


The "General" Tab is pre-filled with all information the system could retrieve from the Latest draft application. Fill-in the Title, choose whether your draft is for information, discussion or decision, you can type free text in the abstract box and click on next or select the tab "Draft" at the Top of this window.
[[File:Submit_tb_approval.png|550px|center]]


[[File:Draft_tab.jpg|400px|center]]


The system has retrieved all information in relation to the draft you have uploaded on latest drafts and that you are contributing to the Technical Committee.


You can also attach your contribution to:
'''Warning:''' beware there is no confirmation requested. Once the meeting selected (or “No meeting”), the contribution will be submitted right away.


- Meeting
===Contributing a draft===
Contributing a draft means '''embedding an available draft in a contribution''' and contributing that contribution to the community for decision, for discussion, or for information. The first step consists in uploading a draft via the Latest Draft application, the second step then consists in embedding the drat in a contribution. This second step is necessary, especially when the rapporteur wants a specific version of his draft to be discussed and/or approved by the community.


- The related work item tab is pre filled by system with the right Work Item reference of your draft
<small>Note that after publication of a Work Item as an ETSI deliverable, drafts are no longer accessible (usually deleted), whereas contributions are never deleted.</small>


- Related contribution
There are '''two ways''' of embedding a draft in a contribution and contributing it:


====Reserve a contribution of type "DRAFT" from the Contribution application====
*The easiest way is to start '''from the Latest Drafts application''', either by uploading a new draft (with the [[Image:update.gif|15px||alt=Upload icon|Upload icon]] icon) and contributing it on-the-fly, or by contributing and already-available draft (with the [[Image:Contribute.gif|15px||alt=Contribute draft|Contribute draft]] icon).  
To contribute a draft from the contribution application, first repeat the steps described in [[Contributions#CREATE_A_CONTRIBUTION|Part 2.CREATE A CONTRIBUTION]] of the present page, then choose the type "New draft" from the list of contribution types.


The system displays the general Tab which you are asked to fill in, ... click on the "NEXT" button or select the tab "Draft" at the top of the window. The system will display the following screen:
*The second way starts '''from the Contribution application'''. This approach is <span style=color:red>'''recommended when contributing a Working Group draft to its parent group''' </span> (Example: WG draft contributed to plenary for approval).  


[[File:Draft_from_appli.jpg|700px]]


From this screen you will select:
====From the Latest Draft application====


* WI committee: drop-down list of all ETSI committees.
The Latest Draft application is available on every Technical Body's portal page, from there, you will upload and/or contribute a draft in a few clicks. Follow the instructions in the [[Latest_Drafts#Latest_Draft_Screen_Content| Latest Draft wiki]].


* WI reference: drop-down list of all active WIs belonging to the selected committee.
* If you just uploaded a new draft, the successful upload confirmation message will prompt you to [[File:Contribute_draft_now_button.PNG]].
  [[File:Draft_upload_confirmation.png|right|500px]]


* Version: drop-down list displaying the available draft versions for this WI (i.e. drafts that have already been uploaded on the server via the Latest Draft application).
* You can also contribute an available draft at any time by clicking on the [[Image:Contribute.gif|15px||alt=Contribute draft|Contribute draft]] icon next to the relevant version on the [[Latest_Drafts#Latest_Draft_Screen_Content|Latest Draft screen]].


If the draft version that you want to contribute is only on your PC (i.e. it has not yet been uploaded), then select "Upload new version" in the dropdown, this will open the Latest Draft pop-up window that will allow you to upload it.
After clicking on the [CONTRIBUTE this draft version now] button or on a [[Image:Contribute.gif|15px||alt=Contribute draft|Contribute draft]] icon, the portal will open a "NEW CONTRIBUTION" window. On that window you will notice that the contribution type is set to ''New Draft'' and that a specific '''Draft''' tab  has been inserted after the '''General''' tab.


[[File:Manage_your_draft.jpg|400px]]
The ''New Draft''tab has already been filled with the draft's meta-data (Committee, reference, version), and in the '''General''' tab most fields have already been pre-filled as well.


From this pop-up, upload your new draft and click on "Save": your draft will be uploaded in the drafts area of the relevant committee. Once back in the Draft tab of the Contribution screen, you will be able to select and contribute the draft version that you have just uploaded.
You still have to:
*Decide if you contribute the draft for '''Decision''', for '''Discussion''', or for '''Information'''.
You may also:
*Link the contribution to a meeting
*Add an abstract to your contribution


You may then attach your contribution to a meeting, link it to other contributions, and click on "Save" when done.
Once this done, click on the '''[Save Changes]''' button to reserve the contribution, and then on the '''[Upload/Make Available]''' one.
An intermediate pop-up will appear: just follow the instructions and acknowledge, at this this stage the portal has enough information to create the contribution file and upload it without any further action from you.


Your contribution is now in a "Reserved" State, <u>it is still not physically available in the contribution area</u>.


====Make Available a contribution of type "DRAFT"====
====From the Contribution application====
This approach is recommended when contributing a Working Group draft to its parent group (Example: a Working Group draft contributed to plenary for approval).
[[File:Contribution_Portlet.jpg|600px|center]]
* From the Portal [[Contributions_Portlet|Contributions application]] click on the "New contribution" link and select "New Draft"  


As the draft you are contributing is already on the server, the systems knows where to find it, therefore all you have to upload (to make your contribution available ) is a cover page that will be zipped together with the draft.
An empty contribution-creation-window will appear, this window has a specific '''[Draft]''' tab (which does not appear when reserving other types of contributions).
You need to get the cover page from the system, update it with any useful information that will help other delegates understanding your draft, and make it available as a companion file to your draft.


To get the cover page, click on the "Get cover Page" button on the reservation confirmation screen (see below)
&rArr; '''Before anything else''', select the appropriate "Input for committee" in the '''[General]''' tab of the contribution-creation-window. This is the committee in which the contribution will be created .


[[File:Reserve_confirmation.jpg|400px|center]]
'''Important:''' when a Working Group draft will be contributed to the parent group (i.e. to the plenary) select the parent group here, not the Working Group.
[[File:Draft_tab_from_contrib_app.png|right|500px]]
'''Then''', switch to the '''[Draft]''' tab and select:
:* The '''WI committee''' (or Working Group) from which the draft is issued
:* The '''WI reference''': drop-down list of all active WIs belonging to the selected committee.
:* The appropriate '''Version''': drop-down list displaying all available draft versions for the selected WI.


Save the cover page on your computer and then click on the button "Upload/Make available" to upload it.


The system has retrieved the draft from the Latest draft application and added the cover page into a zip file. Your contribution is uploaded and appears as "Available" in the list of contributions.  
Go back to the '''[General]''' Tab &rarr; the title field should have been automatically filled with meta-data retrieved from the draft you selected.


Note: You can also upload your draft cover page from the "More" button on the line of your contribution in the list of contributions.
Fill-in the remaining fields: choose whether your draft is for information, discussion or decision, type free text in the abstract box and allocate your contribution to a meeting.


[[File:Make_ava_from_list.jpg|400px|center]]
When done, click on the [Save Changes] button to reserve a contribution number and then on the [[File:Upload_make_avail_button.PNG]] one to upload the contribution.
An intermediate pop-up may appear: just follow the instructions and acknowledge, at this this stage the portal has enough information to create the contribution file and upload it without any further action from you.

Latest revision as of 13:26, 21 December 2018

CONTRIBUTION SEARCH

In order to access the Contribution application you first need to be logged in to the ETSI portal (http://portal.etsi.org).

You have two ways of accessing this application:

1st way:

Select a Technical body/Working Group/Task Group. On this page you will see the Contributions portlet appearing. On the top of this portlet you see two links:
  • New Contribution - to unfold the menu and choose the type of the contribution
  • Full view - to access the contribution list in the application.


2nd way

Go on the "Meeting Calendar" Portlet and select the meeting you wish to contribute to. The system displays the following meeting details page.

Meeting details.jpg


On this above screen you can:

  • Create a New contribution
  • View the contributions that have been attached to this meeting
  • Access the docbox area of all contributions attached to this Technical Body


In the full list view of the contributions; statuses and UID are now displayed in different colours depending on their status: i.e. the reserved status is in blue, the accepted status in green and rejected status in red.


Contributions full list view

On the left side of the above screen, there is a new quick access panel divided in 3 parts:

  • You can access your saved queries
  • You can have direct access to contributions which have been linked to recent, on-going and future meetings
  • You can also have direct access to contributions associated to any committees


This quick access panel can be collapsed by clicking on Picture2.jpg


You may also use the new search panel to retrieve a set of contributions. To use this search options click on the link show filter options on the up right side of the screen.


Picture4.jpg


You can customize your search by providing data to the most common used filter options. Such as free text, selected community, Meeting, contribution type, status, contribution for...

You also have the possibility to perform your search using advanced filters options. To expand the search options click on the link More filter Options

More filter.jpg

Select one criterion and click on the Superior.JPG button in order to move it from the "Available Criteria list" to the “Selected Criteria list”, repeat the action should you wish to add other criteria. To select all criteria at once click on Double superior.JPG. When your selection is finished click on Search.

The system will now ask you to indicate the value for each criterion.



Note: The criterion value and the operator selection depend on the selected search criteria. It can be value selection from a list, value selection from input date fields (using calendar), or free text input.


To save your query and being able to retrieve your favourite ones each time you log in the portal click on the link Save query at the top of the screen, a pop up window will open asking you the name of your query, fill in the name of your query and click OK:

Save Query.jpg


The custom query is saved and appears on the left part of the screen under "My queries".


Update a saved query:

To update a saved query, click on one of them under "Saved queries" and apply your changes, then click the link Save Query.


Default view

You may customize your own contribution list view format. To do so, click on the button [Default view] at the top right of the contribution list which displays the list predefined views.

Note: A view format is a selection of columns of the result grid. It also contains data about the column order, sort, grouping, and width.


Default view.jpg


When selecting the item "Edit view " from the menu as shown in print screen above, a pop-up opens which allows you to customize your preferred view by defining the columns you would like to see displayed in the result grid of contributions. You can also select the order in which the columns are displayed.

See figure below:

Edit view format.jpg


Should you wish to display all available columns then use the Double superior.JPG that will move all the items from the left to the right column. Should you wish to remove the selected items except "Contrib ID", "Title" and "Actions which are mandatory, then click on Multiple inferior.jpg

Should you wish to select items one by one then select the wished item in the left part of the pop-up and use Superior.JPG to move it to the right part. Should you wish to remove one item from the selected list then select this item and click on Inferior.jpg

To order your selected columns use the up and down button on the right of the pop-up screen.

Creating a Contribution

IMPORTANT: Only logged users can reserve/upload contributions.

There are two places on the portal from which a user can reserve a contribution:

  • From the Portal Contributions tab by clicking on the "New contribution" link and selecting a contribution type in the drop-down menu.

Contribution Portlet.jpg


  • From the Contribution application itself by clicking on "New contribution" button.

New contribution.jpg



Contributing a Meeting Agenda, a Meeting Report, a Change Request, a Liaison Statement, or an "Other contribution" type


The Contribution Creation screen opens on the General tab.

The General tab

Contribution Creation.jpg

Several attributes need to filled, these attributes will allow categorization and retrieval of contribution documents.

  • Title: free text
  • Source: When clicking on the "Change" button near the field "Source", a pop-up "Manage Source" opens (see figure below). 4 different types of Source are available:
    • Organisations: a company allowed to contribute to the technical work of a committee
    • ETSI committees: an active ETSI (sub-)Technical Body
    • Roles: Chairman, Vice-Chairman, Secretary, Rapporteur, WG/TG Chairman, ETSI support
    • Other: free text describing a role not matching one of the above categories
Note: there can be more than one source for a contribution (example: company A, company B, and company C) yet all sources of a contribution have to be of the same type.
Manage Source.jpg
  • Main Contact: Is set automatically to the submitter's name of the contribution this field can be enriched by an additional contact in the text field.
  • Input for Committee: group to which the contribution will be submitted
  • Contribution for: to inform the committee whether your contribution is for Decision, for Discussion, or Information
In case your contribution is for decision you then have to describe the expected decision by filling in the "Decision/Action requested" box
  • Meeting - Allocation:

You can assign a contribution to ONE meeting (and one allocation) by clicking on the "Change" button next to Meeting - Allocation. Contributions assigned to a meeting are then listed in the Meeting's Document list.

Attach meeting.jpg

The system retrieves all recent, ongoing and future meetings for the related committee (including joint meetings).

There is also the possibility to attach your contribution to an allocation (if some exists). Those allocations could be for instance agenda items.

Selecting a meeting (and an allocation) in the list(s) will display further information in the grey box below. Once the correct selection is made, you can ssign the contribution to your selected meeting with the [Assign] button. The assignment will be effective after saving your contribution.

  • Related WIs or deliverables: You can also attach your contribution to an existing Work Items or deliverable. click on the Change button

Related WI.jpg

The system displays all the work items attached to the committee you contribute to, the text field allow you to filter the content of the box or to search for other ETSI work items. It is possible to select more than one work item. Select one Work item in the displayed list and click on the "Add" button, the selected work item appears on the left part of the pop-up with a red cross which allow you to remove it. then click on the "Done" button.

  • Abstract: Free text summarizing the content of the contribution

You then have the possibility to link your contribution to a meeting.

The Related Contributions tab

You can also refer to one or several other contributions and link them to the contribution you are submitting.

This feature can be used (for example) to place your contribution in the context of other ones, and help its understanding.
This feature could also be used to point the attention of the reader to a contribution of another committee which you consider as for interest as well...

To do so, the selection mechanism is similar as for "Add related Work Item", except that instead of linking WIs you are linking other contributions.


Saving your contribution

Your contribution can now been saved.

Note: As soon as all the mandatory fields from the General Tab have been filled in, the contribution can be Saved(except for New WI proposals and New Drafts).

Once you click on the Save button, it will receive a Unique contribution Identifier (UID) and a new record will be added to the contribution database. Your contribution appears now with status RESERVED.

Contribution reserved.jpg

The next steps are:

  • Download the Cover Page for your contribution with the "Get cover page" button: the system will PUSH a contribution template pre-filled with the information you have entered in the General Tab.


  • Edit the contribution details and update


  • Upload the final contribution with the "make available" button


You can Make available a contribution from the detailled view of the contribution (accessible from the portlet and from the full list view) by clicking on the "Upload/Make Available" button.


Or you can Upload a contribution from the full list view by clicking on the [upload] Icon on the line of the RESERVED contribution:

Make ava from list.jpg

Revising a contribution


You can Revise a contribution from the detailled view of the contribution (accessible from the portlet and from the full list view) by clicking on the "Revise" button.

Or you can Revise a contribution from the full list view by clicking on the [Revise] Icon on the line of the AVAILABLE or NOTED contribution:

Revise.jpg

Contribute/Create a New Work Item Proposal

To create a New Work Item (NWI) proposal, log in the ETSI portal with your EOL account and click on the Technical Body you intend to contribute to.

Login banner.png


In the Contributions portlet, click on "New contribution" and select the type "New WI Proposal / Description" from the drop down list.

Newcontrib droplist.png


To create a NWI proposal, you first need to fill in the attributes from the general tab:

NWIgeneral tab.png


After having filled in the attributes from this tab, then click on "WI Details" tab. This tab reflects the content of the New Work Item sheet you are used to utilize.

WIdetails complete NWI.PNG


Fill in the following mandatory attributes in order to present the proposal to the community:

  • ‘‘‘WI committee’’’
  • ‘‘‘Deliverable’’’
Select either a New Work Item or Revision of an Existing Work Item.
  • ‘‘‘Formal Title 1 and 2’’’
If it is a Revision, the system will retrieve most information from the ETSI Work Programme.
  • ‘‘‘Scope of the work’’’


You can present your contribution to the chosen Committee with only those 4 fields filled in. Nevertheless you will need to inform the system about the other fields in order to be able to "accept" this Work Item.


In addition to the above listed fields, the following fields are mandatory to pass the Work Item proposal from the status "available" to "accepted":


  • ‘‘‘Standard type’’’
Choose in the drop down list from the six ETSI deliverable types: EN, TR, TS, EG, ES, GS
  • ‘‘‘To be published as version’’’
If it is a New Work Item, then by default, the version will be 1.1.1
  • ‘‘‘Requested WI reference’’’
The system will automatically attribute the next available number.
  • ‘‘‘Rapporteur’’’
Enter the name of the rapporteur, the system will propose matching results and complete the entry automatically.
  • ‘‘‘Supporting Companies’’’
A minimum of 4 supporting companies is requested. Click on the button “Add/Remove” and enter the name in the new window. Double click to select and add the company. The company’s details appear at the bottom. When done, click “Done” to save the selection and close the window.
Add supp orga.PNG


  • ‘‘‘Schedule’’’
A NWI proposal needs at least the TB adoption, WG and TB approval dates in the schedule in order to be accepted.
‘‘‘Note: For deliverable type EN’’’, an extra line will appear. Select the Procedure, whether or not it is a Harmonized Standard and Mandate if applicable.
  • ‘‘‘Keywords’’’
To select the Keywords, click on “Add/Remove”. Search the keywords and add them with a double click. Click “Done” to save the selection and close the window.


‘‘‘IMPORANT NOTE: If this a Revision of an existing Work Item’’’, then you can enter the ETSI number (e.g. EN 383 001) or the reference of the Work Item to be revised (e.g. DEN/TISPAN-03008) and the system will retrieve all the information available from the Work Programme.


Example of a NWI revision:

WIdetails complete revision.PNG


Check your Work Item Proposal

During the creation of the Work Item Proposal, the system displays a warning on the top right corner of the WI details tab.

It will display “WI proposal is NOT READY” until all the mandatory fields necessary to accept the proposal are filled in. You may mouse over this warning to see what information is missing.


Warning with info.png


The warning is refreshed automatically. Once the Work Item is complete and ready for approval, the system will display the following warning:


Warning green.PNG


To save your proposal, click on the "Save changes" button, at the bottom of the window. The system retrieves your contribution details.


If the proposal is incomplete:
You may leave your contribution in the "reserved" status and complete it later on. Click then on “Complete later”.


WI not complete.PNG


If the proposal is complete:
You may leave your contribution in the "reserved" status and make it available later on. Click then on “No later”.


Pop up save complete.PNG


In either case, you will see a confirmation that you contribution has been reserved, with the contribution number allocated.


Confirmation reserve.jpg

Make available a Work Item Proposal

You can make available a Work Item proposal which is in "Reserved" Status.

To make it available you need to proceed to the upload of the contribution which is done automatically for this type of contribution.


NOTE: For the Work Item Proposal Contribution, there is no need to get cover page as the system will take all data and generate it automatically.


There are two ways of making available a New Work Item Proposal.

From the “Save changes” button
If you wish to make your proposal right away, click “Yes now”.


Pop up save complete.PNG


You will be redirected to the following screen.


Automatic generation.jpg


From the reservation confirmation screen


Confirmation reserve.jpg


Click on "Upload/Make available", a pop-up is displayed


Automatic generation.jpg


Select if you wish to upload a cover page from your computer or if you want it to be generated by the system itself and then click on "Make Available" and the system will generate a zip file with the cover page and the Work Item sheet.


Your New Work Item proposal is now in status "Available".

NWIavailable.png

At this stage, updating the proposal is still possible, however it requires to [Revise] the contribution.

The Preliminary Work Item number (PWI)

Once a NWI contribution is reserved and or made available to the community, a Preliminary Work Item number (PWI) is attributed. It is the identification number of the Work Item until it is approved at the Technical Body level.


The PWI number consists of the following:

“PWI_TBname_Year+sequence number_version”

(For example, PWI_TETRA01_1204_1 is a proposed Work Item to TETRA WG1, the 4th proposal in 2012 and it is currently version 1 of the proposal).


That PWI number is visible on top of the WI Details tab in the NWI proposal:


PWI WI details tab.PNG


It can also be found in the contribution file, in the New Work Item sheet:


PWI WI sheet.png

Change the status of a contribution of type NWI proposal

To change the status of the contribution, go the Contribution portlet.

Click on the Glasses icon.PNG on the line of your contribution. This will open the details of the contribution.


Status buttons.png


There are four changes possible changes to the status:

Accept
Reject
Note
Withdraw


Click on the appropriate status button. A pop-up will open allowing you to enter some comments


Status confirm popup.png


Click “OK”. The status is updated in the General tab of your contribution:


Gen tab Accepted status.png


From this same screen, you may progress the Work Item to the parent Technical Body for adoption.


See description under section Progress the New Work Item to Technical Body of the Contribution application helpfiles.

Progress the New Work Item to the Technical Body

Should you have created a New Work Item at Working Group/Task Group level and got it approved by this WG/TG; you will need to get it approved by the Parent Technical Body.


To do that click on the Glasses icon.PNG in the contribution application for the concerned NWI proposal.


In the contribution General tab, click on Submit tbappr button.PNG


A drop down list appears with all the upcoming meeting of the parent Technical Body. Select the meeting the contribution should be attached to, or “No meeting” if applicable.


Submit tb approval.png


Warning: beware there is no confirmation requested. Once the meeting selected (or “No meeting”), the contribution will be submitted right away.

Contributing a draft

Contributing a draft means embedding an available draft in a contribution and contributing that contribution to the community for decision, for discussion, or for information. The first step consists in uploading a draft via the Latest Draft application, the second step then consists in embedding the drat in a contribution. This second step is necessary, especially when the rapporteur wants a specific version of his draft to be discussed and/or approved by the community.

Note that after publication of a Work Item as an ETSI deliverable, drafts are no longer accessible (usually deleted), whereas contributions are never deleted.

There are two ways of embedding a draft in a contribution and contributing it:

  • The easiest way is to start from the Latest Drafts application, either by uploading a new draft (with the Upload icon icon) and contributing it on-the-fly, or by contributing and already-available draft (with the Contribute draft icon).
  • The second way starts from the Contribution application. This approach is recommended when contributing a Working Group draft to its parent group (Example: WG draft contributed to plenary for approval).


From the Latest Draft application

The Latest Draft application is available on every Technical Body's portal page, from there, you will upload and/or contribute a draft in a few clicks. Follow the instructions in the Latest Draft wiki.

  • If you just uploaded a new draft, the successful upload confirmation message will prompt you to Contribute draft now button.PNG.
Draft upload confirmation.png
  • You can also contribute an available draft at any time by clicking on the Contribute draft icon next to the relevant version on the Latest Draft screen.

After clicking on the [CONTRIBUTE this draft version now] button or on a Contribute draft icon, the portal will open a "NEW CONTRIBUTION" window. On that window you will notice that the contribution type is set to New Draft and that a specific Draft tab has been inserted after the General tab.

The New Drafttab has already been filled with the draft's meta-data (Committee, reference, version), and in the General tab most fields have already been pre-filled as well.

You still have to:

  • Decide if you contribute the draft for Decision, for Discussion, or for Information.

You may also:

  • Link the contribution to a meeting
  • Add an abstract to your contribution

Once this done, click on the [Save Changes] button to reserve the contribution, and then on the [Upload/Make Available] one. An intermediate pop-up will appear: just follow the instructions and acknowledge, at this this stage the portal has enough information to create the contribution file and upload it without any further action from you.


From the Contribution application

This approach is recommended when contributing a Working Group draft to its parent group (Example: a Working Group draft contributed to plenary for approval).

Contribution Portlet.jpg

An empty contribution-creation-window will appear, this window has a specific [Draft] tab (which does not appear when reserving other types of contributions).

Before anything else, select the appropriate "Input for committee" in the [General] tab of the contribution-creation-window. This is the committee in which the contribution will be created .

Important: when a Working Group draft will be contributed to the parent group (i.e. to the plenary) select the parent group here, not the Working Group.

Draft tab from contrib app.png

Then, switch to the [Draft] tab and select:

  • The WI committee (or Working Group) from which the draft is issued
  • The WI reference: drop-down list of all active WIs belonging to the selected committee.
  • The appropriate Version: drop-down list displaying all available draft versions for the selected WI.


Go back to the [General] Tab → the title field should have been automatically filled with meta-data retrieved from the draft you selected.

Fill-in the remaining fields: choose whether your draft is for information, discussion or decision, type free text in the abstract box and allocate your contribution to a meeting.

When done, click on the [Save Changes] button to reserve a contribution number and then on the Upload make avail button.PNG one to upload the contribution. An intermediate pop-up may appear: just follow the instructions and acknowledge, at this this stage the portal has enough information to create the contribution file and upload it without any further action from you.