MDBREADMI-Transaktionen

In diesem Dokument wird die benutzerdefinierte API MDBREADMI zum Lesen von Daten aus einer einzelnen Tabelle beschrieben. MDBREADMI ist die empfohlene API, wenn keine API vorhanden ist und Daten aus einer einzelnen Tabelle erforderlich sind. Wenn Informationen aus virtuellen Feldern, mehreren Tabellen und komplexen SQL-Anweisungen erforderlich sind, verwenden Sie stattdessen CMS100MI (Designer f. benutzerdefinierte Listen MI) oder EXCHEADMI (Datenexport).
Hinweis

Sowohl MDBREADMI als auch EXPORTMI unterstützt Tabellen, die über XtendM3 erstellt wurden.

Einschränkung

Das Erstellen benutzerdefinierter API-Transaktionen in M3 Business Engine kann auf verschiedene Arten erfolgen, jede davon bietet andere Vorteile. MDBREADMI-Transaktionen sind schneller und einfacher zu definieren und weisen eine gute Performance auf. Allerdings kann nur eine einzelne Datenbanktabelle verwendet werden, und virtuelle Felder können nicht verwendet werden.

MDBREADMI-Definition

Eine MDBREADMI-Transaktion hat drei Typen:
  • Abrufen (Get) – Abrufen einzelner Datensätze aus der Tabelle.
  • Liste (List, Lst) – Abrufen des ersten Datensatzes, gefolgt von einer Liste von Datensätzen.
  • Auswahl (Select, Sel) – Abrufen aller Datensätze, die der Eingabeauswahl entsprechen.

Die Sortieroption ist die Grundlage für die Eingabe der MDBREADMI-Transaktion. Wenn es sich bei der Transaktion um einen Listen- oder einen Auswahltyp handelt, können Sie Eingabefelder entfernen, um die Tabellenauswahl zu erweitern. Sie können eine Suchabfrage auch als Eingabe für Infor Enterprise Search verwenden. Für die Ausgabefelder der MDBREADMI-Transaktion kann jedes Feld der Tabelle ausgewählt werden.

Die Einrichtung von MDBREADMI-Transaktionen erfolgt durch Definieren von API-Metadaten auf eine bestimmte Art und Weise. Die Programme MRS010-MRS012 dienen zur Vereinfachung dieser Einrichtung.

Führen Sie folgende Schritte aus

  1. Erstellen Sie in "MDBREADMI. Öffnen" (MRS010) eine neue Transaktion, in der auch andere vorhandene MDBREADMI-Transaktionen aufgelistet werden. Der Name einer MDBREADMI-Transaktion besteht aus vier Elementen im Format XxxYYYYYYZZsfxx, wobei die Zeichen für die folgenden Werte stehen:
    • Xxx: Der API-Transaktionstyp, z. B. Get (Abrufen), Lst (Liste) oder Sel (Auswahl)
    • YYYYYY: Die Tabelle oder die Datenbankdatei für die Transaktion.
    • ZZ: Die Sortieroption für die Transaktion.
    • Sfxx: Das optionale Suffix des Transaktionsnamens
    Wenn einige dieser Elemente unbekannt sind, erstellen Sie in (MRS010/B) eine Transaktion, und definieren Sie die Elemente später in Bild E. Zum Erstellungszeitpunkt können Sie für die Transaktion anstelle von Eingabefeldern auch eine Suchabfrage verwenden. Für MDBREADMI-Listentransaktionen können Sie die Anzahl der Filter als Eingabe verwenden, anstatt einen festen Filtersatz für die Transaktion zu definieren. Wenn die Transaktion in (MRS010) erstellt wird, erstellt sie automatisch eingehende API-Transaktionsfelder, die in "API-Transaktionsfelder. Öffnen" (MRS012) angezeigt werden.
    Hinweis

    MDBREADMI Listentransaktionen können keine benutzerdefinierten Sortieroptionen verwenden, die das Feld "NFTR - Anzahl Filter" enthalten. Verwenden Sie bei Bedarf eine Auswahltransaktion oder EXPORTMI.

  2. Legen Sie die Ausgabefelder für eine MDBREADMI-Transaktion in "Mit ausgeh. API-Feldern arbeiten. Öffnen" (MRS011) fest. Alle verfügbaren Felder für die ausgewählte Tabelle werden aufgelistet. Bei den in der Transaktion enthaltenen Feldern muss "Feld aktiviert" eingestellt sein. Um die Reihenfolge der Felder zu ändern, geben Sie in der Serie der Felder "Neue Sequenznummer" eine Nummer ein.

    Es gibt auch die Funktionstasten F15 = Alle Felder hinzufügen, um alle Felder zur Transaktion hinzuzufügen, F16 = Alle Felder entfernen, um alle Felder aus der Transaktion zu entfernen, und F17 = Bookmark-Felder hinzufügen, um einer Transaktion Bookmarkfelder hinzuzufügen.

    Hinweis

    Änderungen werden auf die MDBREADMI-Transaktion erst nach Beendigung des Programms angewendet. Denken Sie daran, die Änderungen anzuwenden.

  3. Ändern Sie ggf. die eingehenden Felder in "API-Transaktionsfelder. Öffnen" (MRS012). Verwenden Sie für die Liste "API-Transaktionstyp" die Funktionstasten F15 = Letztes Feld entfernen, um das letzte eingehende API-Transaktionsfeld zu entfernen, und F16 = Nächstes Feld hinzufügen, um das zuvor gelöschte eingehende API-Transaktionsfeld hinzuzufügen. Wenn die Transaktion die Anzahl der Filter als Eingabe verwendet, sind diese Funktionstasten nicht erforderlich.
  4. Stellen Sie sicher, dass alle erforderlichen Felder enthalten sind, indem Sie in (MRS012) Standard-Sortieroption 2 verwenden, um für die API-Transaktion eingehende und ausgehende Felder aufzulisten.

Beim Exportieren der Konfiguration können Sie die MDBREADMI-Transaktionen speichern oder übertragen. Verwenden Sie Eingabe 20 = Exportkonfiguration für eine oder mehrere MDBREADMI-Transaktionen, und geben Sie den Dateinamen und die Versionsnummer der Konfiguration an. Suchen Sie die Datei durch Öffnen von "Konfigurationsdaten-Jobs. Öffnen" (MNS200): Verwenden Sie die Sortierfolge 4, und geben Sie den Dateinamen und das Startdatum an. Verwenden Sie Eingabe 20 = XML-Datei anz., um die XML-Datei als komprimierte ZIP-Datei herunterzuladen.

Verwandte Themen