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.

    Web Service Configuration Tool

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

    SOAP project

  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.

    SOAP service screen with user name and password

  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.

    web service download progress screen

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

    SOAP service endpoints and operations discovered

  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 :

    Soap discovery

  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.

    Operations declared under the end point

  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.

    Expanded endpoints

  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.

    Defining object type

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

    viewing newly created object type

  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 :

    Attribute and data type

    Attribute and data type with Anchor option selected

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

    Object type with attribute information

  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).

    Object Types shows operations that employee can perform

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
    • Remplacer
  • 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.

Workflow Designer

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.

    Full import workflow arguments

    Imported namespaces

    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.

    Sequence activity

  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 .

    Default response

    Full import properties

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

    Full import variables

  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.

    Service name operation

    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 :

      Assign 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 :

    Web Service call activity

  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.

    Create CS entry change scope activity

  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 :

    Get the employee ID

    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.

    Create anchor

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

    Change an attribute

    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 :

    If activity

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

    Assign activity and set the 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.

    Add

  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.

    Export

    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.

    Set the properties for the ForEach activity

  5. Définir DisplayName comme foreach AnchorAttribute

    Set the display name

  6. Définissez TypeArgument en tant que .

    Set the type argument

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

    Add a Switch activity

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

    Add an 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 .

    Add a new case and assign it to the sequence

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

    Assign the To and Value properties

  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.

    Add another ForEach activity with the AttributeChange anchor

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

    Add Switch activity for the AttributeChange anchor

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

    Add an expression for the switch activity

  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 .

    Add a new case for the sequence

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

    Add values for required attributes

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

    Add a Web Service call activity and set the values

    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 :

Completed export workflow

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.

    Export delete workflows

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

    Add a sequence activity

    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.

    Set the properties for the ForEach activity

  5. Définissez DisplayName en tant que :

    Set the display name

  6. Définissez TypeArgument en tant que :

    Set the type argument

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

    Add a Switch activity

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

    Add an 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 .

    Add a new case and assign it to the sequence

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

    Assign the To and Value properties

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

    Add a Web Service call activity and set the values

    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 :

Deleted export workflow

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.

    Replace a workflow

  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 with a Switch activity and anchor attribute

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

    Add a Web Service call activity and set the values

    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é :

Replace export workflow

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