Adding Users to MOSS 2007 (SharePoint) Sites and Groups

http://www.codeproject.com/KB/sharepoint/Adding_users_to_MOSS_2007.aspx

Introduction

On a recent project with MOSS 2007, our team was required to create a unified user creation wizard that added user information to our database and then added the new user to a site/group in SharePoint. I dug around and found several sources that showed different ways of doing this task however I found that there is “more to the story”. This article is about the approach I took, I hope it helps.

Using the Code

For the most part I am just going to list code fragments that I used in this project and talk briefly on what it is doing. It is pretty straight forward but there are subtle nuances. The approach I took was to first look for the user. If the user was already in the site collection then I just had to add her or him to the group. Otherwise I would have to add the user first to the site and then to the group. To start, you will need a reference to Microsoft.SharePoint:

Collapse
using Microsoft.SharePoint;

The first function tries to return a user. You want to look first to make sure that the user is not currently in the site collection. In my code, if GetSPUser returns null then I know I have to create the user. You might want to handle exceptions differently. I have removed our exception handling routines for clarity.

Collapse
private SPUser GetSPUser(string strLoginName, string strSiteURL)
{
    SPUser spReturn = null;
    SPSite spSite = null;
    SPWeb spWeb = null;
    try

    {
        //Open the ShrePoint site

        spSite = new SPSite(strSiteURL);
        spWeb = spSite.OpenWeb();
        
        //Check to see if user exists

        spReturn = spWeb.AllUsers[txbUser.Text];
    }
    catch(Exception)
    {
    }
    finally

    {
        spWeb.Close();
        spSite.Close();
    }

    return spReturn;
} 

Now if GetSPUser returns null then we have to create the user in the site collection. What’s important here is the SPRoleAssignment and SPRoleDefinition. These should be set to create the user correctly. You have to tell SharePoint what access level the new user has. In this sample I am just using Contribute. You may want to make that a parameter or use a different level. Notice that I am not calling spWeb.Users.Add() as this is not needed. When you add the role definition, it will add the user as well.

Collapse
private SPUser CreateUser(string strLoginName, string strEMail, 
    string strName, string strNotes, string strSiteURL)
{
    SPUser spReturn = null;
    SPSite spSite = null;
    SPWeb spWeb = null;

    try

    {
        //Open the SharePoint site

        spSite     = new SPSite(strSiteURL);
        spWeb     = spSite.OpenWeb();

        //Assign role and add user to site

        SPRoleAssignment spRoleAssignment = 
            new SPRoleAssignment(strLoginName, strEMail, strName, strNotes);
        //Using Contribute, might need high access


        SPRoleDefinition spSPRoleDefinition = 
            spWeb.RoleDefinitions["Contribute"]; 
    
        spRoleAssignment.RoleDefinitionBindings.Add(spSPRoleDefinition);
        spWeb.RoleAssignments.Add(spRoleAssignment);

        //Update site

        spWeb.Update();
        spReturn = spWeb.AllUsers[strLoginName];
    }
    catch(Exception)
    { 
    }
    finally
    {
        spWeb.Close();
        spSite.Close();
    }

    return spReturn;
}

Putting It All Together

Here is the code from the main function. Once again, open the site, get or create the user, then add to the group.

Collapse
//Open Site

SPSite spSite = new SPSite(strSiteURL);
SPWeb spWeb = spSite.OpenWeb();

//Get or create user


SPUser spUser = GetSPUser(strLoginName, strSiteURL);

if(spUser == null)
{
    spUser = CreateUser(strLoginName, strEMail, strName, strNotes, strSiteURL);
}

//Open group

SPGroup spGroup = spWeb.SiteGroups[strGroup];

//Add and update group with new user

spGroup.AddUser(spUser.LoginName, spUser.Email, spUser.Name, 
    "Added by UserControl");
spGroup.Update();    
Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s