Freigeben über


Web Service Connector-Workflowleitfaden für SOAP

In diesem Artikel wird beschrieben, wie Sie im Webdienstkonfigurationstool ein neues Projekt für Ihre Datenquelle erstellen. Führen Sie die folgenden Schritte aus, um ein Projekt zu erstellen.

  1. Öffnen Sie das Webdienstkonfigurationstool. Es wird ein leeres Projekt geöffnet.

    Webdienstkonfigurationstool

  2. Wählen Sie SOAP-Projekt und dann Hinzufügen aus.

    SOAP-Projekt

  3. Geben Sie auf der nächsten Seite die folgenden Informationen an, und wählen Sie dann Weiter aus:

    • Der neue Webdienstname
    • Adresse (WSDL-Pfad) zum Abrufen der verfügbar gemachten Dienste, Endpunkte und Vorgänge
    • Namespace
    • Sicherheitsmodus (Authentifizierungstyp)
  4. In diesem Beispiel wird die Seite Anmeldeinformationen mit den Anforderungen für den Standardsicherheitsmodus (der modus, der im vorherigen Schritt ausgewählt wurde) angezeigt. Wenn für den Sicherheitsmodus "Keine" angegeben wurde, wird keine Anmeldeinformationenseite angezeigt. Wählen Sie Weiter aus.

    SOAP-Dienstbildschirm mit Benutzername und Kennwort

  5. Auf den WSDL-Pfad wird zugegriffen, um die Dienstinformationen abzurufen, und die Liste der verfügbar gemachten Funktionen wird angezeigt. Wenn der eingegebene WSDL-Pfad falsch ist, ruft das Konfigurationstool die Dienstinformationen nicht ab und löst einen Fehler aus.

    Statusbildschirm für Webdienstdownloads

  6. Sobald die Ermittlung ausgeführt wurde, werden der Endpunkt und die ermittelten Vorgänge aufgelistet. Wählen Sie Fertig stellen aus.

    Ermittelte SOAP-Dienstendpunkte und -Vorgänge

  7. Die Kompilierung wird ausgeführt. Die Kompilierung ist ein Prozess zum Kompilieren der Datenvertragsassembly, was zeitaufwendig sein kann. Der Benutzer wird über alle Kompilierungsfehler informiert. Nachdem die Ermittlung durchgeführt wurde, zeigt das Tool die folgende Seite an:

    Soap-Ermittlung

  8. Erweitern des SOAP-Projekts und Auswählen des verfügbar gemachten Endpunkts unten auf dem Bildschirm. Auf diesem Bildschirm werden die Vorgänge aufgelistet, die unter dem Endpunkt deklariert werden.

    Unter dem Endpunkt deklarierte Vorgänge

  9. Beim Erweitern des Endpunkts wird eine Liste der Vorgänge angezeigt. Ein Vorgang ist eine Funktion, die von einem Endpunkt deklariert wird. Jeder Vorgang befasst sich mit einem Tasktyp, der innerhalb des Diensts ausgeführt werden kann. Auf diesem Bildschirm werden die Argumente aufgelistet, die für den Vorgang deklariert sind. Diese Argumente werden dann definiert, wenn der Vorgang beim Konfigurieren der Workflows verwendet wird.

    Erweiterte Endpunkte

  10. Der nächste Schritt besteht darin, das Connectorraumschema zu definieren, das durch Erstellen des Objekttyps und Definieren der zugehörigen Objekttypen erreicht wird. Wählen Sie Objekttypen und dann Hinzufügen aus. Fügen Sie im neuen Fenster einen neuen Objekttyp hinzu, und geben Sie einen Namen an. Klicken Sie auf OK.

    Definieren des Objekttyps

  11. Das Hinzufügen eines Objekttyps bietet den folgenden Bildschirm.

    Anzeigen des neu erstellten Objekttyps

  12. Im rechten Bereich, der dem Objekttyp entspricht, können Sie die Attribute und deren Eigenschaften für den ausgewählten Objekttyp verwalten. Wählen Sie Hinzufügen. Ein neues Fenster wird geöffnet, um Attribute hinzuzufügen:

    Attribut und Datentyp

    Attribut und Datentyp mit ausgewählter Option

  13. Der folgende Bildschirm wird angezeigt, nachdem alle erforderlichen Attribute hinzugefügt wurden:

    Objekttyp mit Attributinformationen

  14. Objekttyp und Attribute nach der Erstellung stellen leere Workflows bereit, die auf die in Microsoft Identity Manager 2016 (MIM) ausgeführten Vorgänge ausgerichtet sind.

    Objekttypen zeigen Vorgänge an, die mitarbeiter ausführen können

Konfigurieren von Workflows im Webdienstkonfigurationstool

Der nächste Schritt besteht darin, die Workflows für Ihren Objekttyp zu konfigurieren. Workflowdateien sind eine Reihe von Aktivitäten, die vom Webdienstconnector zur Laufzeit verwendet werden. Die Workflows werden verwendet, um den entsprechenden MIM-Vorgang zu implementieren. Mit dem Webdienstkonfigurationstool können Sie vier verschiedene Workflows erstellen:

  • Importieren: Importieren Sie Daten aus einer Datenquelle für die folgenden beiden Arten von Workflows:

    • Vollständiger Import: Ein vollständiger Import, der konfiguriert werden kann.
    • Deltaimport: Wird vom Webdienstkonfigurationstool nicht unterstützt.
  • Exportieren: Exportieren von Daten aus MIM in eine verbundene Datenquelle. Die folgenden drei Aktionen werden für den Vorgang unterstützt. Sie können diese Aktionen basierend auf Ihren Anforderungen konfigurieren.

    • Hinzufügen
    • Löschen
    • Replace
  • Kennwort: Führen Sie die Kennwortverwaltung für den Benutzer (Objekttyp) aus. Für diesen Vorgang sind zwei Aktionen verfügbar:

    • Festlegen des Kennworts
    • Kennwort ändern
  • Verbindung testen: Konfigurieren Sie einen Workflow, um zu überprüfen, ob die Verbindung mit dem Datenquellenserver erfolgreich hergestellt wurde.

Hinweis

Sie können diese Workflows für Ihr Projekt konfigurieren oder das Standardprojekt aus dem Microsoft Download Center herunterladen.

Workflow-Designer

Die Workflow-Designer öffnet den Arbeitsbereich, um den Workflow gemäß den Anforderungen zu konfigurieren. Für jeden Objekttyp (neu /existing) stellt das Konfigurationstool die Knoten für Workflows bereit, die vom Tool unterstützt werden.

Workflow-Designer

Die Workflow-Designer besteht aus den folgenden Ui-Elementen:

  • Knoten im linken Bereich: Mit diesen Knoten können Sie auswählen, welchen Workflow Sie entwerfen möchten.

  • Zentrale Workflow-Designer: Hier können Sie die Aktivitäten zum Konfigurieren der Workflows löschen. Zum Ausführen verschiedener MIM-Vorgänge (Export, Import, Kennwortverwaltung) können Sie die standardmäßigen und benutzerdefinierten Workflowaktivitäten von .NET Workflow Framework 4 verwenden. Das Webdienstkonfigurationstool verwendet standardmäßige und benutzerdefinierte Workflowaktivitäten. Weitere Informationen zu Standardaktivitäten finden Sie unter Verwenden von Aktivitätsdesignern.

    • In der zentralen Workflow-Designer gibt ein roter Kreis mit Ausrufezeichen neben jeder Aktivität an, dass der Vorgang gelöscht wurde und nicht ordnungsgemäß und vollständig definiert ist. Zeigen Sie auf den roten Kreis, um den genauen Fehler herauszufinden. Nachdem die Aktivität richtig definiert wurde, wechselt der rote Kreis in das gelbe Informationszeichen.

    • Im zentralen Workflow-Designer gibt ein gelbes Dreiecksinformationszeichen neben jeder Aktivität an, dass die Aktivität definiert ist. Sie können jedoch noch mehr tun, um die Aktivität abzuschließen. Zeigen Sie auf das gelbe Dreieck, um weitere Informationen anzuzeigen.

  • Toolbox: Packt alle Tools, einschließlich system- und benutzerdefinierter Aktivitäten und vordefinierter Anweisungen zum Entwerfen des Workflows. Weitere Informationen finden Sie unter Toolbox.

  • Toolboxabschnitte: Die Toolbox verfügt über die folgenden Abschnitte und Kategorien:

    • Beschreibung: Der Header der Toolbox. Eine Registerkarte greift auf die Toolbox und die Eigenschaften der ausgewählten Workflowaktivität zu.

    • Importworkflow: Benutzerdefinierte Aktivitäten zum Konfigurieren von Importworkflows.

    • Exportworkflow: Benutzerdefinierte Aktivitäten zum Konfigurieren von Exportworkflows.

    • Allgemein: Benutzerdefinierte Aktivitäten zum Konfigurieren eines beliebigen Workflows.

    • Debuggen: Systemworkflowaktivitäten zum Debuggen, die in Workflow 4 definiert sind. Diese Aktivitäten ermöglichen die Problemnachverfolgung für einen Workflow.

    • Anweisungen: Systemworkflowaktivitäten, die in Workflow 4 definiert sind. Weitere Informationen finden Sie unter Verwenden von Aktivitätsdesignern.

  • Eigenschaften: Auf der Registerkarte Eigenschaften werden die Eigenschaften einer bestimmten Workflowaktivität angezeigt, die im Designerbereich gelöscht und ausgewählt wird. Die Abbildung auf der linken Seite zeigt die Eigenschaften der Aktivität zuweisen . Für jede Aktivität unterscheiden sich die Eigenschaften und werden beim Konfigurieren des benutzerdefinierten Workflows verwendet. Auf dieser Registerkarte können Sie die Attribute des ausgewählten Tools definieren, das im zentralen Workflow-Designer abgelegt wurde. Weitere Informationen finden Sie unter Eigenschaftendefiniert sind.

  • Taskleiste: Die Taskleiste enthält drei Elemente: Variablen, Argumente und Importe. Diese Elemente werden zusammen mit Workflowaktivitäten verwendet. Weitere Informationen finden Sie unter Einführung eines Entwicklers in Windows Workflow Foundation (WF) in .NET 4.

Konfigurieren eines vollständigen Importworkflows im Webdienstkonfigurationstool

Die folgenden Schritte zeigen, wie Sie vollständige Importworkflows für SOAP mithilfe des Webdienstkonfigurationstools konfigurieren.

Warnung

In diesem Beispiel wird nur ein Workflow erstellt. Änderungen am Workflow, z. B. zur Verwendung benutzerdefinierter Logik in der API, sind möglicherweise erforderlich.

  1. Wählen Sie den zu konfigurierenden Workflow Vollständiger Import aus. Die Argumente und Importe sind bereits definiert und für die Aktivitäten spezifisch. Weitere Informationen finden Sie auf den folgenden Bildschirmen.

    Argumente für den vollständigen Importworkflow

    Importierte Namespaces

    Ändern Sie nach der Neukonfiguration der Aufrufe die Namen der Attribute, die den Namespace ändern, hinzufügen oder ändern, in Variablen, die auf die Rückgabestruktur der API- und Objekttypen verweisen, die auf den alten Namespace verweisen. Die Toolbox im rechten Bereich enthält alle benutzerdefinierten workflowspezifischen Aktivitäten, die Sie für die Konfiguration benötigen. Weisen Sie die Werte den Variablen zu, die Sie für Ihre Logik verwenden werden. Wechseln Sie zum unteren Abschnitt des zentralen Workflow-Designers, und deklarieren Sie die Variablen. Variablen werden im nächsten Schritt deklariert.

  2. Fügen Sie eine Sequenzaktivität hinzu. Ziehen Sie den Sequenzaktivitäts-Designer aus der Toolbox, und legen Sie ihn auf die Windows Workflow-Designer Oberfläche ab. Weitere Informationen finden Sie auf den folgenden Bildschirmen. Die Sequence-Aktivität enthält eine geordnete Auflistung untergeordneter Aktivitäten, die in der Reihenfolge ausgeführt werden.

    Sequenzaktivität

  3. Suchen Sie zum Hinzufügen einer Variablen nach Variable erstellen. Geben Sie wsResponse für den Namen ein, wählen Sie die Dropdownliste Variablentyp aus, und wählen Sie dann Nach Typen suchen aus. Es wird ein Dialogfeld angezeigt. Wählen Sie generierte>Standardantwort>aus. Lassen Sie die Werte Bereich und Standardwerte deaktiviert. Alternativ können Sie diese Werte mithilfe der Eigenschaftenansicht festlegen.

    Standardantwort

    Eigenschaften des vollständigen Imports

  4. Fügen Sie nun alle anderen Variablen hinzu, und unten befindet sich der letzte Bildschirm.

    Vollimportvariablen

  5. Ziehen Sie einen weiteren Sequenzaktivitäts-Designer aus der Toolbox innerhalb der bereits hinzugefügten Sequenzaktivität.

  6. Ziehen Sie eine WebServiceCallActivity , die unter Allgemein angezeigt wird . Diese Aktivität wird verwendet, um den nach der Ermittlung verfügbaren Webdienstvorgang aufzurufen. Dies ist eine benutzerdefinierte Aktivität, die in verschiedenen Vorgangsszenarien üblich ist.

    Dienstnamevorgang

    Um den Webdienstvorgang zu verwenden, legen Sie die folgenden Eigenschaften fest:

    • Dienstname: Geben Sie einen Namen für den Webdienst ein.

    • Endpunktname: Geben Sie einen Endpunktnamen für den ausgewählten Dienst an.

    • Vorgangsname: Geben Sie den entsprechenden Vorgang für den Dienst an.

    • Argument: Wählen Sie Argumente aus. Weisen Sie im nächsten Dialogfeld die Argumentwerte zu, wie in der folgenden Abbildung gezeigt:

      Zuweisen von Argumenten

      Wichtig

      Ändern Sie den Namen, die Richtung oder den Typ für ein Argument nicht, indem Sie dieses Dialogfeld verwenden. Wenn einer dieser Werte geändert wird, wird die Aktivität ungültig. Legen Sie nur den Wert für das Argument fest. Wie in dieser Abbildung gezeigt, ist der Wert wsResponse festgelegt.

  7. Fügen Sie eine ForEach-Aktivität direkt unterhalb von WebServiceCallActivity hinzu. Diese Aktivität wird verwendet, um alle Attribute (sowohl Anker als auch Nichtanker) des Objekttyps zu durchlaufen. Beim Ziehen dieser Aktivität in Ihre Workflow-Designer Oberfläche werden automatisch alle Attributnamen für Ihr Objekt aufgelistet. Legen Sie die erforderlichen Werte gemäß dem folgenden Bildschirm fest:

    Webdienstaufrufaktivität

  8. Ziehen Sie eine CreateCSEntryChangeScope-Aktivität in den ForEach-Text . Diese Aktivität wird verwendet, um eine instance des CSEntryChange-Objekts in der Workflowdomäne für jeden datensatz beim Abrufen von Daten aus der Zieldatenquelle zu erstellen. Durch Ziehen dieser Aktivität wird der unten angezeigte Bildschirm angezeigt. CreateAnchorAttribute-Aktivitäten werden automatisch geerbt.

    Erstellen einer Cs-Eintragsänderungsbereichsaktivität

  9. Legen Sie den Wert des DN-Ausdrucks auf ‘string.Concat ("Employee",item.EmployeeID)’fest. Legen Sie anchorValue für die EmployeeID auf "Convert.tostring(item. EmployeeID)". Legen Sie ObjectTypeName auf Employee fest. Nachdem Sie diese Änderungen vorgenommen haben, wird der folgende Bildschirm angezeigt:

    Abrufen der Mitarbeiter-ID

    Hinweis

    Ankerwerte und Objektnamen variieren je nach verfügbar gemachtem Webdienst. Die Abbildung zeigt ein Beispiel.

  10. Ziehen Sie eine CreateAttributeChange-Aktivität unter die CreateAnchorAttribute-Aktivität . Die Anzahl der zu ziehenden Aktivitäten entspricht der Anzahl von Nichtankerattributen. Weitere Informationen finden Sie in der folgenden Abbildung.

    Anker erstellen

  11. Ziehen Sie CreateValueChangeActivity in die CreateAttributeChange-Aktivität , und legen Sie den Attributwert gemäß dem folgenden Bildschirm fest.

    Ändern eines Attributs

    Hinweis

    Um diese Aktivität zu verwenden, wählen Sie die entsprechenden Felder aus der Dropdownliste aus, und weisen Sie die Werte zu. Löschen Sie für mehrwertige Attribute mehrere CreateValueChangeActivity-Aktivitäten in einer CreateAttributeChangeActivity-Aktivität .

  12. Um Bedingungen für ein Attribut hinzuzufügen, fügen Sie eine If-Aktivität hinzu, wie in der folgenden Abbildung gezeigt:

    If-Aktivität

  13. Fügen Sie abschließend eine Aktivität Zuweisen hinzu, und legen Sie den Ausdruck fest, wie in der folgenden Abbildung dargestellt:

    Zuweisen einer Aktivität und Festlegen des Ausdrucks

  14. Speichern Sie dieses Projekt am Speicherort %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.

    Standardprojekte sollten heruntergeladen und am Speicherort %FIM_INSTALL_DIR\2010\Synchronization Service\Extensions auf dem Zielsystem gespeichert werden. Die Projekte werden dann im Webdienstconnector-Assistenten angezeigt.

    Beim Ausführen der ausführbaren Datei werden Sie aufgefordert, den Speicherort für die Installation anzugeben. Geben Sie den Speicherort ein.

    Wichtig

    Die Projektdatei kann an einem beliebigen Speicherort (mit den entsprechenden Zugriffsberechtigungen des Executors) gespeichert und geöffnet werden. Nur Projektdateien, die Synchronization Service\Extension im Ordner gespeichert sind, können im Webdienstconnector-Assistenten ausgewählt werden, auf den über die MIM-Synchronisierungsoberfläche zugegriffen wird.

    Der Benutzer, der das Webdienstkonfigurationstool ausführt, benötigt die folgenden Berechtigungen:

    • Vollständige Kontrolle über den Ordner "Erweiterung des Synchronisierungsdiensts".
    • Lesezugriff auf den Registrierungsschlüssel HKLM\System\CurrentControlSet\Services\FIMSynchronizationService\Parameters , über den sich der Pfad des Erweiterungsordners befindet.

Konfigurieren von Exportworkflows im Webdienstkonfigurationstool

In den folgenden Abschnitten wird gezeigt, wie Sie Ihre Workflows mithilfe des Webdienstkonfigurationstools exportieren.

Hinzufügen von Workflows

Fügen Sie Exportworkflows hinzu, indem Sie die folgenden Schritte im Webdienstkonfigurationstool ausführen.
  1. Wählen Sie den zu konfigurierenden Exportworkflow aus. Wählen Sie unter Exportierendie Option Hinzufügen aus. Die Argumente und Importe sind bereits definiert und für die Aktivitäten spezifisch. Weitere Informationen finden Sie auf den folgenden Bildschirmen.

    Screenshot: Hinzufügen im Navigationsbereich

  2. Fügen Sie eine Sequenzaktivität hinzu. Ziehen Sie den Sequenzaktivitäts-Designer aus der Toolbox, und legen Sie ihn auf die Windows Workflow-Designer Oberfläche ab. Die Sequence-Aktivität enthält eine geordnete Auflistung untergeordneter Aktivitäten, die in der Reihenfolge ausgeführt werden. Wählen Sie Variable erstellen aus. Weisen Sie die Werte den Variablen zu, die Sie für Ihre Logik verwenden werden.

    Exportieren

    Hinweis

    Die Schritte zum Hinzufügen einer Variablen werden im Abschnitt zum Erstellen vollständiger Importworkflows beschrieben.

  3. Ziehen Sie eine ForEach-Aktivität innerhalb der bereits hinzugefügten Sequence-Aktivität , um die Werte des Ankerattributs zu durchlaufen.

  4. Wählen Sie Eigenschaften aus, und legen Sie die Werte gemäß dem folgenden Bildschirm fest. Hier ist objectToExport argument.

    Screenshot: Festgelegte Werte für die ForEach-Aktivität

  5. Festlegen von DisplayName auf ForEach<AnchorAttribute>

    Screenshot: Set DisplayName

  6. Legen Sie TypeArgument auf fest Microsoft.MetadirectoryServices.AnchorAttribute.

    Screenshot: Set TypeArgument

  7. Fügen Sie eine Switch-Aktivität im ForEach-Textkörper des AnchorAttribute hinzu.

    Screenshot: Hinzufügen einer Switch-Aktivität im ForEach-Textkörper des AnchorAttributes

  8. Fügen Sie einen Ausdruck gemäß dem folgenden Bildschirm hinzu.

    Hinzufügen eines Ausdrucks

  9. Wählen Sie Neuen Fall hinzufügen aus, und geben Sie einen Wert für die EmployeeId ein. Ziehen Sie eine Sequenzaktivität , und fügen Sie darin eine Aktivität Zuweisen hinzu.

    Screenshot: Hinzufügen eines neuen Falles für Mitarbeiter I d

  10. Weisen Sie die Eigenschaften To und Wert für die Aktivität Zuweisen zu.

    Screenshot der Eigenschaften To und Wert für diese Aktivität

  11. Die ForEach-Aktivität wird für Ankerwerte verwendet. Fügen Sie eine weitere ForEach-Aktivität hinzu, um Nicht-Ankerwerte zuzuweisen. In diesem Beispiel wird der AttributeChange-Anker verwendet.

    Hinzufügen einer weiteren ForEach-Aktivität mit dem AttributChange-Anker

  12. Fügen Sie eine Switch-Aktivität im ForEach-Textkörper des AttributeChange-Ankers hinzu.

    Hinzufügen der Switch-Aktivität für den AttributeChange-Anker

  13. Fügen Sie einen Ausdruck gemäß dem folgenden Bildschirm hinzu.

    Hinzufügen eines Ausdrucks für die Switchaktivität

  14. Wählen Sie Neue Groß- und Kleinschreibung hinzufügen aus, und geben Sie einen Wert für FirstName ein. Ziehen Sie eine Sequenzaktivität , und fügen Sie darin eine Aktivität Zuweisen hinzu. Weisen Sie die Eigenschaften To und Wert für die Aktivität Zuweisen zu.

    Hinzufügen eines neuen Falls für die Sequenz

  15. Fügen Sie Werte für die erforderlichen Attribute wie LastName, Email usw. hinzu.

    Hinzufügen von Werten für erforderliche Attribute

  16. Ziehen Sie unter Allgemein eine WebServiceCallActivity , und legen Sie Werte für ihre Argumente fest.

    Screenshot: Webdienstaufrufaktivität und Festlegen der Werte

    Wichtig

    Ändern Sie den Namen, die Richtung oder den Typ für ein Argument nicht, indem Sie dieses Dialogfeld verwenden. Wenn einer dieser Werte geändert wird, wird die Aktivität ungültig. Legen Sie nur den Wert für das Argument fest. Wie in dieser Abbildung gezeigt, ist der Wert wsResponse festgelegt.

  17. Fügen Sie abschließend eine If-Aktivität hinzu, um antworten zu überprüfen, die vom Webdienstvorgang zurückgegeben werden.

Die Erstellung des Exportworkflows mit dem Vorgang Hinzufügen ist abgeschlossen:

Abgeschlossener Exportworkflow

Speichern Sie dieses Projekt am Speicherort %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.

Workflows löschen

Löschen Sie Exportworkflows, indem Sie die folgenden Schritte im Webdienstkonfigurationstool ausführen.

  1. Wählen Sie den zu konfigurierenden Exportworkflow aus. Wählen Sie unter Exportierendie Option Löschen aus. Die Argumente und Importe sind bereits definiert und für die Aktivitäten spezifisch. Weitere Informationen finden Sie auf den folgenden Bildschirmen.

    Exportieren von Löschworkflows

  2. Fügen Sie eine Sequenzaktivität hinzu. Wählen Sie Variable erstellen aus. Weisen Sie die Werte den Variablen zu, die Sie für Ihre Logik verwenden werden.

    Hinzufügen einer Sequenzaktivität

    Hinweis

    Die Schritte zum Hinzufügen einer Variablen werden im Abschnitt zum Erstellen vollständiger Importworkflows beschrieben.

  3. Ziehen Sie eine ForEach-Aktivität innerhalb der bereits hinzugefügten Sequence-Aktivität , um die Werte des Ankerattributs zu durchlaufen.

  4. Wählen Sie Eigenschaften aus, und legen Sie die Werte für den folgenden Bildschirm fest. Hier ist objectToExport argument.

    Screenshot: Festlegen der Eigenschaften für die ForEach-Aktivität

  5. Legen Sie DisplayName als ForEach\<AnchorAttribute\>fest:

    Screenshot: Festlegen des Anzeigenamens

  6. Legen Sie TypeArgument als Microsoft.MetadirectoryServices.AnchorAttributefest:

    Screenshot: Festlegen des Typarguments

  7. Fügen Sie eine Switch-Aktivität im ForEach-Textkörper des AnchorAttribute hinzu.

    Screenshot: Hinzufügen einer Switch-Aktivität

  8. Fügen Sie einen Ausdruck gemäß dem folgenden Bildschirm hinzu.

    Hinzufügen eines Ausdrucks

  9. Wählen Sie Neuen Fall hinzufügen aus, und geben Sie einen Wert für die EmployeeId ein. Ziehen Sie eine Sequenzaktivität , und fügen Sie darin eine Aktivität Zuweisen hinzu.

    Screenshot: Hinzufügen eines neuen Falls und Zuweisens zur Sequenz

  10. Weisen Sie die Eigenschaften To und Wert für die Aktivität Zuweisen zu.

    Screenshot: Zuweisen der Eigenschaften To und Wert für die Zuweisen von Aktivitäten

  11. Ziehen Sie unter Allgemein eine WebServiceCallActivity , und legen Sie Werte für ihre Argumente fest.

    Screenshot und Aufruf mit Argumentwerten zum Hinzufügen einer Webdienstaufrufaktivität

    Wichtig

    Ändern Sie den Namen, die Richtung oder den Typ für ein Argument nicht, indem Sie dieses Dialogfeld verwenden. Wenn einer dieser Werte geändert wird, wird die Aktivität ungültig. Legen Sie nur den Wert für das Argument fest. Wie in dieser Abbildung dargestellt, ist der Wert employeeID festgelegt.

  12. Fügen Sie abschließend eine If-Aktivität hinzu, um die vom Webdienstvorgang zurückgegebenen Antworten zu überprüfen.

Das Löschen des Exportworkflows mit dem Löschvorgang ist abgeschlossen:

Exportworkflow gelöscht

Speichern Sie dieses Projekt am Speicherort %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.

Ersetzen von Workflows

Ersetzen Sie Exportworkflows, indem Sie die folgenden Schritte im Webdienstkonfigurationstool ausführen.

  1. Wählen Sie den zu konfigurierenden Exportworkflow aus. Wählen Sie unter Exportierendie Option Ersetzen aus. Die Argumente und Importe sind bereits definiert und für die Aktivitäten spezifisch. Weitere Informationen finden Sie im folgenden Bildschirm.

    Ersetzen eines Workflows

  2. Fügen Sie eine Sequenzaktivität hinzu.

  3. Ziehen Sie eine ForEach-Aktivität für das <AnchorAttribute>.

  4. Fügen Sie eine weitere ForEach<AttributeChange-Aktivität> hinzu, um Nicht-Ankerwerte zuzuweisen.

  5. Schließlich sieht der Bildschirm wie die folgende Abbildung aus. Anweisungen zum Konfigurieren dieser Aktivität finden Sie im Abschnitt zum Hinzufügen von Exportworkflows.

    ForEach mit einer Switch-Aktivität und einem Ankerattribut

  6. Ziehen Sie unter Allgemein eine WebServiceCallActivity , und legen Sie Werte für ihre Argumente fest.

    Screenshot: Werte zum Hinzufügen einer Webdienstaufrufaktivität

    Wichtig

    Ändern Sie den Namen, die Richtung oder den Typ für ein Argument nicht, indem Sie dieses Dialogfeld verwenden. Wenn einer dieser Werte geändert wird, wird die Aktivität ungültig. Legen Sie nur den Wert für das Argument fest. Wie in dieser Abbildung gezeigt, ist der Wert Mitarbeiter festgelegt.

  7. Fügen Sie abschließend eine If-Aktivität hinzu, um die Antworten zu überprüfen, die vom Webdienstvorgang zurückgegeben werden.

Das Ersetzen des Exportworkflows durch den Replace-Vorgang ist abgeschlossen:

Ersetzen des Exportworkflows

Speichern Sie dieses Projekt am Speicherort %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.

Debuggen von Aktivitäten

Die folgenden benutzerdefinierten Aktivitäten sind verfügbar, um die Workflowvorlage zu debuggen.

Protokollaktivität

Die Protokollaktivität wird verwendet, um Textnachrichten in die Protokolldatei zu schreiben. Weitere Informationen finden Sie unter Protokollierung.

Hinweis

Wenn Sie Ihren Workflow nicht einfach debuggen können, versuchen Sie, den Workflow in der Produktionsumgebung zu debuggen.

Um die Protokollaktivität zu verwenden, legen Sie die folgenden Eigenschaften fest. Die Eigenschaften werden angezeigt, wenn Sie die Aktivität in Workflow Designer auswählen und die Eigenschaften für die Aktivität anzeigen.

WriteLine-Aktivität

Die WriteLine-Aktivität wird verwendet, um Textnachrichten an den Writer eines Anbieters zu schreiben. Wenn kein Writer verfügbar ist, schreibt die WriteLine-Aktivität den Text in das Konsolenfenster.

Schreiben Sie in das Textfeld die Nachricht, die im Writerziel sichtbar sein soll.

Wichtig

Das Konsolenfenster kann nicht für diese Aktivität verwendet werden. Verwenden Sie einen anderen Fensterausgabeschreiber für diese Aufgabe.

Um die WriteLine-Aktivität zu verwenden, legen Sie die folgenden Eigenschaften fest. Die Eigenschaften werden angezeigt, wenn Sie die Aktivität in Workflow Designer auswählen und die Eigenschaften für die Aktivität anzeigen.

  • Protokollebene: Gibt die Menge an Inhalt an, die in den Protokollwert geschrieben werden soll. Mögliche Werte:

    • Hoch: Schreiben Sie die LogText-Nachricht in die Protokolldatei, wenn der Protokollschweregrad auf Hoch festgelegt ist.
    • Ausführlich: Schreiben Sie die LogText-Nachricht in die Protokolldatei, wenn der Protokollschweregrad auf Ausführlich festgelegt ist.
    • Deaktiviert: Schreiben Sie nicht in die Protokolldatei.
  • LogText: Gibt den Textinhalt an, der in das Protokoll geschrieben werden soll.

  • Tag: Fügt dem Text ein Tag hinzu, um den Typ des Inhalts zu identifizieren, der im Protokoll geschrieben wird. Die möglichen Werte sind: Fehler, Ablaufverfolgung oder Warnung.

Nächste Schritte