Операции с профилями пользователей в модели надстроек SharePoint
Подход, который вы используете для выполнения операций создания, чтения, обновления и удаления (CRUD) в службе профилей пользователей, в новой модели надстроек SharePoint отличается от подхода к коду полного доверия. В типичном сценарии полного кода доверия (FTC) или решения фермы операции CRUD UPS выполнялись с помощью кода серверной объектной модели SharePoint или веб-службы профилей пользователей и развертывались с помощью решений фермы.
В сценарии модели надстройки SharePoint операции CRUD UPS выполняются с клиентской объектной моделью (CSOM) или веб-службой профилей пользователей.
Рекомендации высокого уровня
Как правило, мы рекомендуем следующие общие рекомендации по выполнению операций CRUD UPS.
- В следующей таблице описаны типы операций, поддерживаемых в Office 365 и локальных средах SharePoint для API-интерфейсов веб-службы CSOM и профилей пользователей.
Operation | API | Локальная среда | Office 365 |
---|---|---|---|
ПРОЧИТАТЬ | CSOM | Поддерживается | Поддерживается |
CREATE | CSOM | Не поддерживается | Поддерживается |
UPDATE | CSOM | Не поддерживается | Поддерживается |
DELETE | CSOM | Не поддерживается | Поддерживается |
ПРОЧИТАТЬ | Веб-служба профиля пользователя | Поддерживается | Не поддерживается |
CREATE | Веб-служба профиля пользователя | Поддерживается | Не поддерживается |
UPDATE | Веб-служба профиля пользователя | Поддерживается | Не поддерживается |
DELETE | Веб-служба профиля пользователя | Поддерживается | Не поддерживается |
- Как правило, надстройка не развертывается в клиенте SharePoint для обработки копирования или синхронизации данных UPS. Как правило, надстройка имеет форму консольного приложения, выполняемого в качестве запланированной задачи, или длительно работающей облачной службы, например веб-задания Azure.
- Дополнительные сведения об этих технологиях и способах их использования в модели надстройки SharePoint см. в разделе Задания удаленного таймера (рецепт модели надстройки SharePoint ).
- Использование проверки подлинности AppOnly не поддерживается ни для каких операций службы профилей пользователей.
- Выполните код CSOM с учетной записью, которая имеет соответствующие разрешения для выполнения операций CRUD UPS.
- При синхронизации Active Directory со службой профилей пользователей некоторые атрибуты синхронизируются по умолчанию.
- Сопоставление свойств профиля пользователя по умолчанию в SharePoint Server 2013 (статья TechNet) содержит список атрибутов, синхронизированных по умолчанию.
- Если вам нужно синхронизировать дополнительные атрибуты, необходимо создать пользовательское средство, используя один из подходов, описанных в этой статье.
Параметры копирования и синхронизации данных UPS
У вас есть несколько вариантов копирования и синхронизации данных UPS.
- Локальная архитектура
- Копирование базы данных
- Копирование данных с помощью веб-службы профилей пользователей
- Синхронизация данных с помощью веб-службы профилей пользователей
- Office 365
- Копирование данных с помощью CSOM
- Синхронизация данных с помощью CSOM
Локальная среда — копирование базы данных
Если у вас есть локальная среда SharePoint, вы можете скопировать базу данных UPS из одной фермы в другую, чтобы быстро реплицировать атрибуты.
Для каких случаев он подходит?
Если у вас есть локальная среда SharePoint и выполняется односторонняя копия атрибутов профиля, это хороший вариант, так как его можно реализовать быстро и легко без написания кода.
Локальная среда— копирование данных с помощью веб-службы профилей пользователей
Если у вас есть локальная среда SharePoint, вы можете использовать веб-службу профилей пользователей для копирования данных UPS из одной фермы в другую.
Для каких случаев он подходит?
Если у вас есть локальная среда SharePoint и вы копируете данные UPS между двумя или более фермами SharePoint, это хороший вариант, так как он дает возможность копировать данные UPS из одной фермы в другую.
Начало работы
В следующем примере показано, как выполнять операции CRUD UPS с веб-службой профилей пользователей.
Локальная среда— синхронизация данных с помощью веб-службы профилей пользователей
Если у вас есть локальная среда SharePoint, вы можете использовать веб-службу профилей пользователей для синхронизации данных UPS между фермами.
Для каких случаев он подходит?
Если у вас есть локальная среда SharePoint и вы синхронизируете данные UPS между двумя или более фермами SharePoint, это хороший вариант, так как он дает вам возможность выполнять подлинную синхронизацию и включать любое количество источников.
Начало работы
В примере Core.UserProfilePropertyUpdater (пример O365 PnP) показано, как выполнять операции CRUD UPS с веб-службой профилей пользователей.
В примере Core.MMSSync (пример PnP O365) показано, как создать средство синхронизации для управляемой службы метаданных (MMS-данные). Хотя в этом примере основное внимание уделяется API-интерфейсам MMS, общий шаблон, используемый для синхронизации, также может применяться к данным UPS.
Office 365 . Использование CSOM для копирования данных
Если у вас есть Office 365 среде SharePoint, вы можете использовать CSOM для копирования данных UPS из одного клиента в другой.
Для каких случаев он подходит?
Если у вас есть Office 365 среда и вы копируете данные UPS между двумя или более арендаторами SharePoint, это хороший вариант, так как он дает возможность копировать данные UPS из одного клиента в другой.
Начало работы
В примере UserProfile.Manipulation.CSOM (пример PnP O365) показано, как выполнять операции CRUD UPS с CSOM.
В разделе CSOM профиля пользователя для чтения и обновлений (видео O365 PnP) приведены инструкции по UserProfile.Manipulation.CSOM (пример PnP O365).
Office 365 — синхронизация данных с помощью CSOM
Если у вас есть Office 365 среде SharePoint и вы синхронизируете данные UPS между двумя или более арендаторами, это хороший вариант, так как он дает возможность выполнять подлинную синхронизацию и включать любое количество источников.
Для каких случаев он подходит?
Если у вас есть Office 365 среда и вы синхронизируете данные UPS между двумя или более арендаторами SharePoint, это хороший вариант, так как он позволяет выполнять подлинную синхронизацию и включать любое количество источников.
Начало работы
В примере Core.UserProfiles.Sync (пример PnP O365) показано, как создать средство синхронизации для данных службы профилей пользователей.
Гибридные среды
В сценарии, когда у вас есть как локальная среда, так и Office 365 среды SharePoint и данные профиля пользователя должны поддерживаться в обеих средах, можно использовать сочетание веб-службы профилей пользователей и CSOM, чтобы предоставить вам возможность выполнять операции CUD с данными UPS.
См. также
- CsOM профиля пользователя для чтения и обновления (видео O365 PnP)
- Задания удаленного таймера (рецепт модели надстройки SharePoint)
- Сопоставления свойств профилей пользователей по умолчанию в SharePoint Server 2013 (статья TechNet)
- Статьи руководства на https://aka.ms/OfficeDevPnPGuidance
- Ссылки в MSDN на https://aka.ms/OfficeDevPnPMSDN
- Видео на https://aka.ms/OfficeDevPnPVideos
Образцы PnP
- Core.UserProfilePropertyUpdater (пример PnP O365)
- Core.MMSSync (пример O365 PnP)
- UserProfile.Manipulation.CSOM (пример PnP O365)
- Core.UserProfiles.Sync (пример PnP O365)
- Примеры и содержимое в Microsoft 365 Patterns and Practices (PnP)
Область применения
- Office 365 Multi Tenant (MT)
- Office 365 Dedicated (D)
- Локальное развертывание SharePoint 2013