Web Service Connector-Workflowhandbuch für SOAP

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

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

   

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

   

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

   • Der name des neuen Webdiensts
   • Adresse (WSDL-Pfad), um die verfügbar gemachten Dienste, Endpunkte und Vorgänge abzurufen
   • Namespace
   • Sicherheitsmodus (Authentifizierungstyp)

4. In diesem Beispiel wird die Seite "Anmeldeinformationen " mit den Anforderungen für den Standardsicherheitsmodus (der im vorherigen Schritt ausgewählte Modus) angezeigt. Wenn "None" für den Sicherheitsmodus angegeben wurde, wird keine Anmeldeinformationenseite angezeigt. Wählen Sie Weiteraus.

   

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, kann das Konfigurationstool die Dienstinformationen nicht abrufen und einen Fehler auslösen.

   

6. Nachdem die Ermittlung durchgeführt wurde, werden der Endpunkt und die ermittelten Vorgänge aufgelistet. Klicken Sie auf Fertig stellen.

   

7. Kompilierung wird ausgeführt. Bei der Kompilierung handelt es sich um einen Prozess zum Kompilieren der Datenvertragsassembly, was ein zeitaufwändiger Vorgang sein kann. Der Benutzer wird über Kompilierungsfehler informiert. Nachdem die Ermittlung durchgeführt wurde, zeigt das Tool die folgende Seite an:

   

8. Erweitern Sie SOAP-Projekt und wählen Sie den exponierten Endpunkt aus, um den folgenden Bildschirm zu erhalten. Dieser Bildschirm listet die Vorgänge auf, die unter dem Endpunkt deklariert werden.

   

9. Durch Erweitern des Endpunkts wird eine Liste der Vorgänge angezeigt. Ein Vorgang ist eine Funktion, die von einem Endpunkt deklariert wird. Jeder Vorgang behebt einen Vorgangstyp, der innerhalb des Diensts ausgeführt werden kann. Dieser Bildschirm listet die Argumente auf, die für den Vorgang deklariert werden. Diese Argumente werden dann definiert, wenn der Vorgang beim Konfigurieren der Workflows verwendet wird.

   

10. Der nächste Schritt besteht darin, das Verbinderraumschema zu definieren, das durch Erstellen des Objekttyps und Definieren ihrer 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. Wählen Sie OK aus.

    

11. Wenn Sie einen Objekttyp hinzufügen, wird die folgende Seite angezeigt.

    

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 aus. Ein neues Fenster wird geöffnet, um Attribute hinzuzufügen:

    

    

13. Der folgende Bildschirm wird nach dem Hinzufügen aller erforderlichen Attribute angezeigt:

    

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

    

Konfigurieren von Workflows im Webdienstkonfigurationstool

Der nächste Schritt besteht darin, die Workflows für Den Objekttyp zu konfigurieren. Workflow-Dateien sind eine Reihe von Aktivitäten, die vom Konnektor der Webdienste zur Ausführung 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 von Daten aus einer Datenquelle für die folgenden beiden Workflowtypen:

  • Vollständiger Import: Ein vollständiger Import, der konfiguriert werden kann.
  • Delta-Import: 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
  • Ersetzen:

• Kennwort: Durchführen der Kennwortverwaltung für den Benutzer (Objekttyp). Für diesen Vorgang stehen zwei Aktionen zur Verfügung:

  • Kennwort festlegen
  • Kennwort ändern

• Testverbindung: 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

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

Der Workflow-Designer besteht aus den folgenden UI-Elementen:

• Knoten im linken Bereich: Diese helfen Ihnen, auszuwählen, welche Workflows Sie entwerfen möchten.

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

  • Im zentralen Workflow-Designer weist ein roter Kreis mit Ausrufezeichen neben jeder Aktivität darauf hin, dass der Vorgang verworfen wurde und nicht richtig und vollständig definiert ist. Zeigen Sie auf den roten Kreis, um den genauen Fehler zu ermitteln. Nachdem die Aktivität richtig definiert wurde, ändert sich der rote Kreis in das gelbe Informationszeichen.

  • Im zentralen Workflow-Designer weist ein gelbes Dreiecksinformationszeichen neben jeder Aktivität darauf hin, dass die Aktivität definiert ist, aber es gibt mehr, die Sie tun können, 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-.

• Toolbox-Abschnitte: Die Toolbox enthält die folgenden Abschnitte und Kategorien:

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

  • Import-Workflow: Benutzerdefinierte Aktivitäten zum Einrichten von Import-Workflows.

  • Export-Workflow: Benutzerdefinierte Aktivitäten zum Konfigurieren von Export-Workflows.

  • Allgemein: Angepasste Aktivitäten zur Konfiguration eines Workflows.

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

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

• Eigenschaften: Auf der Registerkarte "Eigenschaften" werden die Eigenschaften einer bestimmten Workflowaktivität angezeigt, die im Designerbereich abgelegt und ausgewählt wird. Die Abbildung auf der linken Seite zeigt die Eigenschaften der Aktivität Zuweisen. Bei jeder 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 Eigenschaften.

• Vorgangsleiste: Die Taskleiste enthält drei Elemente: Variablen, Argumenteund Imports. 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 workflows für den vollständigen Import 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 Vollständigen Importworkflow aus. Die Argumente und Importe sind bereits definiert und sind spezifisch für die Aktivitäten. Weitere Informationen finden Sie in den folgenden Bildschirmen.

   

   

   Ändern Sie nach der Neukonfiguration der Aufrufe die Namen der Attribute, die den Namespace ändern, hinzufügen oder in Variablen ändern, die sich auf die Rückgabestruktur der API und der Objekttypen beziehen, die sich auf den alten Namespace beziehen. 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 möchten. 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 Aktivität Sequenz hinzu. Ziehen Sie den Aktivitätsdesigner Sequenz aus der Toolbox und legen Sie ihn auf der Oberfläche des Windows Workflow Designers ab. Siehe die folgenden Bildschirme. Die Aktivität Sequenz enthält eine geordnete Collection von untergeordneten Aktivitäten, die sie der Reihe nach ausführt.

   

3. Um eine Variable hinzuzufügen, suchen Sie Create Variable. Geben Sie wsResponse als Name ein, wählen Sie die Dropdown-Liste Variablentyp und wählen Sie dann Durchsuchen nach Typen. Ein Dialogfeld wird angezeigt. Wählen Sie die generierte>Standardantwort>aus. Lassen Sie die Werte Umfang und Standard unmarkiert. Alternativ können Sie diese Werte auch über die Ansicht Eigenschaften festlegen.

   

   

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

   

5. Ziehen Sie einen weiteren Sequenz Aktivitätsdesigner aus der Toolbox innerhalb der bereits hinzugefügten Sequenz-Aktivität.

6. Ziehen Sie eine WebServiceCallActivity, die unter Common. präsentiert wird. Diese Aktivität dient dazu, eine nach der Erkennung verfügbare Webdienst-Operation aufzurufen. Dies ist eine benutzerdefinierte Aktivität, die in verschiedenen Vorgangsszenarien üblich ist.

   

   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 jeweiligen Vorgang für den Dienst an.

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

     Zuweisen von Argumenten

     Von Bedeutung

     Ändern Sie den Name, Richtung oder Typ für ein Argument nicht über diesen Dialog. Wenn eine 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 unter WebServiceCallActivity hinzu. Diese Aktivität wird verwendet, um alle Attribute (sowohl Anker als auch Nichtanker) des Objekttyps zu iterieren. Beim Ziehen dieser Aktivität in die Workflow-Designer-Oberfläche werden automatisch alle Attributnamen für Ihr Objekt aufgezählt. Legen Sie die erforderlichen Werte gemäß folgendem Bildschirm fest:

   

8. Ziehen Sie eine CreateCSEntryChangeScope Aktivität in den ForEach-Teil. Diese Aktivität wird verwendet, um eine Instanz des CSEntryChange-Objekts in der Workflowdomäne für jeden jeweiligen Datensatz zu erstellen, während Daten aus der Zieldatenquelle abgerufen werden. Wenn Sie diese Aktivität ziehen, wird die folgende Seite angezeigt. CreateAnchorAttribute-Aktivitäten werden automatisch vererbt.

   

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

   

   Hinweis

   Verankerungswerte und Objektnamen variieren je nach dem verfügbar gemachten 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 ist gleich der Anzahl der Nicht-Anker-Attribute. Siehe die folgende Abbildung als Referenz.

    erstellen

11. Ziehen Sie CreateValueChangeActivity innerhalb der CreateAttributeChange-Aktivität und legen Sie den Attributwert gemäß dem untenstehenden Bildschirm fest.

    

    Hinweis

    Um diese Aktivität zu verwenden, wählen Sie die entsprechenden Felder aus der Dropdownliste aus, und weisen Sie die Werte zu. Bei mehrwertigen Attributen legen Sie mehrere CreateValueChangeActivity-Aktivitäten innerhalb einer CreateAttributeChangeActivity-Aktivität ab.

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

    

13. Fügen Sie schließlich eine Assign-Aktivität hinzu, und legen Sie den Ausdruck fest, wie in der folgenden Abbildung dargestellt:

    

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

    Standardprojekte sollten an Standort %FIM_INSTALL_DIR\2010\Synchronization Service\Extensions auf dem Zielsystem heruntergeladen und gespeichert werden. Die Projekte sind dann im Assistenten des Konnektors für Webdienste sichtbar.

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

    Von Bedeutung

    Die Projektdatei kann an jedem Speicherort gespeichert und geöffnet werden, vorausgesetzt, der Ausführende verfügt über die entsprechenden Zugriffsrechte. Nur Projektdateien, die im ordner Synchronization Service\Extension gespeichert werden, können im Webdienst-Connector-Assistenten ausgewählt werden, auf den über die MIM-Synchronisierungs-UI zugegriffen wird.

    Der Benutzer, der das Webdienstkonfigurationstool ausführt, erfordert die folgenden Berechtigungen:

    • Vollzugriff auf den Ordner "Erweiterung des Synchronisierungsdiensts".
    • Lesezugriff auf den Registrierungsschlüssel HKLM\System\CurrentControlSet\Services\FIMSynchronizationService\Parameters, in dem sich der Speicherort 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 diese Schritte im Webdienstkonfigurationstool ausführen.

1. Wählen Sie den zu konfigurierenden Exportworkflow aus. Wählen Sie unter "Exportieren" die Option "Hinzufügen" aus. Die Argumente und Importe sind bereits definiert und sind spezifisch für die Aktivitäten. Siehe die folgenden Bildschirme zur Referenz.

   

2. Fügen Sie eine Sequenzaktivität hinzu. Ziehen Sie den Aktivitätsdesigner Sequenz aus der Toolbox und legen Sie ihn auf der Oberfläche des Windows Workflow Designers ab. Die Aktivität Sequenz enthält eine geordnete Collection von untergeordneten Aktivitäten, die sie der Reihe nach ausführt. Wählen Sie "Variable erstellen" aus. Weisen Sie die Werte den Variablen zu, die Sie für Ihre Logik verwenden möchten.

   

   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 über Ankerattributwerte zu iterieren.

4. Wählen Sie "Eigenschaften" aus, und legen Sie die Werte wie unten auf dem Bildschirm fest. Hier ist objectToExport ein Argument.

   

5. Setzen Sie DisplayName als ForEach<AnchorAttribute>

   

6. Set TypeArgument as Microsoft.MetadirectoryServices.AnchorAttribute.

   

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

   

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

   

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 Zuweisungsaktivität hinzu.

   

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

    

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

    

12. Fügen Sie eine Switch Aktivität innerhalb des ForEach Körpers des AttributeChange Ankers hinzu.

    

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

    

14. Wählen Sie "Neuen Fall hinzufügen " aus, und geben Sie einen Wert für " FirstName" ein. Ziehen Sie eine Sequenzaktivität und fügen Sie darin eine Zuweisungsaktivität hinzu. Weisen Sie die Eigenschaften An und Wert für die Aktivität Zuweisen zu.

    

15. Fügen Sie Werte für die erforderlichen Attribute wie Nachname, E-Mail usw. hinzu.

    

16. Ziehen Sie unter "Allgemein" eine WebServiceCallActivity, und legen Sie Werte für die zugehörigen Argumente fest.

    

    Von Bedeutung

    Ändern Sie den Name, Richtung oder Typ für ein Argument nicht über diesen Dialog. Wenn eine 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 schließlich eine If-Aktivität hinzu, um Antworten zu überprüfen, die vom Webdienstvorgang zurückgegeben werden.

Die Erstellung des Exportworkflows mit dem Add-Vorgang ist abgeschlossen:

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

Löschen von Workflows

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

1. Wählen Sie den zu konfigurierenden Exportworkflow aus. Wählen Sie unter "Exportieren" die Option "Löschen" aus. Die Argumente und Importe sind bereits definiert und sind spezifisch für die Aktivitäten. Siehe die folgenden Bildschirme zur Referenz.

   

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 möchten.

   

   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 einer bereits hinzugefügten Sequence Aktivität, um über Ankerattributwerte zu iterieren.

4. Wählen Sie Eigenschaften und stellen Sie die Werte gemäß dem folgenden Bildschirm ein. Hier ist objectToExport ein Argument.

   

5. Setzen Sie den DisplayName als ForEach\<AnchorAttribute\>:

   

6. Setzen Sie das TypeArgument als Microsoft.MetadirectoryServices.AnchorAttribute:

   

7. Fügen Sie eine Switch Aktivität innerhalb des ForEach Körpers des AnchorAttributehinzu.

   

8. Fügen Sie einen Ausdruck hinzu, wie auf dem Bildschirm unten gezeigt.

   

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

   

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

    

11. Ziehen Sie unter "Allgemein" eine WebServiceCallActivity, und legen Sie Werte für die zugehörigen Argumente fest.

    

    Von Bedeutung

    Ändern Sie den Name, Richtung oder Typ für ein Argument nicht über diesen Dialog. Wenn eine 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, wird der Wert employeeID festgelegt.

12. Fügen Sie schließlich eine If-Aktivität hinzu, um die Antworten zu überprüfen, die von der Webservice-Operation zurückgegeben wurden.

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

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

Ersetzen von Workflows

Ersetzen Sie Exportworkflows durch Ausführen dieser Schritte im Webdienstkonfigurationstool.

1. Wählen Sie den zu konfigurierenden Exportworkflow aus. Wählen Sie unter "Exportieren" die Option "Ersetzen" aus. Die Argumente und Importe sind bereits definiert und sind spezifisch für die Aktivitäten. Siehe den untenstehenden Bildschirm als Referenz.

   

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 Nichtankerwerte zuzuweisen.

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

   

6. Ziehen Sie unter "Allgemein" eine WebServiceCallActivity, und legen Sie Werte für die zugehörigen Argumente fest.

   

   Von Bedeutung

   Ändern Sie den Name, Richtung oder Typ für ein Argument nicht über diesen Dialog. Wenn eine dieser Werte geändert wird, wird die Aktivität ungültig. Legen Sie nur den Wert für das Argument fest. Der Wert Mitarbeiter wird festgelegt, wie in dieser Abbildung gezeigt.

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

Der Austausch des Exportworkflows durch den Ersetzungsvorgang ist abgeschlossen:

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

Debugaktivitäten

Die folgenden benutzerdefinierten Aktivitäten stehen zur Verfügung, um die Workflowvorlage zu debuggen.

Protokollaktivität

Die Protokollaktivität wird verwendet, um Textnachrichten in die Protokolldatei zu schreiben. Weitere Informationen siehe Logging.

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 sind sichtbar, wenn Sie die Aktivität im Workflow-Designer auswählen und die Eigenschaften für die Aktivität anzeigen.

WriteLine-Aktivität

Die Aktivität WriteLine wird verwendet, um Textnachrichten an den Writer eines Providers 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 Writer-Ziel angezeigt werden soll.

Von Bedeutung

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

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

• Protokollebene: Gibt die Menge des Inhalts an, der in den Protokollwert geschrieben werden soll. Mögliche Werte sind:

  • Hoch: Schreiben Sie die LogText-Nachricht in die Protokolldatei, wenn der Schweregrad des Protokolls auf "Hoch" festgelegt ist.
  • Verbose: Schreibt die Meldung LogText in die Protokolldatei, wenn der Schweregrad des Protokolls auf Ausführlich eingestellt ist.
  • Deaktiviert: Schreiben Sie nicht in die Protokolldatei.

• LogText: Gibt den Textinhalt an, der im Protokoll geschrieben werden soll.

• Tag: Fügt dem Text ein Tag hinzu, um den Inhaltstyp zu identifizieren, der im Protokoll geschrieben wird. Die möglichen Werte sind: Error, Trace oder Warning.

Nächste Schritte

• Übersicht über den generischen Konnektor für Webdienste
• Installieren des Webdienstkonfigurationstools
• SOAP-Bereitstellungshandbuch
• REST-Bereitstellungshandbuch
• Webdienst MA-Konfiguration