Parcourir, rechercher et obtenir des métadonnées pour les opérations RFC dans SAP

Cette section fournit des instructions sur la façon de parcourir, de rechercher et de récupérer des métadonnées à partir de SAP pour les opérations RFC à l’aide de l’Assistant Ajout d’un plug-in de référence de service d’adaptateur, de l’Assistant Ajout de métadonnées d’adaptateur ou de l’utilisation du complément service d’adaptateur. La plupart des instructions sont les mêmes pour les trois interfaces utilisateur. Le cas échéant, des procédures distinctes sont fournies pour l’interface utilisateur appropriée.

Avant d’effectuer les étapes fournies dans les sections suivantes, vous devez disposer des éléments suivants :

• Création d’un projet Visual Studio.

• Connectez-vous au système SAP à l’aide du complément Consommer le service d’adaptateur, de l’Assistant Ajout de métadonnées d’adaptateur ou de l’ajout d’un plug-in de référence de service d’adaptateur. Pour obtenir des instructions, consultez Se connecter au système SAP dans Visual Studio.

Navigation dans les RFC dans un système SAP

Lors de la navigation dans les métadonnées à l’aide du complément Consommer le service d’adaptateur, de l’Assistant Ajout de métadonnées de l’adaptateur ou du plug-in Ajouter une référence de service d’adaptateur, l’adaptateur SAP est exposé :

• RFC en tant qu’opérations pouvant être appelées sur le système SAP.

• Opération RfcGetAttributes, qui permet aux clients de l’adaptateur d’obtenir des informations sur les paramètres de connexion RFC.

  Pour plus d’informations sur la navigation dans les métadonnées SAP, consultez Exposer les paramètres de l’adaptateur en tant que propriété de liaison à l’aide du Kit de développement logiciel (SDK) de l’adaptateur LOB WCF.

  Effectuez les étapes suivantes pour parcourir les RFC dans un système SAP à l’aide du complément Consommer le service d’adaptateur, de l’Assistant Ajout de métadonnées d’adaptateur ou du plug-in Add Adapter Service Reference.

Pour parcourir les RFC dans un système SAP

1. Connectez-vous à un serveur SAP à l’aide du complément Consommer le service de l’adaptateur, de l’Assistant Ajout de métadonnées d’adaptateur ou du plug-in Add Adapter Service Reference Plug-in. Pour obtenir des instructions, consultez Se connecter au système SAP dans Visual Studio .

2. Dans la liste déroulante Sélectionner un type de contrat , sélectionnez le type de contrat selon que vous allez effectuer des opérations entrantes ou sortantes à l’aide de l’adaptateur.

3. Dans la zone Sélectionner une catégorie , cliquez sur le nœud RFC pour afficher les groupes fonctionnels RFC dans la zone Catégories et opérations disponibles . Vous pouvez également voir les groupes fonctionnels RFC en développant le nœud RFC.

   Conseil

   Vous pouvez accéder directement au nœud de catégorie « immédiat » ou aux nœuds de sous-catégorie dans l’arborescence, en tapant le nom de l’artefact dans alors que le focus se trouve sur l’arborescence dans la zone Sélectionner une catégorie . Par exemple, pour accéder au groupe fonctionnel RFC de base , gardez le focus sur le nœud RFC , puis tapez Basis.

   La figure suivante montre le complément De service Consume Adapter répertoriant les groupes fonctionnels RFC.

   

4. Cliquez sur les groupes fonctionnels RFC pour afficher les RFC appropriés. La figure suivante montre le complément Consume Adapter Service avec les RFC sous un groupe fonctionnel RFC particulier.

   

Recherche de RFC dans un système SAP

Lors de la recherche de métadonnées pour les RFC dans un système SAP à l’aide du complément Consommer le service d’adaptateur, de l’Assistant Ajout de métadonnées d’adaptateur ou du plug-in Add Adapter Service Reference Plug-in de l’adaptateur SAP :

• Prend en charge les caractères génériques dans l’expression de recherche.

• Active la recherche immédiatement sous le nœud au niveau duquel l’opération de recherche est effectuée.

  Le tableau suivant répertorie les caractères spéciaux qui peuvent être utilisés pour la recherche et leur interprétation par l’adaptateur SAP.

Pour plus d’informations sur les caractères spéciaux pris en charge par l’adaptateur, consultez Exposer les paramètres de l’adaptateur en tant que propriété de liaison à l’aide du Kit de développement logiciel (SDK) de l’adaptateur LOB WCF.

Effectuez les étapes suivantes pour rechercher des RFC dans un système SAP à l’aide du complément Consommer le service d’adaptateur, de l’Assistant Ajout de métadonnées d’adaptateur ou du plug-in Add Adapter Service Reference.

Pour rechercher des RFC dans un système SAP

1. Connectez-vous à un serveur SAP à l’aide du complément Consommer le service de l’adaptateur, de l’Assistant Ajout de métadonnées d’adaptateur ou du plug-in Add Adapter Service Reference Plug-in. Pour obtenir des instructions, consultez Se connecter au système SAP dans Visual Studio .

2. Dans la liste déroulante Sélectionner un type de contrat , sélectionnez le type de contrat selon que vous allez rechercher des opérations entrantes ou sortantes à l’aide de l’adaptateur.

3. Dans la zone Sélectionner une catégorie , cliquez sur le groupe fonctionnel RFC contenant la RFC à rechercher. Si vous ne savez pas dans quel groupe fonctionnel rechercher, cliquez sur le nœud RFC racine.

4. Dans la zone de texte Rechercher dans la catégorie , entrez une expression de recherche pour rechercher une RFC spécifique. Par exemple, pour rechercher des RFC dont le nom est « RFC_CUST », tapez *RFC_CUST* dans la zone de texte.

5. Cliquez sur le bouton avec l’icône de flèche droite pour démarrer la recherche. Une fois la recherche terminée, la zone Catégories et opérations disponibles répertorie les RFC qui répondent aux critères de recherche.

   La figure suivante montre le complément Consume Adapter Service répertoriant le résultat de la recherche RFC.

   

Génération du schéma pour les projets BizTalk

Vous pouvez utiliser le complément Consommer le service d’adaptateur ou l’Assistant Ajout de métadonnées d’adaptateur pour générer le schéma pour les artefacts SAP sélectionnés. Une fois que vous avez parcouru et recherché les artefacts que vous souhaitez appeler, vous pouvez générer un schéma pour ces artefacts et envoyer des messages, conformes au schéma, au système SAP.

Pour récupérer des métadonnées pour les RFC

1. Connectez-vous à un serveur SAP à l’aide du complément Consommer le service d’adaptateur ou de l’Assistant Ajout de métadonnées d’adaptateur. Pour obtenir des instructions, consultez Se connecter au système SAP dans Visual Studio .

2. Dans la liste déroulante Sélectionner un type de contrat , sélectionnez le type de contrat selon que vous allez effectuer des opérations entrantes ou sortantes à l’aide de l’adaptateur.

3. Dans la zone Sélectionner une catégorie , cliquez sur le groupe fonctionnel RFC contenant la RFC pour laquelle vous souhaitez générer des métadonnées.

   Vous pouvez également rechercher des RFC spécifiques. Par exemple, pour rechercher des RFC qui contiennent « RFC_CUST » dans leur nom, cliquez sur le nœud RFC et dans la zone de texte Rechercher dans la catégorie , tapez *RFC_CUST*. Cliquez sur le bouton avec l’icône de flèche droite pour démarrer la recherche. La zone Catégories et opérations disponibles répertorie tous les RFC qui ont « RFC_CUST » dans leur nom.

4. Dans la zone Catégories et opérations disponibles , sélectionnez les RFC pour lesquels vous souhaitez générer des métadonnées, puis cliquez sur Ajouter. Les RFC sélectionnés sont répertoriés dans la zone Catégories et opérations ajoutées .

   La figure suivante montre le complément Consume Adapter Service répertoriant les RFC sélectionnés.

   

   Si vous souhaitez générer un schéma pour plusieurs opérations, il peut y avoir des définitions d’éléments en double parmi ces schémas qui peuvent entraîner un échec lors de la compilation du projet BizTalk. Par exemple, considérez un scénario où vous générez un schéma pour une opération « Op1 ». Le schéma pour « Op1 » contient un paramètre de type de données complexe « CT1 ». Après avoir généré le schéma pour « Op1 », vous fermez le complément Consume Adapter Service et le rouvrez pour générer le schéma pour une autre opération « Op2 ». Supposons que « Op2 » contient également un paramètre de type de données complexe « CT1 ». Après avoir quitté le complément Consume Adapter Service et compilé le projet, vous obtenez des erreurs de compilation, car le type de données complexe « CT1 » est défini deux fois dans différents fichiers XSD. Dans de telles situations, nous vous recommandons ce qui suit :

   • Générez le schéma pour toutes les opérations en une seule exécution du complément Consume Adapter Service. Cela garantit que le complément de service Consume Adapter ne génère qu’une seule définition pour le type de données complexe « CT1 ».

   • Si vous souhaitez générer un schéma pour plusieurs opérations dans différentes exécutions du complément de service Consume Adapter, veillez à sélectionner la zone Générer des types de schémas uniques case activée afin que les fichiers XSD générés contiennent des espaces de noms uniques pour le type de données complexe « CT1 ».

5. Cliquez sur OK. Le fichier de schéma est enregistré avec une extension .xsd au même emplacement que le projet BizTalk.

   Notes

   Si vous utilisez le complément Consume Adapter Service, par défaut, les fichiers sont créés avec la convention d’affectation de noms « SAPBinding<n.xsd> », où « n » peut être 1, 2, etc. en fonction du nombre de fichiers de schéma créés. Vous pouvez également fournir un nom personnalisé aux fichiers de schéma en entrant un nom dans la zone de texte Préfixe du nom de fichier. Le complément Consume Adapter Service crée désormais des fichiers de schéma avec le préfixe de nom de fichier de la convention <d’affectation de noms><n.xsd>.

   Notes

   Le complément Consume Adapter Service crée également un fichier de liaison (un fichier XML) contenant les propriétés de liaison que vous avez spécifiées lors de la génération du schéma d’une opération et de l’action SOAP pour appeler l’opération. Vous pouvez importer ce fichier de liaison dans la console d’administration BizTalk Server pour créer un port WCF-Custom avec l’URI de connexion, les propriétés de liaison et l’action SOAP. Pour plus d’informations, consultez Configurer une liaison de port physique à l’aide d’un fichier de liaison de port à SAP.

6. Dans le menu Fichier , cliquez sur Enregistrer tout.

Génération d’un client WCF pour les opérations RFC à l’aide du plug-in Add Adapter Service Reference

Vous pouvez utiliser le plug-in Add Adapter Service Reference pour générer soit du code client WCF pour envoyer des RFC au système SAP, soit un contrat de service WCF et du code pour recevoir des RFC (serveur RFC) du système SAP.

Pour générer un client WCF ou un contrat de service WCF pour RFC

1. Dans la liste déroulante Ajouter un plug-in de référence du service d’adaptateur, sélectionnez le type de contrat selon que vous effectuerez des opérations entrantes (serveur RFC) ou sortantes.

2. Dans la zone Sélectionner une catégorie , développez le nœud RFC , puis cliquez sur le groupe fonctionnel RFC qui contient la RFC pour laquelle vous souhaitez générer un client WCF ou un contrat de service WCF.

   Vous pouvez également rechercher des RFC. Par exemple, pour rechercher des RFC qui contiennent « RFC_CUST » dans leur nom, cliquez sur le nœud RFC et dans la zone de texte Rechercher dans la catégorie , tapez *RFC_CUST*. Cliquez sur le bouton avec l’icône de flèche droite pour démarrer la recherche. La zone Catégories et opérations disponibles répertorie tous les RFC dont le nom est « RFC_CUST ».

3. Dans la zone Catégories et opérations disponibles , sélectionnez les opérations ou les catégories (groupes fonctionnels RFC) pour lesquelles vous souhaitez générer un client WCF (ou un contrat de service WCF), puis cliquez sur Ajouter. Les opérations sélectionnées sont répertoriées dans la zone Catégories et opérations ajoutées . Vous pouvez sélectionner n’importe quel nœud répertorié dans la zone Catégories et opérations disponibles . Si vous sélectionnez un nœud de catégorie, toutes les opérations disponibles sous ce nœud et ses sous-nœuds seront ajoutées.

4. Pour la plupart des scénarios, les options de sérialisation par défaut sont suffisantes ; Toutefois, si nécessaire, vous pouvez contrôler plusieurs aspects du code généré et du type de sérialiseur utilisé. Pour définir ces options :

   1. Cliquez sur Options avancées pour ouvrir la zone Options avancées .

   2. Dans la zone Options avancées sous Choisir les options pour le proxy généré, sélectionnez les options souhaitées. Par exemple, vous pouvez sélectionner si des méthodes asynchrones sont générées pour le client WCF ou désactiver la génération d’un fichier de configuration.

   3. Sous Sérialiseur , sélectionnez le sérialiseur à utiliser.

      La figure suivante montre la zone Options avancées avec les sélections par défaut (Auto est sélectionné pour le sérialiseur et aucune autre option n’est sélectionnée).

      

      Les options que vous pouvez configurer dans la zone Options avancées sont équivalentes à certaines des options disponibles lorsque vous utilisez l’outil Utilitaire de métadonnées ServiceModel (svcutil.exe). Pour plus d’informations sur ces options, consultez ServiceModel Metadata Utility Tool (Svcutil.exe).

5. Cliquez sur OK. Le plug-in add adapter service reference enregistre la classe de client WCF (ou l’interface de service WCF) et le code d’assistance pour les opérations et les catégories que vous avez sélectionnées dans votre répertoire de projet. Par défaut, un fichier de configuration est également enregistré. Des fichiers légèrement différents sont générés pour les opérations entrantes et sortantes ; Pour plus d’informations, consultez Générer un client WCF ou un contrat de service WCF pour les artefacts de solution SAP.

Voir aussi

Obtenir les métadonnées pour les opérations SAP dans Visual Studio