Fonctoids de base de données
Les fonctoids de base de données extraient des données d’une base de données pour les utiliser dans un message instance de sortie.
Voici une liste des fonctoids de base de données et de la façon dont vous pouvez les utiliser :
Recherche dans la base de données : Utilisez le fonctoid Recherche de base de données pour extraire des informations d’une base de données et les stocker sous la forme d’un jeu d’enregistrements Microsoft ActiveX Data Objects .NET (ADO.NET). Ce fonctoid requiert quatre paramètres d'entrée dans l'ordre suivant :
Une valeur de recherche
Une chaîne de connexion à la base de données
Un nom de table
Un nom de colonne pour la valeur de recherche
Retour d'erreur : Utilisez le fonctoid De retour d’erreur pour capturer les informations d’erreur, telles que les échecs de connexion à la base de données, qui se produisent pendant l’exécution. Ce fonctoid nécessite un paramètre d’entrée : un lien à partir du fonctoid Recherche de base de données.
Formater message : renvoie une chaîne formatée et localisée utilisant une substitution d'argument et, potentiellement, des références croisées d'ID et de valeurs.
Obtenir l’ID d’application. extrait un identificateur pour un objet d'application.
Obtenir la valeur d'application : extrait une valeur d'application.
Obtenir l'ID courant : extrait un identificateur pour un objet commun.
Obtenir la valeur courante : extrait une valeur commune.
Supprimez l’ID d’application. Supprime une valeur d’application.
Définissez l’ID commun. Permet de définir et renvoyer un identificateur pour un objet courant.
Extracteur de valeur : Utilisez le fonctoid Value Extractor pour extraire des données de la colonne spécifiée dans un jeu d’enregistrements retourné par le fonctoid Recherche de base de données. Ce fonctoid nécessite deux paramètres d’entrée : un lien vers le fonctoid Recherche de base de données et un nom de colonne.
Sept des fonctoids de base de données ( Format Message, Get Application ID, Get Application Value, Get Common ID, Get Common Value, Remove Application ID et Set Common ID) sont des fonctoids CrossReferencing . Ces fonctoids convertissent les ID et valeurs d'un message d'entrée en ID et valeurs requises dans le message de sortie. Pour plus d’informations, consultez Informations de référence sur les fonctoids de base de données dans les instructions de l’interface utilisateur et informations de référence sur l’espace de noms d’API des développeurs.
L’exemple suivant utilise certains des fonctoids de base de données . Imaginez un grand détaillant dont les magasins sont répartis sur une zone géographique étendue. Pour suivre les magasins, l’administration centrale affecte à chaque magasin un code unique appelé StoreID. En outre, le siège social associe les informations suivantes à chaque StoreID :
StoreName
StoreAddress
Ville
PostalCode
StorePhoneNumber
StoreManager
Ces informations sont stockées dans une base de données et communiquées régulièrement aux partenaires commerciaux. L'ensemble des achats du détaillant sont effectués par le siège et non par les magasins. Lorsque le siège envoie un bon de commande aux partenaires commerciaux, en général, plusieurs magasins reçoivent les marchandises commandées à l'aide de cet unique bon de commande. Au lieu d’envoyer les informations de nom et d’adresse pour chaque magasin qui doit recevoir la marchandise, le siège social envoie simplement le StoreID. Pour insérer les informations de nom et d’adresse dans l’avis d’expédition avancé, le partenaire commercial utilise les fonctoids de base de données pour insérer automatiquement ces informations dans le message instance de sortie. La figure suivante montre comment un partenaire commercial peut mettre en œuvre le remplacement du StoreID dans un mappage.
Dans cette figure, le schéma source représente un bon de commande entrant, le schéma de destination un avis d'expédition avancée. Le fonctoid Recherche de base de données recherche l’enregistrement approprié à partir de la table de base de données appropriée. Les fonctoids de l’extracteur de valeur extraient la colonne appropriée de l’enregistrement de recherche. Le fonctoid De retour d’erreur génère une chaîne contenant des informations d’erreur en cas d’erreurs (telles que des échecs de connexion) au moment de l’exécution.
Dans l’exemple précédent, le premier paramètre d’entrée est extrait du champ StoreID du bon de commande entrant, et les trois autres paramètres d’entrée sont des constantes configurées dans la boîte de dialogue Configurer <le fonctoid du fonctoid> de recherche de base de données. Il est possible de créer des liens à partir du schéma source afin de fournir des valeurs pour les quatre paramètres d'entrée.
Notes
Vous ne pouvez pas utiliser certains types de données Microsoft SQL Server, tels que texte, ntext et image, comme valeurs de recherche pour le fonctoid Recherche de base de données. Le fonctoid requiert des types de données pouvant être représentés par une chaîne de texte.
S’il existe plusieurs enregistrements correspondant aux paramètres d’entrée du fonctoid Recherche de base de données , le fonctoid Extracteur de valeurs extrait uniquement les données du premier enregistrement.
Dans les chaînes de connexion, utilisez l'authentification NT pour protéger les mots de passe par chiffrement.
Les fonctoids de base de données sont les suivants :
- Recherche dans la base de données
- Retour d'erreur
- Formater message
- Obtenir l'ID d'application
- Obtenir la valeur d'application
- Obtenir l'ID courant
- Obtenir la valeur courante
- Supprimer l'identificateur d'application
- Définir l'ID courant
- Extracteur de valeur
Pour plus d’informations sur ces fonctiods, consultez la référence du fonctoid dans les instructions de l’interface utilisateur et les informations de référence sur l’espace de noms d’API des développeurs.
- Ajout d'un fonctoid de base à un mappage
- Informations de référence sur les fonctoids de base de données dans les instructions de l’interface utilisateur et les informations de référence sur l’espace de noms d’API des développeurs