Vorgänge für Schnittstellentabellen und -ansichten
Der Microsoft BizTalk-Adapter für Oracle E-Business Suite enthält eine Reihe von Standardvorgängen (Auswählen, Einfügen, Aktualisieren und Löschen) für jede Schnittstellentabelle und den Select-Vorgang für jede Schnittstellenansicht in Oracle E-Business Suite. Mithilfe dieser Vorgänge können Sie die SELECT-, INSERT-, UPDATE- und DELETE-Anweisungen ausführen, die durch eine WHERE-Klausel in der Zielschnittstellentabelle qualifiziert sind, und die SELECT-Anweisung, die durch eine WHERE-Klausel in der Zielschnittstellensicht qualifiziert ist. Diese Vorgänge werden auch als DML-Vorgänge (Data Manipulation Language) bezeichnet.
Wichtig
Bevor Sie Vorgänge für Schnittstellentabellen und Schnittstellenansichten ausführen können, müssen Sie den Anwendungskontext für diese Artefakte im Oracle E-Business-Adapter festlegen. Dies liegt daran, dass das Festlegen des Anwendungskontexts sichere Transaktionen in Oracle E-Business Suite erleichtert, indem Benutzereinstellungen (z. B. Verantwortungs-, organization- und Spracheinstellungen) und die Zugriffssteuerung für ein Artefakt festgelegt werden. Weitere Informationen zum Anwendungskontext und zum Festlegen finden Sie unter Festlegen des Anwendungskontexts.
Unterstützte DML-Vorgänge
In der folgenden Tabelle sind die DML-Vorgänge aufgeführt, die vom Oracle E-Business-Adapter unterstützt werden:
| Vorgang | BESCHREIBUNG |
|---|---|
| Select | Führt einen Select-Vorgang für die Zielschnittstellentabelle oder Schnittstellensicht basierend auf einer angegebenen Liste von Spaltennamen und einer Filterzeichenfolge aus, die eine SQL WHERE-Klausel angibt. Der Rückgabewert für einen Select-Vorgang ist ein stark typisiertes Resultset, das die angegebenen Spalten und Zeilen enthält. |
| Einfügen | Führt einen Insert-Vorgang für die Zielschnittstellentabelle aus. Der Insert-Vorgang unterstützt das Einfügen mehrerer Datensätze in die Zielschnittstellentabelle basierend auf einem angegebenen Datensatzsatz. Der Rückgabewert für einen Insert-Vorgang ist die Anzahl der eingefügten Zeilen. InlineValue Für alle einfachen Datensätze in einem Insert-Vorgang können Sie den Wert eines Datensatzes überschreiben, indem Sie einen Wert für ein optionales Attribut namens InlineValue angeben. Das InlineValue-Attribut kann verwendet werden, um berechnete Werte in Schnittstellentabellen einzufügen, z. B. das Auffüllen der Primärschlüsselspalte mithilfe einer Sequenz oder das Einfügen des Systemdatums (mithilfe von SYSDATE) in eine Datumsspalte. Beispiel: In der folgenden INSERT-Anweisung: <Insert xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/InterfaceTables/AR/AR_ARCHIVE_PURGE_INTERIM"> <RECORDSET> <InsertRecord xmlns="http://schemas.microsoft.com/OracleEBS/2008/05/TableViewRecord/AR/AR_ARCHIVE_PURGE_INTERIM"> <TRNS_DATE InlineValue="sysdate">2008-06-21T15:52:19</TRNS_DATE> <EMPNAME>John</EMPNAME> </InsertRecord> </RECORDSET> </Insert>Obwohl "2008-06-21T15:52:19" als Wert für TRNS_DATE angegeben wird, wird der Wert des InlineValue-Attributs "SYSDATE" (Systemdatum) in die Zielschnittstellentabelle eingefügt. Bei Verwendung des InlineValue-Attributs: – Vermeiden Sie die Verwendung konstanter Werte für das InlineValue-Attribut. Wenn Sie beispielsweise in der INSERT-Anweisung angeben <EMPNAME InlineValue="John"/> , führt dies zu einem Fehler. Dies liegt daran, dass der Wert des InlineValue-Attributs unverändert an Oracle übergeben wird. In diesem Fall wird John an Oracle E-Business Suite übergeben, was nicht dem erwarteten Wert entspricht (der erwartete Wert ist "John"). Sie müssten einzelne Anführungszeichen um den Namen des Mitarbeiters verwenden. Beispiel: <EMPNAME InlineValue="’John’"/>.- Wenn Sie eine Select-Abfrage für das InlineValue-Attribut verwenden möchten, müssen Sie die SELECT-Anweisung in Klammern einschließen und außerdem sicherstellen, dass die Select-Abfrage nur einen einzelnen Datensatz abruft. Beispiel: <EMPNAME InlineValue="(SELECT NAME FROM MS_SAMPLE_EMPLOYEES WHERE ID=123)"/>.Hinweis: Wenn ein Element in Oracle E-Business Suite als NOT NULL gekennzeichnet ist, müssen Sie einen Wert für dieses Element angeben, auch wenn Sie einen Inlinewert angegeben haben. Andernfalls tritt bei der Schemaüberprüfung ein Fehler auf. |
| Aktualisieren | Führt einen Updatevorgang für die Zielschnittstellentabelle aus. Die zu aktualisierenden Datensätze werden durch eine Filterzeichenfolge angegeben, die eine SQL WHERE-Klausel angibt. Die Werte für das Update werden in einem Vorlagendatensatz angegeben. Der Rückgabewert für einen Updatevorgang ist die Anzahl der aktualisierten Zeilen. |
| Löschen | Führt einen Delete-Vorgang für die Zielschnittstellentabelle basierend auf einer SQL WHERE-Klausel aus, die in einer Filterzeichenfolge angegeben ist. Der Rückgabewert für einen Delete-Vorgang ist die Anzahl der gelöschten Zeilen. |
Wichtige Details
Der Oracle E-Business-Adapter zeigt den gleichen Satz von Standardvorgängen (Auswählen, Einfügen, Aktualisieren und Löschen) für jede Tabelle und den Select-Vorgang für jede Ansicht in der zugrunde liegenden Oracle-Datenbank an. Die oben genannten DML-Vorgänge gelten auch für die zugrunde liegenden Oracle-Datenbanktabellen und -sichten.
- Es ist nicht erforderlich, den Anwendungskontext festzulegen, um Vorgänge für Tabellen und Sichten in der Oracle-Datenbank auszuführen. Bei benutzerdefinierten Oracle E-Business Suite-Anwendungen können Benutzer jedoch die Basisdatenbanktabellen als Schnittstellentabellen registrieren. Wenn eine Datenbanktabelle nicht als Schnittstellentabelle registriert ist, ist sie unter dem Unterknoten Tabellen im Knoten Artefaktbasierte Ansicht oder im Knoten Schemabasierte Ansicht zur Entwurfszeit verfügbar, während Sie das Adapterdienst-Add-In nutzen, den Assistenten zum Hinzufügen von Adaptermetadaten oder das Adapterdienstverweis-Plug-In hinzufügen verwenden.
Diese Tabellen sind einer Oracle E-Business-Anwendung zugeordnet. Daher müssen Sie für jeden Vorgang in diesen Tabellen den Anwendungskontext festlegen. Weitere Informationen finden Sie unter Set Application Contextenter link description (Anwendungskontext festlegen), um eine Linkbeschreibung hier einzugeben.
- Es ist nicht erforderlich, den Anwendungskontext festzulegen, um Vorgänge für Tabellen und Sichten in der Oracle-Datenbank auszuführen. Bei benutzerdefinierten Oracle E-Business Suite-Anwendungen können Benutzer jedoch die Basisdatenbanktabellen als Schnittstellentabellen registrieren. Wenn eine Datenbanktabelle nicht als Schnittstellentabelle registriert ist, ist sie unter dem Unterknoten Tabellen im Knoten Artefaktbasierte Ansicht oder im Knoten Schemabasierte Ansicht zur Entwurfszeit verfügbar, während Sie das Adapterdienst-Add-In nutzen, den Assistenten zum Hinzufügen von Adaptermetadaten oder das Adapterdienstverweis-Plug-In hinzufügen verwenden.