Définition de connexions externes

Si vous avez sélectionné Fichier de serveur, indiquez le chemin UNC du serveur, puis cliquez sur .

Si vous avez sélectionné FTP, saisissez les informations suivantes :

• Serveur hôte

• ID utilisateur

• Mot de passe de l'utilisateur

• Cliquez sur .

Si vous avez sélectionné Base de données, procédez comme suit :

• Sélectionnez un Fournisseur d'accès aux données : Oracle, SqlServer ou OleDb.

  • Entrer une valeur de délai d'expiration de connexion à la base de données

  • Entrer une valeur de délai d'expiration de commande de base de données

• Indiquez une chaîne de connexion.

• Entrez votre ID utilisateur et votre mot de passe

  Remarque :

  Pour établir une connexion externe accessible en écriture, l'administrateur doit disposer d'un accès en mode SELECT, INSERT et DELETE. Un utilisateur qui ne dispose que d'un accès SELECT peut établir une connexion externe en lecture seule à des tables et des vues.

• Cliquez sur .

• Dans l'onglet Objets autorisés, pour filtrer une longue liste, effectuez l'une des opérations suivantes :

  • Sélectionnez ou indiquez un schéma/propriétaire, en utilisant des caractères génériques si nécessaire.

  • Entrez le nom d'un objet, en utilisant des caractères génériques si nécessaire.

  • Sélectionnez Inclure les vues pour inclure des vues ayant au moins le privilège SELECT. Les vues sont toujours en lecture seule.

  • Sélectionnez Inclure les tables en lecture seule pour inclure des tables pour lesquelles le privilège est au moins SELECT, mais pas INSERT ni DELETE.

  • Cliquez sur , puis sélectionnez des objets dans la liste Disponible. Utilisez les flèches pour déplacer les objets dans la liste Sélectionné.

  • Facultatif : pour utiliser la section Ajout rapide, entrez le propriétaire/schéma et le nom de l'objet que vous voulez ajouter, puis cliquez sur la flèche pour le déplacer dans la liste Sélectionné.

• Pour ajouter une opération externe, cliquez sur l'onglet Opérations externes, cliquez sur Ajouter, puis procédez comme suit :

  • Entrez le nom de l'opération. Le nom doit être unique pour la connexion externe parent.

  • Saisissez le texte de description de l'objectif de l'opération.

  • Sélectionnez le type d'opération : Equivalence ou Validation (commit). Cette sélection permet de filtrer la liste des opérations pouvant être sélectionnées avec les fonctionnalités Equivalence externe et Validation externe.

  • Sélectionnez le type d'opération de base de données : Instruction ou Procédure stockée.

    • Si vous avez sélectionné Instruction, cliquez sur Ajouter, puis procédez comme suit :

      • Saisissez les paramètres à transmettre lors de l'appel de l'opération :

        • Nom de paramètre : nom du paramètre. Les espaces ne sont pas autorisés.

        • Description de paramètre : description du paramètre.

        • Valeur de test : valeur utilisée pour tester l'opération. La valeur est stockée pour être réutilisée.

      • Dans le champ Instruction SQL, entrez une seule instruction SQL à exécuter. Vous pouvez utiliser des paramètres de substitution dans l'instruction SQL pour transmettre des valeurs d'exécution. Le format des paramètres de substitution est <%ParamKey%>, où <% et %> indiquent un paramètre de substitution et ParamKey représente le nom du paramètre à utiliser pour la substitution. Par exemple, <%TopNode%>.

      • Cliquez sur pour tester l'opération. L'option Restauration permet de restaurer toute modification apportée à la base de données par le script. L'option Restauration est sélectionnée par défaut. Lorsqu'une opération est testée, les valeurs de test du paramètre sont insérées dans l'instruction, puis exécutées. Cliquez sur l'onglet Résultat pour afficher les résultats du test.

    • Si vous avez sélectionné Procédure stockée, procédez comme suit :

      • Entrez le nom de procédure stockée à exécuter, qui peut inclure le nom de composant comme préfixe.

      • Entrez le nom de l'opération. Le nom doit être unique pour la connexion externe parent.

      • Saisissez le texte de description de l'objectif de l'opération.

      • Affichez la liste des paramètres pour la procédure stockée. Sélectionnez True pour le paramètre de résultat afin de renvoyer le paramètre dans le résultat d'opération Data Relationship Management. Un seul paramètre peut être sélectionné en tant que paramètre de résultat. Les paramètres de résultat sont renvoyés uniquement pour les opérations d'équivalence. Pour les opérations de validation, seule l'indication de succès ou d'échec est disponible.

      • Valeur de test : valeur utilisée pour tester l'opération. La valeur est stockée pour être réutilisée.

      • Cliquez sur pour tester l'opération. L'option Restauration permet de restaurer toute modification apportée à la base de données par la procédure stockée. L'option Restauration est sélectionnée par défaut. Lorsqu'une opération est testée, les valeurs de test du paramètre sont insérées dans la procédure stockée, puis exécutées. Cliquez sur l'onglet Résultat pour afficher les résultats du test.

Si vous avez sélectionné Service Web, procédez comme suit :

• Sélectionnez le protocole : HTTP ou HTTPS.

• Entrez le nom d'hôte.

• Entrez le port. Si le port 0 est indiqué, les ports 80 et 443 standard sont utilisés respectivement pour HTTP et HTTPS.

• Sélectionnez le type d'authentification. Si la valeur De base est définie, l'ID utilisateur et le mot de passe peuvent être enregistrés.

• Entrer l'ID utilisateur et le mot de passe.

• Pour ajouter une opération externe, cliquez sur Ajout, puis procédez comme suit :

  • Entrez le nom de l'opération. Le nom doit être unique pour la connexion externe parent.

  • Saisissez le texte de description de l'objectif de l'opération.

  • Sélectionnez le type d'opération : Equivalence ou Validation (commit). Cette sélection permet de filtrer la liste des opérations pouvant être sélectionnées avec les fonctionnalités Equivalence externe et Validation externe.

  • Dans l'onglet Demande, cliquez sur Ajouter, puis entrez les paramètres à transmettre lors de l'appel de l'opération :

    • Nom de paramètre : nom du paramètre. Les espaces ne sont pas autorisés.

    • Description de paramètre : description du paramètre.

    • Valeur de test : valeur utilisée pour tester l'opération. La valeur est stockée pour être réutilisée.

  • Dans Action HTTP, sélectionnez GET, POST, PUT ou DELETE.

    Remarque :

    Seules les actions POST et PUT autorisent l'envoi du contenu du corps HTTP.

  • Entrez l'URI HTTP du message de service Web.

  • Entrez le contenu brut de l'en-tête HTTP.

  • Entrez le contenu du texte du corps HTTP.

  • Onglet Réponse : affiche les messages entrant et sortant complets pour l'opération de service Web. Les valeurs de test des paramètres utilisés dans le message sortant sont insérées dans la demande. Le corps HTTP du message entrant renvoyé par le service Web est censé être au format XML ou JSON. Pour les opérations d'équivalence externe, le message entrant doit être converti au format tabulaire (lignes et colonnes) pour être utilisé avec les propriétés d'équivalence externe. Pour gérer cette conversion, vous pouvez utiliser des expressions XPath. Le paramètre Expression d'identifiant de liste identifie les éléments du message entrant qui constituent les lignes de l'ensemble de résultats. Les colonnes de résultat identifient les attributs des éléments de ligne qui sont affichés en tant que colonnes dans l'ensemble de résultats.

    Pour afficher un aperçu des résultats des configurations Expression d'identifiant de liste et Colonnes de résultat, cliquez sur l'onglet Aperçu. Les résultats sont affichés dans une grille de données.

  Vous pouvez utiliser des paramètres de substitution dans l'URI, l'en-tête HTTP et le corps HTTP pour transmettre des valeurs d'exécution à l'opération externe. Le format des paramètres de substitution est <%ParamKey%>, où <% et %> indiquent un paramètre de substitution et ParamKey représente le nom du paramètre à utiliser pour la substitution. Par exemple, <%TopNode%>.

  Pour tester la configuration, cliquez sur . La demande HTTP est créée, puis envoyée au point de terminaison. L'interface utilisateur bascule automatiquement vers l'onglet Réponse et affiche le message sortant et la réponse entrante complets. Les valeurs de test des paramètres utilisés dans le message sortant sont insérées dans la demande.