Guide de flux de travail du connecteur de service Web pour SOAP

Cet article explique comment créer un projet pour votre source de données dans l’outil de configuration de service Web. Pour créer un projet, procédez comme suit.

  1. Ouvrez l’outil de configuration du service Web. Il ouvre un projet vide.

    Outil de configuration de service Web

  2. sélectionnez SOAP Project , puis sélectionnez ajouter.

    Projet SOAP

  3. Sur la page suivante, fournissez les informations suivantes, puis sélectionnez suivant:

    • Nouveau nom du service Web
    • Adresse (chemin WSDL) pour récupérer les services, les points de terminaison et les opérations exposés
    • Espace de noms
    • Mode de sécurité (type d’authentification)
  4. Dans cet exemple, la page informations d’identification est indiquée avec la configuration requise pour le mode de sécurité de base (le mode qui a été sélectionné à l’étape précédente). Si la valeur « None » a été spécifiée pour le mode de sécurité, aucune page d’informations d’identification ne s’affiche. Sélectionnez Suivant.

    Écran du service SOAP avec nom d’utilisateur et mot de passe

  5. Le chemin d’accès WSDL est accessible pour récupérer les informations de service et la liste des fonctions exposées s’affiche. Si le chemin d’accès WSDL entré est incorrect, l’outil de configuration ne parvient pas à récupérer les informations de service et génère une erreur.

    écran de progression du téléchargement du service Web

  6. Une fois la détection effectuée, elle répertorie le point de terminaison et les opérations découvertes. Sélectionnez Terminer.

    Points de terminaison de service SOAP et opérations découvertes

  7. La compilation est effectuée. La compilation est un processus de compilation de l’assembly de contrat de données, qui peut être une opération longue. L’utilisateur est informé des erreurs de compilation. Une fois la détection effectuée, l’outil affiche la page suivante :

    Détection SOAP

  8. Développement du projet SOAP et sélection du point de terminaison exposé ci-dessous. Cet écran répertorie les opérations qui sont déclarées sous le point de terminaison.

    Opérations déclarées sous le point de terminaison

  9. Le point de terminaison de développement affiche la liste des opérations. Une opération est une fonction déclarée par un point de terminaison. Chaque opération traite un type de tâche qui peut être effectué au sein du service. Cet écran répertorie les arguments qui sont déclarés pour l’opération. Ces arguments sont ensuite définis lorsque l’opération est utilisée pour la configuration des flux de travail.

    Points de terminaison étendus

  10. L’étape suivante consiste à définir le schéma de l’espace connecteur, qui est obtenu en créant le type d’objet et en définissant ses types d’objets. Sélectionnez types d’objets , puis Ajouter. Dans la nouvelle fenêtre, ajoutez un nouveau type d’objet et fournissez un nom. Sélectionnez OK.

    Définition du type d’objet

  11. L’ajout d’un type d’objet fournit un écran ci-dessous.

    affichage du type d’objet nouvellement créé

  12. Le volet droit correspondant au type d’objet vous permet de conserver les attributs et leurs propriétés pour le type d’objet sélectionné. Sélectionnez Ajouter. Une nouvelle fenêtre s’ouvre pour ajouter des attributs :

    Attribut et type de données

    Attribut et type de données avec option d’ancrage sélectionnée

  13. L’écran suivant s’affiche après l’ajout de tous les attributs requis :

    Type d’objet avec les informations d’attribut

  14. les attributs et le type d’objet une fois créés, fournissent des flux de travail vides qui répondent aux opérations effectuées dans Microsoft Identity Manager 2016 (MIM).

    Types d’objets affiche les opérations que l’employé peut effectuer

Configurer des flux de travail dans l’outil de configuration de service Web

L’étape suivante consiste à configurer les flux de travail pour votre type d’objet. Les fichiers de flux de travail sont une série d’activités utilisées par le connecteur de services Web au moment de l’exécution. les flux de travail sont utilisés pour implémenter l’opération de MIM appropriée. L’outil de configuration de service Web vous aide à créer quatre workflows différents :

  • Importation : importez des données à partir d’une source de données pour les deux types de flux de travail suivants :

    • Importation complète : importation complète qui peut être configurée.
    • Importation différentielle : non prise en charge par l’outil de configuration de service Web.
  • exportation : exportez des données à partir de MIM vers une source de données connectée. Les trois actions suivantes sont prises en charge pour l’opération. Vous pouvez configurer ces actions en fonction de vos besoins.

    • Ajouter
    • Supprimer
    • Replace
  • Mot de passe : effectuer la gestion des mots de passe pour l’utilisateur (type d’objet). Deux actions sont disponibles pour cette opération :

    • Définition du mot de passe
    • Modifier le mot de passe
  • Tester la connexion : configurez un flux de travail pour vérifier si la connexion avec le serveur de source de données a été établie.

Notes

Vous pouvez configurer ces flux de travail pour votre projet ou télécharger le projet par défaut à partir du Centre de téléchargement Microsoft.

Concepteur de flux de travail

Le Concepteur de flux de travail ouvre la zone de travail pour configurer le flux de travail conformément à la spécification. Pour chaque type d’objet (New/existing), l’outil de configuration fournit les nœuds pour les flux de travail pris en charge par l’outil.

Concepteur de flux de travail

La Concepteur de flux de travail est composée des éléments d’interface utilisateur suivants :

  • Nœuds dans le volet gauche: ils vous aident à sélectionner le flux de travail à utiliser pour la conception.

  • Concepteur de flux de travail centrale: vous pouvez ici supprimer les activités de configuration des flux de travail. pour effectuer diverses opérations de MIM (exportation, importation, gestion des mots de passe), vous pouvez utiliser les activités de flux de travail standard et personnalisées de .net workflow Framework 4. L’outil de configuration de service Web utilise des activités de flux de travail standard et personnalisées. Pour plus d’informations sur les activités standard, consultez utilisation des concepteurs d’activités.

    • Dans le Concepteur de flux de travail central, un cercle rouge avec un point d’exclamation à côté d’une activité indique que l’opération a été supprimée et qu’elle n’est pas définie correctement et complètement. Pointez sur le cercle rouge pour trouver l’erreur exacte. Une fois l’activité définie correctement, le cercle rouge passe à la marque d’information jaune.

    • Dans le Concepteur de flux de travail central, une marque d’information de triangle jaune en regard de toute activité indique que l’activité est définie, mais il existe d’autres opérations que vous pouvez effectuer pour terminer l’activité. Pointez sur le triangle jaune pour afficher plus d’informations.

  • Boîte à outils: empaquette tous les outils, y compris les activités système et personnalisées, ainsi que des instructions prédéfinies pour concevoir le flux de travail. Pour plus d'informations, consultez Boîte à outils.

  • Sections de la boîte à outils: la boîte à outils contient les sections et les catégories suivantes :

    • Description: l’en-tête de la boîte à outils. Un onglet accède à la boîte à outils et aux propriétés de l’activité de workflow sélectionnée.

    • Importer un flux de travail: activités personnalisées pour configurer des flux de travail d’importation.

    • Exporter le flux de travail: activités personnalisées pour configurer des flux de travail d’exportation.

    • Commun: activités personnalisées pour configurer un flux de travail.

    • Débogage: activités de flux de travail système pour le débogage défini dans Workflow 4. Ces activités permettent le suivi des problèmes pour un flux de travail.

    • Instructions: activités de flux de travail système définies dans le workflow 4. Pour plus d’informations, consultez utilisation des concepteurs d’activités.

  • Propriétés: l’onglet Propriétés affiche les propriétés d’une activité de workflow particulière qui est supprimée dans la zone du concepteur et sélectionnée. La figure à gauche montre les propriétés de l’activité Assign . Pour chaque activité, les propriétés diffèrent et sont utilisées lors de la configuration du flux de travail personnalisé. Cet onglet vous permet de définir les attributs de l’outil sélectionné qui a été déposé dans le concepteur de flux de travail central. Pour plus d'informations, consultez Propriétés.

  • Barre des tâches : La barre des tâches comprend trois éléments : variables, argumentset importations. Ces éléments sont utilisés avec les activités de flux de travail. pour plus d’informations, consultez la page présentation d’Windows Workflow Foundation (WF) du développeur dans .net 4.

Configurer un flux de travail d’importation complet dans l’outil de configuration de service Web

Les étapes suivantes montrent comment configurer des flux de travail d’importation complets pour SOAP à l’aide de l’outil de configuration de service Web.

Avertissement

Cet exemple crée uniquement un flux de travail. Les modifications apportées au flux de travail, telles que l’utilisation d’une logique personnalisée dans l’API, peuvent être nécessaires.

  1. Sélectionnez le flux de travail d’importation complet à configurer. Les arguments et les importations sont déjà définis et sont spécifiques aux activités. Pour plus d’informations, consultez les écrans suivants.

    Arguments du flux de travail d’importation complète

    Espaces de noms importés

    Après la reconfiguration des appels, modifiez les noms des attributs qui changent, ajoutez ou modifiez l’espace de noms en variables qui font référence à la structure de retour de l’API et les types d’objets qui font référence à l’ancien espace de noms. La boîte à outils dans le volet droit contient toutes les activités personnalisées spécifiques au flux de travail dont vous avez besoin pour la configuration. Affectez les valeurs aux variables que vous allez utiliser pour votre logique. Accédez à la section inférieure du concepteur de flux de travail central et déclarez les variables. Les variables sont déclarées à l’étape suivante.

  2. Ajoutez une activité Sequence. faites glisser le concepteur d’activités Sequence de la boîte à outils et déposez-le sur la surface de Concepteur de flux de travail Windows. Reportez-vous aux écrans suivants. L’activité Sequence contient une collection ordonnée d’activités enfants qu’elle exécute dans l’ordre.

    Activité de séquence

  3. Pour ajouter une variable, recherchez créer une variable. Tapez wsResponse pour le nom, sélectionnez la liste déroulante type de variable , puis sélectionnez Parcourir les types. Une boîte de dialogue s’affiche. Sélectionnez la réponse par défautgénérée . Conservez la sélection de l' étendue et des valeurs par défaut . Vous pouvez également définir ces valeurs à l’aide de la vue Propriétés .

    Réponse par défaut

    Propriétés de l’importation complète

  4. À présent, ajoutez toutes les autres variables et voici l’écran final.

    Variables d’importation complètes

  5. Faites glisser un autre concepteur d’activités Sequence de la boîte à outils au sein de l’activité Sequence déjà ajoutée.

  6. Faites glisser un WebServiceCallActivity présenté sous Common. Cette activité est utilisée pour appeler l’opération de service Web disponible après la découverte. Il s’agit d’une activité personnalisée qui est courante dans différents scénarios d’opération.

    Opération de nom de service

    Pour utiliser l’opération de service Web, définissez les propriétés suivantes :

    • Nom du service: entrez un nom pour le service Web.

    • Nom du point de terminaison: spécifiez un nom de point de terminaison pour le service sélectionné.

    • Nomde l’opération : spécifiez l’opération correspondante pour le service.

    • Argument: sélectionnez arguments. Dans la boîte de dialogue suivante, assignez les valeurs d’argument, comme illustré dans la figure suivante :

      Affecter des arguments

      Important

      Ne modifiez pas le nom, la directionou le type d’un argument à l’aide de cette boîte de dialogue. Si l’une de ces valeurs est modifiée, l’activité devient non valide. Définissez uniquement la valeur de l’argument. Comme illustré dans cette figure, la valeur wsResponse est définie.

  7. Ajoutez une activité foreach juste en dessous de WebServiceCallActivity. Cette activité est utilisée pour effectuer une itération sur tous les attributs (ancres et non-ancres) du type d’objet. Tout en faisant glisser cette activité dans la surface de Concepteur de flux de travail, elle énumère automatiquement tous les noms d’attribut de votre objet. Définissez les valeurs requises en fonction de l’écran suivant :

    Activité d’appel du service Web

  8. Faites glisser une activité CreateCSEntryChangeScope dans le corps foreach . Cette activité est utilisée pour créer une instance de l’objet CSEntryChange dans le domaine de workflow pour chaque enregistrement respectif lors de la récupération des données à partir de la source de données cible. Si vous faites glisser cette activité, l’écran ci-dessous s’affiche. Les activités CreateAnchorAttribute sont héritées automatiquement.

    Créer une activité d’étendue de modification d’entrée CS

  9. Définissez la valeur de l’expression DN comme ‘string.Concat ("Employee",item.EmployeeID)’ . Définissez AnchorValue pour EmployeeID sur «Convert. ToString (Item. EmployeeID) '. Définissez ObjectTypeName comme Employee. Après avoir apporté ces modifications, l’écran suivant s’affiche :

    Obtient l’ID de l’employé

    Notes

    Les valeurs d’ancrage et les noms d’objets varient en fonction du service Web exposé. L’illustration montre un exemple.

  10. Faites glisser une activité CreateAttributeChange sous l’activité CreateAnchorAttribute . Le nombre d’activités à faire glisser est égal au nombre d’attributs sans ancrage. Consultez la figure suivante pour référence.

    Créer un point d’ancrage

  11. Faites glisser CreateValueChangeActivity dans l’activité CreateAttributeChange et définissez la valeur d’attribut comme indiqué ci-dessous.

    Modifier un attribut

    Notes

    Pour utiliser cette activité, choisissez et assignez les champs correspondants à partir de la liste déroulante et assignez les valeurs. Pour les attributs à valeurs multiples, supprimez plusieurs activités CreateValueChangeActivity dans une activité CreateAttributeChangeActivity .

  12. Pour ajouter des conditions pour un attribut, ajoutez une activité If comme indiqué dans l’illustration suivante :

    Activité If

  13. Enfin, ajoutez une activité Assign et définissez l’expression, comme illustré dans la figure suivante :

    Affecter une activité et définir l’expression

  14. Enregistrez ce projet à l’emplacement %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions .

    Les projets par défaut doivent être téléchargés et enregistrés à l’emplacement %FIM_INSTALL_DIR\2010\Synchronization Service\Extensions sur le système cible. Les projets sont ensuite visibles dans l’Assistant connecteur de service Web.

    Lorsque vous exécutez le fichier exécutable, vous êtes invité à spécifier l’emplacement de l’installation. Entrez l’emplacement d’enregistrement.

    Important

    Le fichier projet peut être enregistré et ouvert à partir de n’importe quel emplacement (avec les privilèges d’accès appropriés de son exécuteur). seuls les fichiers projet enregistrés dans le Synchronization Service\Extension dossier peuvent être sélectionnés dans l’assistant connecteur de Service Web accessible via l’interface utilisateur de synchronisation MIM.

    L’utilisateur qui exécute l’outil de configuration de service Web requiert les privilèges suivants :

    • Contrôle total du dossier d’extension du service de synchronisation.
    • Accès en lecture à la clé de Registre HKLM\System\CurrentControlSet\Services\FIMSynchronizationService\Parameters via laquelle se trouve le chemin d’accès au dossier d’extension.

Configurer des flux de travail d’exportation dans l’outil de configuration de service Web

Les sections suivantes montrent comment exporter vos flux de travail à l’aide de l’outil de configuration de service Web.

Ajouter des flux de travail

Ajoutez des flux de travail d’exportation en suivant ces étapes dans l’outil de configuration de service Web.
  1. Sélectionnez le flux de travail d’exportation à configurer. Sous Exporter, sélectionnez Ajouter. Les arguments et les importations sont déjà définis et sont spécifiques aux activités. Consultez les écrans suivants pour référence.

    Complémentaires

  2. Ajoutez une activité Sequence . faites glisser le concepteur d’activités Sequence de la boîte à outils et déposez-le sur la surface de Concepteur de flux de travail Windows. L’activité Sequence contient une collection ordonnée d’activités enfants qu’elle exécute dans l’ordre. Sélectionnez créer une variable. Affectez les valeurs aux variables que vous allez utiliser pour votre logique.

    Exporter

    Notes

    La procédure d’ajout d’une variable est décrite dans la section relative à la création de flux de travail d’importation complets.

  3. Faites glisser une activité foreach dans l’activité Sequence déjà ajoutée pour itérer au sein des valeurs d’attribut d’ancrage.

  4. Sélectionnez Propriétés et définissez les valeurs comme indiqué ci-dessous. Ici, objectToExport est un argument.

    Définir les propriétés de l’activité ForEach

  5. Définir DisplayName comme foreach AnchorAttribute

    Définir le nom complet

  6. Définissez TypeArgument en tant que .

    Définir l’argument de type

  7. Ajoutez une activité switch dans le corps foreach du AnchorAttribute.

    Ajouter une activité de commutateur

  8. Ajoutez une expression comme indiqué ci-dessous.

    Ajouter une expression

  9. Sélectionnez Ajouter un nouveau cas , puis entrez une valeur pour EmployeeID. Faites glisser une activité Sequence et dans celle-ci, ajoutez une activité Assign .

    Ajouter un nouveau cas et l’affecter à la séquence

  10. Assignez les propriétés to et value pour l’activité Assign .

    Assigner les propriétés to et value

  11. L’activité foreach est utilisée pour les valeurs d’ancrage. Ajoutez une autre activité foreach pour assigner des valeurs non-ancres. Dans cet exemple, l’ancre AttributeChange est utilisée.

    Ajouter une autre activité ForEach avec l’ancre AttributeChange

  12. Ajoutez une activité switch dans le corps foreach de l’ancre AttributeChange .

    Ajouter l’activité du commutateur pour l’ancre AttributeChange

  13. Ajoutez une expression comme indiqué ci-dessous.

    Ajouter une expression pour l’activité Switch

  14. Sélectionnez Ajouter un nouveau cas et entrez une valeur pour le prénom. Faites glisser une activité Sequence et dans celle-ci, ajoutez une activité Assign . Assignez les propriétés to et value pour l’activité Assign .

    Ajouter un nouveau cas pour la séquence

  15. Ajoutez des valeurs pour les attributs requis tels que LastName, email, etc.

    Ajouter des valeurs pour les attributs requis

  16. Sous Common, faites glisser un WebServiceCallActivity et définissez des valeurs pour ses arguments.

    Ajouter une activité d’appel de service Web et définir les valeurs

    Important

    Ne modifiez pas le nom, la directionou le type d’un argument à l’aide de cette boîte de dialogue. Si l’une de ces valeurs est modifiée, l’activité devient non valide. Définissez uniquement la valeur de l’argument. Comme illustré dans cette figure, la valeur wsResponse est définie.

  17. Enfin, ajoutez une activité If pour vérifier les réponses retournées à partir de l’opération de service Web.

La création du flux de travail d’exportation avec l’opération d' Ajout est terminée :

Flux de travail d’exportation terminé

Enregistrez ce projet à l’emplacement %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions .

Supprimer des workflows

Pour supprimer des flux de travail d’exportation, procédez comme suit dans l’outil de configuration de service Web.

  1. Sélectionnez le flux de travail d’exportation à configurer. Sous Exporter, sélectionnez supprimer. Les arguments et les importations sont déjà définis et sont spécifiques aux activités. Consultez les écrans suivants pour référence.

    Exporter les flux de travail de suppression

  2. Ajoutez une activité Sequence . Sélectionnez créer une variable. Affectez les valeurs aux variables que vous allez utiliser pour votre logique.

    Ajouter une activité Sequence

    Notes

    La procédure d’ajout d’une variable est décrite dans la section relative à la création de flux de travail d’importation complets.

  3. Faites glisser une activité foreach dans l’activité Sequence déjà ajoutée pour itérer au sein des valeurs d’attribut d’ancrage.

  4. Sélectionnez Propriétés et définissez les valeurs par écran ci-dessous. Ici, objectToExport est un argument.

    Définir les propriétés de l’activité ForEach

  5. Définissez DisplayName en tant que :

    Définir le nom complet

  6. Définissez TypeArgument en tant que :

    Définir l’argument de type

  7. Ajoutez une activité switch dans le corps foreach du AnchorAttribute.

    Ajouter une activité de commutateur

  8. Ajoutez une expression comme indiqué ci-dessous.

    Ajouter une expression

  9. Sélectionnez Ajouter un nouveau cas , puis entrez une valeur pour EmployeeID. Faites glisser une activité Sequence et dans celle-ci, ajoutez une activité Assign .

    Ajouter un nouveau cas et l’affecter à la séquence

  10. Assignez les propriétés to et value pour l’activité Assign .

    Assigner les propriétés to et value

  11. Sous Common, faites glisser un WebServiceCallActivity et définissez des valeurs pour ses arguments.

    Ajouter une activité d’appel de service Web et définir les valeurs

    Important

    Ne modifiez pas le nom, la directionou le type d’un argument à l’aide de cette boîte de dialogue. Si l’une de ces valeurs est modifiée, l’activité devient non valide. Définissez uniquement la valeur de l’argument. Comme illustré dans cette figure, la valeur EmployeeID est définie.

  12. Enfin, ajoutez une activité If pour vérifier les réponses retournées par l’opération de service Web.

La suppression du flux de travail d’exportation avec l’opération de suppression est terminée :

Flux de travail d’exportation supprimé

Enregistrez ce projet à l’emplacement %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions .

Remplacer des flux de travail

Remplacez exporter les flux de travail en procédant comme suit dans l’outil de configuration de service Web.

  1. Sélectionnez le flux de travail d’exportation à configurer. Sous Exporter, sélectionnez remplacer. Les arguments et les importations sont déjà définis et sont spécifiques aux activités. Voir l’écran ci-dessous pour référence.

    Remplacer un flux de travail

  2. Ajoutez une activité Sequence .

  3. Faites glisser une activité foreach pour AnchorAttribute .

  4. Ajoutez une autre activité foreach AttributeChange > pour assigner des valeurs non-ancres.

  5. Enfin, l’écran ressemble à l’illustration suivante. Les instructions relatives à la configuration de cette activité sont fournies dans la section relative à l' Ajout de flux de travail d’exportation.

    ForEach avec une activité Switch et un attribut Anchor

  6. Sous Common, faites glisser un WebServiceCallActivity et définissez des valeurs pour ses arguments.

    Ajouter une activité d’appel de service Web et définir les valeurs

    Important

    Ne modifiez pas le nom, la directionou le type d’un argument à l’aide de cette boîte de dialogue. Si l’une de ces valeurs est modifiée, l’activité devient non valide. Définissez uniquement la valeur de l’argument. Comme illustré dans cette figure, la valeur Employee est définie.

  7. Enfin, ajoutez une activité If pour vérifier les réponses retournées à partir de l’opération de service Web.

Le remplacement du flux de travail d’exportation avec l’opération de remplacement est terminé :

Remplacer le flux de travail d’exportation

Enregistrez ce projet à l’emplacement %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions .

Activités de débogage

Les activités personnalisées suivantes sont disponibles pour vous aider à déboguer le modèle de flux de travail.

Activité du journal

L’activité du Journal est utilisée pour écrire des messages texte dans le fichier journal. Pour plus d’informations, consultez Journalisation.

Notes

Si vous n’êtes pas en mesure de déboguer facilement votre flux de travail, essayez de déboguer le flux de travail dans l’environnement de production.

Pour utiliser l’activité du Journal , définissez les propriétés suivantes. Les propriétés sont visibles lorsque vous sélectionnez l’activité dans Concepteur de flux de travail et affichez les Propriétés de l’activité.

Activité WriteLine

L’activité WriteLine est utilisée pour écrire des messages texte dans l’enregistreur d’un fournisseur. Si aucun enregistreur n’est disponible, l’activité WriteLine écrit le texte dans la fenêtre de console.

Dans la zone de texte, écrivez le message que vous souhaitez afficher dans la cible du writer.

Important

La fenêtre de console ne peut pas être utilisée pour cette activité. Utilisez un autre générateur de sortie de fenêtre pour cette tâche.

Pour utiliser l’activité WriteLine , définissez les propriétés suivantes. Les propriétés sont visibles lorsque vous sélectionnez l’activité dans Concepteur de flux de travail et affichez les Propriétés de l’activité.

  • Niveau de journal: spécifie la quantité de contenu à écrire dans la valeur de journal. Les valeurs possibles sont les suivantes :

    • High : écrit le message logText dans le fichier journal si la gravité du journal est définie sur High.
    • Verbose : écrit le message logText dans le fichier journal si la gravité du journal est définie sur Verbose.
    • Désactivé : n’écrit pas dans le fichier journal.
  • LogText: spécifie le contenu de texte à écrire dans le journal.

  • Tag: ajoute une balise au texte pour identifier le type de contenu qui est écrit dans le journal. Les valeurs possibles sont : Error, trace ou Warning.

Étapes suivantes