Creating User Property Programmatically Using JSOM In SharePoint/ O365

Gowtham Rajamanickam

9y15.7k50100Article

SharePoint JSOM O365User Property

5 Comments

Join the conversation! Your thoughts help the community grow.

Aakash Maurya7y ago
Friend, the article title and contents is totally misleading and mismatched. I am not able to find a single line of code which describe how to create user property. The article title, article description and article summary does not match at all. Please update the title of the article. It mislead to the user who come here from google search.
- Aakash Maurya7y ago
  Issue is not with me. Actually I am telling you to update the article title. Your article title is "Creating User Property Programmatically Using JSOM In SharePoint/ O365", and in your article the code is to get the user property. I was saying that either you add the code to create user profile property into your article, or you should update the title of the article. Let's help in not spreading misleading contents to the world....
- Gowtham Rajamanickam7y ago
  Send me your error screenshot and we can't help you without knowing your issue
Krunal Patel7y ago
Where is the code to Create a User Profile Properties? I want to create a custom User Profile Properties using CSOM. Here, I found that you have given a steps to create using UI in Office Portal.
Ravi Kandel9y ago
Awesome Thanks for sharing

Introduction

In this article, we will see how to create a user property programmatically, using JavaScript Object Model (JSOM). Before going to the code first, we will see what the user property is and how to get into the Service.

The user properties and user profile properties provide information about SharePoint users, such as display name, E-mail, title, other business and personal information.

In client-side APIs, we can use two properties to access the user details.

Prerequisites

SharePoint Server 2013
Visual Studio 2012 or higher version

To access the User Profile Service, we need to include the reference file given below in the ASPX page.

<SharePoint:ScriptLink ID="ScriptLink1" name="SP.js" runat="server" ondemand="false" localizable="false" loadafterui="true" />
<SharePoint:ScriptLink ID="ScriptLink2" name="SP.UserProfiles.js" runat="server" ondemand="false" localizable="false" loadafterui="true" />

The code is given below and the article explains how to get the user profile properties from the userproperties object and how it works.

This article demonstrates how to create and use a user property in SharePoint Online (O365).

A user profile is the collection of the user properties that describes about a single user. The property includes basic details, policies and settings. Most of the organizations get a headache maintaining user profile properties in an efficient way but it helps the people to find the content that connects them with other people.

Based on the user profile properties, you can learn many things about the user and connect with them, using social features like blogs and discussions.

The admin from SharePoint Online can enhance the SharePoint capabilities by adding the user profile properties, defining user policies, and creating the audiences.

Here are the basic screenshots I have added to access the user profile Service.

Open your SharePoint Central Admin on the Server and click Application Management, followed by selecting user profile Service.

Afterwards, you will get a new screen. Click SharePoint link for redirecting to the screen given below.

The user profile has three important sections. I have explained about the sections here.

People

In this people section, Admin can manage all the user properties and profiles .They can provide the permissions for audience.
Organization

This section is for managing an organization's details.
My Site Settings

This is totally for MySite related topics.My Sites are essentially personal portals that give individual users the ability to have a one-to-many collaboration path with the enterprise.

Now, we will see how to manage User Properties.

Click the "Manage User Properties" link under the "People" heading. You will be redirected to the below screen.

The basic default properties are available under here and you can use this page to add, edit, organize, delete or map user profile properties. Profile properties can be mapped to Active Directory or LDAP compliant directory services. Profile properties can also be mapped to Application Entity Fields exposed by Business Data Connectivity.

Here, you can create a new user propery and new section.Those details can be explained in the next article.

Now, we will see how to create a User Profile property programmatically using JSOM.

Specify property settings for this property. The name will be used programmatically for the property by the user profile service, while the display name is the label used when the property is shown.

After the property is created, the only property setting you can change is the display name. Specify a description for this property, that will provides instructions or information to the users.

Source Code

var personProperties;
SP.SOD.executeOrDelayUntilScriptLoaded(getUserProperties, 'SP.UserProfiles.js');
function getUserProperties() {
var targetUser = "SPDEV\\gwotham";
var Context = new SP.ClientContext.get_current();
var peopleManager = new SP.UserProfiles.PeopleManager(Context);
personProperties = peopleManager.getPropertiesFor(targetUser);
Context.load(personProperties);
Context.executeQueryAsync(Success, Fail);
}
function Success() {
var displayName = personProperties.get_displayName();
var department = personProperties.get_userProfileProperties()['Department'];
alert(displayName);
alert(department);
}
function onRequestFail(sender, args) {
alert(args.get_message());
}

Conclusion

The above article will help you to understand how to access the SharePoint Online User Profile Property.

Thanks for reading my articles.