ECS19 - Patrick Curran - Expanding User Profiles with Line of Business Data (SharePoint Online)

3. ♡ ♡

4. @PCfromDC nopehttps://blog.pcfromdc.com
nein linkedin.com/in/PCfromDC
Patrick Curran
Federal CTO, Planet Technologies

5. Patrick Curran
SharePoint / Cloud Architect
• MCT, MCPD, MCITP, MCP, MCTS, MCSA, MCSE
• CTO Planet Technologies.
• Co-Author of Microsoft SharePoint 2013: Designing and Architecting Solutions.
• Working with Azure since 2010.
• Working with SharePoint since 2003.
• Working with SQL Server since 1998.

6. Batch
Update API

7. In this session we will review:
• Why you cannot just simply modify your Active Directory properties and expect the
properties to show in SharePoint Online.
• How to create your own LOB system using PowerShell.
• How to take on-premises LOB user properties and update SharePoint Online user profile
properties through PowerShell.
• How to synchronize your LOB database with an Azure DB.
• How to take data from user properties stored in an Azure SQL Database and update
SharePoint Online user profiles
• How to update custom SharePoint Online user properties using a Console Application(C#)
• How to continually update your SPO user properties through an Azure Web Job (C#)

8. https://github.com/PCfromDC/spc18-UPA

9. Batch
Update API

10. Microsoft
Azure
SharePoint
Online Services
On-Premises
Azure
Active Directory
Active Directory
Office 365
Azure AD
Connect
SPO-UPA

11. accountEnabled, authOrig, c, cn, co, company, countryCode, department, description, displayName,
dLMemRejectPerms, dLMemSubmitPerms, extensionAttribute1, extensionAttribute10,
extensionAttribute11, extensionAttribute12, extensionAttribute13, extensionAttribute14,
extensionAttribute15, extensionAttribute2, extensionAttribute3, extensionAttribute4,
extensionAttribute5, extensionAttribute6, extensionAttribute7, extensionAttribute8,
extensionAttribute9, facsimiletelephonenumber, givenName, hideDLMembership, homephone, info,
initials, ipPhone, l, mail, mailnickname, managedBy, manager, member, middleName, mobile,
msExchTeamMailboxExpiration, msExchTeamMailboxOwners, msExchTeamMailboxSharePointLinkedBy,
msExchTeamMailboxSharePointUrl, objectSID, oOFReplyToOriginator, otherFacsimileTelephone,
otherHomePhone, otherIpPhone, otherMobile, otherPager, otherTelephone, pager,
physicalDeliveryOfficeName, postalCode, postOfficeBox, preferredLanguage, proxyAddresses,
pwdLastSet, reportToOriginator, reportToOwner, securityEnabled, sn, sourceAnchor, st, streetAddress,
targetAddress, telephoneAssistant, telephoneNumber, thumbnailphoto, title, unauthOrig, url,
usageLocation, userPrincipalName, wWWHomePage

12. Batch
Update API

13. Microsoft
Azure
SharePoint
Online Services
On-Premises
Azure
Active Directory
LOB System
Sync-AD2SQL
Active Directory
Update-O365UPA
SQL Data Sync
SPO Library
Azure
Web Job
spc18-UPA.sln
JSON File
JSON File
Office 365
Azure AD
Connect
SPO-UPA

17. Batch
Update API

18. few restrictions on the source data:
• Max size: 2GB
• Max properties: 500,000
• Source file must be uploaded to same SharePoint
Online tenant where the process is started
• UPA Property must be already created in SPO
• UPA Property Edit Settings must be disabled
{
"value": [
{
"<IdName>": "<UserIdValue_1>",
"<AttributeName_1>": "<User1_AttributedValue_1>",
"<AttributeName_2>": "<User1_AttributedValue_2>",
...,
"<AttributeName_x>": "<User1_AttributedValue_x>"
},
{
"<IdName>": "<UserIdValue_2>",
"<AttributeName_1>": "<User2_AttributedValue_1>",
"<AttributeName_2>": "<User2_AttributedValue_2>",
...,
"<AttributeName_x>": "<User1_AttributedValue_x>"
},
...,
{
"<IdName>": "< UserIdValue_n >",
"<AttributeName_1>": "<Usern_AttributedValue_1>",
"<AttributeName_2>": "<Usern_AttributedValue_2>",
...,
"< AttributeName_x >": "<User1_AttributedValue_x>"
}
]
}

19. Queue import process:
The QueueImportProfileProperties method located in the Office365Tenant object is an
asynchronous call. It does not download the source data or the import it, but simply adds the
work item to the queue.
idType = userIdType = userPricipalName (mail)
sourceDataIdProperty = userLookupKey = IdName = UPN (mail)
propertyMap = Attributes
sourceUri = Uri of file located in SPO Document Library
{
"value": [
{
"<IdName>": "<UserIdValue_1>",
"<AttributeName_1>": "<User1_AttributedValue_1>",
"<AttributeName_2>": "<User1_AttributedValue_2>",
...,
"<AttributeName_x>": "<User1_AttributedValue_x>"

20. Return Value: GUID
Check Job Status:
public ImportProfilePropertiesJobInfo GetImportProfilePropertyJob(Guid jobId);

21. Exceptions:
The API does handle exceptions and will create a folder for the log file.

22. Batch
Update API

23. Microsoft
Azure
SharePoint
Online Services
On-Premises
Azure
Active Directory
LOB System
Sync-AD2SQL
Active Directory
Update-O365UPA
SPO Library
JSON File
Office 365
Azure AD
Connect
SPO-UPA

25. Batch
Update API

26. Microsoft
Azure
SharePoint
Online Services
On-Premises
Azure
Active Directory
LOB System
Sync-AD2SQL
Active Directory
SQL Data Sync
SPO Library
Azure
Web Job
spc18-UPA.sln
JSON File
Office 365
Azure AD
Connect
SPO-UPA

28. Resources
https://github.com/PCfromDC/spc18-UPA