Transactions MDBREADMI

Ce document décrit la transaction API MDBREADMI paramétrable qui permet de lire des données à partir d'une seule et unique table. MDBREADMI est l'API préconisée quand aucune API existante et aucune donnée d'une table unique ne sont requises. Si des informations provenant de champs virtuels, plusieurs tables et instructions SQL complexes sont nécessaires, utilisez plutôt les transactions CMS100MI (Créateur ligne personnalisée MI) ou EXPORTMI (Export de données).

Remarque

Tables de support MDBREADMI et DTAMI créées via XtendM3.

Restriction

La création de transactions API paramétrables dans M3 Business Engine peut être réalisée de plusieurs manières et chacune d'elles présente ses propres avantages. Les transactions MDBREADMI sont rapides et simples à définir et offrent de bonnes performances. En revanche, leur utilisation se limite à une seule table de base de données et aucun champ virtuel ne peut être utilisé.

Définition d'une transaction MDBREADMI

Une transaction MDBREADMI présente trois types :

(Get) utilisé pour extraire un enregistrement unique de la table.
(List) utilisé pour extraire le premier enregistrement suivi d'une liste d'enregistrements.
(Select) utilisé pour extraire tous les enregistrements correspondant aux entrées sélectionnées.

L'option de tri est la base de saisie de la transaction MDBREADMI. Si la transaction est de type Liste ou Select, vous pouvez supprimer des champs d'entrée pour étendre la sélection des tables. Vous pouvez également recourir à Infor Enterprise Search et utiliser une requête de recherche comme entrée. Comme pour les champs de sortie de la transaction MDBREADMI, tous les champs issus de la table peuvent être sélectionnés.

La configuration des transactions MDBREADMI s'effectue en définissant des métadonnées d'API selon une méthode spécifique. Les programmes MRS010-MRS012 sont conçus pour simplifier cette configuration.

Suivez les étapes ci-dessous :

Créez une nouvelle transaction dans 'Transaction MDBREADMI. Ouvrir' (MRS010), où d'autres transactions MDBREADMI existantes sont également répertoriées. Le nom d'une transaction MDBREADMI est composé de quatre éléments au format XxxYYYYYYZZsfxx où les caractères correspondent à ce qui suit :
- Xxx : type de transaction API, comme Either, Get, List (Lst) ou Select (Sel)
- YYYYYY : table ou fichier de base de données de la transaction
- ZZ : option de tri de la transaction
- Sfxx : suffixe du nom de la transaction (facultatif)
Si certains de ces éléments sont inconnus, créez une transaction dans (MRS010/B) et définissez les éléments par la suite dans l'écran E. Au moment de la création, vous pouvez demander à la transaction d'utiliser la requête de recherche plutôt que les champs d'entrée. Pour les transactions de liste MDBREADMI, vous pouvez utiliser le nombre de filtres comme entrée, plutôt que définir un ensemble fixe de filtres pour la transaction. Lorsque la transaction est créée dans (MRS010), elle crée automatiquement des champs de transactions API entrants qui sont consultés dans le programme 'Champs de transaction API. Ouvrir' (MRS012).
Remarque
Les transactions de liste MDBREADMI ne peuvent pas utiliser d'options de tri personnalisées contenant le champ NFTR - 'Nombre de filtres'. Si nécessaire, utilisez à la place une transaction de sélection ou EXPORTMI.
Définissez les champs de sortie d'une transaction MDBREADMI dans le programme 'Gestion des champs API sortants. Ouvrir' (MRS011). Tous les champs disponibles pour la table sélectionnée sont répertoriés. L'option 'Champ activé' doit être définie pour les champs à inclure dans la transaction. Pour modifier l'ordre des champs, spécifiez un numéro dans la série de champs 'Nouv n° séquence'.
Plusieurs touches de fonction sont également disponibles : F15 ('Ajouter tous les champs') pour ajouter tous les champs à la transaction, F16 ('Supprimer tous les champs') pour supprimer tous les champs de la transaction et F17 ('Ajouter des champs de signet') pour ajouter des champs de signet à la transaction.
Remarque
Les modifications apportées concernent uniquement la transaction MDBREADMI une fois le programme clôturé. N'oubliez pas d'apporter des modifications.
Si nécessaire, modifiez les champs entrants dans le programme 'Champs de transaction API. Ouvrir' (MRS012). Pour la liste et sélection 'Type de transaction API', servez-vous des touches de fonction F15 ('Supprimer le dernier champ') pour supprimer le dernier champ de transaction API entrant et F16 ('Ajouter le champ suivant') pour ajouter le champ de transaction API entrant précédemment supprimé. Si la transaction utilise le nombre de filtres comme entrée, ces touches de fonction ne sont pas nécessaires.
Vérifiez que tous les champs requis sont inclus au moyen de l'option de tri standard 2 dans (MRS012) pour répertorier à la fois les champs entrants et sortants de la transaction API.

En exportant la configuration, vous pouvez enregistrer ou transférer les transactions MDBREADMI. Utilisez l'option 20='Exporter configuration' avec une ou plusieurs transactions MDBREADMI et spécifiez le nom de fichier et le numéro de version de la configuration. Localisez le fichier en ouvrant le programme 'Tâches données de configuration. Ouvrir' (MNS200). Utilisez l'ordre de tri 4, puis spécifiez le nom de fichier et la date de début. Utilisez l'option 20='Afficher XML' pour télécharger le fichier XML sous forme de fichier ZIP compressé.