Freigeben über

Benutzerprofilbearbeitung im SharePoint-Add-In-Modell

  • Artikel

Der Ansatz, den Sie zum Ausführen von CruD-Vorgängen (Create, Read, Update and Delete) im Benutzerprofildienst verwenden, unterscheidet sich im neuen SharePoint-Add-In-Modell von dem mit voll vertrauenswürdigem Code. In einem typischen FTC-Szenario (Full Trust Code) bzw. farm solution wurden UPS CRUD-Vorgänge mit dem serverseitigen SharePoint-Objektmodellcode oder dem Benutzerprofilwebdienst ausgeführt und über Farmlösungen bereitgestellt.

In einem SharePoint-Add-In-Modellszenario werden UPS CRUD-Vorgänge mit dem clientseitigen Objektmodell (CSOM) oder dem Benutzerprofilwebdienst ausgeführt.

Richtlinien auf hoher Ebene

Als Faustregel empfehlen wir die folgenden allgemeinen Richtlinien für die Durchführung von UPS CRUD-Vorgängen.

  • In der folgenden Tabelle wird beschrieben, welche Arten von Vorgängen in Office 365 und lokalen SharePoint-Umgebungen für die CSOM- und Benutzerprofilwebdienst-APIs unterstützt werden.
Vorgang API Lokal Office 365
LESEN CSOM Unterstützt Unterstützt
CREATE CSOM Nicht unterstützt Unterstützt
UPDATE CSOM Nicht unterstützt Unterstützt
LÖSCHEN CSOM Nicht unterstützt Unterstützt
LESEN Benutzerprofilwebdienst Unterstützt Nicht unterstützt
CREATE Benutzerprofilwebdienst Unterstützt Nicht unterstützt
UPDATE Benutzerprofilwebdienst Unterstützt Nicht unterstützt
LÖSCHEN Benutzerprofilwebdienst Unterstützt Nicht unterstützt
  • In der Regel stellen Sie kein Add-In für einen SharePoint-Mandanten bereit, um das Kopieren oder Synchronisieren von UPS-Daten zu verarbeiten. In der Regel hat das Add-In die Form einer Konsolenanwendung, die als geplante Aufgabe ausgeführt wird, oder in Form eines Clouddiensts mit langer Ausführungsdauer, z. B. eines Azure-Webauftrags.
  • Die Verwendung der AppOnly-Authentifizierung wird für Benutzerprofildienstvorgänge nicht unterstützt.
  • Führen Sie den CSOM-Code mit einem Konto aus, das über die entsprechenden Berechtigungen zum Ausführen von UPS CRUD-Vorgängen verfügt.
  • Beim Synchronisieren von Active Directory mit dem Benutzerprofildienst werden einige Attribute standardmäßig synchronisiert.

Optionen zum Kopieren und Synchronisieren von UPS-Daten

Sie haben eine Reihe von Optionen zum Kopieren und Synchronisieren von UPS-Daten.

  • Lokal
    • Datenbank kopieren
    • Verwenden des Benutzerprofilwebdiensts zum Kopieren von Daten
    • Verwenden des Benutzerprofilwebdiensts zum Synchronisieren von Daten
  • Office 365
    • Verwenden von CSOM zum Kopieren von Daten
    • Verwenden von CSOM zum Synchronisieren von Daten

Lokal – Datenbank kopieren

Wenn Sie über eine lokale SharePoint-Umgebung verfügen, können Sie die UPS-Datenbank von einer Farm in eine andere kopieren, um Attribute schnell zu replizieren.

Wann ist die Option geeignet?

Wenn Sie über eine lokale SharePoint-Umgebung verfügen und eine unidirektionale Kopie von Profilattributen ausführen, ist dies eine gute Option, da sie schnell und einfach implementiert werden kann, ohne Code zu schreiben.

Lokal: Kopieren von Daten mithilfe des Benutzerprofilwebdiensts

Wenn Sie über eine lokale SharePoint-Umgebung verfügen, können Sie den Benutzerprofilwebdienst verwenden, um UPS-Daten von einer Farm in eine andere zu kopieren.

Wann ist die Option geeignet?

Wenn Sie über eine lokale SharePoint-Umgebung verfügen und UPS-Daten zwischen zwei oder mehr SharePoint-Farmen kopieren, ist dies eine gute Option, da sie Ihnen die Flexibilität bietet, die UPS-Daten von einer Farm in eine andere zu kopieren.

Erste Schritte

Im folgenden Beispiel wird veranschaulicht, wie UPS CRUD-Vorgänge mit dem Benutzerprofilwebdienst ausgeführt werden.

Lokal: Verwenden des Benutzerprofilwebdiensts zum Synchronisieren von Daten

Wenn Sie über eine lokale SharePoint-Umgebung verfügen, können Sie den Benutzerprofilwebdienst verwenden, um UPS-Daten zwischen Farmen zu synchronisieren.

Wann ist die Option geeignet?

Wenn Sie über eine lokale SharePoint-Umgebung verfügen und UPS-Daten zwischen zwei oder mehr SharePoint-Farmen synchronisieren, ist dies eine gute Option, da sie Ihnen die Flexibilität bietet, eine echte Synchronisierung durchzuführen und beliebig viele Quellen einzubeziehen.

Erste Schritte

Core.UserProfilePropertyUpdater (O365 PnP-Beispiel) veranschaulicht, wie UPS CRUD-Vorgänge mit dem Benutzerprofilwebdienst ausgeführt werden.

Das Core.MMSSync (O365 PnP-Beispiel) veranschaulicht, wie ein Synchronisierungstool für MANAGED Metadata Service (MMS-Daten) erstellt wird. Obwohl sich dieses Beispiel auf die MMS-APIs konzentriert, kann das für die Synchronisierung verwendete Gesamtmuster auch auf UPS-Daten angewendet werden.

Office 365 : Kopieren von Daten mithilfe von CSOM

Wenn Sie über eine Office 365 SharePoint-Umgebung verfügen, können Sie DAS CSOM verwenden, um UPS-Daten von einem Mandanten in einen anderen zu kopieren.

Wann ist die Option geeignet?

Wenn Sie über eine Office 365 Umgebung verfügen und UPS-Daten zwischen zwei oder mehr SharePoint-Mandanten kopieren, ist dies eine gute Option, da sie Ihnen die Flexibilität bietet, die UPS-Daten von einem Mandanten in einen anderen zu kopieren.

Erste Schritte

Das UserProfile.Manipulation.CSOM (O365 PnP-Beispiel) veranschaulicht, wie UPS CRUD-Vorgänge mit CSOM ausgeführt werden.

Das Benutzerprofil-CSOM zum Lesen und Aktualisieren (O365-PnP-Video) führt Sie durch das UserProfile.Manipulation.CSOM (O365 PnP-Beispiel).

Office 365: Verwenden von CSOM zum Synchronisieren von Daten

Wenn Sie über eine Office 365 SharePoint-Umgebung verfügen und UPS-Daten zwischen zwei oder mehr Mandanten synchronisieren, ist dies eine gute Option, da sie Ihnen die Flexibilität bietet, eine echte Synchronisierung durchzuführen und beliebig viele Quellen einzubeziehen.

Wann ist die Option geeignet?

Wenn Sie über eine Office 365-Umgebung verfügen und UPS-Daten zwischen zwei oder mehr SharePoint-Mandanten synchronisieren, ist dies eine gute Option, da sie Ihnen die Flexibilität bietet, eine echte Synchronisierung durchzuführen und beliebig viele Quellen einzubeziehen.

Erste Schritte

Core.UserProfiles.Sync (O365 PnP-Beispiel) veranschaulicht, wie ein Synchronisierungstool für Benutzerprofildienstdaten erstellt wird.

Hybridumgebungen

In einem Szenario, in dem Sowohl lokale als auch Office 365 SharePoint-Umgebungen vorhanden sind und Benutzerprofilinformationen in beiden Umgebungen verwaltet werden müssen, können Sie eine Kombination aus dem Benutzerprofilwebdienst und dem CSOM verwenden, um Ihnen die Möglichkeit zu bieten, CUD-Vorgänge für UPS-Daten auszuführen.

PnP-Beispiele

Gilt für

  • Office 365 mit mehreren Mandanten (MT)
  • Office 365 dediziert (D)
  • SharePoint 2013 lokal