Sélectionner un schéma d’URI et un format d’adressage lors de l’utilisation du Kit de développement logiciel (SDK) de l’adaptateur LOB WCF
Un URI (Uniform Resource Identifier) identifie de manière unique des ressources telles qu’un service Web ou, dans le cas d’un adaptateur développé avec le Kit de développement logiciel (SDK) de l’adaptateur LOB WCF, le système auquel se connecter, ainsi que l’action à effectuer. Cette section fournit une recommandation sur la façon de construire un URI pour décrire de manière unique l’adresse de point de terminaison et l’action de votre adaptateur.
Anatomie d’un URI
Un URI se compose des trois composants suivants :
Le nom du schéma est la partie principale de la chaîne d’URI et est le premier niveau de la structure de nommage ; Les exemples incluent http, urn et contoso.
La partie hiérarchique se compose d’informations généralement hiérarchiques et pouvant contenir des informations facultatives sur l’autorité, le nom d’hôte et le port. Exemples :
www.microsoft.cometUserName=User@microsoft.com:4099.La requête contient des informations facultatives marquées d’un point d’interrogation ( ?) et généralement regroupées sous forme de paires clé/valeur séparées par une esperluette (&). Par exemple, contoso://microsoft.com/functions?name=Find.
Fragment est utilisé pour stocker des informations d’identification supplémentaires qui peuvent être nécessaires à l’adaptateur. Le fragment est séparé par un hachage (#) ; par exemple, contoso://microsoft.com/functions?name=Find#public.
Il est possible que vous n’utilisiez pas toutes les fonctionnalités fournies par la syntaxe d’URI.
Conception de l’URI
En tant que développeur d’adaptateurs, vous devrez concevoir un URI approprié pour votre système métier cible. Lors de la conception de votre URI, il est important de le rendre unique et significatif.
Un URI unique est un URI qui n’entre pas en conflit avec les URI existants au sein d’un organization et dans d’autres entreprises et Internet. Par exemple, le choix d’un nom de schéma comme « http » ou « afs » qui peut être actuellement reconnu ou déjà largement utilisé peut entraîner des problèmes de connexion ou de fonctionnement, car les demandes peuvent être acheminées vers un autre système et non vers votre adaptateur.
Un autre aspect important de la conception d’URI est de le rendre significatif pour le public développeur qui consommera votre adaptateur. Par exemple, si vous écrivez un adaptateur pour un système de traitement des revendications médicales, vous pouvez concevoir un schéma d’URI qui inclut le nom de votre entreprise, le nom du système de traitement des revendications cible et la version du système : northwind.contoso.cps.v1.0 ://.
Connexion au système cible
Les chaînes de connexion ont la syntaxe suivante :
<scheme> ://[userinfo « @"]<Chaîne de connexion métier>
Par exemple, vous pouvez vous connecter au système de classement de catalogue contoso (exemple d’application métier) à l’aide des éléments suivants :
northwind.contoso.v1.0 ://<servername> ? Catalog=Contoso&Integrated Security=True
Vous pouvez également fournir des informations d’autorité facultatives dans l’URI, notamment le nom d’utilisateur et le mot de passe et d’autres informations d’identification importantes. Toutefois, cela peut présenter un risque pour la sécurité.
Attention
Ne transmettez pas les informations d’identification de l’utilisateur et d’autres informations sensibles dans l’URI. Ces informations peuvent être interceptées et consultées par des utilisateurs non autorisés.