View source for DSpace/C2/Create-Community-and-Sub-Community-in-DSpace/English

'''Script : Create Community and Sub-community'''

'''Author : Pankaj Patil '''

'''Keywords: Community, Sub-community, Group policy, Community administrator, create Community, Community metadata '''

{| border =1
|-
| align=center| '''Visual Cue'''
| align=center| '''Narration '''
|- 
|| Slide: Title
|| Welcome to this spoken tutorial on '''Create Community''' and '''Sub-community.'''
|- 
|| Slide: Learning Objectives
|| In this tutorial, we will learn to
* Create a '''Community''' and '''Sub-community'''
* Edit a '''Community'''
* Authorize''' EPerson''' as '''Community administrator'''
|- 
|| Slide: System requirements
|| This tutorial is recorded using
* '''Ubuntu Linux OS '''18.04
* '''DSpace '''version 6.3 and
* '''Firefox web browser'''
However you may use any other '''web browser '''of your choice.
|- 
|| Slide: Pre-requisites
|| To practice this tutorial, you should have
* Installed '''DSpace 6.3''' on your system
* '''Tomcat service''' should be running
* '''Administrator’s authority''' in '''DSpace'''
|- 
|| Slide: Pre-requisites
||
* If not then go through the prerequisite tutorials on this website.
|- 
|| Slide: Prerequisites 
||
* This tutorial assumes that you have done the immediate previous tutorial assignment in this series.
* If not, pls do so before proceeding ahead.
|- 
|| Slide : Code files
|| 
* The''' metadata '''and the''' image '''used in this tutorial is available in the '''Code Files '''link on this tutorial page.
* Please download and extract the file before practicing.
|- 
|| Slide: '''Community''' in '''DSpace'''
||
* '''Community''' is the highest level of the content hierarchy in '''DSpace'''.
* '''Communities''' consist of '''Sub-communities''' and '''Collections'''.
|- 
|| Narration only
|| Now, let us proceed to create a '''Community'''.
|- 
|| Open '''Web Browser '''
Address Bar''' >> localhost:8080'''
|| Open a '''web browser '''and go to the '''DSpace''' interface.
|- 
|| Log in to '''DSpace''' with''' administrator'''
'''Username: dspace.u1@gmail.com
'''Password : '''u1pass
|| Log in to '''DSpace''' with an '''administrator''' account.
I will login with the '''administrator account.'''
|- 
|| Only narration
|| We are now in the '''admin’s My DSpace''' page.
|- 
|| Click on '''Browse''' tab
|| Click on the '''Browse''' tab in the '''navigation bar.'''
|- 
|| Select '''Communities & Collections'''
|| Select '''Communities & Collections''' from the drop-down.
'''Communities''' '''and''' '''Collections''' page opens up.
|- 
|| Click on '''Create Top-Level''' '''Community'''
|| To create a '''Community,''' click on the '''Create Top-Level Community''' button in '''Admin Tools''' section.
|- 
|| Point to '''Create Community''' label
|| '''Create Community''' page opens up. 
It displays the '''Community's metadata '''form.
|- 
|| Slide : '''Community Metadata'''
|| '''Communities''' are described using '''metadata elements'''. 
Basic '''metadata elements '''of '''communities''' are,
* '''Community Name'''
* '''Short Description'''
* '''Introductory text'''
* '''Copyright text'''
* '''Sidebar text '''and
* '''Logo'''
|- 
|| Narration only
|| Switch to '''DSpace'''.
|- 
|| Point to '''Community’s metadata''' label
|| Now we will fill the '''Community’s metadata.'''
|- 
|| Point to all fields in the form
|| Notice that all the fields in the form are optional. 
But, it is recommended to enter at least a '''Community Name.'''
Otherwise an untitled '''Community '''will be created.
|- 
|| Show '''metadata file'''
|| For ease of practice, we have provided '''Community''' '''metadata''' in a text file. 
I will use the same for entering the '''Community metadata'''.
|- 
|| Enter '''Name''' and '''Introductory text'''

'''Name''' :''' IITB Digital Library'''
'''Introductory text : IITB Digital Library Community
contains educational resources '''
|| Enter the '''Name''' and '''Introductory text''' as shown.
You can use basic '''HTML tags '''in the '''Introductory text '''field.
|- 
|| Point to '''Short Description, '''
'''Copyright text, Sidebar text'''
|| For now, I will leave the fields''' Short Description, Copyright text, '''and '''Sidebar text '''as''' '''empty.
|- 
|| Point to create button
|| By clicking on the '''Create '''button at the bottom of the page, a '''Community''' without '''logo '''is created.
|- 
|| Click on '''Upload a Logo '''button
|| For this demonstration, let us upload a '''logo'''.
To do so, click on the '''Upload a Logo '''button.
|- 
|| Point to '''Upload Logo'''
|| We will be redirected to the '''Upload Logo''' page.
|- 
|| Click on '''Browse '''button
|| Click on the '''Browse '''button.
|- 
|| Point to '''File Upload '''pop up window
|| '''File Upload '''window opens up.
|- 
|| Select logo image
Select '''communitylogo.png''' from '''Downloads''' directory.
|| Browse and select the '''logo''' image from your machine.
The same is available in the '''Code Files''' link.
I have downloaded the '''logo '''image in the '''Downloads '''directory in my machine.
|- 
|| Click '''Open '''button
|| Then, click on the '''Open''' button.
|- 
|| Point to '''logo''' name
|| Immediately, the selected '''logo''' filename appears next to the '''Browse '''button.
|- 
|| Slide: '''Community Logo'''
||
* '''png, jpg, gif '''format images can be used for '''Community logo'''
* '''Logo''' of any size can be used.
* '''Logos''' of size approximately 200 by 75 '''pixels''' makes a good visual appearance.
|- 
|| Narration only
|| Switch to '''DSpace'''.
|- 
|| Click on '''Upload''' button
|| To upload a '''logo''', click on the '''Upload''' button at the bottom of the page.
|- 
|| Point to '''Edit Community'''
|| We are redirected to the '''Edit Community''' page.
'''Edit Community''' page has details of the newly created '''Community'''.
|- 
|| Narration only
|| The''' Create '''button on the '''Create Community''' page is used to save a newly created '''Community.'''
But, If we upload a '''Community logo''', '''DSpace '''directly creates a '''Community'''.
In that case, it is not required to click the '''Create '''button on the '''Create Community''' page.
|- 
|| Narration only
|| We have now successfully created a '''Community.'''
Let us proceed to cross-verify the newly created '''Community.'''
|- 
|| Click on '''Home''' tab
|| To do that, click on the '''Home''' tab in the '''navigation bar'''.
|- 
|| Click on '''Browse''' tab
|| Then click on the '''Browse''' tab in the '''navigation bar'''.
|- 
|| Select '''Communities & Collections'''
|| Select '''Communities & Collections''' from the drop-down.
'''Communities''' '''and''' '''Collections''' interface opens up.
|- 
|| Point to '''IITB Digital Library'''
|| Observe that the newly created '''Community''' is displayed with a''' logo '''and''' name.'''
|- 
|| Narration only
|| Let us now proceed to '''edit''' the '''Community.'''
|- 
|| Select '''IITB Digital Library'''
|| Click on the '''Community''' name, to select it for editing.
|- 
|| Point to '''Community home page'''
|| The '''Community home page '''appears.
|- 
|| Point to '''Admin Tools'''
|| Next to the '''Community home page''' section, we have '''Admin Tools.'''
'''Admin Tools '''are used for managing '''Community'''.
|- 
|| click on button '''Edit'''
|| To edit a '''Community,''' click on the '''Edit button''' in the '''Admin Tools.'''
|- 
|| Point to '''Edit Community'''
|| '''Edit Community''' page opens up with the details of the selected '''Community'''.
|- 
|| Edit fields in '''Community's metadata''' 
'''Introductory text: IITB Digital Library Community contains
educational resources from various domains
like Electrical Engineering,
Mechanical Engineering,etc '''
|| You can edit the fields in the '''Community's metadata '''form now.
I have edited, '''Introductory text''' as shown here.
|- 
|| Click on the Update''' '''button 
|| Once '''Community's metadata '''is edited, click on the '''Update '''button at the bottom of the page.
|- 
|| Point to updated '''Introductory text'''
|| Notice that '''Introductory text '''is now updated.
|- 
|| Narration only
|| Now, let us proceed to learn how to delete''' '''the '''Community'''.
|- 
|| Click the '''Edit''' button
|| Click on the '''Edit''' button in '''Admin Tools.'''
|- 
|| Click on '''Delete this Community '''button
|| Click on the '''Delete this Community '''button''' '''above the '''Community's settings '''section.
|- 
|| Point to''' Delete Community'''
|| Immediately, we will be asked to confirm '''Delete''' '''Community''' action.
|- 
|| Narration only
|| To confirm, click on the '''Delete''' button.
|- 
|| Narration only
|| Once you click the '''Delete''' button, the '''Community''' will be deleted.
|- 
|| Click on '''Cancel''' button
|| For this demonstration, I will not delete any '''Community'''.
So, I will click on the '''Cancel''' button.
|- 
|| Narration only
|| We are back to the '''Community home page.'''
|- 
|| Narration only
|| Now, let us proceed to create the '''Community Administrator role''' for our '''Community.'''
We will assign the '''Community Administrator''' role to the '''EPerson''' with the '''ID dspace.u2@gmail.com'''
|- 
|| Click the '''Edit''' button
|| Click on the '''Edit''' button in the '''Admin Tools.'''
|- 
|| Point to '''Community Administrator'''
|| '''Community's settings '''section has the settings for''' Community Administrator.'''
|- 
|| Click on the '''Create '''button
|| Click on the '''Create''' button next to the '''Community Administrators '''label.
|- 
|| Point to '''Edit Group'''
|| We will be redirected to the '''Edit Group '''page.
|- 
|| Narration only
|| Observe that this '''Edit group '''page is the one, which we had used to create a''' group'''.
That means, '''DSpace '''is creating a '''group''' of '''Community Administrators'''.
|- 
|| Point to '''Name''' field
|| By default, '''DSpace''' generates a name for the '''group.'''
But we can provide our own name to the '''group '''of''' Community Administrators.'''
For this demonstration, I will keep the default '''name '''as it is.
|- 
|| Click on '''Select E-people'''
|| Now, we will add the '''EPerson''' as a '''Community Administrator.'''
Click on the '''Select E-people''' button below the '''EPerson''' '''Members''' field. 
|- 
|| Point to '''Select E-people '''window''' '''
|| '''Select E-people''' pop-up window opens up.
|- 
|| Click on the Add''' '''button
|| Click on the '''Add '''button adjacent to the '''ID '''of the respective '''EPerson.'''
I will select the '''user''' with the '''email ID dspace.u2@gmail.com.'''
|- 
|| Point to the added user in the '''EPerson Members''' field
|| Immediately the selected '''user''' will be added to the '''EPerson''' '''Members''' field.
|- 
|| Click on the '''Close '''button
|| If you wish to add more members, then repeat the same steps.
Once done, close the '''Select E-people '''pop-up''' '''window by clicking on the '''Close''' button.
|- 
|| 
Select '''EPerson''' from '''EPerson Member '''field
|| We can also remove the member from the''' group.'''
To do so, select the respective member''' '''to be removed from the '''EPerson Members '''field.
|- 
|| Point on the '''Remove Selected '''button
|| Then click on the '''Remove Selected '''button, below the '''EPerson Members '''field.
I’m skipping this step for this demonstration.
|- 
|| Click on '''Update Group'''
|| Once done, click on the '''Update Group''' button at the bottom of the page to update the changes.
|- 
|| Narration only
|| So, we have now successfully assigned the '''Community Administrator''' role to '''EPerson.'''
Let us proceed to cross-verify the same.
|- 
|| Click on '''Content''' tab in navigation bar
|| Click on the '''Content''' tab in the '''navigation bar.'''
|- 
|| Select '''Communities & Collections'''
|| Select '''Communities & Collections''' from the drop-down.
|- 
|| Select '''IITB Digital Library'''
|| Select the '''Community'''.
I am selecting the '''IITB Digital Library.'''
|- 
|| Point to '''Community home page'''
|| The '''Community home page '''appears.
|- 
|| Click the '''Edit''' button
|| Click on the '''Edit''' button in the '''Admin Tools.'''
|- 
|| Click the '''Edit '''button next to '''Community Administrators'''
|| Now, click on the '''Edit '''button next to '''Community Administrators. '''
|- 
|| Point to '''EPerson Members''' field
|| We can see that '''EPerson''' has been assigned the '''Community Administrator’s''' role.
|- 
|| Narration only
|| The '''Community Administrator '''has '''authority''' to manage the '''Community.'''
|- 
|| Narration only
|| Now, let us proceed to create a '''Sub-community'''.
Hierarchically, '''Sub-community '''is created under the '''Community. '''
|- 
|| Narration only
|| To create a '''Sub-community''' first we have to select a '''Community.'''
|- 
|| Click on '''Content''' tab in navigation bar >>Select '''Communities & Collections'''
|| Click on the '''Content''' tab in the '''navigation''' '''bar''' and select '''Communities & Collections''' from the drop-down.
|- 
|| Narration Only
|| Select the '''Community'''.
|- 
|| Select '''IITB Digital Library'''
|| I am selecting '''IITB Digital Library.'''
|- 
|| Point to '''Community home page'''
|| '''Community home page '''appears.
|- 
|| Click on the button '''Create Sub-community'''
|| Click on the button '''Create Sub-community '''in the''' Admin Tools''' section.
|- 
|| Point to '''Create Community''' label
|| The '''Create Community''' page opens up.
It contains the '''Community's metadata '''form.
|- 
|| Point to '''Community's metadata '''
|| Scan through the '''Community's metadata '''form.
The form is the same as the one which we used to create the '''Community.'''
|- 
|| Point to '''Name''' and '''Introductory Text'''
'''Sub-community Name : Electrical Engineering'''
'''Introductory text :  Electrical Engineering Sub -community
contains educational resources of Electrical Domain. '''
|| Fill the '''Community's metadata '''as shown here.
|- 
|| Point to '''Logo'''
|| For this demonstration, I will skip uploading a '''logo''' for the '''Sub-community.'''
|- 
|| click on the '''Create '''button
|| Once the '''Community metadata''' is entered, click on the '''Create '''button at the bottom of the page'''.'''
|- 
|| Point to '''Community home page'''
|| The '''Sub-community''' is created and the '''Sub-community home page''' is displayed.
|- 
|| Narration only
|| This means that we have successfully created a '''Sub-community.'''
|- 
|| '''Logout from DSpace'''
|| Let us '''logout''' this '''user '''from the '''DSpace''' interface now.
|- 
|| Only Narration
|| This brings us to the end of this tutorial.
Let us summarise.
|- 
|| Slide: Summary
|| In this tutorial we learnt to :* Create a '''Community''' and '''Sub-community'''
* Edit a '''Community '''and
* Authorize '''EPerson''' as '''Community Administrator'''
|- 
|| Slide: Assignment
|| As an assignment,
* Create another '''Community''' with the name '''IITB archives'''
* Assign a '''Community administrator''' to '''IITB archives'''
|- 
|| Slide : About Spoken Tutorial project
|| The video at the following link summarises the '''Spoken Tutorial project.'''
Please download and watch it.
|- 
|| Slide : Spoken Tutorial workshops
|| The '''Spoken Tutorial Project''' team conducts workshops and gives certificates.
For more details, please write to us.
|- style="background-color:#ffffff;border:1pt solid #000000;padding:0.176cm;"
|| Slide: Answers for THIS Spoken Tutorial
|| Please post your timed queries in this Forum.
|- 
|| Slide: Acknowledgement -I
|| '''Spoken Tutorial project''' is funded by MHRD, Government of India.
|- 
|| Slide: Acknowledgement -II

|| '''DSpace spoken tutorial''' series is funded by the National Virtual Library of India, Ministry of Culture, Government of India.
|- 
|| Narration only

|| This script and video for this tutorial was contributed by '''Pankaj Patil''' from''' IIT Bombay.'''

And this is '''Nancy Varkey '''along with the Spoken Tutorial team''' '''signing off. Thanks for joining.
|-
|}