Datenbankfunktoide
Datenbank-Funktoide extrahieren Daten aus einer Datenbank für die Verwendung in einer Ausgabe instance Nachricht.
Im Folgenden finden Sie eine Liste der Datenbank-Funktoide und deren Verwendung:
Datenbanksuche. Verwenden Sie das Funktoid Datenbanksuche , um Informationen aus einer Datenbank zu extrahieren und als Microsoft ActiveX Data Objects .NET -Recordset (ADO.NET) zu speichern. Dieses Funktoid erfordert vier Eingabeparameter in der folgenden Reihenfolge:
Einen Suchwert
Eine Verbindungszeichenfolge für die Datenbank
Einen Tabellennamen
Einen Spaltennamen für den Suchwert
Fehlerrückgabe. Verwenden Sie das Funktoid Fehlerrückgabe , um Fehlerinformationen zu erfassen, z. B. Datenbankverbindungsfehler, die während der Laufzeit auftreten. Dieses Funktoid erfordert einen Eingabeparameter: einen Link aus dem Funktoid Datenbanksuche .
Nachricht formatieren. Gibt eine mittels Argumentsubstitution und auch Querverweisen auf ID und Wert formatierte und lokalisierte Zeichenfolge zurück.
Abrufen der Anwendungs-ID. Ruft einen Bezeichner für ein Anwendungsobjekt ab.
Anwendungswert abrufen. Ruft einen Anwendungswert ab.
Allgemeine ID abrufen. Ruft einen Bezeichner für ein allgemeines Objekt ab.
Allgemeinen Wert abrufen. Ruft einen allgemeinen Wert ab.
Entfernen Sie die Anwendungs-ID. Entfernt einen Anwendungswert.
Legen Sie allgemeine ID fest. Legt einen Bezeichner für ein allgemeines Objekt fest und gibt ihn zurück.
Werte extrahieren. Verwenden Sie das Funktoid Value Extractor , um Daten aus der angegebenen Spalte in einem Recordset zu extrahieren, das vom Funktoid Datenbanksuche zurückgegeben wird. Dieses Funktoid erfordert zwei Eingabeparameter: einen Link zum Funktoid Datenbanksuche und einen Spaltennamen.
Sieben der Datenbank-Funktoide – Format Message, Get Application ID, Get Application Value, Get Common ID, Get Common Value, Remove Application ID und Set Common ID – sind CrossReferencing-Funktoide. Diese Funktoide übersetzen IDs und Werte aus einer Eingabenachricht in IDs und Werte für die Ausgabenachricht. Weitere Informationen finden Sie unter Referenz zu Datenbank-Funktoiden in der Referenz zu Ui-Anleitungen und API-Namespace für Entwickler.
Im folgenden Beispiel werden einige der Datenbank-Funktoide verwendet. Ein großer Hersteller für den Einzelhandel verfügt über eine Reihe von Filialen, die geografisch weit verteilt sind. Um die Filialen nachzuverfolgen, weist die Zentrale jedem Speicher einen eindeutigen Code zu, der als StoreID bezeichnet wird. Darüber hinaus ordnet die Zentrale jeder StoreID die folgenden Informationen zu:
StoreName
StoreAddress
Stadt
PostalCode
StorePhoneNumber
StoreManager
Diese Informationen werden in einer Datenbank gespeichert und regelmäßig an Handelspartner weitergegeben. Für den Hersteller läuft der gesamte Bestellvorgang über die Unternehmenszentrale und nicht über die einzelnen Filialen. Wenn die Unternehmenszentrale eine Bestellung an die Handelspartner sendet, ist es nicht ungewöhnlich, dass mehrere Filialen Waren erhalten, die über einen einzigen Auftrag bestellt wurden. Anstatt Namen und Adressinformationen für jedes Geschäft zu senden, das Waren empfangen soll, sendet die Zentrale einfach die StoreID. Um die Namens- und Adressinformationen in die erweiterte Versandbenachrichtigung einzufügen, verwendet der Handelspartner die Datenbank-Funktoide, um diese Informationen automatisch in die Ausgabe instance Nachricht einzufügen. In der folgenden Abbildung wird gezeigt, wie ein Handelspartner das Ersetzen der StoreID in einer Zuordnung implementieren kann.
In der Abbildung steht das Quellschema für eine eingehende Bestellung und das Zielschema für eine Vorablieferbescheinigung. Das Funktoid Datenbanksuche findet den entsprechenden Datensatz aus der entsprechenden Datenbanktabelle. Die Wertextraktionsfunktion extrahiert die entsprechende Spalte aus dem Nachschlagedatensatz. Das Funktoid Fehlerrückgabe gibt eine Zeichenfolge mit Fehlerinformationen aus, wenn zur Laufzeit Fehler (z. B. Verbindungsfehler) vorhanden sind.
Im vorherigen Beispiel wird der erste Eingabeparameter aus dem Feld StoreID der eingehenden Bestellung entnommen, und die restlichen drei Eingabeparameter sind Konstanten, die im Dialogfeld Funktoid> konfigurieren < für das Funktoid Datenbanksuche konfiguriert sind. Es ist möglich, Verknüpfungen aus dem Quellschema zu erstellen, um Werte für alle vier Eingabeparameter bereitzustellen.
Hinweis
Sie können einige Microsoft SQL Server-Datentypen, z. B. text, ntext und bild, nicht als Nachschlagewerte für das Funktoid Datenbanksuche verwenden. Dieses Funktoid benötigt Datentypen, die als Textzeichenfolge dargestellt werden können.
Wenn mehrere Datensätze vorhanden sind, die den Eingabeparametern des Funktoids Datenbanksuche entsprechen, extrahiert das Funktoid Value Extractor nur Daten aus dem ersten Datensatz.
Verwenden Sie in Verbindungszeichenfolgen die Windows NT-Authentifizierung, um Kennwörter durch Verschlüsselung zu schützen.
Die Datenbank-Funktoide sind:
- Datenbanksuche
- Fehlerrückgabe
- Nachricht formatieren
- Anwendungs-ID abrufen
- Anwendungswert abrufen
- Allgemeine ID abrufen
- Allgemeinen Wert abrufen
- Anwendungs-ID entfernen
- Allgemeine ID festlegen
- Werte extrahieren
Weitere Informationen zu diesen Funktiods finden Sie in der Referenz zu Funktoiden in der Referenz zu API-Namespaces für Benutzeroberflächen und Entwickler.For more details on these functiods, see the Functoid Reference in the UI guidance and developers API namespace reference.
- Hinzufügen von Standardfunktoiden zu einer Zuordnung
- Referenz zu Datenbank-Funktoiden in der Referenz zu Benutzeroberflächenanleitungen und API-Namespaces für Entwickler